How furrer-stefan/zobaroute works
ZoBaRoute turns an uploaded Excel order list into geocoded, team-balanced delivery routes and provides PDF/GPX exports. The main user workflow runs through a five-step React wizard, backed by an Express API and PostgreSQL. The README documents four optimization phases; those stages are shown as distinct domain components, though their individual implementation details were not sampled. Edges rely on the excerpts, SOURCE INDEX references, and README; unsampled internals are not inferred beyond documented capabilities.
Main entry points: App.jsx Wizard shell · routeController.js Route and export API · routeApiService.js Endpoint functions · index.js API routing
Components 34
Wizard interface
- Wizard shell
frontend/src/App.jsx - Order import
frontend/src/pages/Step1ImportPage.jsx - Address review
frontend/src/pages/Step2ValidationPage.jsx - Team setup
frontend/src/pages/Step3ConfigurationPage.jsx - Route calculation
frontend/src/pages/Step4CalculationPage.jsx - Route export
frontend/src/pages/Step5ExportPage.jsx - Wizard state
frontend/src/hooks/useWizard.js - Endpoint functions
frontend/src/services/routeApiService.js - HTTP client
frontend/src/services/api.js
API orchestration
- Express server
backend/src/app.js - API routing
backend/src/routes/index.js - Order and geocode API
backend/src/controllers/importController.js - Route and export API
backend/src/controllers/routeController.js - Session reset API
backend/src/controllers/dataController.js - Health check
backend/src/controllers/healthController.js
Route domain
- Excel parsing
backend/src/services/excelParserService.js - Order validation
backend/src/services/validationService.js - Address geocoding
backend/src/services/geocodingService.js - Geocoding adapter
backend/src/adapters/geocodingAdapter.js - Rate-limited queue
backend/src/adapters/rateLimiterQueue.js - Mock geocoder
backend/src/adapters/mockGeocodingAdapter.js - Route optimizer
backend/src/services/routeOptimizerService.js - Team clustering
backend/src/services/routeOptimizerService.js - Cluster balancing
backend/src/services/routeOptimizerService.js - Stop sequencing
backend/src/services/routeOptimizerService.js - Distance matrix
backend/src/adapters/routingAdapter.js - PDF exporter
backend/src/exporters/pdfExporter.js - GPX exporter
backend/src/exporters/gpxExporter.js
Persistence and services
- Order repository
backend/src/repositories/orderRepository.js - Route repository
backend/src/repositories/routeRepository.js - PostgreSQL pool
backend/src/db/connection.js - Application database
backend/src/db/schema.sql
Other components
- Route planner
- geo.admin.ch
Connections 42
- Route planner → Wizard shell: uses
README.md - Wizard shell → Wizard state: tracks steps
frontend/src/App.jsx - Wizard shell → Order import: renders
frontend/src/App.jsx - Wizard shell → Address review: renders
frontend/src/App.jsx - Wizard shell → Team setup: renders
frontend/src/App.jsx - Wizard shell → Route calculation: renders
frontend/src/App.jsx - Wizard shell → Route export: renders
frontend/src/App.jsx - Order import → Endpoint functions: calls
frontend/src/pages/Step1ImportPage.jsx - Address review → Endpoint functions: calls
frontend/src/pages/Step2ValidationPage.jsx - Team setup → Endpoint functions: calls
frontend/src/pages/Step3ConfigurationPage.jsx - Route calculation → Endpoint functions: calls
frontend/src/pages/Step4CalculationPage.jsx - Route export → Endpoint functions: calls
frontend/src/pages/Step5ExportPage.jsx - Endpoint functions → HTTP client: uses
frontend/src/services/routeApiService.js - Endpoint functions → API routing: requests
README.md - Express server → API routing: mounts
backend/src/app.js - API routing → Order and geocode API: routes requests
backend/src/routes/index.js - API routing → Route and export API: routes requests
backend/src/routes/index.js - API routing → Session reset API: routes requests
backend/src/routes/index.js - API routing → Health check: routes requests
backend/src/routes/index.js - Order and geocode API → Excel parsing: parses upload
backend/src/controllers/importController.js - Order and geocode API → Order validation: validates orders
backend/src/controllers/importController.js - Order and geocode API → Order repository: reads and writes
backend/src/controllers/importController.js - Order and geocode API → Address geocoding: starts geocoding
backend/src/controllers/importController.js - Address geocoding → Geocoding adapter: uses
backend/src/services/geocodingService.js - Address geocoding → Rate-limited queue: queues requests
backend/src/services/geocodingService.js - Geocoding adapter → geo.admin.ch: queries addresses
README.md - Route and export API → Order repository: loads orders
backend/src/controllers/routeController.js - Route and export API → Route optimizer: calculates routes
backend/src/controllers/routeController.js - Route optimizer → Team clustering: clusters stops
README.md - Route optimizer → Cluster balancing: balances teams
README.md - Route optimizer → Stop sequencing: optimizes order
README.md - Route optimizer → Distance matrix: requests distances
backend/src/services/routeOptimizerService.js - Route and export API → Route repository: saves and reads
backend/src/controllers/routeController.js - Route and export API → PDF exporter: builds PDF
backend/src/controllers/routeController.js - Route and export API → GPX exporter: builds GPX
backend/src/controllers/routeController.js - Route and export API → Route repository: loads export route
backend/src/controllers/routeController.js - Session reset API → Order repository: clears data
backend/src/controllers/dataController.js - Health check → PostgreSQL pool: checks connection
backend/src/controllers/healthController.js - Order repository → PostgreSQL pool: queries
backend/src/repositories/orderRepository.js - Route repository → PostgreSQL pool: queries
backend/src/repositories/routeRepository.js - PostgreSQL pool → Application database: connects
README.md - Address geocoding → Mock geocoder: optional adapter