# kevin-hc/arquitectura_hexagonal architecture

> Architecture diagram of the GitHub repository kevin-hc/arquitectura_hexagonal, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-14). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kevin-hc/arquitectura_hexagonal
- Repository: https://github.com/kevin-hc/arquitectura_hexagonal

## Overview

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

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% External Clients
    Client["Client (Postman/Browser)"]:::external

    %% Hexagonal Core
    subgraph "Hexágono Arquitectura"
        direction TB
        subgraph "Capa de Aplicación" 
            direction TB
            TS["TaskService"]:::app
            CTUImpl["CreateTaskUseCaseImpl"]:::app
            RTUImpl["RetrieveTaskUseCaseImpl"]:::app
            UTUImpl["UpdateTaskUseCaseImpl"]:::app
            DTUImpl["DeleteTaskUseCaseImpl"]:::app
            GTIUImpl["GetAdditionalTaskInfoUseCaseImpl"]:::app
        end
        subgraph "Capa de Dominio"
            direction TB
            T["Task"]:::domain
            ATI["AdditionalTaskInfo"]:::domain
            CTUPort["CreateTaskUseCase<<in>>"]:::domain
            RTUPort["RetrieveTaskUseCase<<in>>"]:::domain
            UTUPort["UpdateTaskUseCase<<in>>"]:::domain
            DTUPort["DeleteTaskUseCase<<in>>"]:::domain
            GTIUPort["GetAdditionalTaskInfoUseCase<<in>>"]:::domain
            TRP["TaskRepositoryPort<<out>>"]:::domain
            ESP["ExternalServicePort<<out>>"]:::domain
        end
    end

    %% Controllers and Adapters
    TC["TaskController"]:::infra
    JPAAdapter["JpaTaskRepositoryAdapter"]:::infra
    ESA["ExternalServiceAdapter"]:::infra
    JPARepo["JpaTaskRepository"]:::infra
    AppConfig["ApplicationConfig"]:::infra

    %% External Resources
    DB["Relational Database"]:::external
    ExtSvc["External Service API"]:::external

    %% Main Application
    MainApp["TasksApplication"]:::infra

    %% Flows
    Client -->|"HTTP Request"| TC
    TC -->|"invoca puerto"| CTUPort
    CTUPort -.-> CTUImpl
    CTUImpl -->|"usa dominio"| T
    CTUImpl -->|"usa puerto out"| TRP

    TC -->|"invoca puerto"| RTUPort
    RTUPort -.-> RTUImpl
    RTUImpl -->|"usa dominio"| T
    RTUImpl -->|"usa puerto out"| TRP

    TC -->|"invoca puerto"| UTUPort
    UTUPort -.-> UTUImpl
    UTUImpl -->|"usa dominio"| T
    UTUImpl -->|"usa puerto out"| TRP

    TC -->|"invoca puerto"| DTUPort
    DTUPort -.-> DTUImpl
    DTUImpl -->|"usa dominio"| T
    DTUImpl -->|"usa puerto out"| TRP

    TC -->|"invoca puerto"| GTIUPort
    GTIUPort -.-> GTIUImpl
    GTIUImpl -->|"usa dominio"| ATI
    GTIUImpl -->|"usa puerto out"| ESP

    TRP --> JPAAdapter
    JPAAdapter --> JPARepo
    JPAAdapter --> DB

    ESP --> ESA
    ESA --> ExtSvc

    %% Configuration and Bootstrap
    MainApp --> AppConfig
    AppConfig --> TRP
    AppConfig --> ESP

    %% Click Events
    click MainApp "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/java/com/exagonal/tasks/TasksApplication.java"
    click TC "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/java/com/exagonal/tasks/infrastructure/controllers/TaskController.java"
    click TS "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/java/com/exagonal/tasks/application/services/TaskService.java"
    click CTUImpl "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/java/com/exagonal/tasks/application/usecases/CreateTaskUseCaseImpl.java"
    click RTUImpl "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/java/com/exagonal/tasks/application/usecases/RetrieveTaskUseCaseImpl.java"
    click UTUImpl "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/java/com/exagonal/tasks/application/usecases/UpdateTaskUseCaseImpl.java"
    click DTUImpl "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/java/com/exagonal/tasks/application/usecases/DeleteTaskUseCaseImpl.java"
    click GTIUImpl "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/java/com/exagonal/tasks/application/usecases/GetAdditionalTaskInfoUseCaseImpl.java"
    click T "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/java/com/exagonal/tasks/domain/model/Task.java"
    click ATI "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/java/com/exagonal/tasks/domain/model/AdditionalTaskInfo.java"
    click CTUPort "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/java/com/exagonal/tasks/domain/ports/in/CreateTaskUseCase.java"
    click RTUPort "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/java/com/exagonal/tasks/domain/ports/in/RetrieveTaskUseCase.java"
    click UTUPort "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/java/com/exagonal/tasks/domain/ports/in/UpdateTaskUseCase.java"
    click DTUPort "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/java/com/exagonal/tasks/domain/ports/in/DeleteTaskUseCase.java"
    click GTIUPort "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/java/com/exagonal/tasks/domain/ports/in/GetAdditionalTaskInfoUseCase.java"
    click TRP "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/java/com/exagonal/tasks/domain/ports/out/TaskRepositoryPort.java"
    click ESP "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/java/com/exagonal/tasks/domain/ports/out/ExternalServicePort.java"
    click JPAAdapter "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/java/com/exagonal/tasks/infrastructure/repositories/JpaTaskRepositoryAdapter.java"
    click JPARepo "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/java/com/exagonal/tasks/infrastructure/repositories/JpaTaskRepository.java"
    click ESA "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/java/com/exagonal/tasks/infrastructure/adapters/ExternalServiceAdapter.java"
    click AppConfig "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/java/com/exagonal/tasks/infrastructure/config/ApplicationConfig.java"
    click DB "https://github.com/kevin-hc/arquitectura_hexagonal/blob/master/src/main/resources/application.properties"

    %% Styles
    classDef domain fill:#bbdefb,stroke:#0d47a1,color:#0d47a1
    classDef app fill:#c8e6c9,stroke:#2e7d32,color:#2e7d32
    classDef infra fill:#fff9c4,stroke:#f9a825,color:#f57f17
    classDef external fill:#e0e0e0,stroke:#616161,color:#424242
```
