How nesamcabs/nesam_cabs works
Nesam Travels is a ride-booking and travel-operations product with customer, driver, and admin applications backed by shared Firebase services and server functions. The customer journey covers booking and ride follow-through; drivers manage verification, trips, and earnings; admins configure services and fares and oversee bookings and operations. The graph includes documented app entry points and fare administration. The README has no product detail, and sampled source is limited, so unverified backend and cross-app relationships are omitted.
Main entry points: src/App.tsx Admin console · fixedRoutes.ts Fixed route fares · app/App.tsx Customer app · driver/App.tsx Driver app
Components 29
Customer booking
- Customer app
user/app/App.tsx - Customer journeys
user/app/src/screens - Quote workflow
user/app/src/hooks/useServerQuotes.ts - Customer auth
user/app/src/services/authService.ts - Customer website
user/web/src/App.tsx
Driver operations
- Driver app
driver/App.tsx - Driver journeys
driver/src/screens - Driver auth
driver/src/services/authService.ts - Driver records
driver/src/services/driverService.ts - Driver domain
driver/src/types/driver.ts
Admin operations
- Admin console
admin/src/App.tsx - Booking oversight
admin/src/pages/BookingDetails.tsx - Local taxi
admin/src/pages/LocalTaxi.tsx - Pricing workspace
admin/src/pages/Pricing.tsx - Service catalog
admin/src/pages/Services.tsx - Location setup
admin/src/pages/Locations.tsx - Reviews
admin/src/pages/Reviews.tsx - Tour packages
admin/src/pages/TourPackages.tsx - Fare calculation
admin/src/services/fareEngine.ts
Server capabilities
- Callable services
functions/src/index.ts - Fixed route fares
functions/src/fixedRoutes.ts - Server permissions
functions/src/admin.ts - Server helpers
functions/src/shared.ts - Fare scope
functions/src/fareScope.ts - Audit records
functions/src/audit.ts
Other components
- Customer
- Driver
- Admin staff
- Firebase data
Connections 26
- Customer → Customer app: uses
- Customer app → Customer auth: subscribes to auth
user/app/App.tsx - Customer app → Customer journeys: opens journeys
user/app/App.tsx - Customer → Customer website: uses website
- Customer → Quote workflow: requests quotes
- Driver → Driver app: uses
- Driver app → Driver auth: subscribes to auth
driver/App.tsx - Driver app → Driver journeys: opens approved workspace
driver/App.tsx - Driver records → Firebase data: reads and writes
driver/src/services/driverService.ts - Driver records → Driver domain: maps records
driver/src/services/driverService.ts - Admin staff → Admin console: uses
- Admin console → Booking oversight: routes to
admin/src/App.tsx - Admin console → Local taxi: routes to
admin/src/App.tsx - Admin console → Reviews: routes to
admin/src/App.tsx - Admin console → Service catalog: routes to
admin/src/App.tsx - Admin console → Pricing workspace: routes to
admin/src/App.tsx - Admin console → Location setup: routes to
admin/src/App.tsx - Admin console → Tour packages: routes to
admin/src/App.tsx - Service catalog → Firebase data: saves services
admin/src/pages/Services.tsx - Pricing workspace → Fare calculation: calculates fares
- Callable services → Fixed route fares: exports callable
- Fixed route fares → Server permissions: checks permission
functions/src/fixedRoutes.ts - Fixed route fares → Server helpers: uses helpers
functions/src/fixedRoutes.ts - Fixed route fares → Fare scope: parses scope
functions/src/fixedRoutes.ts - Fixed route fares → Audit records: records changes
functions/src/fixedRoutes.ts - Fixed route fares → Firebase data: reads and writes
functions/src/fixedRoutes.ts