Segarloka Auto-Route Service

How to Use

1. always use uv

Coding Rules:

1. Keep it simple
2. Treat UI and backend logic as one vertical slice
3. Do not change app.py without checking the matching application service, test, and output flow

Architecture Rules

1. app.py is a Streamlit UI shell only
2. Business orchestration belongs in src/application/
3. Streamlit state and display helpers belong in src/presentation/
4. app.py must not import solver, parser, distance-calculation, output-generator, or map-visualizer modules directly
5. Any change to route generation flow must be reflected in:
   • UI entrypoint
   • application service contract or orchestration
   • relevant tests
6. Prefer vertical-slice changes over layer-only edits

High-Level Purpose

This project is to automate the routing process for Segarloka's delivery service. Currently, the routing process is done manually by the operations team.

Matrix

Matrix done by OSRM.