# nguyenvananit/booking-hotel-backend architecture

> Architecture diagram of the GitHub repository nguyenvananit/booking-hotel-backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nguyenvananit/booking-hotel-backend
- Repository: https://github.com/nguyenvananit/booking-hotel-backend

## Overview

##### Project type and purpose
- This is a monolithic, backend-only Java application (Spring Boot) named “Manage-Hotel-Backend.”
- It exposes RESTful HTTP endpoints for hotel operations (authentication, booking, rooms, services, staff attendance, payments, etc.).

##### File structure
- Top-level artifacts:
- pom.xml / .mvn / mvnw → Maven build and wrapper
- Dockerfile → containerization
- src/main/java/com/nguyenvanancodeweb/lakesidehotel/** → Java source code
- src/main/resources/application.properties / application.yml → configuration
- src/test → unit/integration tests
- Layered package layout:
- config → web and CORS configuration
- controller → REST controllers (API layer)
- service / I*Service → business logic
- repository → Spring Data JPA interfaces (data access layer)
- model → domain entities
- request / response → DTOs for inbound/outbound JSON
- security → JWT filters, security config, user-details service
- utils → VNPAY payment configuration and helpers
- External integration:
- VNPAYService calls out to the VNPAY payment gateway
- Persistence:
- Repositories target a relational database (e.g., MySQL/PostgreSQL) via JPA/Hibernate.

##### README for additional insights
- Minimal README (“# Manage-Hotel-Backend”) but file tree reveals full REST API and external dependencies (JWT, VNPAY).

##### Detail recommendations
- Docker host & container boundary around that block.
- Inside the app block, list:
- REST Layer (controllers)
- Security Layer (JWT filter, WebSecurityConfig)
- Service Layer
- Repository Layer
- Model Layer (entities)
- Configuration components (WebConfig, CorsConfig) near the REST layer.

## Diagram (Mermaid)

```mermaid
flowchart TB
    Clients["Clients (Web/Mobile/External)"]:::client

    subgraph "Docker Container: Lakesidehotel-SpringBoot App"
        direction TB
        Entry["LakesidehotelApplication"]:::module

        subgraph "Configuration Layer"
            WebConfig["WebConfig"]:::module
            CorsConfig["CorsConfig"]:::module
            WebSecurityConfig["WebSecurityConfig"]:::module
        end

        subgraph "Security Layer"
            AuthTokenFilter["AuthTokenFilter"]:::module
            JwtAuthEntryPoint["JwtAuthEntryPoint"]:::module
            JwtUtils["JwtUtils"]:::module
            HotelUserDetails["HotelUserDetails"]:::module
            HotelUserDetailsService["HotelUserDetailsService"]:::module
        end

        subgraph "REST Controller Layer"
            AuthController["AuthController"]:::module
            BookingController["BookingController"]:::module
            RoomController["RoomController"]:::module
            ServicesController["ServicesController"]:::module
            StaffController["StaffController"]:::module
            UserController["UserController"]:::module
        end

        subgraph "Service Layer"
            IBookingService["IBookingService"]:::module
            BookingService["BookingService"]:::module
            UserService["UserService"]:::module
            VNPAYService["VNPAYService"]:::module
        end

        subgraph "Repository Layer"
            BookingRepo["BookingRepository"]:::module
            UserRepo["UserRepository"]:::module
        end

        subgraph "Domain Model Layer"
            UserModel["User"]:::entity
            RoomModel["Room"]:::entity
        end

        subgraph "Utilities"
            VNPAYConfig["VNPAYConfig"]:::module
            VnpayUtils["VnpayUtils"]:::module
        end

        subgraph "Exception Handling"
            GlobalExceptionHandler["GlobalExceptionHandler"]:::module
        end
    end

    DB[(Relational Database)]:::db
    VNPAY((VNPAY Payment Gateway)):::ext

    Clients -->|HTTP| WebConfig
    WebConfig -->|configures| CorsConfig
    Clients -->|requests| AuthTokenFilter
    AuthTokenFilter -->|filters JWT| AuthController
    JwtAuthEntryPoint -->|handles auth errors| AuthController
    AuthController -->|calls| IBookingService
    BookingController -->|calls| BookingService
    BookingService -->|uses| BookingRepo
    BookingRepo -->|reads/writes| DB
    BookingService -->|calls| VNPAYService
    VNPAYService -->|integrates| VNPAY
    UserController -->|calls| UserService
    UserService -->|uses| UserRepo
    UserRepo -->|reads/writes| DB
    BookingController -->|uses| JwtUtils
    AuthController -->|uses| JwtUtils
    HotelUserDetailsService -->|loads user| HotelUserDetails
    GlobalExceptionHandler -->|handles| AuthController
    GlobalExceptionHandler -->|handles| BookingController

    classDef module fill:#D0E6FF,stroke:#0366D6,color:#000
    classDef entity fill:#FFF5BA,stroke:#C69500,color:#000
    classDef db fill:#DFFFE0,stroke:#34A853,color:#000
    classDef ext fill:#FFE5D0,stroke:#EA7600,color:#000
    classDef client fill:#E0E0E0,stroke:#888,color:#000

    click Entry "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/LakesidehotelApplication.java"
    click WebConfig "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/config/WebConfig.java"
    click CorsConfig "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/security/CorsConfig.java"
    click WebSecurityConfig "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/security/WebSecurityConfig.java"
    click AuthTokenFilter "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/security/jwt/AuthTokenFilter.java"
    click JwtAuthEntryPoint "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/security/jwt/JwtAuthEntryPoint.java"
    click JwtUtils "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/security/jwt/JwtUtils.java"
    click HotelUserDetails "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/security/user/HotelUserDetails.java"
    click HotelUserDetailsService "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/security/user/HotelUserDetailsService.java"
    click AuthController "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/controller/AuthController.java"
    click BookingController "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/controller/BookingController.java"
    click RoomController "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/controller/RoomController.java"
    click ServicesController "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/controller/ServicesController.java"
    click StaffController "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/controller/StaffController.java"
    click UserController "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/controller/UserController.java"
    click IBookingService "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/service/IBookingService.java"
    click BookingService "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/service/BookingService.java"
    click UserService "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/service/UserService.java"
    click VNPAYService "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/service/VNPAYService.java"
    click BookingRepo "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/repository/BookingRepository.java"
    click UserRepo "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/repository/UserRepository.java"
    click VNPAYConfig "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/utils/VNPAYConfig.java"
    click VnpayUtils "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/utils/VnpayUtils.java"
    click GlobalExceptionHandler "https://github.com/nguyenvananit/booking-hotel-backend/blob/main/src/main/java/com/nguyenvanancodeweb/lakesidehotel/exception/GlobalExceptionHandler.java"
```
