# ammartheeb/hijazi-apartments architecture

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

- Interactive diagram: https://gitdiagram.com/ammartheeb/hijazi-apartments
- Repository: https://github.com/ammartheeb/hijazi-apartments

## Overview

HIJAZI Apartments is a bilingual apartment-discovery and booking site with an admin PMS. Guests browse apartment information and submit date-based booking requests; the backend manages availability and booking records, while staff administer bookings and calendar integrations. The README documents photo galleries, amenities, email notifications, reminders, and passport-assisted manual booking. Backend route details and some frontend wiring were not sampled, so uncertain relationships are omitted; documented features are retained without implying unshown calls.

Main entry points: [`backend/server.js`](https://github.com/ammartheeb/hijazi-apartments/blob/main/backend/server.js) (Express API), [`frontend/booking.html`](https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/booking.html) (Reservation form), [`frontend/index.html`](https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/index.html) (Bilingual website), [`frontend/js/passport-scan.js`](https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/js/passport-scan.js) (Passport scanning)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_guest["Guest experience"]
  node_site["Bilingual website<br/>[index.html]"]
  node_apartment_pages["Apartment pages<br/>[apartments.html]"]
  node_gallery["Photo galleries<br/>[main.js]"]
  node_booking_form["Reservation form<br/>[booking.html]"]
  node_passport_ocr["Passport scanning<br/>[passport-scan.js]"]
  node_mrz["MRZ parsing<br/>[passport-mrz.js]"]
  node_reservation_doc["Reservation document"]
end

subgraph group_pms["Booking PMS"]
  node_api["Express API<br/>[server.js]"]
  node_booking[("Booking records<br/>[Booking.js]")]
  node_apartments[("Apartment records<br/>[Apartment.js]")]
  node_activity[("Admin activity log<br/>[ActivityLog.js]")]
  node_admin["Admin dashboard<br/>[admin.html]"]
  node_booking_groups["Booking groups"]
end

subgraph group_ops["Operations and integrations"]
  node_calendar_sync["Calendar sync<br/>[ical.js]"]
  node_reminders["Booking reminders"]
  node_security["API security<br/>[security.js]"]
  node_turnstile["Bot verification<br/>[turnstile.js]"]
  node_email["Email service"]
end

subgraph group_content["Property content"]
  node_amenities_data["Amenities data<br/>[amenities-data.js]"]
  node_amenities_ui["Amenities display<br/>[amenities-ui.js]"]
  node_listings["Apartment listings<br/>[apartments.html]"]
end

node_guest(("Guest"))
node_external_calendars["Airbnb and Booking"]

node_guest -->|"browses"| node_site
node_site -->|"offers listings"| node_apartment_pages
node_apartment_pages -->|"shows photos"| node_gallery
node_guest -->|"requests booking"| node_booking_form
node_booking_form -->|"submits request"| node_api
node_api -->|"reads and writes"| node_booking
node_api -->|"reads and writes"| node_apartments
node_api -->|"records actions"| node_activity
node_admin -->|"manages bookings"| node_api
node_admin -->|"groups bookings"| node_booking_groups
node_booking_form -.->|"verifies request"| node_turnstile
node_api -->|"applies protections"| node_security
node_api -->|"checks submissions"| node_turnstile
node_api -->|"dispatches calendar work"| node_calendar_sync
node_calendar_sync -->|"imports and exports"| node_external_calendars
node_api -->|"computes reminders"| node_reminders
node_api -.->|"sends notifications"| node_email
node_amenities_ui -->|"renders data"| node_amenities_data
node_site -->|"displays amenities"| node_amenities_ui
node_guest -->|"scans document"| node_passport_ocr
node_passport_ocr -->|"parses MRZ"| node_mrz
node_passport_ocr -->|"fills guest details"| node_booking_form
node_booking_form -->|"renders confirmation"| node_reservation_doc
node_site -->|"loads apartment prices"| node_api

click node_site "https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/index.html"
click node_apartment_pages "https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/apartments.html"
click node_gallery "https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/js/main.js"
click node_booking_form "https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/booking.html"
click node_passport_ocr "https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/js/passport-scan.js"
click node_mrz "https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/js/passport-mrz.js"
click node_reservation_doc "https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/js/reservation-form.js"
click node_api "https://github.com/ammartheeb/hijazi-apartments/blob/main/backend/server.js"
click node_booking "https://github.com/ammartheeb/hijazi-apartments/blob/main/backend/models/Booking.js"
click node_apartments "https://github.com/ammartheeb/hijazi-apartments/blob/main/backend/models/Apartment.js"
click node_activity "https://github.com/ammartheeb/hijazi-apartments/blob/main/backend/models/ActivityLog.js"
click node_admin "https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/admin.html"
click node_booking_groups "https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/js/admin-booking-groups.js"
click node_calendar_sync "https://github.com/ammartheeb/hijazi-apartments/blob/main/backend/services/ical.js"
click node_reminders "https://github.com/ammartheeb/hijazi-apartments/blob/main/backend/services/booking-reminders.js"
click node_security "https://github.com/ammartheeb/hijazi-apartments/blob/main/backend/services/security.js"
click node_turnstile "https://github.com/ammartheeb/hijazi-apartments/blob/main/backend/services/turnstile.js"
click node_amenities_data "https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/js/amenities-data.js"
click node_amenities_ui "https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/js/amenities-ui.js"
click node_listings "https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/apartments.html"

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_site,node_apartment_pages,node_gallery,node_booking_form,node_passport_ocr,node_mrz,node_reservation_doc toneBlue
class node_api,node_booking,node_apartments,node_activity,node_admin,node_booking_groups toneAmber
class node_calendar_sync,node_reminders,node_security,node_turnstile,node_email toneMint
class node_amenities_data,node_amenities_ui,node_listings toneRose
class node_guest,node_external_calendars toneIndigo
```

## Components

### Guest experience

- [Bilingual website](https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/index.html): `frontend/index.html`
- [Apartment pages](https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/apartments.html): `frontend/apartments.html`
- [Photo galleries](https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/js/main.js): `frontend/js/main.js`
- [Reservation form](https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/booking.html): `frontend/booking.html`
- [Passport scanning](https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/js/passport-scan.js): `frontend/js/passport-scan.js`
- [MRZ parsing](https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/js/passport-mrz.js): `frontend/js/passport-mrz.js`
- [Reservation document](https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/js/reservation-form.js): `frontend/js/reservation-form.js`

### Booking PMS

- [Express API](https://github.com/ammartheeb/hijazi-apartments/blob/main/backend/server.js): `backend/server.js`
- [Booking records](https://github.com/ammartheeb/hijazi-apartments/blob/main/backend/models/Booking.js): `backend/models/Booking.js`
- [Apartment records](https://github.com/ammartheeb/hijazi-apartments/blob/main/backend/models/Apartment.js): `backend/models/Apartment.js`
- [Admin activity log](https://github.com/ammartheeb/hijazi-apartments/blob/main/backend/models/ActivityLog.js): `backend/models/ActivityLog.js`
- [Admin dashboard](https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/admin.html): `frontend/admin.html`
- [Booking groups](https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/js/admin-booking-groups.js): `frontend/js/admin-booking-groups.js`

### Operations and integrations

- [Calendar sync](https://github.com/ammartheeb/hijazi-apartments/blob/main/backend/services/ical.js): `backend/services/ical.js`
- [Booking reminders](https://github.com/ammartheeb/hijazi-apartments/blob/main/backend/services/booking-reminders.js): `backend/services/booking-reminders.js`
- [API security](https://github.com/ammartheeb/hijazi-apartments/blob/main/backend/services/security.js): `backend/services/security.js`
- [Bot verification](https://github.com/ammartheeb/hijazi-apartments/blob/main/backend/services/turnstile.js): `backend/services/turnstile.js`
- **Email service**

### Property content

- [Amenities data](https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/js/amenities-data.js): `frontend/js/amenities-data.js`
- [Amenities display](https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/js/amenities-ui.js): `frontend/js/amenities-ui.js`
- [Apartment listings](https://github.com/ammartheeb/hijazi-apartments/blob/main/frontend/apartments.html): `frontend/apartments.html`

### Other components

- **Guest**
- **Airbnb and Booking**

## Connections

- Guest → Bilingual website: browses (evidence: `README.md`)
- Bilingual website → Apartment pages: offers listings (evidence: `README.md`)
- Apartment pages → Photo galleries: shows photos (evidence: `README.md`)
- Guest → Reservation form: requests booking (evidence: `README.md`)
- Reservation form → Express API: submits request (evidence: `README.md`)
- Express API → Booking records: reads and writes (evidence: `backend/server.js`)
- Express API → Apartment records: reads and writes (evidence: `backend/server.js`)
- Express API → Admin activity log: records actions (evidence: `backend/server.js`)
- Admin dashboard → Express API: manages bookings (evidence: `README.md`)
- Admin dashboard → Booking groups: groups bookings (evidence: `README.md`)
- Reservation form → Bot verification: verifies request
- Express API → API security: applies protections (evidence: `backend/server.js`)
- Express API → Bot verification: checks submissions (evidence: `backend/server.js`)
- Express API → Calendar sync: dispatches calendar work (evidence: `backend/server.js`)
- Calendar sync → Airbnb and Booking: imports and exports (evidence: `README.md`)
- Express API → Booking reminders: computes reminders (evidence: `backend/server.js`)
- Express API → Email service: sends notifications
- Amenities display → Amenities data: renders data (evidence: `frontend/js/amenities-ui.js`)
- Bilingual website → Amenities display: displays amenities (evidence: `README.md`)
- Guest → Passport scanning: scans document (evidence: `README.md`)
- Passport scanning → MRZ parsing: parses MRZ (evidence: `README.md`)
- Passport scanning → Reservation form: fills guest details (evidence: `README.md`)
- Reservation form → Reservation document: renders confirmation (evidence: `README.md`)
- Bilingual website → Express API: loads apartment prices
