How fotatoe24/busahero-webapp works
BUSAhero is an operator-facing bus fleet dashboard with live bus monitoring, bus details, and distance-based fare settings. Operators register or sign in, then view bus status and map data or edit bus and fare information; session and terms controls gate access. Firebase supplies realtime bus data and fare settings, with simulated buses when Firebase is unavailable. The README also describes fare CRUD, but the sampled Fares page implements fare calculation settings. Some unsampled subsystem relationships are omitted rather than inferred.
Main entry points: useAuth.tsx Auth state · useRealtimeBuses.ts Realtime bus feed · page.tsx Dashboard · route.ts Registration API
Components 24
Identity and access
- Sign-in and registration
app/page.tsx - Auth state
lib/useAuth.tsx - Registration API
app/api/register/route.ts - Login API
app/api/login/route.ts - Session cookies
lib/session.ts - Operator records
lib/supabaseAdmin.ts - Terms acceptance
app/api/accept-terms/route.ts - Access guard
components/AuthGuard.tsx - Terms gate
components/TermsGate.tsx
Fleet monitoring
- Dashboard
app/dashboard/page.tsx - Bus information
app/bus-info/page.tsx - Realtime bus feed
lib/useRealtimeBuses.ts - Bus database
- Status normalization
lib/busStatus.ts - Live bus map
components/RealtimeMap.tsx - Route geometry
lib/routes.ts
Fare management
- Fare settings page
app/fares/page.tsx - Fare settings state
lib/useFareSettings.ts - Fare settings store
- Fare matrix calculator
components/FareMatrixCalculator.tsx - Fare calculation
lib/fareCalculator.ts - Route distances
lib/routeDistances.ts
Shared services
- Firebase client
lib/firebase.ts
Other components
- Fleet operator
Connections 28
- Fleet operator → Sign-in and registration: signs in
app/page.tsx - Sign-in and registration → Auth state: calls auth
app/page.tsx - Auth state → Registration API: posts registration
lib/useAuth.tsx - Registration API → Operator records: creates operator
app/api/register/route.ts - Registration API → Session cookies: creates session
app/api/register/route.ts - Auth state → Login API: posts credentials
lib/useAuth.tsx - Login API → Operator records: checks operator
app/api/login/route.ts - Login API → Session cookies: creates session
app/api/login/route.ts - Auth state → Terms acceptance: accepts terms
lib/useAuth.tsx - Terms acceptance → Session cookies: reads session
app/api/accept-terms/route.ts - Terms acceptance → Operator records: updates acceptance
app/api/accept-terms/route.ts - Dashboard → Access guard: guards page
app/dashboard/page.tsx - Bus information → Access guard: guards page
app/bus-info/page.tsx - Access guard → Auth state: checks operator
components/AuthGuard.tsx - Terms gate → Auth state: checks acceptance
components/TermsGate.tsx - Dashboard → Realtime bus feed: reads buses
app/dashboard/page.tsx - Bus information → Realtime bus feed: reads and updates
app/bus-info/page.tsx - Realtime bus feed → Firebase client: uses database client
lib/useRealtimeBuses.ts - Realtime bus feed → Bus database: subscribes and updates
README.md - Realtime bus feed → Status normalization: normalizes status
lib/useRealtimeBuses.ts - Dashboard → Live bus map: renders map
app/dashboard/page.tsx - Live bus map → Route geometry: uses geometry
components/RealtimeMap.tsx - Fare settings page → Fare settings state: loads settings
app/fares/page.tsx - Fare settings state → Firebase client: uses database client
lib/useFareSettings.ts - Fare settings state → Fare settings store: reads and writes
- Fare settings page → Fare matrix calculator: renders calculator
app/fares/page.tsx - Fare matrix calculator → Fare calculation: calculates fares
components/FareMatrixCalculator.tsx - Fare matrix calculator → Route distances: uses distances
components/FareMatrixCalculator.tsx