How arunkumar-codec/skip-line works
Skip Line is a FastAPI digital queue and virtual-token platform for customers, walk-ins, employees, and organization operators. Its central flow is booking: customers check service availability, reserve a token, then track queue progress and receive turn notifications; staff operate counters and advance tokens. The product also includes organization administration, payments, multi-stage workflows, kiosk/display access, and an optional AI booking assistant. The graph reflects documented capabilities and indexed references; unsampled router and service implementations limit some call-level evidence.
Main entry points: main.py FastAPI app · database.py SQL database · token_service.py Token lifecycle · schedule_service.py Availability and slots
Components 21
Application entry
- FastAPI app
app/main.py - Authentication
app/routers/auth.py - Public booking
app/routers/public.py - Token endpoints
app/routers/tokens.py
Booking and queue
- Availability and slots
app/services/schedule_service.py - Token lifecycle
app/services/token_service.py - Token records
models/token.py - Schedule and capacity
models/weekly_schedule.py
Organization operations
- Organization management
app/routers/org.py - Employee and shifts
app/services/shift_service.py - Admin oversight
app/routers/admin.py - Service workflows
app/routers/workflow.py - Payments
app/routers/payments.py
Customer engagement
- AI booking assistant
app/routers/ai.py - Notifications
app/routers/notifications.py - Live queue updates
app/routers/websocket.py - Display and kiosk
app/routers/public.py
Platform services
- SQL database
app/database.py - Runtime configuration
app/config.py - WebSocket delivery
app/websocket/manager.py
Other components
- Customer / kiosk
Connections 30
- Customer / kiosk → FastAPI app: uses
README.md - FastAPI app → Authentication: registers
app/main.py - FastAPI app → Public booking: registers
app/main.py - FastAPI app → Token endpoints: registers
app/main.py - FastAPI app → Organization management: registers
app/main.py - FastAPI app → Admin oversight: registers
app/main.py - FastAPI app → Payments: registers
app/main.py - FastAPI app → Notifications: registers
app/main.py - FastAPI app → Live queue updates: registers
app/main.py - Token endpoints → Token lifecycle: dispatches
- Public booking → Availability and slots: checks availability
- Token lifecycle → Availability and slots: checks slots
app/services/token_service.py - Token lifecycle → Token records: creates and updates
app/services/token_service.py - Availability and slots → Schedule and capacity: resolves hours
app/services/schedule_service.py - Availability and slots → SQL database: queries
app/services/schedule_service.py - Token lifecycle → SQL database: persists bookings
app/services/token_service.py - Authentication → SQL database: uses sessions
app/routers/auth.py - Organization management → SQL database: manages organization
app/routers/org.py - Employee and shifts → SQL database: updates shifts
app/services/shift_service.py - Admin oversight → SQL database: manages records
- Service workflows → SQL database: tracks stages
- Payments → SQL database: records payments
- AI booking assistant → Customer / kiosk: assists booking
README.md - Token lifecycle → Notifications: triggers notices
- Token lifecycle → WebSocket delivery: broadcasts queue state
app/services/token_service.py - Live queue updates → WebSocket delivery: serves connections
- Display and kiosk → Customer / kiosk: shows queue
README.md - FastAPI app → Runtime configuration: loads settings
app/main.py - SQL database → Runtime configuration: configures engine
app/database.py - WebSocket delivery → Runtime configuration: reads settings
app/websocket/manager.py