How bachiep/gove works
Gove is a real-time ride-hailing and logistics platform built as a NestJS modular monolith, with a React web client. Its documented ride workflow spans fare quoting, trip creation, driver matching and acceptance, trip completion, and idempotent payment; the delivery workflow covers order creation through driver custody and handoff. The graph also captures identity, driver onboarding, location, live projections, and operator diagnostics. Several service and repository implementations were not sampled, so uncertain internal links are omitted; documented workflow links are identified as such.
Main entry points: dispatch.service.ts Driver matching · trip.service.ts Trip lifecycle · payment.service.ts Payment handling · App.tsx Web application
Components 28
Web client
- Web application
apps/web/src/App.tsx
Identity
- Authentication service
apps/api/src/identity/auth.service.ts - Identity repository
apps/api/src/identity/identity.repository.ts - Token service
apps/api/src/identity/token.service.ts
Ride lifecycle
- Fare quoting
apps/api/src/pricing/pricing.service.ts - Pricing API
apps/api/src/pricing/pricing.controller.ts - Trip API
apps/api/src/trip/trip.controller.ts - Trip lifecycle
apps/api/src/trip/trip.service.ts - Dispatch API
apps/api/src/dispatch/dispatch.controller.ts - Driver matching
apps/api/src/dispatch/dispatch.service.ts - Payment API
apps/api/src/payment/payment.controller.ts - Payment handling
apps/api/src/payment/payment.service.ts - Payment providers
apps/api/src/payment/payment-provider.ts
Delivery and live state
- Delivery API
apps/api/src/delivery/delivery.controller.ts - Driver delivery offers
apps/api/src/delivery/delivery-offer.controller.ts - Delivery workflow
apps/api/src/delivery/delivery.service.ts - Location API
apps/api/src/location/location.controller.ts - Driver location
apps/api/src/location/location.service.ts - Live projections
apps/api/src/realtime/realtime.gateway.ts
Driver and operations
- Driver profile API
apps/api/src/driver/driver.controller.ts - Driver profiles
apps/api/src/driver/driver.service.ts - Operator API
apps/api/src/operator/operator.controller.ts - Operator workflows
apps/api/src/operator/operator.service.ts
Other components
- Customer
- Driver
- Operator
- PostgreSQL / PostGIS
- SIMULATOR provider
Connections 27
- Customer → Web application: uses
- Driver → Web application: uses
- Operator → Web application: uses
- Pricing API → Fare quoting: calls
- Trip API → Trip lifecycle: calls
- Dispatch API → Driver matching: calls
- Payment API → Payment handling: calls
- Delivery API → Delivery workflow: calls
- Driver delivery offers → Delivery workflow: calls
- Location API → Driver location: calls
- Driver profile API → Driver profiles: calls
- Operator API → Operator workflows: calls
- Authentication service → Identity repository: reads and writes
- Authentication service → Token service: issues and verifies
- Customer → Pricing API: requests quote
- Fare quoting → Trip lifecycle: quote precedes trip
- Trip lifecycle → Driver matching: trip enters matching
- Driver matching → Driver: offers assignment
- Driver → Dispatch API: accepts and updates
- Driver matching → Payment handling: completion precedes payment
- Customer → Payment API: requests capture
- Payment handling → SIMULATOR provider: uses provider
- Customer → Delivery API: creates delivery
- Driver → Driver delivery offers: accepts and updates custody
- Driver → Location API: sends location
- Driver → Driver profile API: manages profile
- Operator → Operator API: reviews and approves