# angaoiyy/queue-csap architecture

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

- Interactive diagram: https://gitdiagram.com/angaoiyy/queue-csap
- Repository: https://github.com/angaoiyy/queue-csap

## Overview

This is a multi-office queue reservation and service-desk application built with Next.js and Supabase, rather than merely the starter kit described in the README. Visitors choose an office and student category, submit a reservation, and receive a queue ticket; staff manage queues while public displays show service status. Separate areas support authentication and staff approval, office-specific configuration, contact messages, and activity reporting. The sampled sources establish reservation, display, office lookup, and settings relationships; several other branches are preserved from the file tree and README but have limited implementation evidence.

Main entry points: [`lib/actions/reservation.ts`](https://github.com/angaoiyy/queue-csap/blob/main/lib/actions/reservation.ts) (Reservation Actions), [`lib/supabase/server.ts`](https://github.com/angaoiyy/queue-csap/blob/main/lib/supabase/server.ts) (Server Client), [`app/page.tsx`](https://github.com/angaoiyy/queue-csap/blob/main/app/page.tsx) (Office Landing), [`components/display-screen.tsx`](https://github.com/angaoiyy/queue-csap/blob/main/components/display-screen.tsx) (Queue Display)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public Experience"]
  node_home["Office Landing<br/>[page.tsx]"]
  node_reserve_picker["Reservation Choice<br/>[page.tsx]"]
  node_admission_form["New Student Form<br/>[admission-form.tsx]"]
  node_legacy_form["Returning Student Form"]
  node_contact["Contact Messages<br/>[contact.ts]"]
  node_contact_ui["Contact Forms"]
end

subgraph group_queue["Queue Operations"]
  node_reservation_action["Reservation Actions<br/>[reservation.ts]"]
  node_ticket_print["Ticket Printing<br/>[ticket.ts]"]
  node_admin_queue["Queue Console"]
  node_display_page["Display Route<br/>[page.tsx]"]
  node_display_screen["Queue Display<br/>[display-screen.tsx]"]
  node_media["Display Media<br/>[video.ts]"]
  node_speech["Queue Announcements<br/>[speech.ts]"]
end

subgraph group_admin["Administration"]
  node_display_settings["Display Settings"]
  node_settings_action["Office Settings<br/>[settings.ts]"]
  node_settings_ui["Settings Console<br/>[settings-panel.tsx]"]
  node_contact_inbox["Message Inbox"]
  node_staff_admin["Staff Administration<br/>[staff.ts]"]
  node_staff_ui["Staff Approvals"]
  node_activity["Activity Reporting"]
end

subgraph group_identity["Identity"]
  node_auth_routes["Authentication Routes<br/>[route.ts]"]
  node_auth_ui["Sign-in and Signup<br/>[sign-up-form.tsx]"]
end

subgraph group_foundation["Data Access"]
  node_office_lookup["Office Lookup<br/>[offices.ts]"]
  node_session_profile["Session and Profile<br/>[offices.ts]"]
  node_supabase_server["Server Client<br/>[server.ts]"]
end

node_visitor(("Visitor"))
node_supabase[("Supabase")]
node_printer(("Ticket Printer"))

node_visitor -->|"opens"| node_home
node_home -->|"lists offices"| node_office_lookup
node_home -->|"renders contact"| node_contact_ui
node_contact_ui -->|"submits message"| node_contact
node_contact_inbox -->|"loads messages"| node_contact
node_home -->|"links to reserve"| node_reserve_picker
node_reserve_picker -->|"looks up office"| node_office_lookup
node_admission_form -->|"creates reservation"| node_reservation_action
node_legacy_form -->|"creates reservation"| node_reservation_action
node_reservation_action -->|"loads form options"| node_settings_action
node_reservation_action -->|"resolves office"| node_office_lookup
node_reservation_action -->|"loads display config"| node_display_settings
node_reservation_action -->|"prints ticket"| node_ticket_print
node_ticket_print -.->|"sends ticket"| node_printer
node_reservation_action -->|"creates client"| node_supabase_server
node_settings_action -->|"creates client"| node_supabase_server
node_contact -->|"creates client"| node_supabase_server
node_supabase_server -->|"connects"| node_supabase
node_display_page -->|"renders"| node_display_screen
node_display_screen -->|"loads queue"| node_reservation_action
node_admin_queue -->|"manages queue"| node_reservation_action
node_admin_queue -->|"configures display"| node_display_settings
node_display_screen -->|"uses video"| node_media
node_display_screen -->|"announces queue"| node_speech
node_settings_ui -.->|"edits settings"| node_settings_action
node_staff_ui -.->|"reviews staff"| node_staff_admin
node_auth_routes -->|"verifies token"| node_supabase_server
node_auth_ui -.->|"uses profile"| node_session_profile
node_session_profile -->|"creates client"| node_supabase_server
node_session_profile -->|"reads profiles"| node_supabase
node_activity -.->|"reports activity"| node_reservation_action

click node_home "https://github.com/angaoiyy/queue-csap/blob/main/app/page.tsx"
click node_office_lookup "https://github.com/angaoiyy/queue-csap/blob/main/lib/offices.ts"
click node_reserve_picker "https://github.com/angaoiyy/queue-csap/blob/main/app/%5Boffice%5D/reserve/page.tsx"
click node_admission_form "https://github.com/angaoiyy/queue-csap/blob/main/components/admission-form.tsx"
click node_legacy_form "https://github.com/angaoiyy/queue-csap/blob/main/components/reservation-form.tsx"
click node_reservation_action "https://github.com/angaoiyy/queue-csap/blob/main/lib/actions/reservation.ts"
click node_ticket_print "https://github.com/angaoiyy/queue-csap/blob/main/lib/printer/ticket.ts"
click node_admin_queue "https://github.com/angaoiyy/queue-csap/blob/main/components/admin-queue-panel.tsx"
click node_display_page "https://github.com/angaoiyy/queue-csap/blob/main/app/%5Boffice%5D/display/page.tsx"
click node_display_screen "https://github.com/angaoiyy/queue-csap/blob/main/components/display-screen.tsx"
click node_display_settings "https://github.com/angaoiyy/queue-csap/blob/main/lib/actions/display-settings.ts"
click node_media "https://github.com/angaoiyy/queue-csap/blob/main/lib/video.ts"
click node_speech "https://github.com/angaoiyy/queue-csap/blob/main/lib/speech.ts"
click node_settings_action "https://github.com/angaoiyy/queue-csap/blob/main/lib/actions/settings.ts"
click node_settings_ui "https://github.com/angaoiyy/queue-csap/blob/main/components/settings-panel.tsx"
click node_contact "https://github.com/angaoiyy/queue-csap/blob/main/lib/actions/contact.ts"
click node_contact_ui "https://github.com/angaoiyy/queue-csap/blob/main/components/contact-section.tsx"
click node_contact_inbox "https://github.com/angaoiyy/queue-csap/blob/main/components/contact-messages-inbox.tsx"
click node_staff_admin "https://github.com/angaoiyy/queue-csap/blob/main/lib/actions/staff.ts"
click node_staff_ui "https://github.com/angaoiyy/queue-csap/blob/main/components/staff-approvals.tsx"
click node_activity "https://github.com/angaoiyy/queue-csap/blob/main/components/activity-logs-table.tsx"
click node_auth_routes "https://github.com/angaoiyy/queue-csap/blob/main/app/auth/confirm/route.ts"
click node_auth_ui "https://github.com/angaoiyy/queue-csap/blob/main/components/sign-up-form.tsx"
click node_session_profile "https://github.com/angaoiyy/queue-csap/blob/main/lib/offices.ts"
click node_supabase_server "https://github.com/angaoiyy/queue-csap/blob/main/lib/supabase/server.ts"

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_home,node_reserve_picker,node_admission_form,node_legacy_form,node_contact,node_contact_ui toneBlue
class node_reservation_action,node_ticket_print,node_admin_queue,node_display_page,node_display_screen,node_media,node_speech,node_supabase toneAmber
class node_display_settings,node_settings_action,node_settings_ui,node_contact_inbox,node_staff_admin,node_staff_ui,node_activity toneMint
class node_auth_routes,node_auth_ui toneRose
class node_office_lookup,node_session_profile,node_supabase_server,node_visitor,node_printer toneIndigo
```

## Components

### Public Experience

- [Office Landing](https://github.com/angaoiyy/queue-csap/blob/main/app/page.tsx): `app/page.tsx`
- [Reservation Choice](https://github.com/angaoiyy/queue-csap/blob/main/app/%5Boffice%5D/reserve/page.tsx): `app/[office]/reserve/page.tsx`
- [New Student Form](https://github.com/angaoiyy/queue-csap/blob/main/components/admission-form.tsx): `components/admission-form.tsx`
- [Returning Student Form](https://github.com/angaoiyy/queue-csap/blob/main/components/reservation-form.tsx): `components/reservation-form.tsx`
- [Contact Messages](https://github.com/angaoiyy/queue-csap/blob/main/lib/actions/contact.ts): `lib/actions/contact.ts`
- [Contact Forms](https://github.com/angaoiyy/queue-csap/blob/main/components/contact-section.tsx): `components/contact-section.tsx`

### Queue Operations

- [Reservation Actions](https://github.com/angaoiyy/queue-csap/blob/main/lib/actions/reservation.ts): `lib/actions/reservation.ts`
- [Ticket Printing](https://github.com/angaoiyy/queue-csap/blob/main/lib/printer/ticket.ts): `lib/printer/ticket.ts`
- [Queue Console](https://github.com/angaoiyy/queue-csap/blob/main/components/admin-queue-panel.tsx): `components/admin-queue-panel.tsx`
- [Display Route](https://github.com/angaoiyy/queue-csap/blob/main/app/%5Boffice%5D/display/page.tsx): `app/[office]/display/page.tsx`
- [Queue Display](https://github.com/angaoiyy/queue-csap/blob/main/components/display-screen.tsx): `components/display-screen.tsx`
- [Display Media](https://github.com/angaoiyy/queue-csap/blob/main/lib/video.ts): `lib/video.ts`
- [Queue Announcements](https://github.com/angaoiyy/queue-csap/blob/main/lib/speech.ts): `lib/speech.ts`

### Administration

- [Display Settings](https://github.com/angaoiyy/queue-csap/blob/main/lib/actions/display-settings.ts): `lib/actions/display-settings.ts`
- [Office Settings](https://github.com/angaoiyy/queue-csap/blob/main/lib/actions/settings.ts): `lib/actions/settings.ts`
- [Settings Console](https://github.com/angaoiyy/queue-csap/blob/main/components/settings-panel.tsx): `components/settings-panel.tsx`
- [Message Inbox](https://github.com/angaoiyy/queue-csap/blob/main/components/contact-messages-inbox.tsx): `components/contact-messages-inbox.tsx`
- [Staff Administration](https://github.com/angaoiyy/queue-csap/blob/main/lib/actions/staff.ts): `lib/actions/staff.ts`
- [Staff Approvals](https://github.com/angaoiyy/queue-csap/blob/main/components/staff-approvals.tsx): `components/staff-approvals.tsx`
- [Activity Reporting](https://github.com/angaoiyy/queue-csap/blob/main/components/activity-logs-table.tsx): `components/activity-logs-table.tsx`

### Identity

- [Authentication Routes](https://github.com/angaoiyy/queue-csap/blob/main/app/auth/confirm/route.ts): `app/auth/confirm/route.ts`
- [Sign-in and Signup](https://github.com/angaoiyy/queue-csap/blob/main/components/sign-up-form.tsx): `components/sign-up-form.tsx`

### Data Access

- [Office Lookup](https://github.com/angaoiyy/queue-csap/blob/main/lib/offices.ts): `lib/offices.ts`
- [Session and Profile](https://github.com/angaoiyy/queue-csap/blob/main/lib/offices.ts): `lib/offices.ts`
- [Server Client](https://github.com/angaoiyy/queue-csap/blob/main/lib/supabase/server.ts): `lib/supabase/server.ts`

### Other components

- **Visitor**
- **Supabase**
- **Ticket Printer**

## Connections

- Visitor → Office Landing: opens (evidence: `app/page.tsx`)
- Office Landing → Office Lookup: lists offices (evidence: `app/page.tsx`)
- Office Landing → Contact Forms: renders contact (evidence: `app/page.tsx`)
- Contact Forms → Contact Messages: submits message (evidence: `components/contact-section.tsx`)
- Message Inbox → Contact Messages: loads messages (evidence: `components/contact-messages-inbox.tsx`)
- Office Landing → Reservation Choice: links to reserve (evidence: `app/page.tsx`)
- Reservation Choice → Office Lookup: looks up office (evidence: `app/[office]/reserve/page.tsx`)
- New Student Form → Reservation Actions: creates reservation (evidence: `components/admission-form.tsx`)
- Returning Student Form → Reservation Actions: creates reservation (evidence: `lib/actions/reservation.ts`)
- Reservation Actions → Office Settings: loads form options (evidence: `lib/actions/reservation.ts`)
- Reservation Actions → Office Lookup: resolves office (evidence: `lib/actions/reservation.ts`)
- Reservation Actions → Display Settings: loads display config (evidence: `lib/actions/reservation.ts`)
- Reservation Actions → Ticket Printing: prints ticket (evidence: `lib/actions/reservation.ts`)
- Ticket Printing → Ticket Printer: sends ticket
- Reservation Actions → Server Client: creates client (evidence: `lib/actions/reservation.ts`)
- Office Settings → Server Client: creates client (evidence: `lib/actions/settings.ts`)
- Contact Messages → Server Client: creates client (evidence: `lib/actions/contact.ts`)
- Server Client → Supabase: connects (evidence: `lib/supabase/server.ts`)
- Display Route → Queue Display: renders (evidence: `app/[office]/display/page.tsx`)
- Queue Display → Reservation Actions: loads queue (evidence: `components/display-screen.tsx`)
- Queue Console → Reservation Actions: manages queue (evidence: `components/admin-queue-panel.tsx`)
- Queue Console → Display Settings: configures display (evidence: `components/admin-queue-panel.tsx`)
- Queue Display → Display Media: uses video (evidence: `components/display-screen.tsx`)
- Queue Display → Queue Announcements: announces queue (evidence: `components/display-screen.tsx`)
- Settings Console → Office Settings: edits settings
- Staff Approvals → Staff Administration: reviews staff
- Authentication Routes → Server Client: verifies token (evidence: `app/auth/confirm/route.ts`)
- Sign-in and Signup → Session and Profile: uses profile
- Session and Profile → Server Client: creates client (evidence: `lib/offices.ts`)
- Session and Profile → Supabase: reads profiles (evidence: `lib/offices.ts`)
- Activity Reporting → Reservation Actions: reports activity
