# themoon-789/project-az-booking-system architecture

> Architecture diagram of the GitHub repository themoon-789/project-az-booking-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/themoon-789/project-az-booking-system
- Repository: https://github.com/themoon-789/project-az-booking-system

## Overview

AZ Vacation Booking is a browser-based employee vacation scheduler backed by an Express/PostgreSQL API. The main workflow is employee sign-in, viewing team/month vacation slots, and booking a concourse slot; the frontend also displays booking history and administrative views. The sampled frontend calls the API and renders fetched calendar results, while the server excerpt shows booking validation and SQL access. Feature boundaries within the large frontend and action-to-handler routing are inferred from the excerpts; only evidenced relationships are drawn.

Main entry points: [`server.js`](https://github.com/themoon-789/project-az-booking-system/blob/main/server.js) (Action dispatcher), [`db/schema.sql`](https://github.com/themoon-789/project-az-booking-system/blob/main/db/schema.sql) (PostgreSQL), [`app.js`](https://github.com/themoon-789/project-az-booking-system/blob/main/app.js) (App controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Booking interface"]
  node_frontend["App controller<br/>[app.js]"]
  node_calendar["Calendar display<br/>[app.js]"]
  node_login["Employee sign-in<br/>[app.js]"]
  node_booking_ui["Booking actions<br/>[app.js]"]
  node_history_ui["Booking history<br/>[app.js]"]
end

subgraph group_domain["Booking services"]
  node_api["HTTP API<br/>[server.js]"]
  node_dispatcher["Action dispatcher<br/>[server.js]"]
  node_identity["Identity lookup<br/>[server.js]"]
  node_slot_search["Slot retrieval<br/>[server.js]"]
  node_booking_rules["Booking validation<br/>[server.js]"]
  node_booking_history["Booking history<br/>[server.js]"]
  node_admin_ops["Admin booking tools<br/>[server.js]"]
end

subgraph group_data["Persistence"]
  node_postgres[("PostgreSQL<br/>[schema.sql]")]
end

node_employee(("Employee or admin"))

node_employee -->|"uses"| node_frontend
node_frontend -->|"requests data"| node_api
node_frontend -->|"renders results"| node_calendar
node_api -->|"dispatches actions"| node_dispatcher
node_dispatcher -.-> node_identity
node_dispatcher -.-> node_slot_search
node_dispatcher -.-> node_booking_rules
node_dispatcher -.-> node_booking_history
node_dispatcher -.-> node_admin_ops
node_identity -->|"queries"| node_postgres
node_slot_search -->|"reads slots"| node_postgres
node_booking_rules -->|"checks and updates"| node_postgres
node_booking_history -->|"reads bookings"| node_postgres
node_admin_ops -->|"clears bookings"| node_postgres

click node_frontend "https://github.com/themoon-789/project-az-booking-system/blob/main/app.js"
click node_calendar "https://github.com/themoon-789/project-az-booking-system/blob/main/app.js"
click node_login "https://github.com/themoon-789/project-az-booking-system/blob/main/app.js"
click node_booking_ui "https://github.com/themoon-789/project-az-booking-system/blob/main/app.js"
click node_history_ui "https://github.com/themoon-789/project-az-booking-system/blob/main/app.js"
click node_api "https://github.com/themoon-789/project-az-booking-system/blob/main/server.js"
click node_dispatcher "https://github.com/themoon-789/project-az-booking-system/blob/main/server.js"
click node_identity "https://github.com/themoon-789/project-az-booking-system/blob/main/server.js"
click node_slot_search "https://github.com/themoon-789/project-az-booking-system/blob/main/server.js"
click node_booking_rules "https://github.com/themoon-789/project-az-booking-system/blob/main/server.js"
click node_booking_history "https://github.com/themoon-789/project-az-booking-system/blob/main/server.js"
click node_admin_ops "https://github.com/themoon-789/project-az-booking-system/blob/main/server.js"
click node_postgres "https://github.com/themoon-789/project-az-booking-system/blob/main/db/schema.sql"

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_frontend,node_calendar,node_login,node_booking_ui,node_history_ui toneBlue
class node_api,node_dispatcher,node_identity,node_slot_search,node_booking_rules,node_booking_history,node_admin_ops toneAmber
class node_postgres toneMint
class node_employee toneIndigo
```

## Components

### Booking interface

- [App controller](https://github.com/themoon-789/project-az-booking-system/blob/main/app.js): `app.js`
- [Calendar display](https://github.com/themoon-789/project-az-booking-system/blob/main/app.js): `app.js`
- [Employee sign-in](https://github.com/themoon-789/project-az-booking-system/blob/main/app.js): `app.js`
- [Booking actions](https://github.com/themoon-789/project-az-booking-system/blob/main/app.js): `app.js`
- [Booking history](https://github.com/themoon-789/project-az-booking-system/blob/main/app.js): `app.js`

### Booking services

- [HTTP API](https://github.com/themoon-789/project-az-booking-system/blob/main/server.js): `server.js`
- [Action dispatcher](https://github.com/themoon-789/project-az-booking-system/blob/main/server.js): `server.js`
- [Identity lookup](https://github.com/themoon-789/project-az-booking-system/blob/main/server.js): `server.js`
- [Slot retrieval](https://github.com/themoon-789/project-az-booking-system/blob/main/server.js): `server.js`
- [Booking validation](https://github.com/themoon-789/project-az-booking-system/blob/main/server.js): `server.js`
- [Booking history](https://github.com/themoon-789/project-az-booking-system/blob/main/server.js): `server.js`
- [Admin booking tools](https://github.com/themoon-789/project-az-booking-system/blob/main/server.js): `server.js`

### Persistence

- [PostgreSQL](https://github.com/themoon-789/project-az-booking-system/blob/main/db/schema.sql): `db/schema.sql`

### Other components

- **Employee or admin**

## Connections

- Employee or admin → App controller: uses
- App controller → HTTP API: requests data (evidence: `app.js`)
- App controller → Calendar display: renders results (evidence: `app.js`)
- HTTP API → Action dispatcher: dispatches actions (evidence: `server.js`)
- Action dispatcher → Identity lookup (evidence: `server.js`)
- Action dispatcher → Slot retrieval (evidence: `server.js`)
- Action dispatcher → Booking validation (evidence: `server.js`)
- Action dispatcher → Booking history (evidence: `server.js`)
- Action dispatcher → Admin booking tools (evidence: `server.js`)
- Identity lookup → PostgreSQL: queries (evidence: `server.js`)
- Slot retrieval → PostgreSQL: reads slots (evidence: `server.js`)
- Booking validation → PostgreSQL: checks and updates (evidence: `server.js`)
- Booking history → PostgreSQL: reads bookings (evidence: `server.js`)
- Admin booking tools → PostgreSQL: clears bookings (evidence: `server.js`)
