How irfanabdul1108/linehaul_project_automation works
Linehaul is a warehouse-scoped freight planning and dispatch application. Operators select a warehouse, review orders and routes, assign orders manually or through recommendations and batch automation, then manage route resources and dispatch. The frontend also provides dashboard, driver/vehicle management, and a chat assistant. Backend subsystems are represented from the repository tree; their internal calls are not shown in the supplied excerpts, so those relationships are omitted.
Main entry points: App.jsx App shell · controller REST controllers · api.js API client · Routes.jsx Route management
Components 21
Operator app
- App shell
frontend/src/App.jsx - Dashboard
frontend/src/pages/Dashboard.jsx - Order management
frontend/src/pages/Orders.jsx - Fleet management
frontend/src/pages/Drivers.jsx - Chat assistant
frontend/src/components/ChatAssistant.jsx
Planning workflow
- Route management
frontend/src/pages/Routes.jsx - Smart assignment
frontend/src/components/SmartAssignModal.jsx - Batch assignment
frontend/src/components/AutoAssignModal.jsx - Assignment client
frontend/src/services/automation.js - Lane validation
frontend/src/services/routeLane.js
Linehaul backend
- REST controllers
backend/src/main/java/com/example/linehaul/controller - Assignment engine
backend/src/main/java/com/example/linehaul/automation - AI advisor
backend/src/main/java/com/example/linehaul/automation/ai - Domain services
backend/src/main/java/com/example/linehaul/service - Data repositories
backend/src/main/java/com/example/linehaul/repository - Linehaul data
Shared services
- Warehouse scope
frontend/src/services/warehouse.js - Chat client
frontend/src/services/chatService.js - API client
frontend/src/services/api.js
Other components
- Operator
- Google Gemini
Connections 27
- Operator → App shell: uses
frontend/src/App.jsx - App shell → Warehouse scope: checks scope
frontend/src/App.jsx - App shell → Dashboard: routes to
frontend/src/App.jsx - App shell → Order management: routes to
frontend/src/App.jsx - App shell → Route management: routes to
frontend/src/App.jsx - App shell → Fleet management: routes to
frontend/src/App.jsx - App shell → Chat assistant: renders
frontend/src/App.jsx - Dashboard → API client: loads summary
frontend/src/pages/Dashboard.jsx - Order management → API client: loads orders
frontend/src/pages/Orders.jsx - Route management → API client: manages routes
frontend/src/pages/Routes.jsx - Route management → Lane validation: checks lane
frontend/src/pages/Routes.jsx - Dashboard → Smart assignment: opens assignment
frontend/src/pages/Dashboard.jsx - Order management → Smart assignment: opens assignment
frontend/src/pages/Orders.jsx - Route management → Smart assignment: opens assignment
frontend/src/pages/Routes.jsx - Smart assignment → Assignment client: requests advice
frontend/src/components/SmartAssignModal.jsx - Batch assignment → Assignment client: assigns orders
frontend/src/components/AutoAssignModal.jsx - Chat assistant → Chat client: asks question
frontend/src/components/ChatAssistant.jsx - Chat client → REST controllers: posts chat
frontend/src/services/chatService.js - API client → Warehouse scope: scopes requests
frontend/src/services/api.js - API client → REST controllers: calls REST endpoints
frontend/src/services/api.js - Assignment client → REST controllers: calls automation endpoints
- REST controllers → Assignment engine: delegates
- REST controllers → Domain services: delegates
- Assignment engine → AI advisor: may consult
- AI advisor → Google Gemini: requests advice
- Domain services → Data repositories: uses
- Data repositories → Linehaul data: reads and writes