# felix202422/hotel_management_system architecture

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

- Interactive diagram: https://gitdiagram.com/felix202422/hotel_management_system
- Repository: https://github.com/felix202422/hotel_management_system

## Overview

Fizzo Hotels is a full-stack hotel reservation and operations system: visitors browse rooms or book, guests self-serve, and staff manage reservations and hotel operations through role-specific workspaces. The frontend routes users to those experiences and its shared API client communicates with a Spring Boot backend; reservation logic validates availability, prices stays, and persists reservation and room changes. The README also documents finance, housekeeping, maintenance, reports, notifications, and audit capabilities. Some subsystems are represented at directory level because their implementation was not sampled; links are limited to documented or indexed relationships.

Main entry points: [`backend/src/main/java/com/fizzohotels/repository`](https://github.com/felix202422/hotel_management_system/tree/main/backend/src/main/java/com/fizzohotels/repository) (JPA repositories), [`frontend/src/api/axios.js`](https://github.com/felix202422/hotel_management_system/blob/main/frontend/src/api/axios.js) (API client), [`frontend/src/App.jsx`](https://github.com/felix202422/hotel_management_system/blob/main/frontend/src/App.jsx) (Route application), [`backend/src/main/java/com/fizzohotels/controller`](https://github.com/felix202422/hotel_management_system/tree/main/backend/src/main/java/com/fizzohotels/controller) (REST controllers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experiences"]
  node_app["Route application<br/>[App.jsx]"]
  node_public["Visitor site"]
  node_guestportal["Guest portal"]
  node_workspaces["Role workspaces"]
  node_client["API client<br/>[axios.js]"]
end

subgraph group_api["Hotel API"]
  node_controllers["REST controllers"]
  node_auth["JWT security"]
end

subgraph group_operations["Hotel operations"]
  node_reservation["Reservation workflow"]
  node_rooms["Room management<br/>[RoomService.java]"]
  node_dashboard["Dashboard analytics"]
  node_reports["Reports"]
  node_hotelops["Hotel operations"]
end

subgraph group_data["Persistence"]
  node_repos["JPA repositories"]
  node_postgres[("PostgreSQL")]
end

node_visitor(("Visitor"))
node_guest(("Guest"))
node_staff(("Hotel staff"))

node_visitor -->|"browses"| node_public
node_guest -->|"books and tracks"| node_guestportal
node_staff -->|"manages hotel"| node_workspaces
node_app -->|"routes to"| node_public
node_app -->|"routes to"| node_guestportal
node_app -->|"routes to"| node_workspaces
node_public -.->|"requests data"| node_client
node_guestportal -.->|"requests data"| node_client
node_workspaces -->|"requests data"| node_client
node_client -->|"HTTP API"| node_controllers
node_controllers -->|"delegates reservations"| node_reservation
node_reservation -->|"reads and writes"| node_repos
node_rooms -->|"uses room data"| node_repos
node_dashboard -->|"aggregates data"| node_repos
node_reports -->|"queries reports"| node_repos
node_auth -->|"loads accounts"| node_repos
node_controllers -.->|"exposes capabilities"| node_hotelops
node_repos -.->|"persists entities"| node_postgres

click node_app "https://github.com/felix202422/hotel_management_system/blob/main/frontend/src/App.jsx"
click node_public "https://github.com/felix202422/hotel_management_system/tree/main/frontend/src/pages/visitor"
click node_guestportal "https://github.com/felix202422/hotel_management_system/tree/main/frontend/src/pages/guest"
click node_workspaces "https://github.com/felix202422/hotel_management_system/tree/main/frontend/src/pages"
click node_client "https://github.com/felix202422/hotel_management_system/blob/main/frontend/src/api/axios.js"
click node_controllers "https://github.com/felix202422/hotel_management_system/tree/main/backend/src/main/java/com/fizzohotels/controller"
click node_auth "https://github.com/felix202422/hotel_management_system/tree/main/backend/src/main/java/com/fizzohotels/security"
click node_reservation "https://github.com/felix202422/hotel_management_system/blob/main/backend/src/main/java/com/fizzohotels/service/ReservationService.java"
click node_rooms "https://github.com/felix202422/hotel_management_system/blob/main/backend/src/main/java/com/fizzohotels/service/RoomService.java"
click node_dashboard "https://github.com/felix202422/hotel_management_system/blob/main/backend/src/main/java/com/fizzohotels/service/DashboardService.java"
click node_reports "https://github.com/felix202422/hotel_management_system/blob/main/backend/src/main/java/com/fizzohotels/controller/ReportController.java"
click node_hotelops "https://github.com/felix202422/hotel_management_system/tree/main/backend/src/main/java/com/fizzohotels"
click node_repos "https://github.com/felix202422/hotel_management_system/tree/main/backend/src/main/java/com/fizzohotels/repository"

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_public,node_guestportal,node_workspaces,node_client toneBlue
class node_controllers,node_auth toneAmber
class node_reservation,node_rooms,node_dashboard,node_reports,node_hotelops toneMint
class node_repos,node_postgres toneRose
class node_visitor,node_guest,node_staff toneIndigo
```

## Components

### Web experiences

- [Route application](https://github.com/felix202422/hotel_management_system/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Visitor site](https://github.com/felix202422/hotel_management_system/tree/main/frontend/src/pages/visitor): `frontend/src/pages/visitor`
- [Guest portal](https://github.com/felix202422/hotel_management_system/tree/main/frontend/src/pages/guest): `frontend/src/pages/guest`
- [Role workspaces](https://github.com/felix202422/hotel_management_system/tree/main/frontend/src/pages): `frontend/src/pages`
- [API client](https://github.com/felix202422/hotel_management_system/blob/main/frontend/src/api/axios.js): `frontend/src/api/axios.js`

### Hotel API

- [REST controllers](https://github.com/felix202422/hotel_management_system/tree/main/backend/src/main/java/com/fizzohotels/controller): `backend/src/main/java/com/fizzohotels/controller`
- [JWT security](https://github.com/felix202422/hotel_management_system/tree/main/backend/src/main/java/com/fizzohotels/security): `backend/src/main/java/com/fizzohotels/security`

### Hotel operations

- [Reservation workflow](https://github.com/felix202422/hotel_management_system/blob/main/backend/src/main/java/com/fizzohotels/service/ReservationService.java): `backend/src/main/java/com/fizzohotels/service/ReservationService.java`
- [Room management](https://github.com/felix202422/hotel_management_system/blob/main/backend/src/main/java/com/fizzohotels/service/RoomService.java): `backend/src/main/java/com/fizzohotels/service/RoomService.java`
- [Dashboard analytics](https://github.com/felix202422/hotel_management_system/blob/main/backend/src/main/java/com/fizzohotels/service/DashboardService.java): `backend/src/main/java/com/fizzohotels/service/DashboardService.java`
- [Reports](https://github.com/felix202422/hotel_management_system/blob/main/backend/src/main/java/com/fizzohotels/controller/ReportController.java): `backend/src/main/java/com/fizzohotels/controller/ReportController.java`
- [Hotel operations](https://github.com/felix202422/hotel_management_system/tree/main/backend/src/main/java/com/fizzohotels): `backend/src/main/java/com/fizzohotels`

### Persistence

- [JPA repositories](https://github.com/felix202422/hotel_management_system/tree/main/backend/src/main/java/com/fizzohotels/repository): `backend/src/main/java/com/fizzohotels/repository`
- **PostgreSQL**

### Other components

- **Visitor**
- **Guest**
- **Hotel staff**

## Connections

- Visitor → Visitor site: browses (evidence: `README.md`)
- Guest → Guest portal: books and tracks (evidence: `README.md`)
- Hotel staff → Role workspaces: manages hotel (evidence: `README.md`)
- Route application → Visitor site: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Guest portal: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Role workspaces: routes to (evidence: `frontend/src/App.jsx`)
- Visitor site → API client: requests data
- Guest portal → API client: requests data
- Role workspaces → API client: requests data (evidence: `frontend/src/pages/housekeeping/HousekeepingTasks.jsx`)
- API client → REST controllers: HTTP API (evidence: `README.md`)
- REST controllers → Reservation workflow: delegates reservations (evidence: `backend/src/main/java/com/fizzohotels/controller/ReservationController.java`)
- Reservation workflow → JPA repositories: reads and writes (evidence: `backend/src/main/java/com/fizzohotels/service/ReservationService.java`)
- Room management → JPA repositories: uses room data (evidence: `backend/src/main/java/com/fizzohotels/service/RoomService.java`)
- Dashboard analytics → JPA repositories: aggregates data (evidence: `backend/src/main/java/com/fizzohotels/service/DashboardService.java`)
- Reports → JPA repositories: queries reports (evidence: `backend/src/main/java/com/fizzohotels/controller/ReportController.java`)
- JWT security → JPA repositories: loads accounts (evidence: `backend/src/main/java/com/fizzohotels/security/CustomUserDetailsService.java`)
- REST controllers → Hotel operations: exposes capabilities (evidence: `backend/src/main/java/com/fizzohotels/controller/ReportController.java`)
- JPA repositories → PostgreSQL: persists entities
