Diego Viscarra
←Volver a proyectos
Retail ERP / Transactional POS / Financial Ledger

Tienda Colonial — ERP & POS Transaccional

Sistema de Punto de Venta con motor FIFO estricto, modelo contable origen → destino y modo contingencia offline.

Rol
Full Stack Engineer & Software Architect
Cliente
Tienda Familiar de Abarrotes (El Salvador)
Periodo
2025 — En Producción
Estado
Desplegado en producción local & Docker
FIFO Estricto
Trazabilidad por lotes

Costo unitario congelado por venta para cálculo de utilidad bruta sin sesgos

FOR UPDATE
Bloqueo pesimista

Transacciones ACID protegidas contra concurrencia y sobreventa de stock

3 Rutas
Clasificación de retiros

Separación contable estricta entre Gasto Operativo, Bóveda y Devolución

Offline Ready
Modo contingencia

Operación ininterrumpida ante fallas eléctricas o caídas de internet

Así se ve

Punto de Venta (POS) Operativo. Cuadrícula de productos con lector de códigos de barra, carrito reactivo, atajos de teclado y cálculo inmediato de cambio.

Aviso: Los datos, cifras y registros mostrados son ficticios y corresponden a pruebas simuladas (mock data); no pertenecen a la empresa ni exponen información real.

El problema

Diseñado para una tienda de abarrotes de alta rotación en El Salvador con ventas 100% en efectivo, compras por fardo y venta fraccionada, operando bajo fallas eléctricas recurrentes. La dueña no sabía si ganaba o perdía dinero por la fluctuación constante de precios de proveedores.

  1. 01

    Distorsión de margen por costo promedio

    Comprar un fardo a $12 y al mes siguiente a $14 hacía que calcular márgenes sobre promedios mostrara ganancias ficticias.

  2. 02

    Caos en la 'sangría' de caja

    Sacar dinero para pagar el pan, guardar en la caja fuerte o gastos personales se registraba como un egreso plano, destruyendo el cálculo contable.

  3. 03

    Cortes de turno descuadrados

    Diferencias por cambio mal dado o pérdidas no se auditaban sistemáticamente contra el saldo real esperado.

  4. 04

    Cortes de energía eléctrica

    La tienda no podía detener ventas durante apagones; requería un POS táctil resiliente que no perdiera tickets en cola.

Decisiones de arquitectura

Motor de Inventario FIFO con Bloqueo Pesimista

Consistencia de Datos

Cada compra ingresa como un lote con fecha y costo. Al vender, se descuenta de los lotes más antiguos y se congela el COGS exacto.

  • Consultas `SELECT ... FOR UPDATE` para serializar transacciones en lotes activos.
  • Cálculo del P&L basado en el costo histórico real del lote vendido.
  • Soporte para fraccionamiento de unidades (caja a unidades individuales) sin duplicar ítems.

Modelo Financiero Origen → Destino

Partida Doble Simplificada

Se eliminaron las tablas de saldo estático en caja; todo saldo se deriva del libro mayor de transacciones.

  • Catálogo cerrado de cuentas: GAVETA, BOVEDA, DUEÑOS, GASTO, PROVEEDOR.
  • Retiros clasificados obligatoriamente en 3 vías contables.
  • Conciliación de arqueo con margen de tolerancia inteligente configurada.

Stack

Backend
  • NestJS 11
  • TypeScript
  • Prisma 7 (@prisma/adapter-pg)
  • PostgreSQL
  • Passport + JWT
Frontend
  • Next.js 16 (App Router)
  • React 19
  • Tailwind CSS
  • Zustand
  • Recharts
  • shadcn/ui
Base de datos
  • PostgreSQL (Supabase / Docker)
  • Bloqueo pesimista FOR UPDATE
  • pg_advisory_xact_lock