How ricardoalvim/biga-fleet-manager works
Biga Fleet Manager is a multi-tenant fleet operations platform with a React portal and NestJS API. Users manage vehicles, trips and routes, maintenance, fuel reconciliation and toll/incident records; operators also monitor live telemetry, while tenant administrators manage onboarding, users, billing, branding and integrations. The graph shows the portal-to-API boundary, telemetry ingestion and streaming, and representative domain services and stores. Several subsystem links reflect README-described capabilities; sampled source confirms the specific controller-to-service and ingestion calls shown, but not all internal wiring.
Main entry points: main.ts NestJS API · api.ts API client · fuel.controller.ts Fuel reconciliation · incident-toll.controller.ts Tolls and incidents
Components 25
Tenant portal
- Portal application
frontend/src/App.tsx - API client
frontend/src/services/api.ts - Fleet views
frontend/src/fleet/FleetManagementView.tsx - Maintenance view
frontend/src/maintenance/MaintenanceManagementView.tsx - Live fleet map
frontend/src/realtime/LiveFleetMap.tsx - Tenant admin
frontend/src/app/TenantDashboard.tsx
Fleet operations
- Vehicles and trips
src/fleet/vehicle/controllers/vehicle.controller.ts - Route planning
src/fleet/route-planning/controllers/route-planning.controller.ts - Maintenance orders
src/fleet/maintenance/controllers/maintenance.controller.ts - Fuel reconciliation
src/fleet/fuel/controllers/fuel.controller.ts - Tolls and incidents
src/fleet/incident-toll/controllers/incident-toll.controller.ts
Telemetry and streaming
- Telemetry ingestion
src/ingestion/ingestion.controller.ts - Ingestion publisher
src/ingestion/ingestion.publisher.ts - Telemetry processor
src/telemetry/telemetry-processor.service.ts - Realtime streaming
src/platform/streaming/services/realtime-streaming.internal.service.ts
Platform services
- NestJS API
src/main.ts - Tenant context
src/tenancy/tenant.middleware.ts - Portal services
src/platform/portal/services/portal.internal.service.ts - Authentication
src/platform/auth/services/auth.internal.service.ts - Tenant ecosystem
src/platform/ecosystem/services/platform-ecosystem.internal.service.ts
Persistence
- Relational store
src/platform/persistence/prisma.service.ts - Document store
src/platform/mongo/mongo.module.ts - Redis event bus
src/platform/redis/redis.module.ts
Other components
- Fleet user
- Fleet integrations
Connections 29
- Fleet user → Portal application: uses
- Portal application → API client: requests
- API client → NestJS API: REST calls
- NestJS API → Tenant context: resolves tenant
- NestJS API → Authentication: authenticates
- NestJS API → Portal services: dispatches portal
- NestJS API → Tenant ecosystem: dispatches platform
- NestJS API → Vehicles and trips: dispatches fleet
- NestJS API → Route planning: dispatches routes
- NestJS API → Maintenance orders: dispatches maintenance
- NestJS API → Fuel reconciliation: dispatches fuel
- NestJS API → Tolls and incidents: dispatches tolls
- NestJS API → Telemetry ingestion: dispatches ingest
- Vehicles and trips → Relational store: persists records
- Fuel reconciliation → Document store: stores audits
- Maintenance orders → Document store: stores orders
- Tolls and incidents → Document store: stores events
- Telemetry ingestion → Ingestion publisher: publishes envelope
- Ingestion publisher → Telemetry processor: forwards telemetry
- Telemetry processor → Realtime streaming: emits events
- Realtime streaming → Redis event bus: broadcasts events
- Live fleet map → API client: requests live data
- Fleet views → API client: requests fleet data
- Maintenance view → API client: requests orders
- Tenant admin → API client: requests portal data
- Fleet integrations → Telemetry ingestion: sends telemetry
- Fleet integrations → Fuel reconciliation: submits transactions
- Fleet integrations → Tolls and incidents: submits toll events
- Tenant ecosystem → Fleet integrations: dispatches webhooks