# josebc377/plataformahotel architecture

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

- Interactive diagram: https://gitdiagram.com/josebc377/plataformahotel
- Repository: https://github.com/josebc377/plataformahotel

## Overview

##### Project Type and Purpose
- This is a Spring Boot–based, monolithic RESTful backend (“PlataformaHotel”) that exposes CRUD operations for hotel resources (rooms, categories, reservations, payments, reviews, users, etc.).
- It follows a classic layered architecture (Controller → Service → Repository → Database).

##### Main Components
a. Presentation Layer
– HTTP/REST interface provided by Spring MVC controllers under `controllers/`
– Endpoints: `/categorias`, `/habitaciones`, `/reservas`, `/pagos`, `/resenas`, `/servicios`, `/usuarios`, plus a global exception handler.
b. Business Logic Layer
– Service classes under `services/` implement core domain workflows (e.g., creating reservations, processing payments).
c. Data Access Layer
– Spring Data JPA repositories under `repositories/`, each exposing CRUD methods for the corresponding entity.
d. Domain Model
– JPA entities under `entities/` (e.g., `Habitacion`, `Reserva`, `Pago`, `Usuario`, etc.) map to relational tables.
e. Infrastructure
– `HotelApplication.java` bootstraps the application.
– `application.properties` configures the datasource (MySQL/H2), JPA settings, server port, etc.
– Maven build (`pom.xml`) and wrapper files (`mvnw`, `.mvn/`) manage lifecycle and dependencies.

##### External Dependencies & Tools
- Spring Boot, Spring MVC, Spring Data JPA, Hibernate
- Relational DB (MySQL, PostgreSQL or H2 for tests)
- JUnit/Mockito for unit and integration tests under `src/test/`
- Maven for build, dependency management, and test execution

##### Architectural Patterns & Principles
- Layered (n-tier) design: clear separation between API (controllers), domain logic (services), and persistence (repositories/entities).
- Dependency Injection via Spring Framework.
- Exception handling centralized with `GlobalExceptionHandler`.
- Repository pattern with Spring Data JPA.

## Diagram (Mermaid)

```mermaid
flowchart TD
    Clients["Client (Browser/Mobile)"]:::client
    subgraph PlataformaHotel
        subgraph "Presentation Layer (Controllers)"
            CHRC["Categoria_HabitacionRestController"]:::controller
            HRC["HabitacionRestController"]:::controller
            RRC["ReservaRestController"]:::controller
            R_hRC["Reserva_habitacionRestController"]:::controller
            R_SRC["Reserva_ServicioController"]:::controller
            PC["PagoController"]:::controller
            ResRC["ResenaRestController"]:::controller
            SERC["ServicioRestController"]:::controller
            URC["UsuarioRestController"]:::controller
            CC["ContactoController"]:::controller
        end
        subgraph "Business Logic Layer (Services)"
            CHS["Categoria_HabitacionService"]:::service
            HS["HabitacionService"]:::service
            RS["ReservaService"]:::service
            R_hS["Reserva_habitacionService"]:::service
            R_SS["Reserva_ServicioService"]:::service
            PS["PagoService"]:::service
            ResS["ResenaService"]:::service
            SeS["ServicioService"]:::service
            US["UsuarioService"]:::service
            CS["ContactoService"]:::service
        end
        subgraph "Data Access Layer (Repositories)"
            CHRepo["Categoria_HabitacionRepository"]:::repo
            HRepo["HabitacionRepository"]:::repo
            RRepo["ReservaRepository"]:::repo
            R_hRepo["Reserva_habitacionRepository"]:::repo
            R_SRepo["Reserva_ServicioRepository"]:::repo
            PRepo["PagoRepository"]:::repo
            ResRepo["ResenaRepository"]:::repo
            SRepo["ServicioRepository"]:::repo
            URepo["UsuarioRepository"]:::repo
            CRepo["ContactoRepository"]:::repo
        end
        DB["Relational Database"]:::db
    end
    subgraph Infrastructure
        SB["Spring Boot"]:::infra
        MEC["GlobalExceptionHandler"]:::infra
        AP["application.properties"]:::infra
        MAV["Maven (pom.xml & wrapper)"]:::infra
    end

    Clients -->|"HTTP Request (GET/POST)"| CHRC
    CHRC -->|"calls"| CHS
    CHS -->|"uses"| CHRepo
    CHRepo -->|"SQL Query"| DB

    Clients -->|"HTTP Request"| HRC
    HRC -->|"calls"| HS
    HS -->|"uses"| HRepo
    HRepo -->|"SQL Query"| DB

    Clients -->|"HTTP Request"| RRC
    RRC -->|"calls"| RS
    RS -->|"uses"| RRepo
    RRepo -->|"SQL Query"| DB

    Clients -->|"HTTP Request"| R_hRC
    R_hRC -->|"calls"| R_hS
    R_hS -->|"uses"| R_hRepo
    R_hRepo -->|"SQL Query"| DB

    Clients -->|"HTTP Request"| R_SRC
    R_SRC -->|"calls"| R_SS
    R_SS -->|"uses"| R_SRepo
    R_SRepo -->|"SQL Query"| DB

    Clients -->|"HTTP Request"| PC
    PC -->|"calls"| PS
    PS -->|"uses"| PRepo
    PRepo -->|"SQL Query"| DB

    Clients -->|"HTTP Request"| ResRC
    ResRC -->|"calls"| ResS
    ResS -->|"uses"| ResRepo
    ResRepo -->|"SQL Query"| DB

    Clients -->|"HTTP Request"| SERC
    SERC -->|"calls"| SeS
    SeS -->|"uses"| SRepo
    SRepo -->|"SQL Query"| DB

    Clients -->|"HTTP Request"| URC
    URC -->|"calls"| US
    US -->|"uses"| URepo
    URepo -->|"SQL Query"| DB

    Clients -->|"HTTP Request"| CC
    CC -->|"calls"| CS
    CS -->|"uses"| CRepo
    CRepo -->|"SQL Query"| DB

    CHRC -->|throws exception| MEC
    HRC -->|throws exception| MEC
    RRC -->|throws exception| MEC
    R_hRC -->|throws exception| MEC
    R_SRC -->|throws exception| MEC
    PC -->|throws exception| MEC
    ResRC -->|throws exception| MEC
    SERC -->|throws exception| MEC
    URC -->|throws exception| MEC
    CC -->|throws exception| MEC

    MEC -->|formats HTTP Error Response| Clients

    MAV -->|builds/runs| SB
    AP -->|configures| SB
    SB -->|boots| PlataformaHotel

    click CHRC "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/controllers/Categoria_HabitacionRestController.java"
    click HRC "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/controllers/HabitacionRestController.java"
    click RRC "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/controllers/ReservaRestController.java"
    click R_hRC "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/controllers/Reserva_habitacionRestController.java"
    click R_SRC "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/controllers/Reserva_ServicioController.java"
    click PC "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/controllers/PagoController.java"
    click ResRC "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/controllers/ResenaRestController.java"
    click SERC "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/controllers/ServicioRestController.java"
    click URC "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/controllers/UsuarioRestController.java"
    click CC "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/controllers/ContactoController.java"

    click CHS "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/services/Categoria_HabitacionService.java"
    click HS "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/services/HabitacionService.java"
    click RS "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/services/ReservaService.java"
    click R_hS "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/services/Reserva_habitacionService.java"
    click R_SS "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/services/Reserva_ServicioService.java"
    click PS "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/services/PagoService.java"
    click ResS "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/services/ResenaService.java"
    click SeS "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/services/ServicioService.java"
    click US "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/services/UsuarioService.java"
    click CS "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/services/ContactoService.java"

    click CHRepo "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/repositories/Categoria_HabitacionRepository.java"
    click HRepo "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/repositories/HabitacionRepository.java"
    click RRepo "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/repositories/ReservaRepository.java"
    click R_hRepo "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/repositories/Reserva_habitacionRepository.java"
    click R_SRepo "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/repositories/Reserva_ServicioRepository.java"
    click PRepo "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/repositories/PagoRepository.java"
    click ResRepo "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/repositories/ResenaRepository.java"
    click SRepo "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/repositories/ServicioRepository.java"
    click URepo "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/repositories/UsuarioRepository.java"
    click CRepo "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/repositories/ContactoRepository.java"

    click SB "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/HotelApplication.java"
    click MEC "https://github.com/josebc377/plataformahotel/blob/main/src/main/java/com/example/hotel/exception/GlobalExceptionHandler.java"
    click AP "https://github.com/josebc377/plataformahotel/blob/main/src/main/resources/application.properties"

    classDef controller fill:#cce5ff,stroke:#004085,color:#004085
    classDef service fill:#d4edda,stroke:#155724,color:#155724
    classDef repo fill:#fff3cd,stroke:#856404,color:#856404
    classDef db fill:#d1ecf1,stroke:#0c5460,color:#0c5460
    classDef infra fill:#e2e3e5,stroke:#6c757d,color:#6c757d
    classDef client fill:#f8d7da,stroke:#721c24,color:#721c24
```
