FactuGES_ERP/docs/architecture/testing-guidelines.md
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

1018 B

Pruebas backend por capa

Estado: NORMATIVO. Cada capa prueba su responsabilidad; no se repite la misma validación en todas ellas.

DTO

Probar schemas válidos e inválidos, keys desconocidas cuando aplique, optional/null y schemas semánticos. Zod se prueba aquí.

InputMapper

Probar DTO + context → Value Objects/Props, fallos de Value Objects, conversión a Maybe y Result/colecciones de errores. No repetir el parsing Zod de la route.

Use case

Probar orquestación, transacción, colaboración con servicios, propagación de Result e idempotencia cuando aplique.

Controller y routes

El controller prueba contexto autenticado, input enviado al use case y traducción Result → HTTP. Las routes se prueban cuando aporten valor estructural: guards, validateRequest y wiring.

Integración

La integración HTTP real se documenta por separado en Tests HTTP backend: Express, módulos, auth/tenant, MariaDB y Sequelize reales.