# ilyesbelahsen/nes-henna2 architecture

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

- Interactive diagram: https://gitdiagram.com/ilyesbelahsen/nes-henna2
- Repository: https://github.com/ilyesbelahsen/nes-henna2

## Overview

Nes Henna is a henna-appointment website with a browser booking flow backed by an API. Customers choose a city, date and slot, select gallery or uploaded designs and participant details, then submit a request; the server rechecks availability, creates a calendar event and attempts email confirmation. The site also exposes reviews, gallery and photo-gated content. Edges are limited to calls and data flow shown in excerpts or the source index; several presentation and server details were not sampled.

Main entry points: [`server/server.js`](https://github.com/ilyesbelahsen/nes-henna2/blob/main/server/server.js) (HTTP API), [`src/scripts/booking.ts`](https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/booking.ts) (Booking coordinator), [`src/scripts/main.ts`](https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/main.ts) (UI initializer), [`src/scripts/booking-submit.ts`](https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/booking-submit.ts) (Booking submission)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Website experience"]
  node_site["Site configuration<br/>[site.ts]"]
  node_main["UI initializer<br/>[main.ts]"]
  node_gallery["Design gallery<br/>[gallery.ts]"]
  node_siteui["Site interactions<br/>[site-ui.ts]"]
  node_photogate["Photo gate<br/>[photo-gate.ts]"]
  node_reviewsui["Reviews display<br/>[reviews.ts]"]
  node_page["Landing page<br/>[index.astro]"]
end

subgraph group_booking["Booking journey"]
  node_bookingui["Booking coordinator<br/>[booking.ts]"]
  node_availabilityui["Availability selection"]
  node_models["Model selection<br/>[booking-models.ts]"]
  node_submit["Booking submission<br/>[booking-submit.ts]"]
  node_bookutils["Booking utilities<br/>[booking-utils.ts]"]
  node_quantity["Quantity control"]
  node_dom["DOM helpers<br/>[dom.ts]"]
end

subgraph group_api["Booking service"]
  node_api["HTTP API<br/>[server.js]"]
  node_bookingrecord["Booking validation<br/>[booking.js]"]
  node_calendar["Availability and events<br/>[calendar.js]"]
  node_config["Server configuration<br/>[config.js]"]
  node_mailer["Email delivery<br/>[mailer.js]"]
  node_mailcontent["Email content<br/>[mail-content.js]"]
  node_reviewsapi["Reviews endpoint logic<br/>[reviews.js]"]
end

subgraph group_integrations["External services"]
  node_googlecalendar["Google Calendar"]
  node_emailservice["Email service"]
end

node_visitor(("Customer"))

node_visitor -->|"browses"| node_page
node_main -->|"initializes"| node_siteui
node_main -->|"initializes"| node_photogate
node_main -->|"initializes"| node_gallery
node_main -->|"initializes"| node_bookingui
node_main -->|"initializes"| node_reviewsui
node_gallery -->|"reads designs"| node_site
node_gallery -->|"uses"| node_quantity
node_siteui -->|"reads settings"| node_site
node_photogate -->|"uses"| node_dom
node_reviewsui -.->|"requests reviews"| node_api
node_bookingui -->|"reads settings"| node_site
node_bookingui -->|"creates"| node_models
node_bookingui -->|"creates"| node_availabilityui
node_bookingui -->|"registers handler"| node_submit
node_models -->|"reads selection"| node_gallery
node_models -->|"uses"| node_quantity
node_availabilityui -->|"fetches days and slots"| node_api
node_availabilityui -->|"formats requests"| node_bookutils
node_submit -->|"posts booking"| node_api
node_submit -->|"reads selection"| node_models
node_submit -->|"reads selected slot"| node_availabilityui
node_submit -->|"formats request"| node_bookutils
node_bookingui -->|"uses"| node_dom
node_api -->|"validates booking"| node_bookingrecord
node_api -->|"checks and creates events"| node_calendar
node_api -->|"serves reviews"| node_reviewsapi
node_api -.->|"sends confirmation"| node_mailer
node_calendar -->|"reads settings"| node_config
node_mailer -->|"reads settings"| node_config
node_mailer -->|"uses templates"| node_mailcontent
node_calendar -->|"queries and writes"| node_googlecalendar
node_mailer -.->|"delivers mail"| node_emailservice

click node_site "https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/data/site.ts"
click node_main "https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/main.ts"
click node_gallery "https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/gallery.ts"
click node_siteui "https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/site-ui.ts"
click node_photogate "https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/photo-gate.ts"
click node_reviewsui "https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/reviews.ts"
click node_page "https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/pages/index.astro"
click node_bookingui "https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/booking.ts"
click node_availabilityui "https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/booking-availability.ts"
click node_models "https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/booking-models.ts"
click node_submit "https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/booking-submit.ts"
click node_bookutils "https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/booking-utils.ts"
click node_quantity "https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/quantity-control.ts"
click node_dom "https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/dom.ts"
click node_api "https://github.com/ilyesbelahsen/nes-henna2/blob/main/server/server.js"
click node_bookingrecord "https://github.com/ilyesbelahsen/nes-henna2/blob/main/server/booking.js"
click node_calendar "https://github.com/ilyesbelahsen/nes-henna2/blob/main/server/calendar.js"
click node_config "https://github.com/ilyesbelahsen/nes-henna2/blob/main/server/config.js"
click node_mailer "https://github.com/ilyesbelahsen/nes-henna2/blob/main/server/mailer.js"
click node_mailcontent "https://github.com/ilyesbelahsen/nes-henna2/blob/main/server/mail-content.js"
click node_reviewsapi "https://github.com/ilyesbelahsen/nes-henna2/blob/main/server/reviews.js"

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_main,node_gallery,node_siteui,node_photogate,node_reviewsui,node_page toneBlue
class node_bookingui,node_availabilityui,node_models,node_submit,node_bookutils,node_quantity,node_dom toneAmber
class node_api,node_bookingrecord,node_calendar,node_config,node_mailer,node_mailcontent,node_reviewsapi toneMint
class node_googlecalendar,node_emailservice toneRose
class node_visitor toneIndigo
```

## Components

### Website experience

- [Site configuration](https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/data/site.ts): `src/data/site.ts`
- [UI initializer](https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/main.ts): `src/scripts/main.ts`
- [Design gallery](https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/gallery.ts): `src/scripts/gallery.ts`
- [Site interactions](https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/site-ui.ts): `src/scripts/site-ui.ts`
- [Photo gate](https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/photo-gate.ts): `src/scripts/photo-gate.ts`
- [Reviews display](https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/reviews.ts): `src/scripts/reviews.ts`
- [Landing page](https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/pages/index.astro): `src/pages/index.astro`

### Booking journey

- [Booking coordinator](https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/booking.ts): `src/scripts/booking.ts`
- [Availability selection](https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/booking-availability.ts): `src/scripts/booking-availability.ts`
- [Model selection](https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/booking-models.ts): `src/scripts/booking-models.ts`
- [Booking submission](https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/booking-submit.ts): `src/scripts/booking-submit.ts`
- [Booking utilities](https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/booking-utils.ts): `src/scripts/booking-utils.ts`
- [Quantity control](https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/quantity-control.ts): `src/scripts/quantity-control.ts`
- [DOM helpers](https://github.com/ilyesbelahsen/nes-henna2/blob/main/src/scripts/dom.ts): `src/scripts/dom.ts`

### Booking service

- [HTTP API](https://github.com/ilyesbelahsen/nes-henna2/blob/main/server/server.js): `server/server.js`
- [Booking validation](https://github.com/ilyesbelahsen/nes-henna2/blob/main/server/booking.js): `server/booking.js`
- [Availability and events](https://github.com/ilyesbelahsen/nes-henna2/blob/main/server/calendar.js): `server/calendar.js`
- [Server configuration](https://github.com/ilyesbelahsen/nes-henna2/blob/main/server/config.js): `server/config.js`
- [Email delivery](https://github.com/ilyesbelahsen/nes-henna2/blob/main/server/mailer.js): `server/mailer.js`
- [Email content](https://github.com/ilyesbelahsen/nes-henna2/blob/main/server/mail-content.js): `server/mail-content.js`
- [Reviews endpoint logic](https://github.com/ilyesbelahsen/nes-henna2/blob/main/server/reviews.js): `server/reviews.js`

### External services

- **Google Calendar**
- **Email service**

### Other components

- **Customer**

## Connections

- Customer → Landing page: browses
- UI initializer → Site interactions: initializes (evidence: `src/scripts/main.ts`)
- UI initializer → Photo gate: initializes (evidence: `src/scripts/main.ts`)
- UI initializer → Design gallery: initializes (evidence: `src/scripts/main.ts`)
- UI initializer → Booking coordinator: initializes (evidence: `src/scripts/main.ts`)
- UI initializer → Reviews display: initializes (evidence: `src/scripts/main.ts`)
- Design gallery → Site configuration: reads designs (evidence: `src/scripts/gallery.ts`)
- Design gallery → Quantity control: uses (evidence: `src/scripts/gallery.ts`)
- Site interactions → Site configuration: reads settings (evidence: `src/scripts/site-ui.ts`)
- Photo gate → DOM helpers: uses (evidence: `src/scripts/photo-gate.ts`)
- Reviews display → HTTP API: requests reviews
- Booking coordinator → Site configuration: reads settings (evidence: `src/scripts/booking.ts`)
- Booking coordinator → Model selection: creates (evidence: `src/scripts/booking.ts`)
- Booking coordinator → Availability selection: creates (evidence: `src/scripts/booking.ts`)
- Booking coordinator → Booking submission: registers handler (evidence: `src/scripts/booking.ts`)
- Model selection → Design gallery: reads selection (evidence: `src/scripts/booking-models.ts`)
- Model selection → Quantity control: uses (evidence: `src/scripts/booking-models.ts`)
- Availability selection → HTTP API: fetches days and slots (evidence: `src/scripts/booking-availability.ts`)
- Availability selection → Booking utilities: formats requests (evidence: `src/scripts/booking-availability.ts`)
- Booking submission → HTTP API: posts booking (evidence: `src/scripts/booking-submit.ts`)
- Booking submission → Model selection: reads selection (evidence: `src/scripts/booking-submit.ts`)
- Booking submission → Availability selection: reads selected slot (evidence: `src/scripts/booking-submit.ts`)
- Booking submission → Booking utilities: formats request (evidence: `src/scripts/booking-submit.ts`)
- Booking coordinator → DOM helpers: uses (evidence: `src/scripts/booking.ts`)
- HTTP API → Booking validation: validates booking (evidence: `server/server.js`)
- HTTP API → Availability and events: checks and creates events (evidence: `server/server.js`)
- HTTP API → Reviews endpoint logic: serves reviews (evidence: `server/server.js`)
- HTTP API → Email delivery: sends confirmation (evidence: `server/server.js`)
- Availability and events → Server configuration: reads settings (evidence: `server/calendar.js`)
- Email delivery → Server configuration: reads settings (evidence: `server/mailer.js`)
- Email delivery → Email content: uses templates (evidence: `server/mailer.js`)
- Availability and events → Google Calendar: queries and writes (evidence: `server/calendar.js`)
- Email delivery → Email service: delivers mail
