# lokesh701449/hotelbooking_site architecture

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

- Interactive diagram: https://gitdiagram.com/lokesh701449/hotelbooking_site
- Repository: https://github.com/lokesh701449/hotelbooking_site

## Overview

AuraStay is a hotel-reservation application with a React frontend and Spring Boot REST backend. Customers browse hotels and room availability, apply promotions, submit a reservation with a simulated payment method, and can later review or cancel bookings; administrators manage hotels, rooms, promotions, and reservations. The graph groups frontend pages and API clients with backend domain services, security, and persistence. Backend implementation details were not sampled, so backend relationships beyond documented API and architecture statements are omitted or marked unverified.

Main entry points: [`frontend/src/App.jsx`](https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/App.jsx) (App routing), [`src/main/java/com/example/DemoHotelBooking/controller`](https://github.com/lokesh701449/hotelbooking_site/tree/main/src/main/java/com/example/DemoHotelBooking/controller) (REST controllers), [`frontend/src/services/api.js`](https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/services/api.js) (HTTP API client), [`frontend/src/services/hotelService.js`](https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/services/hotelService.js) (Hotel and room clients)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_app["App routing<br/>[App.jsx]"]
  node_authui["Authentication UI<br/>[Register.jsx]"]
  node_browse["Hotel browsing<br/>[Hotels.jsx]"]
  node_hotelview["Hotel details<br/>[HotelDetails.jsx]"]
  node_checkout["Reservation checkout<br/>[Checkout.jsx]"]
  node_history["Booking history"]
  node_offers["Promotions view<br/>[Promotions.jsx]"]
  node_adminui["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_authstate["Auth context<br/>[AuthContext.jsx]"]
  node_api_client["HTTP API client<br/>[api.js]"]
  node_catalog_client["Hotel and room clients<br/>[hotelService.js]"]
  node_booking_client["Booking client<br/>[bookingService.js]"]
  node_promotion_client["Promotion client"]
  node_auth_client["Auth client<br/>[authService.js]"]
end

subgraph group_api["API and domain"]
  node_controllers["REST controllers"]
  node_booking_domain["Booking and payment"]
  node_catalog_domain["Hotel and room services<br/>[HotelService.java]"]
  node_promotion_domain["Promotion service"]
end

subgraph group_identity["Identity and security"]
  node_auth_domain["Auth service<br/>[AuthService.java]"]
  node_security["JWT security"]
end

subgraph group_state["Persistence and integrations"]
  node_database[("H2 database")]
  node_entities["Booking domain records<br/>[Booking.java]"]
  node_email["Confirmation email<br/>[EmailService.java]"]
end

node_customer(("Customer"))
node_admin(("Administrator"))

node_customer -->|"uses"| node_app
node_admin -->|"uses"| node_app
node_app -->|"routes"| node_authui
node_app -->|"routes"| node_browse
node_app -->|"routes"| node_hotelview
node_app -->|"routes"| node_checkout
node_app -->|"routes"| node_history
node_app -->|"routes"| node_offers
node_app -->|"routes"| node_adminui
node_app -->|"provides auth"| node_authstate
node_authstate -->|"calls"| node_auth_client
node_auth_client -->|"sends requests"| node_api_client
node_browse -->|"loads hotels"| node_catalog_client
node_hotelview -->|"loads details"| node_catalog_client
node_checkout -->|"submits booking"| node_booking_client
node_checkout -->|"checks coupon"| node_promotion_client
node_checkout -->|"loads room"| node_catalog_client
node_history -->|"loads bookings"| node_booking_client
node_adminui -->|"loads records"| node_booking_client
node_adminui -->|"manages inventory"| node_catalog_client
node_adminui -->|"creates offers"| node_promotion_client
node_catalog_client -->|"sends requests"| node_api_client
node_booking_client -->|"sends requests"| node_api_client
node_promotion_client -->|"sends requests"| node_api_client
node_api_client -->|"calls REST API"| node_controllers
node_controllers -.->|"delegates"| node_booking_domain
node_controllers -.->|"delegates"| node_catalog_domain
node_controllers -.->|"delegates"| node_promotion_domain
node_controllers -.->|"delegates"| node_auth_domain
node_auth_domain -.->|"uses JWT"| node_security
node_booking_domain -.->|"manages"| node_entities
node_catalog_domain -.->|"persists inventory"| node_database
node_booking_domain -.->|"persists bookings"| node_database
node_promotion_domain -.->|"persists offers"| node_database
node_booking_domain -.->|"dispatches confirmation"| node_email

click node_app "https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/App.jsx"
click node_authui "https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/pages/Register.jsx"
click node_browse "https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/pages/Hotels.jsx"
click node_hotelview "https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/pages/HotelDetails.jsx"
click node_checkout "https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/pages/Checkout.jsx"
click node_history "https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/pages/BookingsHistory.jsx"
click node_offers "https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/pages/Promotions.jsx"
click node_adminui "https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/pages/AdminDashboard.jsx"
click node_authstate "https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/context/AuthContext.jsx"
click node_api_client "https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/services/api.js"
click node_catalog_client "https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/services/hotelService.js"
click node_booking_client "https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/services/bookingService.js"
click node_promotion_client "https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/services/promotionService.js"
click node_auth_client "https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/services/authService.js"
click node_controllers "https://github.com/lokesh701449/hotelbooking_site/tree/main/src/main/java/com/example/DemoHotelBooking/controller"
click node_booking_domain "https://github.com/lokesh701449/hotelbooking_site/blob/main/src/main/java/com/example/DemoHotelBooking/service/BookingService.java"
click node_catalog_domain "https://github.com/lokesh701449/hotelbooking_site/blob/main/src/main/java/com/example/DemoHotelBooking/service/HotelService.java"
click node_promotion_domain "https://github.com/lokesh701449/hotelbooking_site/blob/main/src/main/java/com/example/DemoHotelBooking/service/PromotionService.java"
click node_auth_domain "https://github.com/lokesh701449/hotelbooking_site/blob/main/src/main/java/com/example/DemoHotelBooking/service/AuthService.java"
click node_security "https://github.com/lokesh701449/hotelbooking_site/blob/main/src/main/java/com/example/DemoHotelBooking/security/WebSecurityConfig.java"
click node_entities "https://github.com/lokesh701449/hotelbooking_site/blob/main/src/main/java/com/example/DemoHotelBooking/entity/Booking.java"
click node_email "https://github.com/lokesh701449/hotelbooking_site/blob/main/src/main/java/com/example/DemoHotelBooking/service/EmailService.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_app,node_authui,node_browse,node_hotelview,node_checkout,node_history,node_offers,node_adminui,node_authstate,node_api_client,node_catalog_client,node_booking_client,node_promotion_client,node_auth_client toneBlue
class node_controllers,node_booking_domain,node_catalog_domain,node_promotion_domain toneAmber
class node_auth_domain,node_security toneMint
class node_database,node_entities,node_email toneRose
class node_customer,node_admin toneIndigo
```

## Components

### Web experience

- [App routing](https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Authentication UI](https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/pages/Register.jsx): `frontend/src/pages/Register.jsx`
- [Hotel browsing](https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/pages/Hotels.jsx): `frontend/src/pages/Hotels.jsx`
- [Hotel details](https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/pages/HotelDetails.jsx): `frontend/src/pages/HotelDetails.jsx`
- [Reservation checkout](https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/pages/Checkout.jsx): `frontend/src/pages/Checkout.jsx`
- [Booking history](https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/pages/BookingsHistory.jsx): `frontend/src/pages/BookingsHistory.jsx`
- [Promotions view](https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/pages/Promotions.jsx): `frontend/src/pages/Promotions.jsx`
- [Admin dashboard](https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/pages/AdminDashboard.jsx): `frontend/src/pages/AdminDashboard.jsx`
- [Auth context](https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [HTTP API client](https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Hotel and room clients](https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/services/hotelService.js): `frontend/src/services/hotelService.js`
- [Booking client](https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/services/bookingService.js): `frontend/src/services/bookingService.js`
- [Promotion client](https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/services/promotionService.js): `frontend/src/services/promotionService.js`
- [Auth client](https://github.com/lokesh701449/hotelbooking_site/blob/main/frontend/src/services/authService.js): `frontend/src/services/authService.js`

### API and domain

- [REST controllers](https://github.com/lokesh701449/hotelbooking_site/tree/main/src/main/java/com/example/DemoHotelBooking/controller): `src/main/java/com/example/DemoHotelBooking/controller`
- [Booking and payment](https://github.com/lokesh701449/hotelbooking_site/blob/main/src/main/java/com/example/DemoHotelBooking/service/BookingService.java): `src/main/java/com/example/DemoHotelBooking/service/BookingService.java`
- [Hotel and room services](https://github.com/lokesh701449/hotelbooking_site/blob/main/src/main/java/com/example/DemoHotelBooking/service/HotelService.java): `src/main/java/com/example/DemoHotelBooking/service/HotelService.java`
- [Promotion service](https://github.com/lokesh701449/hotelbooking_site/blob/main/src/main/java/com/example/DemoHotelBooking/service/PromotionService.java): `src/main/java/com/example/DemoHotelBooking/service/PromotionService.java`

### Identity and security

- [Auth service](https://github.com/lokesh701449/hotelbooking_site/blob/main/src/main/java/com/example/DemoHotelBooking/service/AuthService.java): `src/main/java/com/example/DemoHotelBooking/service/AuthService.java`
- [JWT security](https://github.com/lokesh701449/hotelbooking_site/blob/main/src/main/java/com/example/DemoHotelBooking/security/WebSecurityConfig.java): `src/main/java/com/example/DemoHotelBooking/security/WebSecurityConfig.java`

### Persistence and integrations

- **H2 database**
- [Booking domain records](https://github.com/lokesh701449/hotelbooking_site/blob/main/src/main/java/com/example/DemoHotelBooking/entity/Booking.java): `src/main/java/com/example/DemoHotelBooking/entity/Booking.java`
- [Confirmation email](https://github.com/lokesh701449/hotelbooking_site/blob/main/src/main/java/com/example/DemoHotelBooking/service/EmailService.java): `src/main/java/com/example/DemoHotelBooking/service/EmailService.java`

### Other components

- **Customer**
- **Administrator**

## Connections

- Customer → App routing: uses (evidence: `frontend/src/App.jsx`)
- Administrator → App routing: uses (evidence: `frontend/src/App.jsx`)
- App routing → Authentication UI: routes (evidence: `frontend/src/App.jsx`)
- App routing → Hotel browsing: routes (evidence: `frontend/src/App.jsx`)
- App routing → Hotel details: routes (evidence: `frontend/src/App.jsx`)
- App routing → Reservation checkout: routes (evidence: `frontend/src/App.jsx`)
- App routing → Booking history: routes (evidence: `frontend/src/App.jsx`)
- App routing → Promotions view: routes (evidence: `frontend/src/App.jsx`)
- App routing → Admin dashboard: routes (evidence: `frontend/src/App.jsx`)
- App routing → Auth context: provides auth (evidence: `frontend/src/App.jsx`)
- Auth context → Auth client: calls (evidence: `frontend/src/context/AuthContext.jsx`)
- Auth client → HTTP API client: sends requests (evidence: `frontend/src/services/authService.js`)
- Hotel browsing → Hotel and room clients: loads hotels (evidence: `frontend/src/pages/Hotels.jsx`)
- Hotel details → Hotel and room clients: loads details (evidence: `frontend/src/pages/HotelDetails.jsx`)
- Reservation checkout → Booking client: submits booking (evidence: `frontend/src/pages/Checkout.jsx`)
- Reservation checkout → Promotion client: checks coupon (evidence: `frontend/src/pages/Checkout.jsx`)
- Reservation checkout → Hotel and room clients: loads room (evidence: `frontend/src/pages/Checkout.jsx`)
- Booking history → Booking client: loads bookings (evidence: `frontend/src/pages/BookingsHistory.jsx`)
- Admin dashboard → Booking client: loads records (evidence: `frontend/src/pages/AdminDashboard.jsx`)
- Admin dashboard → Hotel and room clients: manages inventory (evidence: `frontend/src/pages/AdminDashboard.jsx`)
- Admin dashboard → Promotion client: creates offers (evidence: `frontend/src/pages/AdminDashboard.jsx`)
- Hotel and room clients → HTTP API client: sends requests (evidence: `frontend/src/services/hotelService.js`)
- Booking client → HTTP API client: sends requests (evidence: `frontend/src/services/bookingService.js`)
- Promotion client → HTTP API client: sends requests (evidence: `frontend/src/services/promotionService.js`)
- HTTP API client → REST controllers: calls REST API (evidence: `README.md`)
- REST controllers → Booking and payment: delegates
- REST controllers → Hotel and room services: delegates
- REST controllers → Promotion service: delegates
- REST controllers → Auth service: delegates
- Auth service → JWT security: uses JWT
- Booking and payment → Booking domain records: manages
- Hotel and room services → H2 database: persists inventory
- Booking and payment → H2 database: persists bookings
- Promotion service → H2 database: persists offers
- Booking and payment → Confirmation email: dispatches confirmation
