# subha035/hotel-room-booking-system architecture

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

- Interactive diagram: https://gitdiagram.com/subha035/hotel-room-booking-system
- Repository: https://github.com/subha035/hotel-room-booking-system

## Overview

This is a small, in-memory Java hotel-management demo. The principal workflow in Main registers guests, generates and validates an OTP, finds available rooms by type, and creates date-range reservations. Room and guest lists and reservations are held in manager-local collections; ReservationManager checks overlapping bookings and marks a booked room unavailable. OTP generation/validation is local rather than an external messaging integration. The README documents management and booking capabilities; the graph follows visible calls in sampled source, so it does not assume an unshown OTP-gated reservation check.

Main entry points: [`Main.java`](https://github.com/subha035/hotel-room-booking-system/blob/main/Main.java) (Demo workflow), [`Room.java`](https://github.com/subha035/hotel-room-booking-system/blob/main/Room.java) (Room record), [`RoomManager.java`](https://github.com/subha035/hotel-room-booking-system/blob/main/RoomManager.java) (Room management), [`ReservationManager.java`](https://github.com/subha035/hotel-room-booking-system/blob/main/ReservationManager.java) (Reservation management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Demo workflow"]
  node_main["Demo workflow<br/>[Main.java]"]
end

subgraph group_operations["Hotel operations"]
  node_guests["Guest and OTP<br/>[GuestManager.java]"]
  node_rooms["Room management<br/>[RoomManager.java]"]
  node_reservations["Reservation management"]
  node_hotel["Hotel collection<br/>[Hotel.java]"]
end

subgraph group_domain["Domain models"]
  node_guest["Guest record<br/>[Guest.java]"]
  node_room["Room record<br/>[Room.java]"]
  node_roomtype["Room types<br/>[RoomType.java]"]
  node_reservation["Reservation record<br/>[Reservation.java]"]
end

node_user(("Operator"))

node_user -->|"runs demo"| node_main
node_main -->|"manages rooms"| node_rooms
node_main -->|"registers guest"| node_guests
node_main -->|"adds rooms"| node_hotel
node_main -->|"creates bookings"| node_reservations
node_rooms -->|"creates and updates"| node_room
node_rooms -->|"filters by type"| node_roomtype
node_guests -->|"creates guest"| node_guest
node_reservations -->|"creates and stores"| node_reservation
node_reservations -->|"checks and marks unavailable"| node_room
node_reservation -->|"references guest"| node_guest
node_reservation -->|"references room"| node_room
node_hotel -->|"stores rooms"| node_room

click node_main "https://github.com/subha035/hotel-room-booking-system/blob/main/Main.java"
click node_guests "https://github.com/subha035/hotel-room-booking-system/blob/main/GuestManager.java"
click node_rooms "https://github.com/subha035/hotel-room-booking-system/blob/main/RoomManager.java"
click node_reservations "https://github.com/subha035/hotel-room-booking-system/blob/main/ReservationManager.java"
click node_hotel "https://github.com/subha035/hotel-room-booking-system/blob/main/Hotel.java"
click node_guest "https://github.com/subha035/hotel-room-booking-system/blob/main/Guest.java"
click node_room "https://github.com/subha035/hotel-room-booking-system/blob/main/Room.java"
click node_roomtype "https://github.com/subha035/hotel-room-booking-system/blob/main/RoomType.java"
click node_reservation "https://github.com/subha035/hotel-room-booking-system/blob/main/Reservation.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_main toneBlue
class node_guests,node_rooms,node_reservations,node_hotel toneAmber
class node_guest,node_room,node_roomtype,node_reservation toneMint
class node_user toneIndigo
```

## Components

### Demo workflow

- [Demo workflow](https://github.com/subha035/hotel-room-booking-system/blob/main/Main.java): `Main.java`

### Hotel operations

- [Guest and OTP](https://github.com/subha035/hotel-room-booking-system/blob/main/GuestManager.java): `GuestManager.java`
- [Room management](https://github.com/subha035/hotel-room-booking-system/blob/main/RoomManager.java): `RoomManager.java`
- [Reservation management](https://github.com/subha035/hotel-room-booking-system/blob/main/ReservationManager.java): `ReservationManager.java`
- [Hotel collection](https://github.com/subha035/hotel-room-booking-system/blob/main/Hotel.java): `Hotel.java`

### Domain models

- [Guest record](https://github.com/subha035/hotel-room-booking-system/blob/main/Guest.java): `Guest.java`
- [Room record](https://github.com/subha035/hotel-room-booking-system/blob/main/Room.java): `Room.java`
- [Room types](https://github.com/subha035/hotel-room-booking-system/blob/main/RoomType.java): `RoomType.java`
- [Reservation record](https://github.com/subha035/hotel-room-booking-system/blob/main/Reservation.java): `Reservation.java`

### Other components

- **Operator**

## Connections

- Operator → Demo workflow: runs demo (evidence: `Main.java`)
- Demo workflow → Room management: manages rooms (evidence: `Main.java`)
- Demo workflow → Guest and OTP: registers guest (evidence: `Main.java`)
- Demo workflow → Hotel collection: adds rooms (evidence: `Main.java`)
- Demo workflow → Reservation management: creates bookings (evidence: `Main.java`)
- Room management → Room record: creates and updates (evidence: `RoomManager.java`)
- Room management → Room types: filters by type (evidence: `RoomManager.java`)
- Guest and OTP → Guest record: creates guest (evidence: `GuestManager.java`)
- Reservation management → Reservation record: creates and stores (evidence: `ReservationManager.java`)
- Reservation management → Room record: checks and marks unavailable (evidence: `ReservationManager.java`)
- Reservation record → Guest record: references guest (evidence: `Reservation.java`)
- Reservation record → Room record: references room (evidence: `Reservation.java`)
- Hotel collection → Room record: stores rooms (evidence: `Hotel.java`)
