# debapriyo-mudi/hotelroombookingsystem architecture

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

- Interactive diagram: https://gitdiagram.com/debapriyo-mudi/hotelroombookingsystem
- Repository: https://github.com/debapriyo-mudi/hotelroombookingsystem

## Overview

StayFinder is a servlet-based hotel booking application. Users register or log in, search destinations and hotels, inspect rooms and dates, book, then view or cancel reservations; session authentication also supports profiles. The README documents these capabilities, but the supplied tree lacks the JSP/HTML pages and several domain servlet excerpts, so their implementation paths and wiring cannot be established here. Edges below are limited to calls visible in excerpts and relationships explicitly stated by the README.

Main entry points: [`HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/DBConnection.java`](https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/DBConnection.java) (JDBC connection), [`HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/RoomServlet.java`](https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/RoomServlet.java) (Hotel room selection), [`HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/DestinationSearchServlet.java`](https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/DestinationSearchServlet.java) (Destination search), [`HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/HotelSearchServlet.java`](https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/HotelSearchServlet.java) (Hotel search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Accounts and sessions"]
  node_register["Registration"]
  node_login["Login<br/>[LoginServlet.java]"]
  node_profile["User profile"]
  node_logout["Logout<br/>[LogoutServlet.java]"]
end

subgraph group_discovery["Destination and hotel discovery"]
  node_destination_search["Destination search"]
  node_destination["Destination results"]
  node_hotel_search["Hotel search"]
  node_hotel_results["Hotel listings<br/>[HotelServlet.java]"]
end

subgraph group_booking["Room booking lifecycle"]
  node_room_results["Hotel room selection<br/>[RoomServlet.java]"]
  node_room_search["Availability search"]
  node_room_dao["Availability DAO<br/>[RoomDAO.java]"]
  node_booking_create["Create booking"]
  node_booking_list["My bookings"]
  node_booking_cancel["Cancel booking"]
end

subgraph group_persistence["Database access"]
  node_db_connection["JDBC connection<br/>[DBConnection.java]"]
  node_mysql[("hotel_booking MySQL")]
end

node_guest(("Traveler"))

node_guest -.->|"registers"| node_register
node_guest -.->|"signs in"| node_login
node_guest -.->|"searches"| node_destination_search
node_guest -.->|"finds hotels"| node_hotel_search
node_guest -.->|"selects room"| node_room_results
node_guest -.->|"confirms"| node_booking_create
node_guest -.->|"views"| node_booking_list
node_guest -.->|"cancels"| node_booking_cancel
node_destination_search -->|"gets connection"| node_db_connection
node_hotel_search -->|"gets connection"| node_db_connection
node_hotel_results -->|"gets connection"| node_db_connection
node_room_results -->|"gets connection"| node_db_connection
node_room_search -->|"calls search"| node_room_dao
node_room_dao -->|"gets connection"| node_db_connection
node_booking_create -->|"gets connection"| node_db_connection
node_booking_list -->|"gets connection"| node_db_connection
node_booking_cancel -->|"gets connection"| node_db_connection
node_login -->|"gets connection"| node_db_connection
node_register -.->|"uses"| node_db_connection
node_profile -.->|"uses"| node_db_connection
node_destination_search -->|"queries"| node_mysql
node_room_dao -->|"queries availability"| node_mysql
node_db_connection -->|"connects"| node_mysql
node_hotel_search -->|"queries hotels"| node_mysql
node_hotel_results -->|"queries hotels"| node_mysql
node_room_results -->|"queries rooms"| node_mysql
node_booking_create -->|"writes booking"| node_mysql
node_booking_list -->|"reads bookings"| node_mysql
node_booking_cancel -->|"updates booking"| node_mysql
node_login -->|"checks credentials"| node_mysql
node_destination_search -.->|"offers results"| node_destination
node_hotel_search -.->|"lists hotels"| node_hotel_results
node_hotel_results -.->|"offers rooms"| node_room_results
node_room_results -.->|"submits selection"| node_booking_create

click node_register "https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/RegisterServlet.java"
click node_login "https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/LoginServlet.java"
click node_profile "https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/ProfileServlet.java"
click node_logout "https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/LogoutServlet.java"
click node_destination_search "https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/DestinationSearchServlet.java"
click node_destination "https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/DestinationServlet.java"
click node_hotel_search "https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/HotelSearchServlet.java"
click node_hotel_results "https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/HotelServlet.java"
click node_room_results "https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/RoomServlet.java"
click node_room_search "https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/RoomSearchServlet.java"
click node_room_dao "https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/dao/RoomDAO.java"
click node_booking_create "https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/BookingServlet.java"
click node_booking_list "https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/MyBookingsServlet.java"
click node_booking_cancel "https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/CancelBookingServlet.java"
click node_db_connection "https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/DBConnection.java"

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_register,node_login,node_profile,node_logout toneBlue
class node_destination_search,node_destination,node_hotel_search,node_hotel_results toneAmber
class node_room_results,node_room_search,node_room_dao,node_booking_create,node_booking_list,node_booking_cancel toneMint
class node_db_connection,node_mysql toneRose
class node_guest toneIndigo
```

## Components

### Accounts and sessions

- [Registration](https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/RegisterServlet.java): `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/RegisterServlet.java`
- [Login](https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/LoginServlet.java): `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/LoginServlet.java`
- [User profile](https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/ProfileServlet.java): `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/ProfileServlet.java`
- [Logout](https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/LogoutServlet.java): `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/LogoutServlet.java`

### Destination and hotel discovery

- [Destination search](https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/DestinationSearchServlet.java): `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/DestinationSearchServlet.java`
- [Destination results](https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/DestinationServlet.java): `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/DestinationServlet.java`
- [Hotel search](https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/HotelSearchServlet.java): `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/HotelSearchServlet.java`
- [Hotel listings](https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/HotelServlet.java): `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/HotelServlet.java`

### Room booking lifecycle

- [Hotel room selection](https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/RoomServlet.java): `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/RoomServlet.java`
- [Availability search](https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/RoomSearchServlet.java): `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/RoomSearchServlet.java`
- [Availability DAO](https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/dao/RoomDAO.java): `HotelRoomBookingSystem.java/src/main/java/com/hotel/dao/RoomDAO.java`
- [Create booking](https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/BookingServlet.java): `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/BookingServlet.java`
- [My bookings](https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/MyBookingsServlet.java): `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/MyBookingsServlet.java`
- [Cancel booking](https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/CancelBookingServlet.java): `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/CancelBookingServlet.java`

### Database access

- [JDBC connection](https://github.com/debapriyo-mudi/hotelroombookingsystem/blob/main/HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/DBConnection.java): `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/DBConnection.java`
- **hotel_booking MySQL**

### Other components

- **Traveler**

## Connections

- Traveler → Registration: registers
- Traveler → Login: signs in
- Traveler → Destination search: searches
- Traveler → Hotel search: finds hotels
- Traveler → Hotel room selection: selects room
- Traveler → Create booking: confirms
- Traveler → My bookings: views
- Traveler → Cancel booking: cancels
- Destination search → JDBC connection: gets connection (evidence: `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/DestinationSearchServlet.java`)
- Hotel search → JDBC connection: gets connection (evidence: `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/HotelSearchServlet.java`)
- Hotel listings → JDBC connection: gets connection (evidence: `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/HotelServlet.java`)
- Hotel room selection → JDBC connection: gets connection (evidence: `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/RoomServlet.java`)
- Availability search → Availability DAO: calls search (evidence: `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/RoomSearchServlet.java`)
- Availability DAO → JDBC connection: gets connection (evidence: `HotelRoomBookingSystem.java/src/main/java/com/hotel/dao/RoomDAO.java`)
- Create booking → JDBC connection: gets connection (evidence: `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/BookingServlet.java`)
- My bookings → JDBC connection: gets connection (evidence: `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/MyBookingsServlet.java`)
- Cancel booking → JDBC connection: gets connection (evidence: `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/CancelBookingServlet.java`)
- Login → JDBC connection: gets connection (evidence: `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/LoginServlet.java`)
- Registration → JDBC connection: uses
- User profile → JDBC connection: uses
- Destination search → hotel_booking MySQL: queries (evidence: `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/DestinationSearchServlet.java`)
- Availability DAO → hotel_booking MySQL: queries availability (evidence: `HotelRoomBookingSystem.java/src/main/java/com/hotel/dao/RoomDAO.java`)
- JDBC connection → hotel_booking MySQL: connects (evidence: `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/DBConnection.java`)
- Hotel search → hotel_booking MySQL: queries hotels (evidence: `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/HotelSearchServlet.java`)
- Hotel listings → hotel_booking MySQL: queries hotels (evidence: `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/HotelServlet.java`)
- Hotel room selection → hotel_booking MySQL: queries rooms (evidence: `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/RoomServlet.java`)
- Create booking → hotel_booking MySQL: writes booking (evidence: `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/BookingServlet.java`)
- My bookings → hotel_booking MySQL: reads bookings (evidence: `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/MyBookingsServlet.java`)
- Cancel booking → hotel_booking MySQL: updates booking (evidence: `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/CancelBookingServlet.java`)
- Login → hotel_booking MySQL: checks credentials (evidence: `HotelRoomBookingSystem.java/src/main/java/com/hotel/controller/LoginServlet.java`)
- Destination search → Destination results: offers results
- Hotel search → Hotel listings: lists hotels
- Hotel listings → Hotel room selection: offers rooms
- Hotel room selection → Create booking: submits selection
