How mnataraj2006/road-logistics-space-utilization works
This is a multi-stop freight capacity and truck-space optimization platform. Customers search corridor capacity, get deterministic quotes, and book shipments; logistics managers plan and approve 3D load assignments, then dispatch and operate trips with stop verification and in-transit re-optimization. The graph also includes analytics and audit capabilities documented by the README. Relationships reflect the excerpts, SOURCE INDEX references, and README; unsampled route wiring and some subsystem internals are not asserted.
Main entry points: engine.js Load-plan optimizer · tripController.js Trip planning API · tripLifecycleService.js Trip lifecycle · App.jsx Role workspaces
Components 24
User experience
- Role workspaces
frontend/src/App.jsx - API client
frontend/src/services/api.js - Load-plan console
frontend/src/views/manager/ManagerOptimizationView.jsx - Load visualizers
frontend/src/components/optimizer/OperationalLoadVisualizer.jsx
API and booking
- Backend API
backend/server.js - Authentication and roles
backend/middleware/auth.js - Capacity search and booking
backend/services/capacitySearchService.js - Deterministic pricing
backend/services/pricingService.js
Fleet operations
- Trip planning API
backend/controllers/tripController.js - Trip lifecycle
backend/services/tripLifecycleService.js - Dynamic re-optimization
backend/services/dynamicReoptimizationService.js - Audit ledger
backend/services/auditService.js
Optimization and analytics
- Load-plan optimizer
backend/optimizer/engine.js - Local search solver
backend/optimizer/localSearch.js - 3D spatial engine
backend/optimizer/spatialEngine.js - Constraint validation
backend/optimizer/validator.js - Prediction and analytics
analytics/app/routes.py
Operational records
- Booking and shipment records
backend/models/Booking.js - Trip and route records
backend/models/Trip.js - Load-plan records
backend/models/LoadPlan.js
Other components
- Customer
- Logistics manager
- Driver
- MongoDB
Connections 29
- Customer → Role workspaces: uses
- Logistics manager → Role workspaces: uses
- Driver → Role workspaces: uses
- Role workspaces → API client: requests data
- API client → Backend API: calls
- Backend API → Authentication and roles: protects routes
backend/server.js - Backend API → Capacity search and booking: serves capacity
- Capacity search and booking → Deterministic pricing: calculates quotes
backend/services/capacitySearchService.js - Capacity search and booking → Booking and shipment records: writes bookings
backend/services/capacitySearchService.js - Booking and shipment records → MongoDB: persists
- Trip planning API → Load-plan optimizer: generates plans
backend/controllers/tripController.js - Load-plan optimizer → Local search solver: solves packing
backend/optimizer/engine.js - Load-plan optimizer → 3D spatial engine: checks placements
backend/optimizer/engine.js - Load-plan optimizer → Constraint validation: validates input
backend/optimizer/engine.js - 3D spatial engine → Constraint validation: checks bounds
backend/optimizer/spatialEngine.js - Trip planning API → Load-plan records: stores assignments
backend/controllers/tripController.js - Load-plan records → MongoDB: persists
- Load-plan console → API client: requests plans
frontend/src/views/manager/ManagerOptimizationView.jsx - Load-plan console → Load visualizers: renders loads
frontend/src/views/manager/ManagerOptimizationView.jsx - Logistics manager → Trip planning API: runs and approves
- Trip planning API → Trip and route records: reads trip data
backend/controllers/tripController.js - Trip and route records → MongoDB: persists
- Logistics manager → Trip lifecycle: operates trip
- Driver → Trip lifecycle: verifies stops
- Trip lifecycle → Dynamic re-optimization: rebalances downstream
backend/services/tripLifecycleService.js - Dynamic re-optimization → Load-plan optimizer: rebuilds plan
backend/services/dynamicReoptimizationService.js - Trip lifecycle → Audit ledger: records events
backend/services/tripLifecycleService.js - Logistics manager → Audit ledger: inspects ledger
- Logistics manager → Prediction and analytics: reviews forecasts