geoffkats/QueueFlow

A comprehensive digital queue management solution built with React and Firebase, designed to solve real-world service delivery challenges in Uganda's hospitals, banks, government offices, and campus service points. # QueueFlow - Smart Queue Management System A comprehensive digital queue management solution built with React and Firebase, featuring mathematical triage algorithms, real-time priority request system, and zero-budget WhatsApp notifications. Designed to solve real-world service delivery challenges in Uganda's hospitals, banks, government offices, and campus service points. ## 🎯 Problem Statement In many service centers across Uganda, clients face: - **Long waiting times** and wasted productive hours - **Overcrowding** in waiting areas (stressful and unsafe, especially in health facilities) - **Unfair service delivery** where vulnerable groups (emergencies, seniors, people with disabilities, pregnant mothers) are not consistently prioritized - **Lack of transparency** - clients don't know their position, expected wait time, or why others are being served first - **Poor accountability** and planning - management lacks reliable data on peak hours, average service time, and service bottlenecks ## ✨ Solution Features QueueFlow provides a complete digital transformation: - **Mathematical Triage Algorithm** with fairness guarantees and anti-starvation mechanisms - **Real-time Priority Request System** where customers can request priority review with instant staff notifications - **Zero-Budget WhatsApp Integration** using Click-to-Chat API for instant customer notifications - **Smart wait time calculations** using actual service data with confidence indicators - **Professional TV displays** for waiting rooms with real-time updates - **Mobile-first PWA** that works offline with service worker caching - **Real-time synchronization** across all devices using Firebase listeners ( 10 samples) | Medium (5-10) | Low ( cd queueflow # Install dependencies npm install # Configure Firebase (see FIREBASE_SETUP.md) # Update src/firebase/config.js with your Firebase credentials # Start development server npm start # Build for production npm run build ``` ### Firebase Setup 1. C …