# skeg-16/nbi-queue-system architecture

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

- Interactive diagram: https://gitdiagram.com/skeg-16/nbi-queue-system
- Repository: https://github.com/skeg-16/nbi-queue-system

## Overview

This is a queue-management system with a React client and a Node/Express backend. Its central workflow is staff registering and managing complainant records, with queue state presented on a live display; the system also supports feedback collection and reporting, user administration, account/profile management, and record backup. The backend exposes API and Socket.IO behavior and uses Supabase for persistence. The README is empty, so capability and relationship coverage relies on the source index and shown excerpts; some frontend-to-API wiring is not visible and is therefore omitted.

Main entry points: [`client/src/App.jsx`](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/App.jsx) (Route and providers), [`client/src/context/AuthContext.jsx`](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/context/AuthContext.jsx) (Authentication state), [`client/src/context/SocketContext.jsx`](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/context/SocketContext.jsx) (Socket connection), [`client/src/pages/Records.jsx`](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/pages/Records.jsx) (Record management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client application"]
  node_app["Route and providers<br/>[App.jsx]"]
  node_auth_guard["Protected routes<br/>[ProtectedRoute.jsx]"]
  node_sidebar["Navigation sidebar<br/>[Sidebar.jsx]"]
  node_auth_context["Authentication state<br/>[AuthContext.jsx]"]
  node_socket_context["Socket connection<br/>[SocketContext.jsx]"]
  node_theme_context["Theme state<br/>[ThemeContext.jsx]"]
end

subgraph group_queue["Queue operations"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_registration["Complainant registration<br/>[Register.jsx]"]
  node_staff_panel["Staff queue panel<br/>[Staff.jsx]"]
  node_records["Record management<br/>[Records.jsx]"]
  node_display["Queue display<br/>[Display.jsx]"]
end

subgraph group_feedback["Feedback"]
  node_feedback_form["Feedback forms<br/>[FeedbackForms.jsx]"]
  node_feedback_reports["Feedback reports"]
end

subgraph group_accounts["Accounts and settings"]
  node_login["Sign-in<br/>[Login.jsx]"]
  node_profile["Profile settings<br/>[Profile.jsx]"]
  node_user_admin["User administration<br/>[ManageUsers.jsx]"]
end

subgraph group_backend["Backend services"]
  node_server["API and realtime server<br/>[server.js]"]
  node_backup["Record backup<br/>[backupJob.js]"]
  node_supabase[("Supabase")]
  node_socket_service["Socket.IO service"]
  node_email["Email service"]
  node_sheets["Google Sheets"]
end

node_visitor(("Visitor"))
node_staff(("Staff user"))
node_admin(("Administrator"))
node_display_user(("Display viewer"))

node_app -->|"provides auth"| node_auth_context
node_app -->|"provides socket"| node_socket_context
node_app -->|"provides theme"| node_theme_context
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_display
node_app -->|"routes to"| node_registration
node_app -->|"routes to"| node_staff_panel
node_app -->|"routes to"| node_records
node_app -->|"routes to"| node_feedback_form
node_app -->|"routes to"| node_feedback_reports
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_user_admin
node_auth_guard -->|"checks session"| node_auth_context
node_login -->|"sets session"| node_auth_context
node_dashboard -->|"reads identity"| node_auth_context
node_records -->|"reads identity"| node_auth_context
node_records -->|"uses connection"| node_socket_context
node_records -->|"renders navigation"| node_sidebar
node_records -->|"requests record APIs"| node_server
node_user_admin -->|"reads credentials"| node_auth_context
node_user_admin -->|"requests user APIs"| node_server
node_profile -->|"uses account state"| node_auth_context
node_profile -->|"uses theme state"| node_theme_context
node_profile -->|"uses connection"| node_socket_context
node_profile -->|"renders navigation"| node_sidebar
node_feedback_reports -->|"renders navigation"| node_sidebar
node_staff_panel -->|"uses connection"| node_socket_context
node_staff_panel -->|"reads identity"| node_auth_context
node_staff_panel -->|"renders navigation"| node_sidebar
node_registration -->|"uses connection"| node_socket_context
node_display -->|"uses connection"| node_socket_context
node_server -->|"reads and writes"| node_supabase
node_backup -->|"reads and deletes"| node_supabase
node_server -->|"uses backup job"| node_backup
node_backup -->|"sends backup"| node_email
node_backup -->|"syncs records"| node_sheets
node_socket_context -->|"connects to"| node_socket_service
node_server -->|"hosts realtime"| node_socket_service
node_visitor -.->|"submits details"| node_registration
node_staff -.->|"handles queue"| node_staff_panel
node_admin -.->|"manages accounts"| node_user_admin
node_display_user -.->|"views queue"| node_display

click node_app "https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/App.jsx"
click node_auth_guard "https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/components/ProtectedRoute.jsx"
click node_sidebar "https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/components/Sidebar.jsx"
click node_auth_context "https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/context/AuthContext.jsx"
click node_socket_context "https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/context/SocketContext.jsx"
click node_theme_context "https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/context/ThemeContext.jsx"
click node_dashboard "https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/pages/Dashboard.jsx"
click node_registration "https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/pages/Register.jsx"
click node_staff_panel "https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/pages/Staff.jsx"
click node_records "https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/pages/Records.jsx"
click node_display "https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/pages/Display.jsx"
click node_feedback_form "https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/pages/FeedbackForms.jsx"
click node_feedback_reports "https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/pages/FeedbackReports.jsx"
click node_login "https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/pages/Login.jsx"
click node_profile "https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/pages/Profile.jsx"
click node_user_admin "https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/pages/ManageUsers.jsx"
click node_server "https://github.com/skeg-16/nbi-queue-system/blob/mainv3/server/server.js"
click node_backup "https://github.com/skeg-16/nbi-queue-system/blob/mainv3/server/backupJob.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_app,node_auth_guard,node_sidebar,node_auth_context,node_socket_context,node_theme_context,node_staff,node_display_user toneBlue
class node_dashboard,node_registration,node_staff_panel,node_records,node_display toneAmber
class node_feedback_form,node_feedback_reports toneMint
class node_login,node_profile,node_user_admin toneRose
class node_server,node_backup,node_supabase,node_socket_service,node_email,node_sheets,node_visitor,node_admin toneIndigo
```

## Components

### Client application

- [Route and providers](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/App.jsx): `client/src/App.jsx`
- [Protected routes](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/components/ProtectedRoute.jsx): `client/src/components/ProtectedRoute.jsx`
- [Navigation sidebar](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/components/Sidebar.jsx): `client/src/components/Sidebar.jsx`
- [Authentication state](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [Socket connection](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/context/SocketContext.jsx): `client/src/context/SocketContext.jsx`
- [Theme state](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/context/ThemeContext.jsx): `client/src/context/ThemeContext.jsx`

### Queue operations

- [Dashboard](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/pages/Dashboard.jsx): `client/src/pages/Dashboard.jsx`
- [Complainant registration](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/pages/Register.jsx): `client/src/pages/Register.jsx`
- [Staff queue panel](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/pages/Staff.jsx): `client/src/pages/Staff.jsx`
- [Record management](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/pages/Records.jsx): `client/src/pages/Records.jsx`
- [Queue display](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/pages/Display.jsx): `client/src/pages/Display.jsx`

### Feedback

- [Feedback forms](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/pages/FeedbackForms.jsx): `client/src/pages/FeedbackForms.jsx`
- [Feedback reports](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/pages/FeedbackReports.jsx): `client/src/pages/FeedbackReports.jsx`

### Accounts and settings

- [Sign-in](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/pages/Login.jsx): `client/src/pages/Login.jsx`
- [Profile settings](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/pages/Profile.jsx): `client/src/pages/Profile.jsx`
- [User administration](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/client/src/pages/ManageUsers.jsx): `client/src/pages/ManageUsers.jsx`

### Backend services

- [API and realtime server](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/server/server.js): `server/server.js`
- [Record backup](https://github.com/skeg-16/nbi-queue-system/blob/mainv3/server/backupJob.js): `server/backupJob.js`
- **Supabase**
- **Socket.IO service**
- **Email service**
- **Google Sheets**

### Other components

- **Visitor**
- **Staff user**
- **Administrator**
- **Display viewer**

## Connections

- Route and providers → Authentication state: provides auth (evidence: `client/src/App.jsx`)
- Route and providers → Socket connection: provides socket (evidence: `client/src/App.jsx`)
- Route and providers → Theme state: provides theme (evidence: `client/src/App.jsx`)
- Route and providers → Sign-in: routes to (evidence: `client/src/App.jsx`)
- Route and providers → Dashboard: routes to (evidence: `client/src/App.jsx`)
- Route and providers → Queue display: routes to (evidence: `client/src/App.jsx`)
- Route and providers → Complainant registration: routes to (evidence: `client/src/App.jsx`)
- Route and providers → Staff queue panel: routes to (evidence: `client/src/App.jsx`)
- Route and providers → Record management: routes to (evidence: `client/src/App.jsx`)
- Route and providers → Feedback forms: routes to (evidence: `client/src/App.jsx`)
- Route and providers → Feedback reports: routes to (evidence: `client/src/App.jsx`)
- Route and providers → Profile settings: routes to (evidence: `client/src/App.jsx`)
- Route and providers → User administration: routes to (evidence: `client/src/App.jsx`)
- Protected routes → Authentication state: checks session (evidence: `client/src/components/ProtectedRoute.jsx`)
- Sign-in → Authentication state: sets session (evidence: `client/src/pages/Login.jsx`)
- Dashboard → Authentication state: reads identity (evidence: `client/src/pages/Dashboard.jsx`)
- Record management → Authentication state: reads identity (evidence: `client/src/pages/Records.jsx`)
- Record management → Socket connection: uses connection (evidence: `client/src/pages/Records.jsx`)
- Record management → Navigation sidebar: renders navigation (evidence: `client/src/pages/Records.jsx`)
- Record management → API and realtime server: requests record APIs (evidence: `client/src/pages/Records.jsx`)
- User administration → Authentication state: reads credentials (evidence: `client/src/pages/ManageUsers.jsx`)
- User administration → API and realtime server: requests user APIs (evidence: `client/src/pages/ManageUsers.jsx`)
- Profile settings → Authentication state: uses account state (evidence: `client/src/pages/Profile.jsx`)
- Profile settings → Theme state: uses theme state (evidence: `client/src/pages/Profile.jsx`)
- Profile settings → Socket connection: uses connection (evidence: `client/src/pages/Profile.jsx`)
- Profile settings → Navigation sidebar: renders navigation (evidence: `client/src/pages/Profile.jsx`)
- Feedback reports → Navigation sidebar: renders navigation (evidence: `client/src/pages/FeedbackReports.jsx`)
- Staff queue panel → Socket connection: uses connection (evidence: `client/src/pages/Staff.jsx`)
- Staff queue panel → Authentication state: reads identity (evidence: `client/src/pages/Staff.jsx`)
- Staff queue panel → Navigation sidebar: renders navigation (evidence: `client/src/pages/Staff.jsx`)
- Complainant registration → Socket connection: uses connection (evidence: `client/src/pages/Register.jsx`)
- Queue display → Socket connection: uses connection (evidence: `client/src/pages/Display.jsx`)
- API and realtime server → Supabase: reads and writes (evidence: `server/server.js`)
- Record backup → Supabase: reads and deletes (evidence: `server/backupJob.js`)
- API and realtime server → Record backup: uses backup job (evidence: `server/server.js`)
- Record backup → Email service: sends backup (evidence: `server/backupJob.js`)
- Record backup → Google Sheets: syncs records (evidence: `server/backupJob.js`)
- Socket connection → Socket.IO service: connects to (evidence: `client/src/context/SocketContext.jsx`)
- API and realtime server → Socket.IO service: hosts realtime (evidence: `server/server.js`)
- Visitor → Complainant registration: submits details
- Staff user → Staff queue panel: handles queue
- Administrator → User administration: manages accounts
- Display viewer → Queue display: views queue
