Introduction
Q-Flow is a multi-tenant virtual queue management platform for public service centres, banks, hospitals, and government offices.
What it does
Q-Flow replaces physical queues with virtual tokens. Citizens join a queue from their phone, a kiosk, or a web page, track their position in real time, and arrive at the counter only when called. Counter staff call the next token, transfer, defer, recall, or finalise service — all with audit logging and real-time display board updates.
Who it's for
Three roles use the platform day-to-day:
| Role | Audience | Where they live |
|---|---|---|
| Super Admin | Platform operators (Atech) | /admin — cross-tenant cockpit |
Organisation Admin (ADMIN) | Per-org administrators | /admin within their organisation |
Department Manager (MANAGER) | Per-department leads | /admin department-scoped views |
Counter Staff (STAFF) | Counter operators | /[org]/staff dashboard |
Citizens use the public /join and /token/[id] pages and never log in.
What you'll find here
This documentation is organised into three parts:
- Setup Guide — install and configure a self-hosted instance.
- Role Guides — step-by-step usage for staff and org admins.
- Operations & Monitoring — feedback system, monitoring, and common how-to walkthroughs.
For the public REST API used by external integrators, see the separate Enterprise API reference.
If you're a developer working on the codebase itself — agents or humans — the internal architecture and schema references live in the project's docs/ directory and are referenced through AGENTS.md.
Platform highlights
- Multi-tenant SaaS — every record is organisation-scoped; tenant isolation is enforced at the server-action and API layers.
- Real-time — live queue updates, display board sync, and citizen push notifications via Appwrite.
- Bilingual — English + Nepali (Devanagari) across citizen-facing surfaces.
- Multi-channel issuance — web, mobile, SMS, kiosk.
- Notifications — SMS (Sparrow), WhatsApp (Meta), Email (Resend), and Browser Push (web-push VAPID).
- Audit & analytics — per-token audit trail, daily statistics, CSV exports, feedback micro-surveys.
Ready to install? Continue to the Setup Guide.