David dac22372b9 feat(docs): archive legacy DTO design and naming guidelines, introduce HTTP request flow, module boundaries, and testing guidelines

- 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.

2026-09-08 23:40:49 +02:00

2.3 KiB

Raw Blame History

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.

2.3 KiB Raw Blame History