Multi-Branch Queue Engine – Ticketing, Calling & Live Display System

A production-ready, self-hosted queue / ticketing management system for banks, clinics, hospitals, government service halls, telecom stores and any walk-in service business that needs orderly queuing across multiple locations.

The system cleanly separates the three real-world roles into purpose-built front-ends:

• Kiosk — a touch-friendly self-service dispenser. Visitors pick Branch → Department → Service and receive a numbered ticket (with optional VIP priority that auto-jumps the queue).

• Counter — a staff workbench. Agents open a window session, call the next ticket, start/hold/complete service, transfer, or mark a no-show — every action is written to a ticket event log.

• Display — a public big-screen board that announces the currently-called ticket and the named queue in real time, designed for wall-mounted TVs.

On top of the three screens there is an Admin / Branch Manager back office for managing branches (hard-capped at 3 in the standard license), departments, services, counters and staff, plus a daily operations report with CSV export.

A JWT-protected REST API (fully documented with Swagger / OpenAPI) drives everything and is ready for third-party integration — kiosks, mobile apps, or external CRMs. A configurable outbound webhook pushes ticket lifecycle events (issued / called / serving / completed / no_show / held / transferred) with exponential-backoff retries.

The backend is a single Fastify process that also serves the built Vue front-end from the same origin, so deployment is one command. For evaluation it runs on SQLite with automatic schema sync and seeded demo data — no external database is required to see the full flow working. Switch to MySQL 8 by setting environment variables; the same Sequelize models apply.

This is a focused core engine, not a bloated platform — every feature listed below actually ships, and the honest boundaries are documented.