david
e5e73a5a13
- Updated general requirements document to clarify its historical context and remove outdated technical details. - Revised template documentation to serve as a base for writing prompts, emphasizing its auxiliary nature. - Enhanced architecture documentation with clear distinctions between canonical and complementary documents. - Added a new document for backend prompt base to centralize common context for backend prompts. - Created a dedicated README for customer invoices, organizing current contracts, operational support, and historical context. - Improved clarity and structure in various customer invoice documents, consolidating operational semantics and referencing canonical sources.
3.7 KiB
3.7 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.
Estructura documental
Documentación vigente
Arquitectura y runtime
- Arquitectura general
- Contexto tenant y
X-Company-Id - API de autenticación de
identity - Relación entre
identityycompanies - Estado de migración a
identity
Frontend
Customer invoices y proformas
- Índice de
customer-invoices - 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
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.