Omar Elshaer · Portfolio

AIU-O-BUS

UNI Transportation System · 2026

University transport system for Alamein International University. It unifies student attendance, bus reservations, and supervisor/admin operations in one web app.

Built with React, Vite, Node.js, Express, Firebase Firestore, Railway

Project Overview

AIU-O-BUS is an Arabic RTL transportation management system for Alamein International University. It allows students to sign in, register weekly attendance, and book early or late buses, while supervisors handle attendance verification through a scanning interface and admins manage schedules, booking rules, and operational reports.

The system replaces manual transport coordination with a centralized Firestore-backed workflow that enforces booking windows, seat limits, and role-based access control to ensure accurate and efficient university transportation management.

Core Features

  • Student login with ID and phone number with optional credential persistence on the device
  • Weekly attendance registration with per-day selection, route assignment, and time-based lock handling
  • Early and late bus booking system with seat availability checks and booking window enforcement
  • Reservation cancellation and rebooking from student dashboard
  • Supervisor barcode scanning with camera support, manual entry, and bulk attendance processing
  • Student profile preview for supervisor verification before attendance submission
  • Admin dashboard for managing schedules, booking windows, system controls, and PDF report exports
  • Connection-aware UI with retry handling and install-to-home-screen support

Technical Highlights

  • SPA architecture with role-based lazy-loaded views using browser History API
  • Firestore caching strategy using TTL and request deduplication for performance optimization
  • Transactional writes and batch updates ensuring consistency of bookings and attendance data
  • Server-side snapshot aggregation across multiple Firestore collections for admin dashboard
  • JWT-based admin authentication with rate limiting for security control
  • Supervisor bulk operations with enforced safety limits
  • PWA support with service worker and manifest enabling installable app experience

Visit the live project