David
5ad446be00
- Removed outdated documents on screen design and editor layout audit. - Added comprehensive documentation on frontend architecture, UI patterns, and UI system. - Established clear guidelines for component usage, routing, and layout structures. - Enhanced accessibility and responsiveness standards across UI components. - Defined testing protocols and anti-patterns to maintain code quality and consistency. |
||
|---|---|---|
| .. | ||
| architecture | ||
| audit | ||
| catalogs | ||
| companies | ||
| customer-invoices | ||
| customers | ||
| dev | ||
| document-series | ||
| factuges | ||
| frontend | ||
| recurring-proformas | ||
| settings | ||
| suppliers | ||
| testing | ||
| API.md | ||
| backend-prompt-base.md | ||
| CONVENCION NOMBRADO DE ESQUEMAS DTO.md | ||
| documentation-ssot-audit.md | ||
| DsRegistroVeriFactu.xlsx | ||
| FACTURAS DE CLIENTE.md | ||
| prompt-auth.md | ||
| prompt-customer-invoices.md | ||
| README.md | ||
| REQUISITOS CLIENTES.md | ||
| REQUISITOS GENERALES.md | ||
| TEMPLATE.md | ||
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
- Arquitectura frontend
- Sistema UI Rdx
- Patrones de UI
- 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.