David
dac22372b9
- Archived historical documents for DTO design and naming conventions. - Added normative documentation for HTTP request flow and module boundaries. - Introduced testing guidelines for backend layers. - Updated onboarding module documentation and clarified onboarding requirements. - Deprecated backend prompt base and prompt auth documents. - Adjusted paths in testing documentation for consistency.
43 lines
2.3 KiB
Markdown
43 lines
2.3 KiB
Markdown
# Auditoría documental SSOT
|
|
|
|
Fecha de actualización: 2026-09-08
|
|
|
|
## Autoridad documental
|
|
|
|
- **NORMATIVO**: establece reglas transversales; vive en `docs/architecture/` y aparece en su índice.
|
|
- **ESPECÍFICO DE MÓDULO**: define contrato o negocio de un contexto; no redefine arquitectura transversal.
|
|
- **HISTÓRICO**: conserva trazabilidad y no debe guiar código nuevo.
|
|
- **AUXILIAR**: apoyo operativo o prompts; no establece reglas.
|
|
|
|
## SSOT normativas
|
|
|
|
| Materia | Documento |
|
|
| --- | --- |
|
|
| Arquitectura backend | `docs/architecture/backend-architecture.md` |
|
|
| DI y composition root | `docs/architecture/dependency-injection.md` |
|
|
| HTTP, guards, validation e InputMapper | `docs/architecture/http-request-flow.md` |
|
|
| DTO, Zod, naming y snapshots | `docs/architecture/dto-guidelines.md` |
|
|
| Fronteras intermodulares | `docs/architecture/module-boundaries.md` |
|
|
| Testing por capa | `docs/architecture/testing-guidelines.md` |
|
|
|
|
`docs/testing/backend-http-integration.md` es la guía específica de integración real; no sustituye la guía transversal de pruebas.
|
|
|
|
## Documentación específica vigente
|
|
|
|
- `docs/modules/onboarding.md`: contrato funcional y composición observable de onboarding.
|
|
- `docs/customer-invoices/README.md` y sus contratos: negocio de proformas/facturas.
|
|
- `docs/architecture/identity-and-companies.md` y `tenant-context.md`: contratos concretos de identity/companies y tenant.
|
|
- Documentos de companies, catalogs, document-series, settings, factuges y recurring-proformas: reglas de sus respectivos contextos.
|
|
|
|
## Histórico y auxiliar
|
|
|
|
- `docs/architecture/history/backend-design-consolidated-legacy.md`: diseño backend anterior, archivado.
|
|
- `docs/architecture/history/dto-design-legacy.md`: guía DTO anterior, archivada.
|
|
- `docs/architecture/history/dto-schema-naming-legacy.md`: naming DTO anterior, archivado.
|
|
- `docs/auxiliary/history/prompt-customer-invoices.md`: prompt retirado, archivado.
|
|
- `docs/backend-prompt-base.md`: deprecated; auxiliar.
|
|
- `docs/prompt-auth.md`: histórico/auxiliar.
|
|
- Los documentos API, requisitos y migraciones marcados como históricos en `docs/README.md` se conservan solo por trazabilidad.
|
|
|
|
Los documentos que no pertenezcan al conjunto normativo no pueden establecer reglas de DI, DTO, HTTP, mappers, límites de módulo o testing transversal.
|