# AGENTS.md: guía para personas e IAs que trabajan en este repo

Backend del ERP Novasis (NestJS + Prisma + PostgreSQL). Arquitectura, comandos y convenciones de migraciones: [`CLAUDE.md`](CLAUDE.md). El front está en `../novasispy-erp` (ver su `AGENTS.md`).

## Reglas no negociables (decisiones del dueño)

- **Todo endpoint exige módulo + submódulo contratados + permiso.** Usar `PrivilegioGuard` + `@RequirePrivilegio(...)` (`src/auth/decorators/require-privilegio.decorator.ts`) o `SubmoduloGuard` + `@RequireSubmodulo(...)` (`require-submodulo.decorator.ts`). Solo login no alcanza. El back es la autoridad: el front solo oculta.
- **Todo se filtra por la empresa del usuario** (y por su alcance de sucursales cuando aplica). Un id de otra empresa da 404/403, nunca datos (IDOR).
- **Secretos nunca salen del back** ni van a los logs: `src/common/utils/ocultar-secretos.ts`, `src/empresas/empresa-sin-secretos.ts`. Un secreto vacío en un PUT conserva el actual.
- **Dinero:** precisión `Decimal`, redondeo según los decimales de la moneda (0 en PYG, 2 en el resto), un solo cálculo por regla (ej. la mora: `src/cobranzas/calculo-mora.ts`; no se copia el cálculo en otro servicio). Operaciones que emiten o numeran: idempotentes y con bloqueo (`FOR UPDATE`).
- **El contador decide las cuentas:** ningún asiento automático tiene cuentas fijas en el código; todo mapeable. Asientos y avisos contables solo con el módulo CONTABILIDAD.
- **Sin banderas ni textos fijos:** nada de booleanos que salteen validaciones, motivos literales inventados, ni `catch` que solo loguea.
- **Arreglos de datos = migración Prisma** escrita a mano (directorio con `migration.sql`, ver `CLAUDE.md`), probada en local con `npx prisma migrate deploy`. Nunca SQL manual en prod, nunca `migrate reset`.
- **Permisos nuevos:** se agregan en `src/seguridad/seeds/seguridad.seed-data.ts`; el seed solo asigna a perfiles de sistema. Los perfiles propios de los clientes se asignan a mano.
- **Guías de NovaIA al día:** cada cambio funcional o de ubicación en la UI actualiza `docs/guias/` y `src/ayuda-ia/ingesta/seed-catalogo.ts`; en el despliegue se re-corre la ingesta.

## Antes de entregar

`npx tsc --noEmit` sin errores nuevos y jest de lo tocado (`./node_modules/.bin/jest <carpeta>`), con tests de guardas (sin permiso, sin submódulo, otra empresa) para todo endpoint nuevo.

## Git

No crear ramas ni commits salvo que te lo pidan explícitamente.
