How kevin-hc/arquitectura_hexagonal works
Identificación del tipo de proyecto y propósito
• Se trata de una aplicación de gestión de tareas (CRUD) implementada en Java con Spring Boot que sigue el patrón de Arquitectura Hexagonal (Puertos y Adaptadores).
• Permite crear, leer, actualizar y eliminar tareas, y además extraer información adicional mediante un servicio externo.
Análisis de la estructura de ficheros
• src/main/java/com/exagonal/tasks
• application: casos de uso (implementaciones y servicios)
• domain: entidades (Task, AdditionalTaskInfo) y puertos (in/out)
• infrastructure:
• controllers: adaptadores de entrada (REST API)
• repositories: adaptadores de persistencia (JPA)
• adapters: adaptadores de servicios externos
• config: configuración de Spring
• src/main/resources/application.properties: configuración de la base de datos y servicios externos
• pom.xml: dependencias clave (Spring Boot, Spring Data JPA, controlador web, etc.)
Aspectos clave extraídos del README
• Arquitectura Hexagonal: separación en tres capas (Dominio, Aplicación, Infraestructura).
• Principios SOLID aplicados: DIP, SRP, OCP, LSP, ISP.
• Endpoints REST documentados para cada caso de uso.
Componentes principales para el diagrama
A. Capa de Entrada (Drivers)
• Cliente/API consumer (Postman, navegador, front-end)
• REST Controller (TaskController)
B. Capa de Aplicación
• Casos de uso (CreateTaskUseCaseImpl, RetrieveTaskUseCaseImpl, etc.)
• Servicio de aplicación (TaskService)
C. Capa de Dominio
• Entidades (Task, AdditionalTaskInfo)
• Puertos de entrada (interfaces de caso de uso)
• Puertos de salida (interfaces TaskRepositoryPort, ExternalServicePort)
D. Capa de Infraestructura (Driven Adapters)
• Adaptador de repositorio JPA (JpaTaskRepositoryAdapter → JpaTaskRepository / BD relacional)
• Adaptador de servicio externo (ExternalServiceAdapter)
• Configuración de Spring (ApplicationConfig)
E. Recursos externos
• Base de datos relacional (configurada en application.properties)
• Servicio externo (API de terceros para información adicional)
Relaciones e interacciones
1. Cliente → HTTP Request → TaskController (adaptador de entrada)
2. TaskController → invoca caso de uso correspondiente (puerto de entrada)
3. Caso de uso → lógica de negocio + utiliza puertos de salida
• Para persistencia: invoca TaskRepositoryPort
• Para información extra: invoca ExternalServicePort
4. Adaptadores de salida
• JpaTaskRepositoryAdapter implementa TaskRepositoryPort → interacciona con la base de datos (JPA)
• ExternalServiceAdapter implementa ExternalServicePort → realiza llamadas HTTP al servicio externo
5. Respuesta → burbujea de vuelta por la cadena hasta el controlador → HTTP Response al cliente
Patrones y principios arquitectónicos
• Hexágono central (Dominio + Casos de uso) rodeado de puertos
• Adaptadores en los vértices: REST, JPA, Servicio externo
• Inversión de dependencias: la lógica de dominio/aplicación solo depende de interfaces
• Separación clara de responsabilidades y capas
Guía para dibujar el diagrama
a. Dibuja un hexágono central dividido en dos zonas:
• Superior: Capa de Aplicación (casos de uso + servicios)
• Inferior: Capa de Dominio (entidades + puertos)
b. En los bordes del hexágono, coloca los puertos de entrada (lado izquierdo) y puertos de salida (lado derecho).
c. Fuera del hexágono, dibuja:
• Adaptadores de entrada: REST Controller conectado al puerto de entrada correspondiente.
• Adaptadores de salida: JPA Adapter y External Service Adapter conectados a sus puertos de salida.
• BD relacional y Servicio externo como cajas externas.
d. Usa flechas direccionales para indicar el flujo:
Cliente → Controller → Caso de uso → Puerto → Adaptador → Recurso externo.
• Azul: Capa de Dominio
• Verde: Capa de Aplicación
• Amarillo: Adaptadores/Infraestructura
• Gris: Servicios o bases de datos externas
Consejos finales
• Etiqueta claramente cada componente (clases, interfaces, adaptadores).
• Marca los puertos con estereotipos («<<in>>», «<<out>>»).
• Incorpora notas o leyenda que referencien los principios SOLID aplicados.
• Asegúrate de reflejar la bidireccionalidad en la inyección de dependencias (flechas punteadas de configuración).
Con este enfoque tendrás un diagrama claro, detallado y fiel a la arquitectura hexagonal de la aplicación de gestión de tareas.