How tinashe2023/ner-logistics-intelligence works
The repository is an early-stage logistics intelligence platform: it presents corridor risk and compares risk-aware routes, while supporting driver incident reports and dispatcher review. The main route-request path is visible in the sampled React app and FastAPI routes. README capabilities also include environmental risk inputs and incident-driven network updates. Some feature-processing and admin modules are represented by their exact tree paths, but their internal wiring was not sampled, so uncertain links are omitted.
Main entry points: routes.py Intelligence API · App.jsx Dashboard app · incidents.php Dispatcher admin · api.js API client
Components 18
Route dashboard
- Dashboard app
frontend/src/App.jsx - Route controls
frontend/src/components/ControlPanel.jsx - Risk map
frontend/src/components/RiskMap.jsx - API client
frontend/src/api.js
Routing intelligence
- Intelligence API
backend/app/api/routes.py - API entrypoint
backend/app/main.py - Risk scoring
backend/app/risk/risk_score.py - Risk-aware router
backend/app/routing/risk_aware_router.py - Graph loader
backend/app/db/graph_loader.py - Feature processing
backend/scripts
Incident operations
- Dispatcher admin
php-admin/public/incidents.php - Admin authentication
php-admin/includes/auth.php - Incident records
backend/app/models/incident.py
Network data
- Database access
backend/app/db/database.py - Incident store
- Road and incident data
backend/data
Other components
- Dispatcher
- Driver
Connections 18
- Driver → Dashboard app: uses dashboard
- Dispatcher → Dispatcher admin: reviews reports
- Dashboard app → API client: requests data
- Dashboard app → Route controls: renders controls
- Dashboard app → Risk map: renders map
- API client → Intelligence API: calls API
- API entrypoint → Intelligence API: mounts routes
- Intelligence API → Graph loader: loads graph
- Intelligence API → Risk-aware router: computes route
- Intelligence API → Database access: opens session
- Database access → Incident store: connects
- Intelligence API → Incident records: queries records
- Incident records → Incident store: maps table
- Intelligence API → Graph loader: bumps nearby risk
- Dispatcher admin → Admin authentication: checks login
- Dispatcher admin → Incident store: reads and updates
- Feature processing → Road and incident data: processes features
- Risk scoring → Risk-aware router: scores inform cost