# hiruneshan/hotel-reservation-system architecture

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

- Interactive diagram: https://gitdiagram.com/hiruneshan/hotel-reservation-system
- Repository: https://github.com/hiruneshan/hotel-reservation-system

## Overview

RXH GrandHotel is a hotel reservation and administration application. Guests use a kiosk booking flow to provide stay and guest details, select rooms and add-ons, and confirm a reservation; administrators manage reservations, payments, loyalty, feedback, and operational reports. BookingService coordinates guest persistence, pricing, and reservation creation, while ReservationService handles reservation persistence and checkout. The supplied excerpts establish those service relationships and reporting data access; many controller and feature implementations are unsampled, so their connections are shown only where configuration or evidence supports them.

Main entry points: [`RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/controller/admin`](https://github.com/hiruneshan/hotel-reservation-system/tree/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/controller/admin) (Admin workflows), [`RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/BookingService.java`](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/BookingService.java) (Booking orchestration), [`RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/ReportingService.java`](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/ReportingService.java) (Reports and activity logs), [`RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/controller/kiosk`](https://github.com/hiruneshan/hotel-reservation-system/tree/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/controller/kiosk) (Kiosk booking screens)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_booking["Guest booking"]
  node_kiosk["Kiosk booking screens"]
  node_booking_session["Booking session"]
end

subgraph group_operations["Hotel operations"]
  node_admin_ui["Admin workflows"]
  node_auth["Admin authentication<br/>[AuthService.java]"]
  node_payments["Payments"]
  node_loyalty["Loyalty"]
  node_feedback["Guest feedback"]
  node_waitlist["Waitlist"]
  node_discounts["Discounts and promotions"]
  node_reporting["Reports and activity logs"]
  node_exporters["Report exports<br/>[CSVExporter.java]"]
end

subgraph group_services["Domain services"]
  node_booking_service["Booking orchestration"]
  node_guest_service["Guest management<br/>[GuestService.java]"]
  node_pricing["Pricing"]
  node_reservation_service["Reservation lifecycle"]
end

subgraph group_data["Persistence and models"]
  node_reservation_model["Reservation records<br/>[Reservation.java]"]
  node_guest_model["Guest records<br/>[Guest.java]"]
  node_room_model["Room inventory<br/>[Room.java]"]
  node_discount_model["Discount records<br/>[Discount.java]"]
  node_loyalty_model["Loyalty accounts"]
  node_reservation_repo[("Reservation storage")]
  node_room_repo[("Room storage")]
  node_loyalty_repo[("Loyalty storage")]
end

subgraph group_platform["Application setup"]
  node_app_config["Dependency wiring<br/>[AppConfig.java]"]
  node_app_main["Application entry<br/>[Main.java]"]
end

node_guest(("Guest"))
node_admin(("Administrator"))

node_guest -.->|"starts booking"| node_kiosk
node_kiosk -.->|"stages booking"| node_booking_session
node_kiosk -.->|"submits booking"| node_booking_service
node_booking_service -->|"saves guest"| node_guest_service
node_booking_service -->|"calculates price"| node_pricing
node_booking_service -->|"saves reservation"| node_reservation_service
node_admin -.->|"manages hotel"| node_admin_ui
node_admin_ui -.->|"authenticates"| node_auth
node_admin_ui -.->|"records payments"| node_payments
node_admin_ui -.->|"manages loyalty"| node_loyalty
node_admin_ui -.->|"reviews feedback"| node_feedback
node_admin_ui -.->|"manages waitlist"| node_waitlist
node_admin_ui -.->|"manages offers"| node_discounts
node_admin_ui -.->|"requests reports"| node_reporting
node_reporting -.->|"exports reports"| node_exporters
node_reservation_service -->|"persists reservations"| node_reservation_repo
node_reporting -->|"reads reservations"| node_reservation_repo
node_reporting -->|"reads room count"| node_room_repo
node_loyalty -->|"updates accounts"| node_loyalty_repo
node_reservation_service -.->|"handles records"| node_reservation_model
node_booking_service -->|"builds guest data"| node_guest_model
node_app_main -->|"initializes"| node_app_config
node_app_config -->|"creates controllers"| node_admin_ui
node_app_config -->|"creates controllers"| node_kiosk

click node_kiosk "https://github.com/hiruneshan/hotel-reservation-system/tree/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/controller/kiosk"
click node_booking_session "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/session/BookingSession.java"
click node_booking_service "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/BookingService.java"
click node_guest_service "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/GuestService.java"
click node_pricing "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/PricingService.java"
click node_reservation_service "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/ReservationService.java"
click node_admin_ui "https://github.com/hiruneshan/hotel-reservation-system/tree/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/controller/admin"
click node_auth "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/security/AuthService.java"
click node_payments "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/PaymentService.java"
click node_loyalty "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/LoyaltyService.java"
click node_feedback "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/FeedbackService.java"
click node_waitlist "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/WaitlistService.java"
click node_discounts "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/DiscountService.java"
click node_reporting "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/ReportingService.java"
click node_exporters "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/util/CSVExporter.java"
click node_reservation_model "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/model/Reservation.java"
click node_guest_model "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/model/Guest.java"
click node_room_model "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/model/Room.java"
click node_discount_model "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/model/Discount.java"
click node_loyalty_model "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/model/LoyaltyAccount.java"
click node_reservation_repo "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/repository/ReservationRepository.java"
click node_room_repo "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/repository/RoomRepository.java"
click node_loyalty_repo "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/repository/LoyaltyRepository.java"
click node_app_config "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/app/AppConfig.java"
click node_app_main "https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/app/Main.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_kiosk,node_booking_session toneBlue
class node_admin_ui,node_auth,node_payments,node_loyalty,node_feedback,node_waitlist,node_discounts,node_reporting,node_exporters toneAmber
class node_booking_service,node_guest_service,node_pricing,node_reservation_service toneMint
class node_reservation_model,node_guest_model,node_room_model,node_discount_model,node_loyalty_model,node_reservation_repo,node_room_repo,node_loyalty_repo toneRose
class node_app_config,node_app_main,node_guest,node_admin toneIndigo
```

## Components

### Guest booking

- [Kiosk booking screens](https://github.com/hiruneshan/hotel-reservation-system/tree/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/controller/kiosk): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/controller/kiosk`
- [Booking session](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/session/BookingSession.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/session/BookingSession.java`

### Hotel operations

- [Admin workflows](https://github.com/hiruneshan/hotel-reservation-system/tree/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/controller/admin): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/controller/admin`
- [Admin authentication](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/security/AuthService.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/security/AuthService.java`
- [Payments](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/PaymentService.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/PaymentService.java`
- [Loyalty](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/LoyaltyService.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/LoyaltyService.java`
- [Guest feedback](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/FeedbackService.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/FeedbackService.java`
- [Waitlist](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/WaitlistService.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/WaitlistService.java`
- [Discounts and promotions](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/DiscountService.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/DiscountService.java`
- [Reports and activity logs](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/ReportingService.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/ReportingService.java`
- [Report exports](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/util/CSVExporter.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/util/CSVExporter.java`

### Domain services

- [Booking orchestration](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/BookingService.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/BookingService.java`
- [Guest management](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/GuestService.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/GuestService.java`
- [Pricing](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/PricingService.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/PricingService.java`
- [Reservation lifecycle](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/ReservationService.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/ReservationService.java`

### Persistence and models

- [Reservation records](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/model/Reservation.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/model/Reservation.java`
- [Guest records](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/model/Guest.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/model/Guest.java`
- [Room inventory](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/model/Room.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/model/Room.java`
- [Discount records](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/model/Discount.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/model/Discount.java`
- [Loyalty accounts](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/model/LoyaltyAccount.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/model/LoyaltyAccount.java`
- [Reservation storage](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/repository/ReservationRepository.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/repository/ReservationRepository.java`
- [Room storage](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/repository/RoomRepository.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/repository/RoomRepository.java`
- [Loyalty storage](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/repository/LoyaltyRepository.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/repository/LoyaltyRepository.java`

### Application setup

- [Dependency wiring](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/app/AppConfig.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/app/AppConfig.java`
- [Application entry](https://github.com/hiruneshan/hotel-reservation-system/blob/master/RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/app/Main.java): `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/app/Main.java`

### Other components

- **Guest**
- **Administrator**

## Connections

- Guest → Kiosk booking screens: starts booking
- Kiosk booking screens → Booking session: stages booking (evidence: `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/controller/kiosk/KioskConfirmationController.java`)
- Kiosk booking screens → Booking orchestration: submits booking
- Booking orchestration → Guest management: saves guest (evidence: `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/BookingService.java`)
- Booking orchestration → Pricing: calculates price (evidence: `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/BookingService.java`)
- Booking orchestration → Reservation lifecycle: saves reservation (evidence: `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/BookingService.java`)
- Administrator → Admin workflows: manages hotel
- Admin workflows → Admin authentication: authenticates (evidence: `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/controller/admin/AdminDashboardController.java`)
- Admin workflows → Payments: records payments
- Admin workflows → Loyalty: manages loyalty
- Admin workflows → Guest feedback: reviews feedback
- Admin workflows → Waitlist: manages waitlist (evidence: `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/controller/admin/WaitlistController.java`)
- Admin workflows → Discounts and promotions: manages offers
- Admin workflows → Reports and activity logs: requests reports (evidence: `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/controller/admin/ReportsController.java`)
- Reports and activity logs → Report exports: exports reports
- Reservation lifecycle → Reservation storage: persists reservations (evidence: `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/ReservationService.java`)
- Reports and activity logs → Reservation storage: reads reservations (evidence: `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/ReportingService.java`)
- Reports and activity logs → Room storage: reads room count (evidence: `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/ReportingService.java`)
- Loyalty → Loyalty storage: updates accounts (evidence: `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/LoyaltyService.java`)
- Reservation lifecycle → Reservation records: handles records (evidence: `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/ReservationService.java`)
- Booking orchestration → Guest records: builds guest data (evidence: `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/service/BookingService.java`)
- Application entry → Dependency wiring: initializes (evidence: `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/app/Main.java`)
- Dependency wiring → Admin workflows: creates controllers (evidence: `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/app/AppConfig.java`)
- Dependency wiring → Kiosk booking screens: creates controllers (evidence: `RXH_GrandHotel/src/main/java/ca/seneca/apd545/RXHgrandhotel/app/AppConfig.java`)
