How aljayvee/capstone_system_project works
SUGO On-The-Go is an operations portal for delivery logistics, with owner administration and dispatcher fulfillment as its main workflows. Users sign in, enter a role-protected portal, and manage fleet/business operations or triage errands through dispatch, customer chat, and settlement. The graph preserves major README capabilities even where their implementation was not sampled; those subsystem paths point to existing directories. Edges use route/source evidence or documented capabilities, so some internal feature-to-feature calls are intentionally omitted.
Main entry points: OwnerPortal.tsx Owner portal · dispatcher Errand triage · LoginPage.tsx Sign-in · apiService.ts API methods
Components 26
Access and sessions
- Sign-in
src/components/LoginPage.tsx - Auth session
src/context/AuthContext.tsx - Role routes
src/app/routes.tsx
Dispatcher fulfillment
- Dispatcher portal
src/portals/dispatcher/DispatcherPortal.tsx - Errand triage
src/portals/dispatcher - Order chat
src/portals/dispatcher/components/order-chat - Store pinning
src/portals/dispatcher/components/order-chat/hooks/useStorePins.ts - Exception review
src/portals/dispatcher/components - Cash reconciliation
src/portals/owner/modules/reports
Owner administration
- Owner portal
src/portals/owner/OwnerPortal.tsx - Business dashboard
src/portals/owner/modules/dashboard - Financial reports
src/portals/owner/modules/reports - Staff management
src/portals/owner/modules/users - Rider fleet
src/portals/owner/modules/riders - Live tracking
src/portals/owner/modules/tracking - Merchant categories
src/portals/owner/modules/merchants - Service rates
src/portals/owner/modules/rates/ServiceRatesModule.tsx - Places directory
src/portals/owner/screens/PlacesDirectoryScreen.tsx
Shared services
- API methods
src/services/apiService.ts - HTTP client
src/services/apiClient.ts - Realtime session
src/firebase/realtimeSession.ts - Firebase database
src/firebase/config.ts - Fleet presence feed
src/hooks/useRiderFleetPresence.ts
Backend and data
- Backend API
Backend/src/server.js - SQL database
Backend/src/db.js
Other components
- Staff user
Connections 29
- Staff user → Sign-in: signs in
- Sign-in → Auth session: establishes session
src/components/LoginPage.tsx - Sign-in → API methods: requests login
src/services/apiService.ts - Auth session → HTTP client: refreshes token
src/context/AuthContext.tsx - Auth session → Realtime session: starts session
src/context/AuthContext.tsx - Role routes → Sign-in: routes guests
src/app/routes.tsx - Role routes → Owner portal: protects owner route
src/app/routes.tsx - Role routes → Dispatcher portal: protects dispatcher route
src/app/routes.tsx - Dispatcher portal → Errand triage: coordinates dispatch
README.md - Errand triage → Order chat: opens errand chat
README.md - Order chat → Store pinning: pins stores
src/portals/dispatcher/components/order-chat/hooks/useStorePins.ts - Errand triage → Exception review: triages exceptions
README.md - Errand triage → Cash reconciliation: reconciles cash
README.md - Dispatcher portal → API methods: loads operations data
README.md - Owner portal → Business dashboard: presents metrics
README.md - Owner portal → Financial reports: opens reports
README.md - Owner portal → Staff management: manages users
README.md - Owner portal → Rider fleet: manages riders
README.md - Owner portal → Live tracking: tracks fleet
README.md - Owner portal → Merchant categories: configures categories
README.md - Owner portal → Service rates: configures rates
src/portals/owner/modules/rates/ServiceRatesModule.tsx - Owner portal → Places directory: opens directory
src/app/routes.tsx - Owner portal → Fleet presence feed: loads fleet presence
src/hooks/useRiderFleetPresence.ts - Fleet presence feed → Firebase database: reads telemetry
src/hooks/useRiderFleetPresence.ts - Fleet presence feed → API methods: loads rider roster
src/hooks/useRiderFleetPresence.ts - API methods → HTTP client: sends requests
src/services/apiService.ts - Realtime session → HTTP client: requests auth token
src/firebase/realtimeSession.ts - HTTP client → Backend API: calls API
README.md - Backend API → SQL database: queries SQL
Backend/src/server.js