Contexto
Arqueos es una herramienta interna para llevar el arqueo de caja diario de varios negocios. Sustituye a un Excel que se había vuelto difícil de mantener.
El Excel original se conserva en el repositorio solo como fixture de regresión: la app tiene que dar exactamente los mismos resultados que él antes de dar un solo paso más.
Mi contribución
Analicé el Excel, extraje sus reglas de negocio y las reimplementé como un motor de cálculo con tests, junto con la importación del histórico y la app multiusuario.
Problema
El control diario de caja vivía en una hoja de cálculo: fórmulas frágiles, errores silenciosos y nadie más podía tocarla con seguridad.
Solución
Una app web multiusuario y multinegocio con las reglas de cálculo explícitas, el histórico importado y una batería de tests que garantiza que los números salen igual que en el Excel.
Funcionalidades
- Arqueos diarios por negocio con totales, saldos y acumulados
- Siete reglas de cálculo documentadas (R1 a R7) y las trampas conocidas del Excel original
- Importación del histórico desde el XLSX con informe de discrepancias explicadas
- Varios usuarios con sesión propia; crear o eliminar usuarios exige la contraseña de quien lo hace
- Diseño mobile-first con Server Actions de Next.js
Retos técnicos
- Aritmética monetaria exacta con decimal.js, sin errores de coma flotante
- 133 tests, incluido un gate de regresión que valida el motor contra el Excel: 78 de 78 totales, 136 de 136 saldos y 12 acumulados históricos
- Migrar datos reales de una hoja de cálculo conservando su significado, y documentar cada discrepancia