# ashutoshsadhwani/hotel-booking-application architecture

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

- Interactive diagram: https://gitdiagram.com/ashutoshsadhwani/hotel-booking-application
- Repository: https://github.com/ashutoshsadhwani/hotel-booking-application

## Overview

This Spring Boot backend supports JWT-based accounts and role-aware hotel management, hotel search, and booking. The principal flow is a user request through REST controllers to authentication or hotel/booking services, then JPA repositories and PostgreSQL. BookingService checks date overlap and cancellation status before saving, and restricts cancellation to the booking’s owner. The graph preserves the documented role and listing capabilities; sampled code does not establish every authorization or search behavior described in the README.

Main entry points: [`src/main/java/com/hotelbooking/service/BookingService.java`](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/service/BookingService.java) (Booking validation), [`src/main/java/com/hotelbooking/controller/HotelController.java`](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/controller/HotelController.java) (Hotel endpoints), [`src/main/java/com/hotelbooking/repository/UserRepository.java`](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/repository/UserRepository.java) (User repository), [`src/main/java/com/hotelbooking/service/HotelService.java`](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/service/HotelService.java) (Listing and search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_auth_api["Auth endpoints"]
  node_hotel_api["Hotel endpoints"]
  node_booking_api["Booking endpoints"]
end

subgraph group_identity["Identity and access"]
  node_security["JWT security filter"]
  node_security_config["Security configuration"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_user_details["User details lookup"]
  node_jwt["JWT utility<br/>[JwtUtil.java]"]
  node_user_data["Account and roles<br/>[User.java]"]
  node_role_data["Role types<br/>[Role.java]"]
end

subgraph group_catalog["Hotel listings"]
  node_hotel_service["Listing and search<br/>[HotelService.java]"]
  node_hotel_data["Hotel records<br/>[Hotel.java]"]
  node_hotel_dto["Listing request"]
end

subgraph group_reservation["Reservations"]
  node_booking_service["Booking validation"]
  node_booking_data["Booking records<br/>[Booking.java]"]
end

subgraph group_persistence["Persistence"]
  node_hotel_repo["Hotel repository"]
  node_booking_repo["Booking repository"]
  node_user_repo["User repository"]
  node_postgres[("PostgreSQL database")]
end

node_client(("API client"))

node_client -->|"submits credentials"| node_auth_api
node_client -->|"requests listings"| node_hotel_api
node_client -->|"requests booking"| node_booking_api
node_auth_api -->|"delegates auth"| node_auth_service
node_auth_service -->|"reads and saves"| node_user_repo
node_auth_service -->|"creates token"| node_jwt
node_security_config -->|"registers filter"| node_security
node_security -->|"validates token"| node_jwt
node_security -->|"loads principal"| node_user_details
node_user_details -->|"looks up account"| node_user_repo
node_hotel_api -->|"delegates listing"| node_hotel_service
node_hotel_api -->|"extracts identity"| node_jwt
node_hotel_api -->|"loads account"| node_user_repo
node_hotel_api -->|"accepts listing data"| node_hotel_dto
node_hotel_service -->|"searches and saves"| node_hotel_repo
node_hotel_service -->|"checks bookings"| node_booking_repo
node_hotel_service -->|"creates listing"| node_hotel_data
node_booking_api -->|"delegates booking"| node_booking_service
node_booking_service -->|"extracts identity"| node_jwt
node_booking_service -->|"loads account"| node_user_repo
node_booking_service -->|"loads hotel"| node_hotel_repo
node_booking_service -->|"checks and saves"| node_booking_repo
node_booking_service -->|"creates booking"| node_booking_data
node_hotel_repo -.->|"persists listings"| node_postgres
node_booking_repo -.->|"persists bookings"| node_postgres
node_user_repo -.->|"persists accounts"| node_postgres

click node_auth_api "https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/controller/AuthController.java"
click node_hotel_api "https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/controller/HotelController.java"
click node_booking_api "https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/controller/BookingController.java"
click node_security "https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/config/JwtAuthenticationFilter.java"
click node_security_config "https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/config/SpringSecurity.java"
click node_auth_service "https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/service/AuthService.java"
click node_user_details "https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/service/UserDetailsServiceImpl.java"
click node_jwt "https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/helper/JwtUtil.java"
click node_hotel_service "https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/service/HotelService.java"
click node_hotel_data "https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/entity/Hotel.java"
click node_hotel_dto "https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/entity/HotelRequestDTO.java"
click node_booking_service "https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/service/BookingService.java"
click node_booking_data "https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/entity/Booking.java"
click node_user_data "https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/entity/User.java"
click node_role_data "https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/entity/Role.java"
click node_hotel_repo "https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/repository/HotelRepository.java"
click node_booking_repo "https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/repository/BookingRepository.java"
click node_user_repo "https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/repository/UserRepository.java"
click node_postgres "https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/resources/application.properties"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_auth_api,node_hotel_api,node_booking_api,node_client toneBlue
class node_security,node_security_config,node_auth_service,node_user_details,node_jwt,node_user_data,node_role_data toneAmber
class node_hotel_service,node_hotel_data,node_hotel_dto toneMint
class node_booking_service,node_booking_data toneRose
class node_hotel_repo,node_booking_repo,node_user_repo,node_postgres toneIndigo
```

## Components

### REST API

- [Auth endpoints](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/controller/AuthController.java): `src/main/java/com/hotelbooking/controller/AuthController.java`
- [Hotel endpoints](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/controller/HotelController.java): `src/main/java/com/hotelbooking/controller/HotelController.java`
- [Booking endpoints](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/controller/BookingController.java): `src/main/java/com/hotelbooking/controller/BookingController.java`

### Identity and access

- [JWT security filter](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/config/JwtAuthenticationFilter.java): `src/main/java/com/hotelbooking/config/JwtAuthenticationFilter.java`
- [Security configuration](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/config/SpringSecurity.java): `src/main/java/com/hotelbooking/config/SpringSecurity.java`
- [Authentication](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/service/AuthService.java): `src/main/java/com/hotelbooking/service/AuthService.java`
- [User details lookup](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/service/UserDetailsServiceImpl.java): `src/main/java/com/hotelbooking/service/UserDetailsServiceImpl.java`
- [JWT utility](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/helper/JwtUtil.java): `src/main/java/com/hotelbooking/helper/JwtUtil.java`
- [Account and roles](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/entity/User.java): `src/main/java/com/hotelbooking/entity/User.java`
- [Role types](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/entity/Role.java): `src/main/java/com/hotelbooking/entity/Role.java`

### Hotel listings

- [Listing and search](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/service/HotelService.java): `src/main/java/com/hotelbooking/service/HotelService.java`
- [Hotel records](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/entity/Hotel.java): `src/main/java/com/hotelbooking/entity/Hotel.java`
- [Listing request](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/entity/HotelRequestDTO.java): `src/main/java/com/hotelbooking/entity/HotelRequestDTO.java`

### Reservations

- [Booking validation](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/service/BookingService.java): `src/main/java/com/hotelbooking/service/BookingService.java`
- [Booking records](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/entity/Booking.java): `src/main/java/com/hotelbooking/entity/Booking.java`

### Persistence

- [Hotel repository](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/repository/HotelRepository.java): `src/main/java/com/hotelbooking/repository/HotelRepository.java`
- [Booking repository](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/repository/BookingRepository.java): `src/main/java/com/hotelbooking/repository/BookingRepository.java`
- [User repository](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/java/com/hotelbooking/repository/UserRepository.java): `src/main/java/com/hotelbooking/repository/UserRepository.java`
- [PostgreSQL database](https://github.com/ashutoshsadhwani/hotel-booking-application/blob/main/src/main/resources/application.properties): `src/main/resources/application.properties`

### Other components

- **API client**

## Connections

- API client → Auth endpoints: submits credentials (evidence: `src/main/java/com/hotelbooking/controller/AuthController.java`)
- API client → Hotel endpoints: requests listings (evidence: `src/main/java/com/hotelbooking/controller/HotelController.java`)
- API client → Booking endpoints: requests booking (evidence: `src/main/java/com/hotelbooking/controller/BookingController.java`)
- Auth endpoints → Authentication: delegates auth (evidence: `src/main/java/com/hotelbooking/controller/AuthController.java`)
- Authentication → User repository: reads and saves (evidence: `src/main/java/com/hotelbooking/service/AuthService.java`)
- Authentication → JWT utility: creates token (evidence: `src/main/java/com/hotelbooking/service/AuthService.java`)
- Security configuration → JWT security filter: registers filter (evidence: `src/main/java/com/hotelbooking/config/SpringSecurity.java`)
- JWT security filter → JWT utility: validates token (evidence: `src/main/java/com/hotelbooking/config/JwtAuthenticationFilter.java`)
- JWT security filter → User details lookup: loads principal (evidence: `src/main/java/com/hotelbooking/config/JwtAuthenticationFilter.java`)
- User details lookup → User repository: looks up account (evidence: `src/main/java/com/hotelbooking/service/UserDetailsServiceImpl.java`)
- Hotel endpoints → Listing and search: delegates listing (evidence: `src/main/java/com/hotelbooking/controller/HotelController.java`)
- Hotel endpoints → JWT utility: extracts identity (evidence: `src/main/java/com/hotelbooking/controller/HotelController.java`)
- Hotel endpoints → User repository: loads account (evidence: `src/main/java/com/hotelbooking/controller/HotelController.java`)
- Hotel endpoints → Listing request: accepts listing data (evidence: `src/main/java/com/hotelbooking/controller/HotelController.java`)
- Listing and search → Hotel repository: searches and saves (evidence: `src/main/java/com/hotelbooking/service/HotelService.java`)
- Listing and search → Booking repository: checks bookings (evidence: `src/main/java/com/hotelbooking/service/HotelService.java`)
- Listing and search → Hotel records: creates listing (evidence: `src/main/java/com/hotelbooking/service/HotelService.java`)
- Booking endpoints → Booking validation: delegates booking (evidence: `src/main/java/com/hotelbooking/controller/BookingController.java`)
- Booking validation → JWT utility: extracts identity (evidence: `src/main/java/com/hotelbooking/service/BookingService.java`)
- Booking validation → User repository: loads account (evidence: `src/main/java/com/hotelbooking/service/BookingService.java`)
- Booking validation → Hotel repository: loads hotel (evidence: `src/main/java/com/hotelbooking/service/BookingService.java`)
- Booking validation → Booking repository: checks and saves (evidence: `src/main/java/com/hotelbooking/service/BookingService.java`)
- Booking validation → Booking records: creates booking (evidence: `src/main/java/com/hotelbooking/service/BookingService.java`)
- Hotel repository → PostgreSQL database: persists listings
- Booking repository → PostgreSQL database: persists bookings
- User repository → PostgreSQL database: persists accounts
