Introducción a la Arquitectura Hexagonal con NestJS

Sobre el curso

En tres clases construyes una aplicación NestJS con arquitectura hexagonal desde el proyecto vacío, y entiendes de quién es cada responsabilidad porque escribiste cada capa por separado, en el orden en que las capas dependen unas de otras. No se refactoriza nada. La arquitectura no se presenta como el arreglo de un código malo: se construye directamente bien, empezando por el centro. El código plano aparece solo al principio, diez minutos, ya escrito y a modo de contraste. El orden de construcción es la lección: primero el dominio, que no depende de nada; después la aplicación, que solo depende del dominio; y al final los adaptadores, que dependen de todo lo anterior. Cuando llegas a la base de datos en la clase 3, la regla de negocio ya estaba escrita y probada dos clases antes. Ahí se entiende, sin que nadie lo explique, para qué servía poner el puerto en el medio. El caso es mínimo a propósito: reservas de sala. Se eligió porque tiene dos reglas de negocio de naturaleza distinta —una que la reserva puede responder sola y otra que necesita ir a ver las demás—, y esa diferencia es exactamente la que enseña dónde va cada cosa. Al terminar la clase 2 la aplicación ya funciona y está probada, y todavía no existe ni un endpoint ni una tabla. En la clase 3 se cambia el adaptador in-memory por TypeORM sobre SQLite modificando una línea del módulo: el dominio y la aplicación no se tocan y los tests siguen pasando. Esa es la comprobación final de las tres clases. Qué te llevas: el repositorio con la construcción paso a paso (un commit por capa), el ejemplo plano como material de contraste, los tests que corren sin base de datos, una hoja de una página con el checklist «¿de qué capa es esto?», las grabaciones y el diploma de participación. Qué NO incluye, dicho antes de vender: no hay ejercicio de refactorización (es deliberado), no es DDD —no se ven agregados, eventos de dominio ni bounded contexts, solo se nombra dónde entran—, no se cubren migraciones en producción ni tuning de base de datos, y no hay autenticación, despliegue ni revisión del proyecto propio.

Lo que vas a aprender

• Construir las tres capas —dominio, aplicación e infraestructura— desde el proyecto vacío
• Saber repartir una regla de negocio: qué va en la entidad y qué en el caso de uso, y por qué
• Escribir un value object y una entidad que nacen válidos y protegen su invariante
• Declarar un puerto sin filtrar la base de datos en su firma
• Implementar dos adaptadores del mismo puerto: in-memory y TypeORM sobre SQLite
• Probar el dominio y el caso de uso con Jest, sin framework y sin base de datos
• Entender por qué la entidad de dominio y la del ORM no son la misma clase, y qué hace el mapper
• Reconocer los cuatro errores típicos: dominio anémico, puerto que filtra el ORM, DTO paseándose por el dominio y capas con las dependencias al revés
• Distinguir cuándo NO vale la pena: un CRUD sin reglas no necesita esto

Programa del curso

3 módulos · 6 horas en total