# manuelarango1229/user-service architecture

> Architecture diagram of the GitHub repository manuelarango1229/user-service, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-03-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/manuelarango1229/user-service
- Repository: https://github.com/manuelarango1229/user-service

## Overview

Basándonos en el análisis del árbol de archivos y el README, el proyecto “User Service” es un microservicio centrado en la gestión de usuarios, construido con Java 17 y Spring Boot. Adopta una arquitectura hexagonal (también conocida como Ports and Adapters), lo que significa que la lógica de negocio (“Domain”) está aislada de la infraestructura (como persistencia, controladores REST, autenticación, etc.) a través de interfaces (puertos) y sus respectivas implementaciones (adaptadores). Aquí tienes una guía detallada para diseñar un diagrama de arquitectura del sistema adaptado a este proyecto:

##### Componentes Principales
- Entrada:
- La aplicación se inicia desde DemoApplication.java, que actúa como el entry point del microservicio.
- Dominio:
- Contains “domain” con entidades (como Usuario y sus especializaciones: Administrador, Cliente y Repartidor), excepciones, repositorios (definidos como puertos) y servicios.
- Casos de Uso:
- “use_cases” encapsula la lógica de negocio, definiendo interacciones específicas como login, registro, actualización y eliminación de usuarios.
- Infraestructura:
- Dividida en varios sub-módulos:
▪ Configuración (config): Configura la seguridad, la documentación de APIs (Swagger/OpenAPI), y otros aspectos de la aplicación.
▪ Base de datos: Implementa adaptadores de repositorios y mapeadores de entidades para la comunicación con H2 Database.
▪ JWT: Contiene adaptadores y filtros para la autenticación y autorización.
▪ REST: Contiene controladores, DTOs y mappers para exponer los endpoints (por ejemplo, /usuarios/login, /usuarios/register, etc.).
▪ Exception: Maneja los errores globalmente a través de un Exception Handler.
- Integraciones Externas:
- Autenticación con JWT.
- Swagger para la documentación de la API.
- H2 Database para la persistencia.

##### Relaciones e Interacciones
- La aplicación (DemoApplication) inicializa Spring Boot, creando el contexto.
- El controlador REST recibe las peticiones externas y traduce (mediante mappers y DTOs) los datos para invocar los casos de uso del dominio.
- Los casos de uso interactúan con la capa de Dominio, usando interfaces (puertos) definidas en el dominio. Estos puertos son implementados por adaptadores en la capa de infraestructura (como los repositorios H2 y adaptadores JWT).
- Los adaptadores de infraestructura se comunican con la base de datos o servicios de autenticación para realizar operaciones o verificaciones.
- Los componentes de seguridad (SecurityConfig y JwtFiltroAutenticacion) validan y autorizan las solicitudes entrantes mediante JWT.

##### Patrones y Principios Clave
- Arquitectura Hexagonal: Separa la lógica de negocio (core) de la infraestructura. Coloca los “puertos” como interfaces en el dominio y utiliza “adaptadores” en infraestructura para conectarse con repositorios, seguridad y API REST.
- Inyección de Dependencias: Para desacoplar la implementación concreta de los servicios y repositorios (uso común en Spring Boot).
- Modularidad y Escalabilidad: La separación clara de dominios y casos de uso facilita la mantenibilidad y la posibilidad de extender la aplicación.

##### Tecnologías y Herramientas
- Java 17 y Spring Boot son la base de la aplicación.
- H2 Database para la persistencia.
- JWT para autenticación.
- Swagger/OpenAPI para la documentación de la API.

##### Directrices para el Diagrama
a. Dibujar cada gran componente como un bloque distinto:
- Bloque “Entrada” para DemoApplication inicial.
- Bloque “API REST” (dentro de Infraestructura) con controladores, DTOs y mappers.
- Bloque “Casos de Uso” que encapsulan la lógica de negocio (ubicados en use_cases).
- Bloque “Dominio” que agrupa entidades, excepciones, interfaces de repositorios y servicios (puertos).
- Bloque “Infraestructura – Adaptadores” que implementan los repositorios, mapas de entidades y adaptadores JWT.
- Bloque “Configuración y Seguridad” para SecurityConfig, OpenApiConfig y demás configuraciones.
- Bloque “Base de Datos” (H2) indicando la persistencia.
b. Conectar estos bloques mediante flechas direccionales:
- Desde el “API REST” hacia “Casos de Uso” (indicar la apertura de datos al dominio).
- Desde “Casos de Uso” hacia “Dominio” (uso de puertos).
- Flechas de “Infraestructura – Adaptadores” conectando el “Dominio” con “Base de Datos” y “JWT/Security”.
c. Usar diferentes colores/estilos:
- Otro para la infraestructura (controladores, adaptadores, seguridad).
- Formas particulares (por ejemplo, rectángulos para componentes lógicos y cilindros para bases de datos) pueden ayudar a distinguir el tipo de componente.
d. Incluir etiquetas claras para cada componente y una breve descripción en cada bloque para explicar su rol.

##### Personalización de la Diagrama para este Proyecto
- Resalta la separación entre la lógica de negocio (Domain y Use Cases) y la infraestructura (REST, Base de Datos, JWT, Configuraciones).
- Dibuja líneas que ilustren la comunicación entre componentes, especialmente cómo los endpoints REST sirven de puerta de entrada al dominio a través de los casos de uso y, finalmente, cómo interactúan con adaptadores que realizan operaciones sobre el H2 database o servicios de autenticación con JWT.
- Asegúrate de mostrar la configuración global, incluyendo los ficheros de propiedades, que son claves para inicializar la seguridad y la documentación.

Al presentar el diagrama, enfatiza la importancia de la claridad en la representación de las dependencias y flujos de datos. Incluir flechas direccionales y anotaciones (por ejemplo, “llamada de método”, “mapea DTO”, “autenticación JWT”) ayudará a comprender rápidamente el comportamiento interno del microservicio User Service.

Con estas directrices, el diagrama reflejará de forma precisa la arquitectura hexagonal del microservicio, la separación de responsabilidades y la interacción entre los distintos componentes del sistema, facilitando tanto la comprensión del diseño como futuras modificaciones o ampliaciones del proyecto.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Entrada"
        A["DemoApplication (Entry)"]:::entry
    end

    subgraph "Infraestructura - Exposición"
        B["REST Controladores"]:::rest
        C["REST DTOs"]:::rest
        D["REST Mapper"]:::rest
        E["Configuración y Seguridad"]:::config
    end

    subgraph "Lógica de Negocio"
        F["Casos de Uso"]:::usecase
    end

    subgraph "Dominio"
        G["Entidades"]:::domain
        H["Excepciones"]:::domain
        I["Repositorios (Puertos)"]:::domain
        J["Servicios (Puertos)"]:::domain
    end

    subgraph "Infraestructura - Adaptadores"
        subgraph "Base de Datos (H2)"
            K["H2 Repository Adapters"]:::adapter
            L["H2 Entities"]:::adapter
            M["H2 Mappers"]:::adapter
        end
        subgraph "JWT"
            N["JWT Filtro Autenticacion"]:::adapter
            O["JWT Adaptadores"]:::adapter
        end
    end

    subgraph "Infraestructura - Manejo de Excepciones"
        P["Global Exception Handler"]:::error
    end

    %% Conexiones
    A -->|"inicia"| B
    E -->|"configura"| B
    E -->|"configura"| N
    B -->|"usa"| C
    B -->|"usa"| D
    B -->|"invoca"| F
    F -->|"usa"| I
    F -->|"usa"| J
    I -->|"implementa"| K
    J -->|"implementa"| O
    K -->|"usa"| L
    K -->|"usa"| M
    N -->|"autentica"| O
    B -->|"maneja"| P

    %% Estilos
    classDef entry fill:#ADD8E6,stroke:#000,stroke-width:1px;
    classDef rest fill:#DDA0DD,stroke:#000,stroke-width:1px;
    classDef config fill:#FFD700,stroke:#000,stroke-width:1px;
    classDef usecase fill:#FFA500,stroke:#000,stroke-width:1px;
    classDef domain fill:#90EE90,stroke:#000,stroke-width:1px;
    classDef adapter fill:#FFC0CB,stroke:#000,stroke-width:1px;
    classDef error fill:#FF6347,stroke:#000,stroke-width:1px;

    %% Click Events
    click A "https://github.com/manuelarango1229/user-service/blob/dev/src/main/java/com/devsoft/user_service/DemoApplication.java"
    click G "https://github.com/manuelarango1229/user-service/tree/dev/src/main/java/com/devsoft/user_service/domain/entities"
    click H "https://github.com/manuelarango1229/user-service/tree/dev/src/main/java/com/devsoft/user_service/domain/exceptions"
    click I "https://github.com/manuelarango1229/user-service/tree/dev/src/main/java/com/devsoft/user_service/domain/repositories"
    click J "https://github.com/manuelarango1229/user-service/tree/dev/src/main/java/com/devsoft/user_service/domain/services"
    click F "https://github.com/manuelarango1229/user-service/tree/dev/src/main/java/com/devsoft/user_service/use_cases"
    click E "https://github.com/manuelarango1229/user-service/tree/dev/src/main/java/com/devsoft/user_service/infraestructure/config"
    click K "https://github.com/manuelarango1229/user-service/tree/dev/src/main/java/com/devsoft/user_service/infraestructure/database/h2/adapter"
    click L "https://github.com/manuelarango1229/user-service/tree/dev/src/main/java/com/devsoft/user_service/infraestructure/database/h2/entity"
    click M "https://github.com/manuelarango1229/user-service/tree/dev/src/main/java/com/devsoft/user_service/infraestructure/database/h2/mapper"
    click N "https://github.com/manuelarango1229/user-service/blob/dev/src/main/java/com/devsoft/user_service/infraestructure/jwt/JwtFiltroAutenticacion.java"
    click O "https://github.com/manuelarango1229/user-service/tree/dev/src/main/java/com/devsoft/user_service/infraestructure/jwt/adapter"
    click B "https://github.com/manuelarango1229/user-service/tree/dev/src/main/java/com/devsoft/user_service/infraestructure/rest/controller"
    click C "https://github.com/manuelarango1229/user-service/tree/dev/src/main/java/com/devsoft/user_service/infraestructure/rest/dto"
    click D "https://github.com/manuelarango1229/user-service/tree/dev/src/main/java/com/devsoft/user_service/infraestructure/rest/mapper"
    click P "https://github.com/manuelarango1229/user-service/blob/dev/src/main/java/com/devsoft/user_service/infraestructure/exception/GlobalExceptionHandler.java"
```
