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
Costo unitario congelado por venta para cálculo de utilidad bruta sin sesgos
Transacciones ACID protegidas contra concurrencia y sobreventa de stock
Separación contable estricta entre Gasto Operativo, Bóveda y Devolución
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.
- 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.
- 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.
- 03
Cortes de turno descuadrados
Diferencias por cambio mal dado o pérdidas no se auditaban sistemáticamente contra el saldo real esperado.
- 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 DatosCada 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 SimplificadaSe 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