david
e0ba5ef229
- Implemented ProformaDuplicator service for duplicating proforma documents. - Added tests for duplicating proformas, including scenarios for successful duplication, audit failure propagation, and payment term adaptations. - Created ProformaStatusChanger service to handle status changes of proformas with corresponding tests. - Developed ProformaArchiver service for unarchiving proformas and added tests to verify functionality. - Introduced a test fixture for creating proforma instances for testing purposes.
5.0 KiB
5.0 KiB
ERP Docs
Este directorio reúne la documentación técnica, operativa y de apoyo del ERP.
Cómo leer esta documentación
- Empieza por este índice si necesitas orientarte.
- Usa los documentos en subdirectorios temáticos como fuente de verdad operativa.
- Trata los documentos marcados como históricos o legacy como contexto, no como contrato vigente.
- Si hay duda sobre qué documento manda, consulta la auditoría SSOT.
Estructura documental
Documentación vigente
Arquitectura y runtime
- Arquitectura general
- Requisitos de
companies - Contexto tenant y
X-Company-Id - Tratamiento de errores HTTP en frontend
- API de autenticación de
identity - Relación entre
identityycompanies - Estado de migración a
identity
Frontend
- Flujo de auth y selección de empresa
- Sistema modular de Settings
- Integración de módulos con Settings
- README de
apps/web
Customer invoices y proformas
- Índice de
customer-invoices - Auditoría SSOT documental
- Plazos de pago
- Diseño backend del perfil VeriFactu empresarial
Documento parcialmente superado: sigue siendo canónico para
CompanyVerifactuProfile, pero no para reintroducirIssuedInvoice.verifactuPolicy. - Diseño frontend de Settings para VeriFactu
- Contrato de series de proformas
- Contrato de create de proformas
- Configuración fiscal persistida en proformas
- Reports de proformas
Document series
- README de
document-series - Diseño de
document-series - Validación manual de
document-series - Validación manual de concurrencia
Módulos y runtime local
- README de
modules/identity - README de
modules/companies - README de
modules/auth - API pública de selección y alta rápida de clientes
- Tests HTTP backend
- Harness frontend con
node:test
Guías y estándares
- [Guía de diseño de DTOs](./DTOS - GUÍA DE DISEÑO.md)
- [Convención de nombres de schemas DTO](./CONVENCION NOMBRADO DE ESQUEMAS DTO.md)
SQL operativos y runbooks
Material auxiliar
Histórico, transicional o de descubrimiento
Estos documentos se conservan por trazabilidad, auditoría o contexto de decisiones. No deben usarse como fuente de verdad del runtime actual sin contrastarlos con la documentación vigente.
- Borrador legacy de API
- [Requisitos generales históricos](./REQUISITOS GENERALES.md)
- [Requisitos históricos del módulo de clientes](./REQUISITOS CLIENTES.md)
- [Notas históricas de facturas de cliente](./FACTURAS DE CLIENTE.md)
- Split histórico Proforma / IssuedInvoice
- Migración desde
customer_invoice_series - InvoiceSeries legacy
Regla práctica de mantenimiento
- Los documentos operativos vigentes deben vivir en subdirectorios temáticos y tener una responsabilidad clara.
- Los documentos raíz en mayúsculas o con naming heredado deben considerarse legacy o auxiliares salvo que este índice los declare explícitamente vigentes.
- Si una regla ya tiene fuente canónica, los demás documentos deben resumirla y enlazarla, no copiarla.
- Para VeriFactu e
IssuedInvoice, el estado vigente es: sinverifactuPolicy, cardinalidad actual1 -> 0..1, objetivo futuro1 -> 0..N.