# cyberfox2005/hotel-manager architecture

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

- Interactive diagram: https://gitdiagram.com/cyberfox2005/hotel-manager
- Repository: https://github.com/cyberfox2005/hotel-manager

## Overview

This is a hotel-management application: staff use a React interface to review dashboard statistics and manage rooms, clients, and reservations; the interface sends JSON requests to Java servlet endpoints, which delegate operations to DAOs and a MySQL connection. Reservation workflows include selecting clients and available rooms, creating bookings, and changing booking status. The frontend also supports table filtering, sorting, pagination, CSV export, and locally persisted settings. Backend servlet and DAO relationships are evidenced by the source index; several domain capabilities are documented by the API client rather than sampled end-to-end.

Main entry points: [`src/App.jsx`](https://github.com/cyberfox2005/hotel-manager/blob/main/src/App.jsx) (App routing), [`src/services/api.js`](https://github.com/cyberfox2005/hotel-manager/blob/main/src/services/api.js) (JSON API client), [`src/hooks/useTableData.js`](https://github.com/cyberfox2005/hotel-manager/blob/main/src/hooks/useTableData.js) (Table data), [`hotel-backend/src/main/java/com/hotel/util/DBConnection.java`](https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/util/DBConnection.java) (Database connection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Hotel interface"]
  node_app["App routing<br/>[App.jsx]"]
  node_dashboard_ui["Dashboard<br/>[Dashboard.jsx]"]
  node_rooms_ui["Rooms<br/>[Rooms.jsx]"]
  node_clients_ui["Clients<br/>[Clients.jsx]"]
  node_reservations_ui["Reservations<br/>[Reservations.jsx]"]
  node_settings_ui["Settings<br/>[Settings.jsx]"]
end

subgraph group_frontend_support["Interface support"]
  node_api_client["JSON API client<br/>[api.js]"]
  node_table_hook["Table data<br/>[useTableData.js]"]
  node_table_utils["Table utilities<br/>[tableUtils.js]"]
  node_settings_hook["Settings hook<br/>[useSettings.js]"]
  node_settings_store[("Local settings<br/>[settings.js]")]
end

subgraph group_server["HTTP operations"]
  node_client_servlet["Client endpoint<br/>[ClientServlet.java]"]
  node_room_servlet["Room endpoint<br/>[RoomServlet.java]"]
  node_reservation_servlet["Reservation endpoint"]
  node_dashboard_servlet["Dashboard endpoint"]
  node_json_util["JSON handling<br/>[JsonUtil.java]"]
end

subgraph group_data["Domain and persistence"]
  node_client_dao["Client DAO<br/>[ClientDAO.java]"]
  node_room_dao["Room DAO<br/>[RoomDAO.java]"]
  node_reservation_dao["Reservation DAO"]
  node_dashboard_dao["Dashboard DAO<br/>[DashboardDAO.java]"]
  node_client_model["Client model<br/>[Client.java]"]
  node_room_model["Room model<br/>[Room.java]"]
  node_reservation_model["Reservation model<br/>[Reservation.java]"]
  node_db_connection["Database connection<br/>[DBConnection.java]"]
end

node_staff(("Hotel staff"))
node_http_api{{"Hotel HTTP API"}}
node_mysql[("MySQL database")]

node_staff -->|"uses"| node_app
node_app -->|"routes to"| node_dashboard_ui
node_app -->|"routes to"| node_rooms_ui
node_app -->|"routes to"| node_clients_ui
node_app -->|"routes to"| node_reservations_ui
node_app -->|"routes to"| node_settings_ui
node_dashboard_ui -->|"requests stats"| node_api_client
node_rooms_ui -->|"manages rooms"| node_api_client
node_clients_ui -->|"manages clients"| node_api_client
node_clients_ui -->|"loads reservation history"| node_api_client
node_reservations_ui -->|"manages bookings"| node_api_client
node_settings_ui -->|"updates settings"| node_settings_hook
node_clients_ui -->|"uses table state"| node_table_hook
node_rooms_ui -->|"uses table state"| node_table_hook
node_reservations_ui -->|"uses table state"| node_table_hook
node_table_hook -->|"sorts with"| node_table_utils
node_table_hook -->|"reads defaults"| node_settings_store
node_settings_hook -->|"loads and saves"| node_settings_store
node_api_client -->|"sends JSON requests"| node_http_api
node_http_api -.->|"routes room requests"| node_room_servlet
node_http_api -.->|"routes client requests"| node_client_servlet
node_http_api -.->|"routes booking requests"| node_reservation_servlet
node_http_api -.->|"routes stats requests"| node_dashboard_servlet
node_client_servlet -->|"delegates to"| node_client_dao
node_room_servlet -->|"delegates to"| node_room_dao
node_reservation_servlet -->|"delegates to"| node_reservation_dao
node_dashboard_servlet -->|"delegates to"| node_dashboard_dao
node_client_servlet -->|"serializes responses"| node_json_util
node_room_servlet -->|"serializes responses"| node_json_util
node_reservation_servlet -->|"serializes responses"| node_json_util
node_dashboard_servlet -->|"serializes responses"| node_json_util
node_client_dao -->|"uses connection"| node_db_connection
node_room_dao -->|"uses connection"| node_db_connection
node_reservation_dao -->|"uses connection"| node_db_connection
node_dashboard_dao -->|"uses connection"| node_db_connection
node_client_dao -->|"maps clients"| node_client_model
node_room_dao -->|"maps rooms"| node_room_model
node_reservation_dao -->|"maps reservations"| node_reservation_model
node_reservation_dao -->|"uses room data"| node_room_model
node_db_connection -->|"connects to"| node_mysql

click node_app "https://github.com/cyberfox2005/hotel-manager/blob/main/src/App.jsx"
click node_dashboard_ui "https://github.com/cyberfox2005/hotel-manager/blob/main/src/components/Dashboard/Dashboard.jsx"
click node_rooms_ui "https://github.com/cyberfox2005/hotel-manager/blob/main/src/components/Rooms/Rooms.jsx"
click node_clients_ui "https://github.com/cyberfox2005/hotel-manager/blob/main/src/components/Clients/Clients.jsx"
click node_reservations_ui "https://github.com/cyberfox2005/hotel-manager/blob/main/src/components/Reservations/Reservations.jsx"
click node_settings_ui "https://github.com/cyberfox2005/hotel-manager/blob/main/src/components/Settings/Settings.jsx"
click node_api_client "https://github.com/cyberfox2005/hotel-manager/blob/main/src/services/api.js"
click node_table_hook "https://github.com/cyberfox2005/hotel-manager/blob/main/src/hooks/useTableData.js"
click node_table_utils "https://github.com/cyberfox2005/hotel-manager/blob/main/src/utils/tableUtils.js"
click node_settings_hook "https://github.com/cyberfox2005/hotel-manager/blob/main/src/hooks/useSettings.js"
click node_settings_store "https://github.com/cyberfox2005/hotel-manager/blob/main/src/utils/settings.js"
click node_client_servlet "https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/servlet/ClientServlet.java"
click node_room_servlet "https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/servlet/RoomServlet.java"
click node_reservation_servlet "https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/servlet/ReservationServlet.java"
click node_dashboard_servlet "https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/servlet/DashboardServlet.java"
click node_json_util "https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/util/JsonUtil.java"
click node_client_dao "https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/dao/ClientDAO.java"
click node_room_dao "https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/dao/RoomDAO.java"
click node_reservation_dao "https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/dao/ReservationDAO.java"
click node_dashboard_dao "https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/dao/DashboardDAO.java"
click node_client_model "https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/model/Client.java"
click node_room_model "https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/model/Room.java"
click node_reservation_model "https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/model/Reservation.java"
click node_db_connection "https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/util/DBConnection.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_dashboard_ui,node_rooms_ui,node_clients_ui,node_reservations_ui,node_settings_ui toneBlue
class node_api_client,node_table_hook,node_table_utils,node_settings_hook,node_settings_store,node_mysql toneAmber
class node_client_servlet,node_room_servlet,node_reservation_servlet,node_dashboard_servlet,node_json_util,node_http_api toneMint
class node_client_dao,node_room_dao,node_reservation_dao,node_dashboard_dao,node_client_model,node_room_model,node_reservation_model,node_db_connection toneRose
class node_staff toneIndigo
```

## Components

### Hotel interface

- [App routing](https://github.com/cyberfox2005/hotel-manager/blob/main/src/App.jsx): `src/App.jsx`
- [Dashboard](https://github.com/cyberfox2005/hotel-manager/blob/main/src/components/Dashboard/Dashboard.jsx): `src/components/Dashboard/Dashboard.jsx`
- [Rooms](https://github.com/cyberfox2005/hotel-manager/blob/main/src/components/Rooms/Rooms.jsx): `src/components/Rooms/Rooms.jsx`
- [Clients](https://github.com/cyberfox2005/hotel-manager/blob/main/src/components/Clients/Clients.jsx): `src/components/Clients/Clients.jsx`
- [Reservations](https://github.com/cyberfox2005/hotel-manager/blob/main/src/components/Reservations/Reservations.jsx): `src/components/Reservations/Reservations.jsx`
- [Settings](https://github.com/cyberfox2005/hotel-manager/blob/main/src/components/Settings/Settings.jsx): `src/components/Settings/Settings.jsx`

### Interface support

- [JSON API client](https://github.com/cyberfox2005/hotel-manager/blob/main/src/services/api.js): `src/services/api.js`
- [Table data](https://github.com/cyberfox2005/hotel-manager/blob/main/src/hooks/useTableData.js): `src/hooks/useTableData.js`
- [Table utilities](https://github.com/cyberfox2005/hotel-manager/blob/main/src/utils/tableUtils.js): `src/utils/tableUtils.js`
- [Settings hook](https://github.com/cyberfox2005/hotel-manager/blob/main/src/hooks/useSettings.js): `src/hooks/useSettings.js`
- [Local settings](https://github.com/cyberfox2005/hotel-manager/blob/main/src/utils/settings.js): `src/utils/settings.js`

### HTTP operations

- [Client endpoint](https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/servlet/ClientServlet.java): `hotel-backend/src/main/java/com/hotel/servlet/ClientServlet.java`
- [Room endpoint](https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/servlet/RoomServlet.java): `hotel-backend/src/main/java/com/hotel/servlet/RoomServlet.java`
- [Reservation endpoint](https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/servlet/ReservationServlet.java): `hotel-backend/src/main/java/com/hotel/servlet/ReservationServlet.java`
- [Dashboard endpoint](https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/servlet/DashboardServlet.java): `hotel-backend/src/main/java/com/hotel/servlet/DashboardServlet.java`
- [JSON handling](https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/util/JsonUtil.java): `hotel-backend/src/main/java/com/hotel/util/JsonUtil.java`

### Domain and persistence

- [Client DAO](https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/dao/ClientDAO.java): `hotel-backend/src/main/java/com/hotel/dao/ClientDAO.java`
- [Room DAO](https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/dao/RoomDAO.java): `hotel-backend/src/main/java/com/hotel/dao/RoomDAO.java`
- [Reservation DAO](https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/dao/ReservationDAO.java): `hotel-backend/src/main/java/com/hotel/dao/ReservationDAO.java`
- [Dashboard DAO](https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/dao/DashboardDAO.java): `hotel-backend/src/main/java/com/hotel/dao/DashboardDAO.java`
- [Client model](https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/model/Client.java): `hotel-backend/src/main/java/com/hotel/model/Client.java`
- [Room model](https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/model/Room.java): `hotel-backend/src/main/java/com/hotel/model/Room.java`
- [Reservation model](https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/model/Reservation.java): `hotel-backend/src/main/java/com/hotel/model/Reservation.java`
- [Database connection](https://github.com/cyberfox2005/hotel-manager/blob/main/hotel-backend/src/main/java/com/hotel/util/DBConnection.java): `hotel-backend/src/main/java/com/hotel/util/DBConnection.java`

### Other components

- **Hotel staff**
- **Hotel HTTP API**
- **MySQL database**

## Connections

- Hotel staff → App routing: uses (evidence: `src/App.jsx`)
- App routing → Dashboard: routes to (evidence: `src/App.jsx`)
- App routing → Rooms: routes to (evidence: `src/App.jsx`)
- App routing → Clients: routes to (evidence: `src/App.jsx`)
- App routing → Reservations: routes to (evidence: `src/App.jsx`)
- App routing → Settings: routes to (evidence: `src/App.jsx`)
- Dashboard → JSON API client: requests stats (evidence: `src/components/Dashboard/Dashboard.jsx`)
- Rooms → JSON API client: manages rooms (evidence: `src/components/Rooms/Rooms.jsx`)
- Clients → JSON API client: manages clients (evidence: `src/components/Clients/Clients.jsx`)
- Clients → JSON API client: loads reservation history (evidence: `src/components/Clients/Clients.jsx`)
- Reservations → JSON API client: manages bookings (evidence: `src/components/Reservations/Reservations.jsx`)
- Settings → Settings hook: updates settings (evidence: `src/components/Settings/Settings.jsx`)
- Clients → Table data: uses table state (evidence: `src/components/Clients/Clients.jsx`)
- Rooms → Table data: uses table state (evidence: `src/components/Rooms/Rooms.jsx`)
- Reservations → Table data: uses table state (evidence: `src/components/Reservations/Reservations.jsx`)
- Table data → Table utilities: sorts with (evidence: `src/hooks/useTableData.js`)
- Table data → Local settings: reads defaults (evidence: `src/hooks/useTableData.js`)
- Settings hook → Local settings: loads and saves (evidence: `src/hooks/useSettings.js`)
- JSON API client → Hotel HTTP API: sends JSON requests (evidence: `src/services/api.js`)
- Hotel HTTP API → Room endpoint: routes room requests
- Hotel HTTP API → Client endpoint: routes client requests
- Hotel HTTP API → Reservation endpoint: routes booking requests
- Hotel HTTP API → Dashboard endpoint: routes stats requests
- Client endpoint → Client DAO: delegates to (evidence: `hotel-backend/src/main/java/com/hotel/servlet/ClientServlet.java`)
- Room endpoint → Room DAO: delegates to (evidence: `hotel-backend/src/main/java/com/hotel/servlet/RoomServlet.java`)
- Reservation endpoint → Reservation DAO: delegates to (evidence: `hotel-backend/src/main/java/com/hotel/servlet/ReservationServlet.java`)
- Dashboard endpoint → Dashboard DAO: delegates to (evidence: `hotel-backend/src/main/java/com/hotel/servlet/DashboardServlet.java`)
- Client endpoint → JSON handling: serializes responses (evidence: `hotel-backend/src/main/java/com/hotel/servlet/ClientServlet.java`)
- Room endpoint → JSON handling: serializes responses (evidence: `hotel-backend/src/main/java/com/hotel/servlet/RoomServlet.java`)
- Reservation endpoint → JSON handling: serializes responses (evidence: `hotel-backend/src/main/java/com/hotel/servlet/ReservationServlet.java`)
- Dashboard endpoint → JSON handling: serializes responses (evidence: `hotel-backend/src/main/java/com/hotel/servlet/DashboardServlet.java`)
- Client DAO → Database connection: uses connection (evidence: `hotel-backend/src/main/java/com/hotel/dao/ClientDAO.java`)
- Room DAO → Database connection: uses connection (evidence: `hotel-backend/src/main/java/com/hotel/dao/RoomDAO.java`)
- Reservation DAO → Database connection: uses connection (evidence: `hotel-backend/src/main/java/com/hotel/dao/ReservationDAO.java`)
- Dashboard DAO → Database connection: uses connection (evidence: `hotel-backend/src/main/java/com/hotel/dao/DashboardDAO.java`)
- Client DAO → Client model: maps clients (evidence: `hotel-backend/src/main/java/com/hotel/dao/ClientDAO.java`)
- Room DAO → Room model: maps rooms (evidence: `hotel-backend/src/main/java/com/hotel/dao/RoomDAO.java`)
- Reservation DAO → Reservation model: maps reservations (evidence: `hotel-backend/src/main/java/com/hotel/dao/ReservationDAO.java`)
- Reservation DAO → Room model: uses room data (evidence: `hotel-backend/src/main/java/com/hotel/dao/ReservationDAO.java`)
- Database connection → MySQL database: connects to (evidence: `hotel-backend/src/main/java/com/hotel/util/DBConnection.java`)
