ONTrack — TDS Telecom Field Route Optimizer (Rust)

Pure-Rust route optimizer for field technicians and service/delivery crews. Import a list of stops, get back an efficient driving order, and open it in your maps app of choice — no cloud backend, no Python runtime, no OR-Tools dependency.

Ships as two native apps sharing one core library:

• Desktop — a three-panel egui GUI for Linux, Windows, and macOS.
• Android — a NativeActivity app with a Slint UI, distributed via Google Play and F-Droid.

---

Crates

Crate	Type	Description
ontrack-core	library	Address parsing (CSV/XLSX), geocoding (Nominatim/Google), distance matrix (haversine/OSRM/Google), nearest-neighbor + 2-opt TSP solver, export URL builders, optional on-device Whisper voice input
ontrack-desktop	binary (ontrack)	egui desktop GUI — Linux, Windows, macOS
ontrack-mobile	cdylib + Android app	NativeActivity + Slint UI, built with cargo-ndk and packaged with Gradle

---

Quick Start (desktop)

git clone https://github.com/qompassai/ontrack.git
cd ontrack

# Build and run the desktop GUI
cargo build --release -p ontrack-desktop
./target/release/ontrack

# Run the core library's tests
cargo test -p ontrack-core

---

Configuration

Copy .env.example to .env in the repo root:

cp .env.example .env

GOOGLE_MAPS_API_KEY=""    # optional — enables Google geocoding/distance matrix + Street View
OSRM_BASE_URL="http://router.project-osrm.org"
ARCGIS_ITEM_ID=""         # optional — your ArcGIS Online web map ID, for FieldMaps deep links
ONTRACK_WHISPER_MODEL="base"

No API key required. Without one, the app uses:

• Nominatim (OpenStreetMap) for geocoding
• The public OSRM router for real driving distances, or offline haversine distance
• Plain Google Maps / Waze / Apple Maps URL schemes for turn-by-turn navigation

---

Solver

Nearest-neighbor seed + 2-opt local search — pure Rust, no C++ FFI, no OR-Tools. For typical field routes (≤ 50 stops) this produces near-optimal results in well under a second.

Backend	Algorithm	Quality	Speed (50 stops)
2-opt (default)	NN seed + 2-opt local search	Near-optimal	< 1s
Nearest-neighbor	Greedy NN	Good	< 10ms

---

Android build (Play Store / F-Droid)

The Android app is built in two stages: cargo-ndk compiles the Rust core into libontrack_mobile.so for arm64-v8a and armeabi-v7a, then Gradle packages it into an APK/AAB. Nothing is committed as a prebuilt binary — both stores build from source.

# One-shot build (AAB for Play Store, APK for sideloading/F-Droid, or both)
./scripts/build-android.sh both

# Local emulator smoke test (SDK setup, AVD, install, launch, screenshot)
./scripts/acli.sh full ontrack 4

See scripts/ for the full Android/emulator/signing toolchain, and fastlane/ + fdroiddata/ for the store metadata.

Application ID: ai.qompass.ontrack

---

Architecture

ontrack/
├── Cargo.toml                          # workspace
├── crates/
│   ├── ontrack-core/
│   │   └── src/
│   │       ├── lib.rs
│   │       ├── config.rs               # .env / environment loading
│   │       ├── parser.rs               # CSV / XLSX address files
│   │       ├── geocoder.rs             # Nominatim + Google geocoding
│   │       ├── matrix.rs               # haversine + OSRM + Google distance matrix
│   │       ├── solver.rs               # nearest-neighbor + 2-opt TSP
│   │       ├── exporter.rs             # CSV, Maps URL, FieldMaps, Street View, Waze
│   │       └── voice.rs                # optional on-device Whisper voice input
│   ├── ontrack-desktop/
│   │   └── src/
│   │       ├── main.rs
│   │       ├── app.rs                  # worker-thread app state
│   │       └── views/                  # home / results / settings panels
│   └── ontrack-mobile/
│       ├── src/
│       │   ├── lib.rs                  # android_main entry point
│       │   ├── controller.rs           # Slint UI wiring
│       │   ├── gps.rs                  # Android LocationManager via JNI
│       │   └── preview_main.rs         # desktop preview of the mobile UI
│       ├── ui/app.slint
│       └── android/                    # Gradle project (Play Store + F-Droid)
├── scripts/                            # build, sign, emulate, screenshot tooling
├── fastlane/                           # Play Store release automation
├── fdroiddata/                         # F-Droid metadata recipe
└── playstore/                          # Play Console listing metadata

---

License

Apache License 2.0 — see LICENSE.md.