# aaronmicarte/hellhotel architecture

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

- Interactive diagram: https://gitdiagram.com/aaronmicarte/hellhotel
- Repository: https://github.com/aaronmicarte/hellhotel

## Overview

HellHotel is a hotel reservation and billing system. Its main guest workflow is browsing rooms, selecting a room, submitting a reservation, and handling payment; staff use separate admin and front-desk screens to manage reservations, guests, rooms, billing, add-ons, and reports. The tree and sampled PHP show database-backed API operations, but README detail is limited and several endpoint implementations are unsampled, so those capabilities are represented without assuming undocumented call sequences.

Main entry points: [`api/config/database.php`](https://github.com/aaronmicarte/hellhotel/blob/main/api/config/database.php) (Hotel database), [`html/frontdesk`](https://github.com/aaronmicarte/hellhotel/tree/main/html/frontdesk) (Front-desk screens), [`html/admin`](https://github.com/aaronmicarte/hellhotel/tree/main/html/admin) (Admin and front desk), [`assets/js/guest/rooms.js`](https://github.com/aaronmicarte/hellhotel/blob/main/assets/js/guest/rooms.js) (Room browsing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guest["Guest booking"]
  node_guest_pages["Guest pages"]
  node_room_browse["Room browsing<br/>[rooms.js]"]
  node_room_select["Room selection<br/>[selected-room.js]"]
  node_booking_form["Booking form<br/>[booking-form.js]"]
end

subgraph group_staff["Staff operations"]
  node_staff_pages["Admin and front desk"]
  node_staff_frontdesk["Front-desk screens"]
  node_staff_reservations["Reservation management<br/>[reservations.js]"]
  node_guest_records["Guest records<br/>[guests.php]"]
  node_room_admin["Room management<br/>[rooms.js]"]
  node_reports_api["Operational reports"]
  node_users_api["Staff accounts<br/>[users.php]"]
end

subgraph group_finance["Billing and sales"]
  node_billing_api["Billing operations<br/>[billing.php]"]
  node_payments_api["Payment operations<br/>[payments.php]"]
  node_addons_api["Add-on orders<br/>[order.php]"]
end

subgraph group_platform["API and persistence"]
  node_reservations_api["Reservations API<br/>[reservations.php]"]
  node_rooms_api["Rooms API<br/>[rooms.php]"]
  node_auth_api["Session authentication<br/>[login.php]"]
  node_auth_middleware["Admin authorization<br/>[auth.php]"]
  node_database[("Hotel database<br/>[database.php]")]
end

node_guest_actor(("Guest"))
node_staff_actor(("Hotel staff"))
node_payment_service(("Payment provider"))

node_guest_actor -->|"browses"| node_guest_pages
node_guest_pages -->|"loads rooms"| node_room_browse
node_room_browse -->|"requests availability"| node_rooms_api
node_room_browse -->|"selects room"| node_room_select
node_room_select -->|"continues booking"| node_booking_form
node_booking_form -->|"submits reservation"| node_reservations_api
node_staff_actor -->|"uses admin"| node_staff_pages
node_staff_actor -->|"uses front desk"| node_staff_frontdesk
node_staff_pages -->|"authenticates"| node_auth_api
node_staff_frontdesk -->|"authenticates"| node_auth_api
node_staff_reservations -->|"manages bookings"| node_reservations_api
node_room_admin -->|"manages rooms"| node_rooms_api
node_staff_pages -->|"manages guests"| node_guest_records
node_staff_pages -->|"manages accounts"| node_users_api
node_auth_middleware -->|"uses connection"| node_database
node_reservations_api -->|"reads and writes"| node_database
node_rooms_api -->|"reads and writes"| node_database
node_guest_records -->|"reads and writes"| node_database
node_users_api -->|"reads and writes"| node_database
node_billing_api -->|"reads and writes"| node_database
node_payments_api -->|"reads and writes"| node_database
node_addons_api -->|"reads and writes"| node_database
node_reports_api -->|"queries metrics"| node_database
node_staff_frontdesk -->|"handles billing"| node_billing_api
node_staff_frontdesk -->|"records payments"| node_payments_api
node_staff_frontdesk -->|"manages orders"| node_addons_api
node_staff_frontdesk -->|"views reports"| node_reports_api
node_payment_service -.->|"optional integration"| node_payments_api

click node_guest_pages "https://github.com/aaronmicarte/hellhotel/tree/main/html/guest"
click node_room_browse "https://github.com/aaronmicarte/hellhotel/blob/main/assets/js/guest/rooms.js"
click node_room_select "https://github.com/aaronmicarte/hellhotel/blob/main/assets/js/guest/selected-room.js"
click node_booking_form "https://github.com/aaronmicarte/hellhotel/blob/main/assets/js/guest/booking-form.js"
click node_reservations_api "https://github.com/aaronmicarte/hellhotel/blob/main/api/admin/reservations/reservations.php"
click node_rooms_api "https://github.com/aaronmicarte/hellhotel/blob/main/api/admin/rooms/rooms.php"
click node_staff_pages "https://github.com/aaronmicarte/hellhotel/tree/main/html/admin"
click node_staff_frontdesk "https://github.com/aaronmicarte/hellhotel/tree/main/html/frontdesk"
click node_staff_reservations "https://github.com/aaronmicarte/hellhotel/blob/main/assets/js/admin/reservations.js"
click node_guest_records "https://github.com/aaronmicarte/hellhotel/blob/main/api/admin/guests/guests.php"
click node_room_admin "https://github.com/aaronmicarte/hellhotel/blob/main/assets/js/admin/rooms.js"
click node_auth_api "https://github.com/aaronmicarte/hellhotel/blob/main/api/auth/login.php"
click node_auth_middleware "https://github.com/aaronmicarte/hellhotel/blob/main/api/middleware/auth.php"
click node_billing_api "https://github.com/aaronmicarte/hellhotel/blob/main/api/admin/billing/billing.php"
click node_payments_api "https://github.com/aaronmicarte/hellhotel/blob/main/api/admin/payments/payments.php"
click node_addons_api "https://github.com/aaronmicarte/hellhotel/blob/main/api/admin/addons/order.php"
click node_reports_api "https://github.com/aaronmicarte/hellhotel/blob/main/api/admin/dashboard/frontdesk_reports.php"
click node_users_api "https://github.com/aaronmicarte/hellhotel/blob/main/api/admin/add-user/users.php"
click node_database "https://github.com/aaronmicarte/hellhotel/blob/main/api/config/database.php"

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_guest_pages,node_room_browse,node_room_select,node_booking_form toneBlue
class node_staff_pages,node_staff_frontdesk,node_staff_reservations,node_guest_records,node_room_admin,node_reports_api,node_users_api toneAmber
class node_billing_api,node_payments_api,node_addons_api toneMint
class node_reservations_api,node_rooms_api,node_auth_api,node_auth_middleware,node_database toneRose
class node_guest_actor,node_staff_actor,node_payment_service toneIndigo
```

## Components

### Guest booking

- [Guest pages](https://github.com/aaronmicarte/hellhotel/tree/main/html/guest): `html/guest`
- [Room browsing](https://github.com/aaronmicarte/hellhotel/blob/main/assets/js/guest/rooms.js): `assets/js/guest/rooms.js`
- [Room selection](https://github.com/aaronmicarte/hellhotel/blob/main/assets/js/guest/selected-room.js): `assets/js/guest/selected-room.js`
- [Booking form](https://github.com/aaronmicarte/hellhotel/blob/main/assets/js/guest/booking-form.js): `assets/js/guest/booking-form.js`

### Staff operations

- [Admin and front desk](https://github.com/aaronmicarte/hellhotel/tree/main/html/admin): `html/admin`
- [Front-desk screens](https://github.com/aaronmicarte/hellhotel/tree/main/html/frontdesk): `html/frontdesk`
- [Reservation management](https://github.com/aaronmicarte/hellhotel/blob/main/assets/js/admin/reservations.js): `assets/js/admin/reservations.js`
- [Guest records](https://github.com/aaronmicarte/hellhotel/blob/main/api/admin/guests/guests.php): `api/admin/guests/guests.php`
- [Room management](https://github.com/aaronmicarte/hellhotel/blob/main/assets/js/admin/rooms.js): `assets/js/admin/rooms.js`
- [Operational reports](https://github.com/aaronmicarte/hellhotel/blob/main/api/admin/dashboard/frontdesk_reports.php): `api/admin/dashboard/frontdesk_reports.php`
- [Staff accounts](https://github.com/aaronmicarte/hellhotel/blob/main/api/admin/add-user/users.php): `api/admin/add-user/users.php`

### Billing and sales

- [Billing operations](https://github.com/aaronmicarte/hellhotel/blob/main/api/admin/billing/billing.php): `api/admin/billing/billing.php`
- [Payment operations](https://github.com/aaronmicarte/hellhotel/blob/main/api/admin/payments/payments.php): `api/admin/payments/payments.php`
- [Add-on orders](https://github.com/aaronmicarte/hellhotel/blob/main/api/admin/addons/order.php): `api/admin/addons/order.php`

### API and persistence

- [Reservations API](https://github.com/aaronmicarte/hellhotel/blob/main/api/admin/reservations/reservations.php): `api/admin/reservations/reservations.php`
- [Rooms API](https://github.com/aaronmicarte/hellhotel/blob/main/api/admin/rooms/rooms.php): `api/admin/rooms/rooms.php`
- [Session authentication](https://github.com/aaronmicarte/hellhotel/blob/main/api/auth/login.php): `api/auth/login.php`
- [Admin authorization](https://github.com/aaronmicarte/hellhotel/blob/main/api/middleware/auth.php): `api/middleware/auth.php`
- [Hotel database](https://github.com/aaronmicarte/hellhotel/blob/main/api/config/database.php): `api/config/database.php`

### Other components

- **Guest**
- **Hotel staff**
- **Payment provider**

## Connections

- Guest → Guest pages: browses
- Guest pages → Room browsing: loads rooms
- Room browsing → Rooms API: requests availability
- Room browsing → Room selection: selects room
- Room selection → Booking form: continues booking
- Booking form → Reservations API: submits reservation
- Hotel staff → Admin and front desk: uses admin
- Hotel staff → Front-desk screens: uses front desk
- Admin and front desk → Session authentication: authenticates
- Front-desk screens → Session authentication: authenticates
- Reservation management → Reservations API: manages bookings
- Room management → Rooms API: manages rooms
- Admin and front desk → Guest records: manages guests
- Admin and front desk → Staff accounts: manages accounts
- Admin authorization → Hotel database: uses connection
- Reservations API → Hotel database: reads and writes
- Rooms API → Hotel database: reads and writes
- Guest records → Hotel database: reads and writes
- Staff accounts → Hotel database: reads and writes
- Billing operations → Hotel database: reads and writes
- Payment operations → Hotel database: reads and writes
- Add-on orders → Hotel database: reads and writes
- Operational reports → Hotel database: queries metrics
- Front-desk screens → Billing operations: handles billing
- Front-desk screens → Payment operations: records payments
- Front-desk screens → Add-on orders: manages orders
- Front-desk screens → Operational reports: views reports
- Payment provider → Payment operations: optional integration
