How skeg-16/nbi-queue-system works
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: App.jsx Route and providers · AuthContext.jsx Authentication state · SocketContext.jsx Socket connection · Records.jsx Record management
Components 26
Client application
- Route and providers
client/src/App.jsx - Protected routes
client/src/components/ProtectedRoute.jsx - Navigation sidebar
client/src/components/Sidebar.jsx - Authentication state
client/src/context/AuthContext.jsx - Socket connection
client/src/context/SocketContext.jsx - Theme state
client/src/context/ThemeContext.jsx
Queue operations
- Dashboard
client/src/pages/Dashboard.jsx - Complainant registration
client/src/pages/Register.jsx - Staff queue panel
client/src/pages/Staff.jsx - Record management
client/src/pages/Records.jsx - Queue display
client/src/pages/Display.jsx
Feedback
- Feedback forms
client/src/pages/FeedbackForms.jsx - Feedback reports
client/src/pages/FeedbackReports.jsx
Accounts and settings
- Sign-in
client/src/pages/Login.jsx - Profile settings
client/src/pages/Profile.jsx - User administration
client/src/pages/ManageUsers.jsx
Backend services
- API and realtime server
server/server.js - Record backup
server/backupJob.js - Supabase
- Socket.IO service
- Email service
- Google Sheets
Other components
- Visitor
- Staff user
- Administrator
- Display viewer
Connections 43
- Route and providers → Authentication state: provides auth
client/src/App.jsx - Route and providers → Socket connection: provides socket
client/src/App.jsx - Route and providers → Theme state: provides theme
client/src/App.jsx - Route and providers → Sign-in: routes to
client/src/App.jsx - Route and providers → Dashboard: routes to
client/src/App.jsx - Route and providers → Queue display: routes to
client/src/App.jsx - Route and providers → Complainant registration: routes to
client/src/App.jsx - Route and providers → Staff queue panel: routes to
client/src/App.jsx - Route and providers → Record management: routes to
client/src/App.jsx - Route and providers → Feedback forms: routes to
client/src/App.jsx - Route and providers → Feedback reports: routes to
client/src/App.jsx - Route and providers → Profile settings: routes to
client/src/App.jsx - Route and providers → User administration: routes to
client/src/App.jsx - Protected routes → Authentication state: checks session
client/src/components/ProtectedRoute.jsx - Sign-in → Authentication state: sets session
client/src/pages/Login.jsx - Dashboard → Authentication state: reads identity
client/src/pages/Dashboard.jsx - Record management → Authentication state: reads identity
client/src/pages/Records.jsx - Record management → Socket connection: uses connection
client/src/pages/Records.jsx - Record management → Navigation sidebar: renders navigation
client/src/pages/Records.jsx - Record management → API and realtime server: requests record APIs
client/src/pages/Records.jsx - User administration → Authentication state: reads credentials
client/src/pages/ManageUsers.jsx - User administration → API and realtime server: requests user APIs
client/src/pages/ManageUsers.jsx - Profile settings → Authentication state: uses account state
client/src/pages/Profile.jsx - Profile settings → Theme state: uses theme state
client/src/pages/Profile.jsx - Profile settings → Socket connection: uses connection
client/src/pages/Profile.jsx - Profile settings → Navigation sidebar: renders navigation
client/src/pages/Profile.jsx - Feedback reports → Navigation sidebar: renders navigation
client/src/pages/FeedbackReports.jsx - Staff queue panel → Socket connection: uses connection
client/src/pages/Staff.jsx - Staff queue panel → Authentication state: reads identity
client/src/pages/Staff.jsx - Staff queue panel → Navigation sidebar: renders navigation
client/src/pages/Staff.jsx - Complainant registration → Socket connection: uses connection
client/src/pages/Register.jsx - Queue display → Socket connection: uses connection
client/src/pages/Display.jsx - API and realtime server → Supabase: reads and writes
server/server.js - Record backup → Supabase: reads and deletes
server/backupJob.js - API and realtime server → Record backup: uses backup job
server/server.js - Record backup → Email service: sends backup
server/backupJob.js - Record backup → Google Sheets: syncs records
server/backupJob.js - Socket connection → Socket.IO service: connects to
client/src/context/SocketContext.jsx - API and realtime server → Socket.IO service: hosts realtime
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