How njoyc/queueless works
QueueLess serves customers booking appointments or joining FIFO service queues, while staff manage appointments and queue progression. The React client uses REST for application operations and a WebSocket for live queue changes; FastAPI routes implement domain operations, with JWT/role dependencies and SQLAlchemy persistence underneath. The graph includes the documented appointment and organization capabilities even where their implementation was not excerpted; those links are documented rather than inferred from unsampled code.
Main entry points: database.py DB Sessions · App.jsx App Router · api.js REST Client · main.py FastAPI App
Components 23
Customer and Staff Client
- App Router
frontend/src/App.jsx - Auth Context
frontend/src/context/AuthContext.jsx - Service Browser
frontend/src/pages/Services.jsx - Appointments UI
frontend/src/pages/Appointments.jsx - Customer Dashboard
frontend/src/pages/CustomerDashboard.jsx - Queue Status UI
frontend/src/pages/QueuePage.jsx - Staff Dashboard
frontend/src/pages/StaffDashboard.jsx - REST Client
frontend/src/services/api.js
Service Operations
- Organizations
backend/app/api/organizations.py - Service Catalog
backend/app/api/services.py - Appointment Booking
backend/app/api/appointments.py - Queue Operations
backend/app/api/queue.py
Identity and Access
- Authentication API
backend/app/api/auth.py - JWT and Roles
backend/app/core/security.py - Request Authorization
backend/app/core/dependencies.py
API and Persistence
- FastAPI App
backend/app/main.py - DB Sessions
backend/app/db/database.py - Domain Models
backend/app/db/models.py - PostgreSQL
- WebSocket Manager
backend/app/core/websocket_manager.py
Other components
- Customer
- Staff
- Browser
Connections 37
- Browser → App Router: uses
README.md - App Router → Auth Context: uses
frontend/src/App.jsx - App Router → Service Browser: routes to
frontend/src/App.jsx - App Router → Appointments UI: routes to
frontend/src/App.jsx - App Router → Customer Dashboard: routes to
frontend/src/App.jsx - App Router → Queue Status UI: routes to
frontend/src/App.jsx - App Router → Staff Dashboard: routes to
frontend/src/App.jsx - Customer → Service Browser: browses
README.md - Staff → Staff Dashboard: operates
README.md - Service Browser → REST Client: requests
frontend/src/pages/Services.jsx - Appointments UI → REST Client: requests
frontend/src/pages/Appointments.jsx - Customer Dashboard → REST Client: requests
frontend/src/pages/CustomerDashboard.jsx - Queue Status UI → REST Client: requests
frontend/src/pages/QueuePage.jsx - Staff Dashboard → REST Client: requests
frontend/src/pages/StaffDashboard.jsx - Auth Context → REST Client: loads user
frontend/src/context/AuthContext.jsx - REST Client → FastAPI App: REST calls
README.md - Service Catalog → Organizations: reads organization
backend/app/api/services.py - FastAPI App → Authentication API: registers routes
backend/app/main.py - FastAPI App → Organizations: registers routes
backend/app/main.py - FastAPI App → Service Catalog: registers routes
backend/app/main.py - FastAPI App → Appointment Booking: registers routes
backend/app/main.py - FastAPI App → Queue Operations: registers routes
backend/app/main.py - Authentication API → JWT and Roles: hashes and signs
backend/app/api/auth.py - Authentication API → DB Sessions: queries and writes
backend/app/api/auth.py - Appointment Booking → DB Sessions: queries and writes
backend/app/api/appointments.py - Queue Operations → DB Sessions: queries and writes
backend/app/api/queue.py - Service Catalog → DB Sessions: queries and writes
backend/app/api/services.py - Organizations → DB Sessions: queries and writes
backend/app/api/organizations.py - Appointment Booking → Request Authorization: checks access
backend/app/api/appointments.py - Queue Operations → Request Authorization: checks access
backend/app/api/queue.py - Service Catalog → Request Authorization: checks access
backend/app/api/services.py - Request Authorization → JWT and Roles: validates JWT
backend/app/core/dependencies.py - Request Authorization → DB Sessions: loads user
backend/app/core/dependencies.py - DB Sessions → Domain Models: sessions use
backend/app/db/database.py - DB Sessions → PostgreSQL: persists data
README.md - Queue Operations → WebSocket Manager: broadcasts updates
backend/app/api/queue.py - Queue Status UI → WebSocket Manager: receives live updates
README.md