# NexoCaja documentación central

Esta carpeta es la fuente de contexto para personas y agentes de inteligencia artificial que continúen el proyecto. Describe qué problema resuelve NexoCaja, cómo está construido, qué permisos existen, qué cálculos realiza y cómo registrar cambios sin perder decisiones anteriores.

## Resumen operativo

NexoCaja es una aplicación web local orientada a micro y pequeñas empresas de Cusco. Permite registrar movimientos, proyectar flujo de caja, estimar impuestos y aportes, simular créditos con cronograma de amortización y presentar resultados mediante tablas y gráficos. La interfaz usa soles peruanos y la identidad visual del proyecto MYPES Digitales y de la Gerencia Regional de Producción del Gobierno Regional Cusco.

La versión actual funciona con Node.js y SQLite. No requiere servicios externos. El modo de demostración crea tres perfiles: cuenta maestra, gestor y usuario financiero.

## Orden de lectura recomendado

1. `SOLICITUDES_Y_ESTADO.md` para identificar qué pidió el responsable y su estado actual.
2. `01_CONTEXTO_Y_OBJETIVOS.md` para entender propósito, audiencia y alcance.
3. `02_ARQUITECTURA.md` para conocer componentes, rutas y flujo técnico.
4. `03_FUNCIONALIDADES_Y_ROLES.md` para revisar módulos y permisos.
5. `04_MODELO_DE_DATOS_Y_REGLAS.md` para comprender tablas y fórmulas.
6. `05_OPERACION_Y_PRUEBAS.md` para ejecutar, respaldar y comprobar el sistema.
7. `06_ESTADO_Y_HOJA_DE_RUTA.md` para conocer el estado actual y el trabajo previo a producción.
8. `07_GUIA_MEJORAS_UX_MYPE.md` para lenguaje claro, prioridades y criterios responsive orientados a usuarios finales.
9. `REGISTRO_CAMBIOS.md` y `DECISIONES_TECNICAS.md` antes de modificar una función existente.
10. `coordinacion/BANDEJA.md` y `coordinacion/README.md` para mensajes, respuestas y autocorrección entre agentes.
11. `../ANTIGRAVITY.md` o `../GEMINI.md`, según el agente que continúe el trabajo.
12. `../README_HOSTING.md` para construir y desplegar el paquete mínimo en la raíz de un subdominio Node.js.

## Archivos que deben mantenerse actualizados

| Archivo | Uso |
| --- | --- |
| `project-context.json` | Resumen estructurado y legible por máquinas |
| `SOLICITUDES_Y_ESTADO.md` | Cronología con fecha, hora, estado, responsable y evidencia de cada solicitud |
| `REGISTRO_CAMBIOS.md` | Historial cronológico de modificaciones |
| `DECISIONES_TECNICAS.md` | Decisiones que no deben cambiarse sin dejar justificación |
| `06_ESTADO_Y_HOJA_DE_RUTA.md` | Estado comprobado, riesgos y siguientes etapas |
| `07_GUIA_MEJORAS_UX_MYPE.md` | Recomendaciones funcionales, lenguaje claro y criterios responsive |
| `imagenes/` | Ilustraciones reutilizables por perfil y mascota Nexo con pies y textos alternativos |
| `ANTIGRAVITY.md` | Traspaso detallado de contexto para Antigravity |
| `../ANTIGRAVITY.md` y `../GEMINI.md` | Entradas de descubrimiento para cada agente |
| `coordinacion/BANDEJA.md` | Entrada a los mensajes compartidos de Codex, Antigravity y Gemini |
| `coordinacion/mensajes/` | Hilos persistentes, respuestas y estados de revisión |

## Principios que no deben romperse

- Un gestor no puede consultar datos financieros de usuarios.
- Un gestor solo puede crear y administrar cuentas normales.
- La cuenta maestra puede crear gestores y usuarios.
- Cada usuario financiero solo accede a su propia información.
- Las contraseñas se almacenan derivadas con sal y nunca se exportan.
- Los datos demo se almacenan separados de la base normal.
- Los cambios en fórmulas financieras requieren pruebas automatizadas.
- La herramienta apoya la planificación y no sustituye la determinación tributaria o contable profesional.

## Versión documentada

- Estado: piloto local funcional con paquete verificado para prueba en subdominio Node.js.
- Fecha de corte: 29 de setiembre de 2026.
- Pruebas automatizadas: 7 casos aprobados.
- Manual institucional: `Manual_institucional_y_de_uso_NexoCaja.docx`.