# asobrados03/hotelmanagementapi architecture

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

- Interactive diagram: https://gitdiagram.com/asobrados03/hotelmanagementapi
- Repository: https://github.com/asobrados03/hotelmanagementapi

## Overview

Para representar con precisión la arquitectura de HotelManagementAPI, sigue estos pasos y recomendaciones, adaptados al propósito y estructura de este proyecto:

##### Identificación del tipo de proyecto y propósito
- Es una API RESTful de backend (monolito) construida en Java 21+ con Spring Boot.
- Aplica principios de “Clean Architecture” (arquitectura limpia / hexagonal) para separar la lógica de negocio, los adaptadores y la infraestructura.

##### Análisis de la estructura de archivos
- src/main/java/com/alfre/DHHotel/adapter:
- web/controller → Controladores REST (@RestController)
- web/dto → Objetos de entrada/salida (DTOs)
- persistence → Implementaciones JDBC de los repositorios (Adapter de Infraestructura)
- security/jwt → Filtros y servicios de JWT (Adaptador de Seguridad)
- src/main/java/com/alfre/DHHotel/usecase: Casos de uso (Orquestación de la lógica de negocio).
- src/main/java/com/alfre/DHHotel/domain:
- model → Entidades de dominio (Clientes, Reservas, Habitaciones, Usuarios…)
- repository → Interfaces (Puertos) para persistencia.
- src/main/java/com/alfre/DHHotel/config: Configuración de Spring, DataSource, Seguridad.
- resources: application.yml, openapi.yml, Docker Compose, SQL inicial para tests.

##### Puntos clave sacados del README
- Arquitectura hexagonal: clientes → adaptadores → casos de uso → dominio → adaptadores de persistencia → base de datos (MariaDB).
- JWT para autenticación/autorización.
- Contenedores Docker para MariaDB y Adminer.
- OpenAPI/Swagger para la documentación.

##### Cómo diseñar el diagrama de arquitectura
a. Componentes principales
1. Cliente (Front-end o Postman)
2. Controladores REST (@RestController)
3. DTOs (mapeo request/response)
4. Adaptador de Seguridad JWT (JwtAuthenticationFilter, JwtService)
5. Casos de Uso (usecase/*.java)
6. Entidades de Dominio y Puertos (domain/model + domain/repository)
7. Adaptador de Persistencia JDBC (adapter/persistence/*JdbcRepository)
8. Base de Datos MariaDB (contenedor Docker)
9. Adminer (contenedor Docker, UI de BD opcional)
10. Configuración Spring (DataSource, SecurityConfig)
b. Relaciones e interacciones
- Cliente —HTTP→ Controlador
- Controlador —mapea DTO→ Caso de Uso
- Adaptador de Seguridad intercepta todas las llamadas HTTP y llama a JwtService
- Caso de Uso —invoca→ Entidades y Puertos (interfaces)
- Puertos —implementados por→ Repositorios JDBC
- Repositorios JDBC —JDBC→ MariaDB
- Respuesta: flujo inverso hasta el Cliente
c. Patrones y principios arquitectónicos
- Arquitectura limpia / hexagonal (Ports & Adapters)
- Separación de capas: Adaptadores | Aplicación (Use Cases) | Dominio | Infraestructura
- Inversión de dependencias: la capa de dominio define interfaces, la infraestructura las implementa
d. Tecnologías y frameworks relevantes
- Spring Boot (MVC, Beans, Config)
- Spring Security + JWT
- JDBC puro (sin ORM)
- MariaDB en Docker
- Swagger/OpenAPI (openapi.yml)
- JUnit5, Mockito, Testcontainers para pruebas

##### Guía para el diagrama (orientado a una API backend full-stack por capas)
- Usa un diagrama de contenedores (nivel C2 del modelo C4) o un diagrama hexagonal:
- Dibujar un rectángulo grande “HotelManagementAPI” dividido en secciones horizontales o en anillos concéntricos:
– Front-end / Cliente
– Adaptadores (Web, DTO, Seguridad)
– Aplicación (Use Cases)
– Dominio (Modelos, Puertos)
– Infraestructura (Repositories, DB)
- Indicar el contenedor Docker de MariaDB y Adminer externamente.
- Mostrar la configuración de Spring como componente transversal (puede anotar Config en el diagrama).

##### Elementos gráficos recomendados
- Labels claros: nombre del componente y paquete principal (por ejemplo, “ReservationController (adapter.web.controller)”).
- Flechas direccionales:
- Flechas sólidas para llamadas sincrónicas (HTTP, método Java).
- Flechas punteadas para dependencias de configuración o inversión de control.
- Colores o formas distintas por capa:
- Adaptadores (azul), Use Cases (verde), Dominio (amarillo), Infraestructura (rojo), Externo (gris).

##### Herramientas y formato
- Exponer el diagrama en el README (PNG, SVG) o directamente en el Swagger-UI si la herramienta lo permite.

##### Nivel de detalle
- Incluye cada subpaquete principal (adapter.web.controller, adapter.security.jwt, usecase, domain.model, adapter.persistence).
- Detalla el flujo de autenticación JWT e identifica el filtro JwtAuthenticationFilter → JwtService → UserRepository.
- Señala que la persistencia usa JDBC puro y MariaDB dentro de Docker.
- No descartes el componente OpenAPI (openapi.yml) como parte de la documentación de la API.

Con estas indicaciones, tu diagrama capturará de forma exhaustiva la arquitectura limpia de HotelManagementAPI, reflejando tanto la capa de presentación (REST + seguridad) como la lógica de negocio, el dominio y la infraestructura de datos.

## Diagram (Mermaid)

```mermaid
flowchart TB
  %% External systems
  Client["Client\n(Front-end/Postman)"]:::external
  Adminer["Adminer\n(Docker)"]:::external
  MariaDB["MariaDB\n(Docker)"]:::external

  %% Main API container
  subgraph "HotelManagementAPI"
    %% Adapters Layer
    subgraph "Adapters Layer"
      Controllers["Controllers\n(adapter.web.controller)"]:::adapters
      DTOs["Web DTOs\n(adapter.web.dto)"]:::adapters
      SecurityFilter["JWTAuthenticationFilter"]:::adapters
      JwtService["JwtService"]:::adapters
    end

    %% Application Layer
    subgraph "Application Layer"
      UseCases["Use Cases\n(usecase)"]:::application
    end

    %% Domain Layer
    subgraph "Domain Layer"
      Entities["Domain Models\n(domain.model)"]:::domain
      Ports["Repository Ports\n(domain.repository)"]:::domain
    end

    %% Infrastructure Layer
    subgraph "Infrastructure Layer"
      AdminRepo["AdministratorJdbcRepository"]:::infra
      ClientRepo["ClientJdbcRepository"]:::infra
      PaymentRepo["PaymentJdbcRepository"]:::infra
      ReservationRepo["ReservationJdbcRepository"]:::infra
      RoomRepo["RoomJdbcRepository"]:::infra
      UserRepo["UserJdbcRepository"]:::infra
      AppConfig["AppConfig"]:::infra
      DbConfig["DatabaseConfig"]:::infra
      SecurityConfig["SecurityConfig"]:::infra
      EntryPoint["DhHotelApplication"]:::infra
      OpenAPI["openapi.yml"]:::infra
      InitSQL["init.sql"]:::infra
      DockerCompose["docker-compose.yml"]:::infra
    end
  end

  %% Relationships
  Client -->|HTTP| Controllers
  Controllers -->|map DTO| DTOs
  Controllers -->|invoke| UseCases
  SecurityFilter -. intercepts .-> Controllers
  SecurityFilter -->|calls| JwtService
  UseCases -->|uses| Entities
  UseCases -->|depends on| Ports
  Ports -->|implemented by| AdminRepo
  Ports -->|implemented by| ClientRepo
  Ports -->|implemented by| PaymentRepo
  Ports -->|implemented by| ReservationRepo
  Ports -->|implemented by| RoomRepo
  Ports -->|implemented by| UserRepo
  AdminRepo -->|JDBC| MariaDB
  ClientRepo -->|JDBC| MariaDB
  PaymentRepo -->|JDBC| MariaDB
  ReservationRepo -->|JDBC| MariaDB
  RoomRepo -->|JDBC| MariaDB
  UserRepo -->|JDBC| MariaDB
  EntryPoint -. loads .-> AppConfig
  EntryPoint -. loads .-> DbConfig
  EntryPoint -. loads .-> SecurityConfig
  OpenAPI -->|documents| Controllers
  InitSQL -->|initializes| MariaDB
  DockerCompose -->|orchestrates| MariaDB
  DockerCompose -->|orchestrates| Adminer

  %% Click events
  click Controllers "https://github.com/asobrados03/hotelmanagementapi/tree/main/src/main/java/com/alfre/DHHotel/adapter/web/controller"
  click DTOs "https://github.com/asobrados03/hotelmanagementapi/tree/main/src/main/java/com/alfre/DHHotel/adapter/web/dto"
  click SecurityFilter "https://github.com/asobrados03/hotelmanagementapi/blob/main/src/main/java/com/alfre/DHHotel/adapter/security/jwt/JWTAuthenticationFilter.java"
  click JwtService "https://github.com/asobrados03/hotelmanagementapi/blob/main/src/main/java/com/alfre/DHHotel/adapter/security/jwt/JwtService.java"
  click UseCases "https://github.com/asobrados03/hotelmanagementapi/tree/main/src/main/java/com/alfre/DHHotel/usecase"
  click Entities "https://github.com/asobrados03/hotelmanagementapi/tree/main/src/main/java/com/alfre/DHHotel/domain/model"
  click Ports "https://github.com/asobrados03/hotelmanagementapi/tree/main/src/main/java/com/alfre/DHHotel/domain/repository"
  click AdminRepo "https://github.com/asobrados03/hotelmanagementapi/blob/main/src/main/java/com/alfre/DHHotel/adapter/persistence/AdministratorJdbcRepository.java"
  click ClientRepo "https://github.com/asobrados03/hotelmanagementapi/blob/main/src/main/java/com/alfre/DHHotel/adapter/persistence/ClientJdbcRepository.java"
  click PaymentRepo "https://github.com/asobrados03/hotelmanagementapi/blob/main/src/main/java/com/alfre/DHHotel/adapter/persistence/PaymentJdbcRepository.java"
  click ReservationRepo "https://github.com/asobrados03/hotelmanagementapi/blob/main/src/main/java/com/alfre/DHHotel/adapter/persistence/ReservationJdbcRepository.java"
  click RoomRepo "https://github.com/asobrados03/hotelmanagementapi/blob/main/src/main/java/com/alfre/DHHotel/adapter/persistence/RoomJdbcRepository.java"
  click UserRepo "https://github.com/asobrados03/hotelmanagementapi/blob/main/src/main/java/com/alfre/DHHotel/adapter/persistence/UserJdbcRepository.java"
  click AppConfig "https://github.com/asobrados03/hotelmanagementapi/blob/main/src/main/java/com/alfre/DHHotel/config/AppConfig.java"
  click DbConfig "https://github.com/asobrados03/hotelmanagementapi/blob/main/src/main/java/com/alfre/DHHotel/config/DatabaseConfig.java"
  click SecurityConfig "https://github.com/asobrados03/hotelmanagementapi/blob/main/src/main/java/com/alfre/DHHotel/config/SecurityConfig.java"
  click EntryPoint "https://github.com/asobrados03/hotelmanagementapi/blob/main/src/main/java/com/alfre/DHHotel/DhHotelApplication.java"
  click OpenAPI "https://github.com/asobrados03/hotelmanagementapi/blob/main/src/main/resources/static/openapi.yml"
  click DockerCompose "https://github.com/asobrados03/hotelmanagementapi/blob/main/docker-compose.yml"
  click InitSQL "https://github.com/asobrados03/hotelmanagementapi/blob/main/src/test/resources/db/init.sql"

  %% Styles
  classDef external fill:#eee,stroke:#666,stroke-width:1px,color:#333;
  classDef adapters fill:#D0E6FF,stroke:#3399FF,stroke-width:1px;
  classDef application fill:#DFFFD6,stroke:#33CC33,stroke-width:1px;
  classDef domain fill:#FFF5B1,stroke:#FFCC00,stroke-width:1px;
  classDef infra fill:#FFD6D6,stroke:#FF3333,stroke-width:1px;
```
