# omranekhedher-code/hotelia architecture

> Architecture diagram of the GitHub repository omranekhedher-code/hotelia, 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/omranekhedher-code/hotelia
- Repository: https://github.com/omranekhedher-code/hotelia

## Overview

Hotelia is a hotel-booking web application: guests browse rooms, make reservations, and submit payment; users and administrators also have portal pages for account and hotel-management tasks. The React router selects page components, while a Spring backend exposes API controllers backed by repositories and domain entities. The excerpts verify payment submission and several backend controller-to-repository interactions; most frontend-to-backend connections and the admin workflows are not shown, so those links are omitted rather than inferred.

Main entry points: [`src/App.jsx`](https://github.com/omranekhedher-code/hotelia/blob/main/src/App.jsx) (Route dispatcher), [`hotelia-backend/src/main/java/com/hotelia/hotelia_backend/Room.java`](https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/Room.java) (Rooms), [`hotelia-backend/src/main/java/com/hotelia/hotelia_backend/reservation/ReservationController.java`](https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/reservation/ReservationController.java) (Reservation API), [`hotelia-backend/src/main/java/com/hotelia/hotelia_backend/promotion/ReviewController.java`](https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/promotion/ReviewController.java) (Review API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["React application"]
  node_router["Route dispatcher<br/>[App.jsx]"]
  node_public["Public pages"]
  node_user_portal["User portal"]
  node_admin_portal["Admin portal"]
  node_payment_page["Payment page<br/>[payment.jsx]"]
end

subgraph group_hotel["Hotel inventory"]
  node_room_api["Room API"]
  node_rooms[("Rooms<br/>[Room.java]")]
  node_room_options["Room options"]
  node_option_api["Option API"]
  node_options[("Options<br/>[Option.java]")]
end

subgraph group_booking["Booking and payment"]
  node_reservation_api["Reservation API"]
  node_reservations[("Reservations<br/>[Reservation.java]")]
  node_payment_api["Payment API"]
  node_payments[("Payments<br/>[Payment.java]")]
end

subgraph group_accounts["Accounts and feedback"]
  node_auth_api["Authentication API"]
  node_users[("Users<br/>[User.java]")]
  node_review_api["Review API"]
  node_reviews[("Reviews<br/>[Review.java]")]
end

subgraph group_management["Promotions and admin"]
  node_promotion_api["Promotion API"]
  node_promotions[("Promotions<br/>[Promotion.java]")]
end

node_guest(("Guest"))

node_guest -.->|"opens app"| node_router
node_router -->|"routes to"| node_public
node_router -->|"routes to"| node_user_portal
node_router -->|"routes to"| node_admin_portal
node_payment_page -->|"posts payment"| node_payment_api
node_room_api -->|"reads and saves"| node_rooms
node_room_options -->|"checks room"| node_rooms
node_room_options -->|"checks and reads"| node_options
node_reservation_api -->|"reads and saves"| node_reservations
node_reservation_api -->|"validates room"| node_rooms
node_reservation_api -->|"validates user"| node_users
node_payment_api -->|"loads reservation"| node_reservations
node_payment_api -->|"reads and saves"| node_payments
node_auth_api -->|"reads and saves"| node_users
node_review_api -->|"reads and saves"| node_reviews
node_review_api -->|"checks user"| node_users
node_review_api -->|"checks room"| node_rooms
node_promotion_api -->|"reads and saves"| node_promotions

click node_router "https://github.com/omranekhedher-code/hotelia/blob/main/src/App.jsx"
click node_public "https://github.com/omranekhedher-code/hotelia/tree/main/src/pages"
click node_user_portal "https://github.com/omranekhedher-code/hotelia/tree/main/src/user/pages"
click node_admin_portal "https://github.com/omranekhedher-code/hotelia/tree/main/src/admin/pages"
click node_payment_page "https://github.com/omranekhedher-code/hotelia/blob/main/src/pages/payment.jsx"
click node_room_api "https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/RoomController.java"
click node_rooms "https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/Room.java"
click node_room_options "https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/roomoption/RoomOptionController.java"
click node_option_api "https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/option/OptionController.java"
click node_options "https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/option/Option.java"
click node_reservation_api "https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/reservation/ReservationController.java"
click node_reservations "https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/reservation/Reservation.java"
click node_payment_api "https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/payment/PaymentController.java"
click node_payments "https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/payment/Payment.java"
click node_auth_api "https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/AuthController.java"
click node_users "https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/user/User.java"
click node_review_api "https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/promotion/ReviewController.java"
click node_reviews "https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/promotion/Review.java"
click node_promotion_api "https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/promotion/PromotionController.java"
click node_promotions "https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/promotion/Promotion.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_router,node_public,node_user_portal,node_admin_portal,node_payment_page toneBlue
class node_room_api,node_rooms,node_room_options,node_option_api,node_options toneAmber
class node_reservation_api,node_reservations,node_payment_api,node_payments toneMint
class node_auth_api,node_users,node_review_api,node_reviews toneRose
class node_promotion_api,node_promotions,node_guest toneIndigo
```

## Components

### React application

- [Route dispatcher](https://github.com/omranekhedher-code/hotelia/blob/main/src/App.jsx): `src/App.jsx`
- [Public pages](https://github.com/omranekhedher-code/hotelia/tree/main/src/pages): `src/pages`
- [User portal](https://github.com/omranekhedher-code/hotelia/tree/main/src/user/pages): `src/user/pages`
- [Admin portal](https://github.com/omranekhedher-code/hotelia/tree/main/src/admin/pages): `src/admin/pages`
- [Payment page](https://github.com/omranekhedher-code/hotelia/blob/main/src/pages/payment.jsx): `src/pages/payment.jsx`

### Hotel inventory

- [Room API](https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/RoomController.java): `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/RoomController.java`
- [Rooms](https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/Room.java): `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/Room.java`
- [Room options](https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/roomoption/RoomOptionController.java): `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/roomoption/RoomOptionController.java`
- [Option API](https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/option/OptionController.java): `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/option/OptionController.java`
- [Options](https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/option/Option.java): `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/option/Option.java`

### Booking and payment

- [Reservation API](https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/reservation/ReservationController.java): `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/reservation/ReservationController.java`
- [Reservations](https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/reservation/Reservation.java): `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/reservation/Reservation.java`
- [Payment API](https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/payment/PaymentController.java): `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/payment/PaymentController.java`
- [Payments](https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/payment/Payment.java): `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/payment/Payment.java`

### Accounts and feedback

- [Authentication API](https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/AuthController.java): `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/AuthController.java`
- [Users](https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/user/User.java): `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/user/User.java`
- [Review API](https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/promotion/ReviewController.java): `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/promotion/ReviewController.java`
- [Reviews](https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/promotion/Review.java): `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/promotion/Review.java`

### Promotions and admin

- [Promotion API](https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/promotion/PromotionController.java): `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/promotion/PromotionController.java`
- [Promotions](https://github.com/omranekhedher-code/hotelia/blob/main/hotelia-backend/src/main/java/com/hotelia/hotelia_backend/promotion/Promotion.java): `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/promotion/Promotion.java`

### Other components

- **Guest**

## Connections

- Guest → Route dispatcher: opens app
- Route dispatcher → Public pages: routes to (evidence: `src/App.jsx`)
- Route dispatcher → User portal: routes to (evidence: `src/App.jsx`)
- Route dispatcher → Admin portal: routes to (evidence: `src/App.jsx`)
- Payment page → Payment API: posts payment (evidence: `src/pages/payment.jsx`)
- Room API → Rooms: reads and saves (evidence: `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/RoomController.java`)
- Room options → Rooms: checks room (evidence: `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/roomoption/RoomOptionController.java`)
- Room options → Options: checks and reads (evidence: `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/roomoption/RoomOptionController.java`)
- Reservation API → Reservations: reads and saves (evidence: `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/reservation/ReservationController.java`)
- Reservation API → Rooms: validates room (evidence: `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/reservation/ReservationController.java`)
- Reservation API → Users: validates user (evidence: `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/reservation/ReservationController.java`)
- Payment API → Reservations: loads reservation (evidence: `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/payment/PaymentController.java`)
- Payment API → Payments: reads and saves (evidence: `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/payment/PaymentController.java`)
- Authentication API → Users: reads and saves (evidence: `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/AuthController.java`)
- Review API → Reviews: reads and saves (evidence: `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/promotion/ReviewController.java`)
- Review API → Users: checks user (evidence: `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/promotion/ReviewController.java`)
- Review API → Rooms: checks room (evidence: `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/promotion/ReviewController.java`)
- Promotion API → Promotions: reads and saves (evidence: `hotelia-backend/src/main/java/com/hotelia/hotelia_backend/promotion/PromotionController.java`)
