How montassartayachi/smartroute works
SmartRoute is a Flask logistics backend whose central workflow generates daily delivery missions: select eligible deliveries, cluster them geographically, assign drivers and vehicle capacity, order pickup/delivery stops, refine route estimates, and persist missions while updating delivery assignments. It also exposes delivery, authentication, tracking, route, and optimization-configuration APIs. The mission pipeline is documented in the README; source-index references support several module links, but unsampled implementations are not inferred beyond those references.
Main entry points: main.py Flask application · mission_service.py Mission orchestration · missions.py Mission routes · mongodb.py MongoDB
Components 27
HTTP and access
- Flask application
app/main.py - Authentication routes
app/routers/auth.py - Delivery routes
app/routers/deliveries.py - Mission routes
app/routers/missions.py - Optimization settings routes
app/routers/admin_optimization.py - Tracking routes
app/routers/tracking.py - Authentication service
app/services/auth_service.py - Request access checks
app/dependencies.py - Socket.IO service
app/socket_manager.py
Mission planning
- Mission orchestration
app/services/mission_service.py - Geographic clustering
app/services/clustering_service.py - Driver assignment
app/services/driver_assignment_service.py - Optimization settings
app/services/optimization_settings_service.py
Optimization
- Capacity allocation
app/algorithms/capacity_optimizer.py - Assignment strategies
app/algorithms/assignment_algorithms.py - Route ordering
app/services/route_optimizer.py - Route strategies
app/algorithms/route_strategies.py - Nearest neighbor
app/algorithms/nearest_neighbor.py - Route refinement
app/algorithms/route_refiner.py - OSRM routing
app/services/osm_routing_service.py
Domain and persistence
- Delivery management
app/services/delivery_service.py - Mission model
app/models/mission.py - Delivery API schema
app/schemas/delivery.py - MongoDB
app/db/mongodb.py - Database initialization
app/db/init_db.py
Other components
- Dispatcher
- OSRM service
Connections 38
- Dispatcher → Flask application: sends requests
app/main.py - Flask application → MongoDB: connects to
app/main.py - Flask application → Database initialization: initializes
app/main.py - Flask application → Mission routes: registers
app/main.py - Flask application → Delivery routes: registers
app/main.py - Flask application → Authentication routes: registers
app/main.py - Flask application → Optimization settings routes: registers
app/main.py - Flask application → Tracking routes: registers
app/main.py - Flask application → Socket.IO service: initializes
app/main.py - Authentication routes → Authentication service: calls
app/routers/auth.py - Mission routes → Mission orchestration: calls
app/routers/missions.py - Mission routes → Optimization settings: calls
app/routers/missions.py - Mission routes → Geographic clustering: calls
app/routers/missions.py - Mission routes → Driver assignment: calls
app/routers/missions.py - Mission routes → Capacity allocation: calls
app/routers/missions.py - Delivery routes → Delivery management: calls
app/routers/deliveries.py - Delivery routes → Delivery API schema: validates with
app/routers/deliveries.py - Tracking routes → Socket.IO service: uses
app/routers/tracking.py - Optimization settings routes → Optimization settings: calls
app/routers/admin_optimization.py - Mission orchestration → Geographic clustering: clusters deliveries
app/services/mission_service.py - Mission orchestration → Driver assignment: assigns drivers
app/services/mission_service.py - Mission orchestration → Capacity allocation: allocates capacity
app/services/mission_service.py - Capacity allocation → Assignment strategies: executes strategy
app/algorithms/capacity_optimizer.py - Geographic clustering → Optimization settings: reads settings
app/services/clustering_service.py - Geographic clustering → MongoDB: stores region geometry
- Mission orchestration → Route ordering: orders route
app/services/mission_service.py - Route ordering → Route strategies: uses strategy
app/services/mission_service.py - Route strategies → Nearest neighbor: falls back to
app/algorithms/route_strategies.py - Route strategies → Route refinement: refines with
app/algorithms/route_strategies.py - Mission orchestration → OSRM routing: requests road route
app/services/mission_service.py - OSRM routing → OSRM service: calls
- Mission orchestration → Mission model: builds mission
app/services/mission_service.py - Mission orchestration → MongoDB: persists missions
app/services/mission_service.py - Mission orchestration → MongoDB: marks deliveries assigned
app/services/mission_service.py - Delivery management → MongoDB: reads and updates
app/services/delivery_service.py - Optimization settings → Assignment strategies: resolves strategy
app/services/optimization_settings_service.py - Optimization settings → MongoDB: stores settings
app/services/optimization_settings_service.py - Flask application → Request access checks: uses request guards