Maliban Uththama Pranama – Wheelchair Reservation & Ground Dispatch Platform
Maliban Uththama Pranama (මැලිබන් උත්තම ප්රණාම) is a mission-critical, full-stack wheelchair reservation, real-time fleet inventory tracking, and QR-based ground dispatch system engineered for Maliban’s premier corporate social responsibility (CSR) pilgrimage initiative during the sacred Poson Poya festival in Sri Lanka. Tailored to serve thousands of elderly, ailing, and differently-abled pilgrims with comfort and dignity, the application eliminates chaotic manual paper queues through an intuitive, bilingual mobile-first reservation portal, rapid SMS OTP verification, and high-speed camera scanner verification for on-ground volunteer agents stationed across high-density pilgrimage temple grounds.
🌟 Key Features:
SMS OTP Verification & Passwordless Onboarding: Streamlined pilgrim authentication integrated with the Text.lk SMS gateway API, featuring SHA-256 hashed one-time passwords, mobile number normalization (+94 format), district selection, and instant custom token issuance without password friction.
Dynamic Date & Time-Slot Allocation Engine: Granular control over pilgrimage event date ranges and hourly reservation windows, enforcing real-time quota caps per slot to prevent overcrowding and ensure guaranteed equipment availability.
Offline-Ready Digital QR Pass Generation: Instant client-side rendered booking pass using qrcode.react and HTML5 Canvas, allowing pilgrims to save their verified QR pass directly to their smartphone gallery for offline validation at remote temple zones with intermittent cellular reception.
Contactless Dual-Scan Ground Agent Verification: Integrated camera-based scanner powered by html5-qrcode that operates directly inside mobile browsers without native app installs. Implements dual-scan lifecycle transitions: Scan 1 for wheelchair dispatch and identity verification, and Scan 2 for return intake and automatic inventory replenishment.
Automated Session Timeout & Overdue Tracking: Configurable wheelchair usage timer (defaulting to 45 minutes per reservation) tracking active loans in real-time, providing ground personnel with immediate visibility into overdue equipment to maintain rapid turnaround times.
Real-Time Fleet & Station Administration: Centralized dashboard for managers and administrators to monitor live fleet statuses (Available, In-Use, Returned, Overdue), manage agent access, provision time-slot capacities, and analyze pilgrim regional distribution.
Multi-Role RBAC & Secure Session Architecture: Robust role-based access control (Admin, Manager, Agent, User) enforced through the Firebase Admin SDK using HttpOnly signed session cookies, cryptographic token verification, and strict API route guards.
Localized Bilingual Experience (Sinhala & English): Fully native i18n implementation with instant language switching between Sinhala and English, featuring respectful cultural phrasing, clear typography, and accessible visual hierarchy.
🛠️ Technologies Used:
Next.js 14+ (App Router & Server-Side Rendering)
TypeScript
React 18+ / React DOM
Node.js & Express.js Backend API
Firebase Realtime Database (Live Multi-Client State Sync)
Firebase Authentication & Firebase Admin SDK
Text.lk SMS Gateway Integration (One-Time Password Pipeline)
Tailwind CSS & Tailwind Animate
Shadcn UI & Radix UI Primitives (Dialog, Card, Button, Tabs, Sonner Toast)
Html5-Qrcode (In-Browser Camera QR Code Scanner)
Progressive Web App (PWA) & Workbox Service Worker Caching
Lucide React Iconography
📦 Highlights:
• Real-Time Dual-Scan QR Dispatch & Return Lifecycle Tracking
• Passwordless Pilgrim Onboarding via Text.lk SMS OTP Engine
• Sub-Second Realtime Fleet Synchronization across Concurrent Ground Stations
• Offline-Capable Digital QR Pass with Client-Side Canvas Image Export
• Automated 45-Minute Usage Countdown & Overdue Fleet Recovery Alerts
• Granular Multi-Tier RBAC (Admin, Station Manager, Field Agent, Pilgrim)
• Native Bilingual Localization in Sinhala and English
• Mobile-Optimized Zero-Install Field Scanner for Volunteer Staff
🔖 Skills:
Full-Stack Web Development (Next.js App Router + Node.js/Express)
Real-Time Database Architecture & State Synchronization (Firebase)
In-Browser Camera Hardware Access & QR Code Scanning
Telecommunications & SMS Gateway Integration (OTP Authentication)
Role-Based Access Control (RBAC) & Cryptographic Session Management
Progressive Web Application (PWA) Offline Architecture
Bilingual Localization (i18n) & Mobile-First Accessibility
Event Logistics & High-Volume Public Sector Mobility Systems
