Spaces:

SolverForge
/

vehicle-routing-rust-pre

Sleeping

App Files Files Community

blackopsrepl commited on Jan 16

Commit

44dceed

verified ·

1 Parent(s): 88735a2

Upload 24 files

Browse files

Files changed (24) hide show

Cargo.lock +2484 -0
Cargo.toml +31 -0
Dockerfile +41 -0
README.md +8 -6
src/api.rs +1252 -0
src/console.rs +361 -0
src/constraints.rs +195 -0
src/demo_data.rs +449 -0
src/domain.rs +568 -0
src/geometry.rs +308 -0
src/lib.rs +26 -0
src/main.rs +60 -0
src/routing.rs +822 -0
src/solver.rs +625 -0
static/app.js +1627 -0
static/index.html +473 -0
static/recommended-fit.js +206 -0
static/score-analysis.js +96 -0
static/webjars/solverforge/css/solverforge-webui.css +68 -0
static/webjars/solverforge/img/solverforge-favicon.svg +65 -0
static/webjars/solverforge/img/solverforge-horizontal-white.svg +66 -0
static/webjars/solverforge/img/solverforge-horizontal.svg +65 -0
static/webjars/solverforge/img/solverforge-logo-stacked.svg +73 -0
static/webjars/solverforge/js/solverforge-webui.js +142 -0

Cargo.lock ADDED Viewed

	@@ -0,0 +1,2484 @@

+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+[[package]]
+name = "adler2"
+version = "2.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "320119579fcad9c21884f5c4861d16174d0e06250625266f50fe6898340abefa"
+[[package]]
+name = "aho-corasick"
+version = "1.1.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ddd31a130427c27518df266943a5308ed92d4b226cc639f5a8f1002816174301"
+dependencies = [
+ "memchr",
+]
+[[package]]
+name = "android_system_properties"
+version = "0.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "819e7219dbd41043ac279b19830f2efc897156490d7fd6ea916720117ee66311"
+dependencies = [
+ "libc",
+]
+[[package]]
+name = "arbitrary"
+version = "1.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c3d036a3c4ab069c7b410a2ce876bd74808d2d0888a82667669f8e783a898bf1"
+dependencies = [
+ "derive_arbitrary",
+]
+[[package]]
+name = "arrayvec"
+version = "0.7.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7c02d123df017efcdfbd739ef81735b36c5ba83ec3c59c80a9d7ecc718f92e50"
+[[package]]
+name = "async-stream"
+version = "0.3.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0b5a71a6f37880a80d1d7f19efd781e4b5de42c88f0722cc13bcb6cc2cfe8476"
+dependencies = [
+ "async-stream-impl",
+ "futures-core",
+ "pin-project-lite",
+]
+[[package]]
+name = "async-stream-impl"
+version = "0.3.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c7c24de15d275a1ecfd47a380fb4d5ec9bfe0933f309ed5e705b775596a3574d"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+[[package]]
+name = "atomic-waker"
+version = "1.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1505bd5d3d116872e7271a6d4e16d81d0c8570876c8de68093a09ac269d8aac0"
+[[package]]
+name = "autocfg"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c08606f8c3cbf4ce6ec8e28fb0014a2c086708fe954eaa885384a6165172e7e8"
+[[package]]
+name = "axum"
+version = "0.8.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8b52af3cb4058c895d37317bb27508dccc8e5f2d39454016b297bf4a400597b8"
+dependencies = [
+ "axum-core",
+ "bytes",
+ "form_urlencoded",
+ "futures-util",
+ "http",
+ "http-body",
+ "http-body-util",
+ "hyper",
+ "hyper-util",
+ "itoa",
+ "matchit",
+ "memchr",
+ "mime",
+ "percent-encoding",
+ "pin-project-lite",
+ "serde_core",
+ "serde_json",
+ "serde_path_to_error",
+ "serde_urlencoded",
+ "sync_wrapper",
+ "tokio",
+ "tower",
+ "tower-layer",
+ "tower-service",
+ "tracing",
+]
+[[package]]
+name = "axum-core"
+version = "0.5.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "08c78f31d7b1291f7ee735c1c6780ccde7785daae9a9206026862dab7d8792d1"
+dependencies = [
+ "bytes",
+ "futures-core",
+ "http",
+ "http-body",
+ "http-body-util",
+ "mime",
+ "pin-project-lite",
+ "sync_wrapper",
+ "tower-layer",
+ "tower-service",
+ "tracing",
+]
+[[package]]
+name = "base64"
+version = "0.22.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "72b3254f16251a8381aa12e40e3c4d2f0199f8c6508fbecb9d91f575e0fbb8c6"
+[[package]]
+name = "bitflags"
+version = "2.10.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "812e12b5285cc515a9c72a5c1d3b6d46a19dac5acfef5265968c166106e31dd3"
+[[package]]
+name = "block-buffer"
+version = "0.10.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3078c7629b62d3f0439517fa394996acacc5cbc91c5a20d8c658e77abd503a71"
+dependencies = [
+ "generic-array",
+]
+[[package]]
+name = "bumpalo"
+version = "3.19.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5dd9dc738b7a8311c7ade152424974d8115f2cdad61e8dab8dac9f2362298510"
+[[package]]
+name = "bytes"
+version = "1.11.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b35204fbdc0b3f4446b89fc1ac2cf84a8a68971995d0bf2e925ec7cd960f9cb3"
+[[package]]
+name = "cc"
+version = "1.2.51"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7a0aeaff4ff1a90589618835a598e545176939b97874f7abc7851caa0618f203"
+dependencies = [
+ "find-msvc-tools",
+ "shlex",
+]
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+[[package]]
+name = "cfg_aliases"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "613afe47fcd5fac7ccf1db93babcb082c5994d996f20b8b159f2ad1658eb5724"
+[[package]]
+name = "chrono"
+version = "0.4.42"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "145052bdd345b87320e369255277e3fb5152762ad123a901ef5c262dd38fe8d2"
+dependencies = [
+ "iana-time-zone",
+ "js-sys",
+ "num-traits",
+ "serde",
+ "wasm-bindgen",
+ "windows-link",
+]
+[[package]]
+name = "core-foundation-sys"
+version = "0.8.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "773648b94d0e5d620f64f280777445740e61fe701025087ec8b57f45c791888b"
+[[package]]
+name = "cpufeatures"
+version = "0.2.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "59ed5838eebb26a2bb2e58f6d5b5316989ae9d08bab10e0e6d103e656d1b0280"
+dependencies = [
+ "libc",
+]
+[[package]]
+name = "crc32fast"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9481c1c90cbf2ac953f07c8d4a58aa3945c425b7185c9154d67a65e4230da511"
+dependencies = [
+ "cfg-if",
+]
+[[package]]
+name = "crossbeam-deque"
+version = "0.8.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9dd111b7b7f7d55b72c0a6ae361660ee5853c9af73f70c3c2ef6858b950e2e51"
+dependencies = [
+ "crossbeam-epoch",
+ "crossbeam-utils",
+]
+[[package]]
+name = "crossbeam-epoch"
+version = "0.9.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5b82ac4a3c2ca9c3460964f020e1402edd5753411d7737aa39c3714ad1b5420e"
+dependencies = [
+ "crossbeam-utils",
+]
+[[package]]
+name = "crossbeam-utils"
+version = "0.8.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d0a5c400df2834b80a4c3327b3aad3a4c4cd4de0629063962b03235697506a28"
+[[package]]
+name = "crypto-common"
+version = "0.1.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "78c8292055d1c1df0cce5d180393dc8cce0abec0a7102adb6c7b1eef6016d60a"
+dependencies = [
+ "generic-array",
+ "typenum",
+]
+[[package]]
+name = "derive_arbitrary"
+version = "1.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1e567bd82dcff979e4b03460c307b3cdc9e96fde3d73bed1496d2bc75d9dd62a"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+[[package]]
+name = "digest"
+version = "0.10.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ed9a281f7bc9b7576e61468ba615a66a5c8cfdff42420a70aa82701a3b1e292"
+dependencies = [
+ "block-buffer",
+ "crypto-common",
+]
+[[package]]
+name = "displaydoc"
+version = "0.2.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "97369cbbc041bc366949bc74d34658d6cda5621039731c6310521892a3a20ae0"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+[[package]]
+name = "either"
+version = "1.15.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "48c757948c5ede0e46177b7add2e67155f70e33c07fea8284df6576da70b3719"
+[[package]]
+name = "equivalent"
+version = "1.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "877a4ace8713b0bcf2a4e7eec82529c029f1d0619886d18145fea96c3ffe5c0f"
+[[package]]
+name = "errno"
+version = "0.3.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "39cab71617ae0d63f51a36d69f866391735b51691dbda63cf6f96d042b63efeb"
+dependencies = [
+ "libc",
+ "windows-sys 0.61.2",
+]
+[[package]]
+name = "find-msvc-tools"
+version = "0.1.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "645cbb3a84e60b7531617d5ae4e57f7e27308f6445f5abf653209ea76dec8dff"
+[[package]]
+name = "fixedbitset"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0ce7134b9999ecaf8bcd65542e436736ef32ddca1b3e06094cb6ec5755203b80"
+[[package]]
+name = "flate2"
+version = "1.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bfe33edd8e85a12a67454e37f8c75e730830d83e313556ab9ebf9ee7fbeb3bfb"
+dependencies = [
+ "crc32fast",
+ "libz-rs-sys",
+ "miniz_oxide",
+]
+[[package]]
+name = "form_urlencoded"
+version = "1.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cb4cb245038516f5f85277875cdaa4f7d2c9a0fa0468de06ed190163b1581fcf"
+dependencies = [
+ "percent-encoding",
+]
+[[package]]
+name = "futures-channel"
+version = "0.3.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2dff15bf788c671c1934e366d07e30c1814a8ef514e1af724a602e8a2fbe1b10"
+dependencies = [
+ "futures-core",
+]
+[[package]]
+name = "futures-core"
+version = "0.3.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "05f29059c0c2090612e8d742178b0580d2dc940c837851ad723096f87af6663e"
+[[package]]
+name = "futures-sink"
+version = "0.3.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e575fab7d1e0dcb8d0c7bcf9a63ee213816ab51902e6d244a95819acacf1d4f7"
+[[package]]
+name = "futures-task"
+version = "0.3.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f90f7dce0722e95104fcb095585910c0977252f286e354b5e3bd38902cd99988"
+[[package]]
+name = "futures-util"
+version = "0.3.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9fa08315bb612088cc391249efdc3bc77536f16c91f6cf495e6fbe85b20a4a81"
+dependencies = [
+ "futures-core",
+ "futures-task",
+ "pin-project-lite",
+ "pin-utils",
+]
+[[package]]
+name = "generic-array"
+version = "0.14.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "85649ca51fd72272d7821adaf274ad91c288277713d9c18820d8499a7ff69e9a"
+dependencies = [
+ "typenum",
+ "version_check",
+]
+[[package]]
+name = "getrandom"
+version = "0.2.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "335ff9f135e4384c8150d6f27c6daed433577f86b4750418338c01a1a2528592"
+dependencies = [
+ "cfg-if",
+ "js-sys",
+ "libc",
+ "wasi",
+ "wasm-bindgen",
+]
+[[package]]
+name = "getrandom"
+version = "0.3.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "899def5c37c4fd7b2664648c28120ecec138e4d395b459e5ca34f9cce2dd77fd"
+dependencies = [
+ "cfg-if",
+ "js-sys",
+ "libc",
+ "r-efi",
+ "wasip2",
+ "wasm-bindgen",
+]
+[[package]]
+name = "hashbrown"
+version = "0.16.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "841d1cc9bed7f9236f321df977030373f4a4163ae1a7dbfe1a51a2c1a51d9100"
+[[package]]
+name = "http"
+version = "1.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e3ba2a386d7f85a81f119ad7498ebe444d2e22c2af0b86b069416ace48b3311a"
+dependencies = [
+ "bytes",
+ "itoa",
+]
+[[package]]
+name = "http-body"
+version = "1.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1efedce1fb8e6913f23e0c92de8e62cd5b772a67e7b3946df930a62566c93184"
+dependencies = [
+ "bytes",
+ "http",
+]
+[[package]]
+name = "http-body-util"
+version = "0.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b021d93e26becf5dc7e1b75b1bed1fd93124b374ceb73f43d4d4eafec896a64a"
+dependencies = [
+ "bytes",
+ "futures-core",
+ "http",
+ "http-body",
+ "pin-project-lite",
+]
+[[package]]
+name = "http-range-header"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9171a2ea8a68358193d15dd5d70c1c10a2afc3e7e4c5bc92bc9f025cebd7359c"
+[[package]]
+name = "httparse"
+version = "1.10.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6dbf3de79e51f3d586ab4cb9d5c3e2c14aa28ed23d180cf89b4df0454a69cc87"
+[[package]]
+name = "httpdate"
+version = "1.0.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "df3b46402a9d5adb4c86a0cf463f42e19994e3ee891101b1841f30a545cb49a9"
+[[package]]
+name = "hyper"
+version = "1.8.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2ab2d4f250c3d7b1c9fcdff1cece94ea4e2dfbec68614f7b87cb205f24ca9d11"
+dependencies = [
+ "atomic-waker",
+ "bytes",
+ "futures-channel",
+ "futures-core",
+ "http",
+ "http-body",
+ "httparse",
+ "httpdate",
+ "itoa",
+ "pin-project-lite",
+ "pin-utils",
+ "smallvec",
+ "tokio",
+ "want",
+]
+[[package]]
+name = "hyper-rustls"
+version = "0.27.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e3c93eb611681b207e1fe55d5a71ecf91572ec8a6705cdb6857f7d8d5242cf58"
+dependencies = [
+ "http",
+ "hyper",
+ "hyper-util",
+ "rustls",
+ "rustls-pki-types",
+ "tokio",
+ "tokio-rustls",
+ "tower-service",
+ "webpki-roots",
+]
+[[package]]
+name = "hyper-util"
+version = "0.1.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "727805d60e7938b76b826a6ef209eb70eaa1812794f9424d4a4e2d740662df5f"
+dependencies = [
+ "base64",
+ "bytes",
+ "futures-channel",
+ "futures-core",
+ "futures-util",
+ "http",
+ "http-body",
+ "hyper",
+ "ipnet",
+ "libc",
+ "percent-encoding",
+ "pin-project-lite",
+ "socket2",
+ "tokio",
+ "tower-service",
+ "tracing",
+]
+[[package]]
+name = "iana-time-zone"
+version = "0.1.64"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "33e57f83510bb73707521ebaffa789ec8caf86f9657cad665b092b581d40e9fb"
+dependencies = [
+ "android_system_properties",
+ "core-foundation-sys",
+ "iana-time-zone-haiku",
+ "js-sys",
+ "log",
+ "wasm-bindgen",
+ "windows-core",
+]
+[[package]]
+name = "iana-time-zone-haiku"
+version = "0.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f31827a206f56af32e590ba56d5d2d085f558508192593743f16b2306495269f"
+dependencies = [
+ "cc",
+]
+[[package]]
+name = "icu_collections"
+version = "2.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4c6b649701667bbe825c3b7e6388cb521c23d88644678e83c0c4d0a621a34b43"
+dependencies = [
+ "displaydoc",
+ "potential_utf",
+ "yoke",
+ "zerofrom",
+ "zerovec",
+]
+[[package]]
+name = "icu_locale_core"
+version = "2.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "edba7861004dd3714265b4db54a3c390e880ab658fec5f7db895fae2046b5bb6"
+dependencies = [
+ "displaydoc",
+ "litemap",
+ "tinystr",
+ "writeable",
+ "zerovec",
+]
+[[package]]
+name = "icu_normalizer"
+version = "2.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5f6c8828b67bf8908d82127b2054ea1b4427ff0230ee9141c54251934ab1b599"
+dependencies = [
+ "icu_collections",
+ "icu_normalizer_data",
+ "icu_properties",
+ "icu_provider",
+ "smallvec",
+ "zerovec",
+]
+[[package]]
+name = "icu_normalizer_data"
+version = "2.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7aedcccd01fc5fe81e6b489c15b247b8b0690feb23304303a9e560f37efc560a"
+[[package]]
+name = "icu_properties"
+version = "2.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "020bfc02fe870ec3a66d93e677ccca0562506e5872c650f893269e08615d74ec"
+dependencies = [
+ "icu_collections",
+ "icu_locale_core",
+ "icu_properties_data",
+ "icu_provider",
+ "zerotrie",
+ "zerovec",
+]
+[[package]]
+name = "icu_properties_data"
+version = "2.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "616c294cf8d725c6afcd8f55abc17c56464ef6211f9ed59cccffe534129c77af"
+[[package]]
+name = "icu_provider"
+version = "2.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "85962cf0ce02e1e0a629cc34e7ca3e373ce20dda4c4d7294bbd0bf1fdb59e614"
+dependencies = [
+ "displaydoc",
+ "icu_locale_core",
+ "writeable",
+ "yoke",
+ "zerofrom",
+ "zerotrie",
+ "zerovec",
+]
+[[package]]
+name = "idna"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3b0875f23caa03898994f6ddc501886a45c7d3d62d04d2d90788d47be1b1e4de"
+dependencies = [
+ "idna_adapter",
+ "smallvec",
+ "utf8_iter",
+]
+[[package]]
+name = "idna_adapter"
+version = "1.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3acae9609540aa318d1bc588455225fb2085b9ed0c4f6bd0d9d5bcd86f1a0344"
+dependencies = [
+ "icu_normalizer",
+ "icu_properties",
+]
+[[package]]
+name = "indexmap"
+version = "2.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0ad4bb2b565bca0645f4d68c5c9af97fba094e9791da685bf83cb5f3ce74acf2"
+dependencies = [
+ "equivalent",
+ "hashbrown",
+ "serde",
+ "serde_core",
+]
+[[package]]
+name = "ipnet"
+version = "2.11.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "469fb0b9cefa57e3ef31275ee7cacb78f2fdca44e4765491884a2b119d4eb130"
+[[package]]
+name = "iri-string"
+version = "0.7.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c91338f0783edbd6195decb37bae672fd3b165faffb89bf7b9e6942f8b1a731a"
+dependencies = [
+ "memchr",
+ "serde",
+]
+[[package]]
+name = "itoa"
+version = "1.0.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "92ecc6618181def0457392ccd0ee51198e065e016d1d527a7ac1b6dc7c1f09d2"
+[[package]]
+name = "js-sys"
+version = "0.3.83"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "464a3709c7f55f1f721e5389aa6ea4e3bc6aba669353300af094b29ffbdde1d8"
+dependencies = [
+ "once_cell",
+ "wasm-bindgen",
+]
+[[package]]
+name = "lazy_static"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bbd2bcb4c963f2ddae06a2efc7e9f3591312473c50c6685e1f298068316e66fe"
+[[package]]
+name = "libc"
+version = "0.2.179"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c5a2d376baa530d1238d133232d15e239abad80d05838b4b59354e5268af431f"
+[[package]]
+name = "libz-rs-sys"
+version = "0.5.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c10501e7805cee23da17c7790e59df2870c0d4043ec6d03f67d31e2b53e77415"
+dependencies = [
+ "zlib-rs",
+]
+[[package]]
+name = "litemap"
+version = "0.8.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6373607a59f0be73a39b6fe456b8192fcc3585f602af20751600e974dd455e77"
+[[package]]
+name = "lock_api"
+version = "0.4.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "224399e74b87b5f3557511d98dff8b14089b3dadafcab6bb93eab67d3aace965"
+dependencies = [
+ "scopeguard",
+]
+[[package]]
+name = "log"
+version = "0.4.29"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5e5032e24019045c762d3c0f28f5b6b8bbf38563a65908389bf7978758920897"
+[[package]]
+name = "lru-slab"
+version = "0.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "112b39cec0b298b6c1999fee3e31427f74f676e4cb9879ed1a121b43661a4154"
+[[package]]
+name = "matchers"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d1525a2a28c7f4fa0fc98bb91ae755d1e2d1505079e05539e35bc876b5d65ae9"
+dependencies = [
+ "regex-automata",
+]
+[[package]]
+name = "matchit"
+version = "0.8.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "47e1ffaa40ddd1f3ed91f717a33c8c0ee23fff369e3aa8772b9605cc1d22f4c3"
+[[package]]
+name = "memchr"
+version = "2.7.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f52b00d39961fc5b2736ea853c9cc86238e165017a493d1d5c8eac6bdc4cc273"
+[[package]]
+name = "mime"
+version = "0.3.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6877bb514081ee2a7ff5ef9de3281f14a4dd4bceac4c09388074a6b5df8a139a"
+[[package]]
+name = "mime_guess"
+version = "2.0.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f7c44f8e672c00fe5308fa235f821cb4198414e1c77935c1ab6948d3fd78550e"
+dependencies = [
+ "mime",
+ "unicase",
+]
+[[package]]
+name = "miniz_oxide"
+version = "0.8.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fa76a2c86f704bdb222d66965fb3d63269ce38518b83cb0575fca855ebb6316"
+dependencies = [
+ "adler2",
+ "simd-adler32",
+]
+[[package]]
+name = "mio"
+version = "1.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a69bcab0ad47271a0234d9422b131806bf3968021e5dc9328caf2d4cd58557fc"
+dependencies = [
+ "libc",
+ "wasi",
+ "windows-sys 0.61.2",
+]
+[[package]]
+name = "nu-ansi-term"
+version = "0.50.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7957b9740744892f114936ab4a57b3f487491bbeafaf8083688b16841a4240e5"
+dependencies = [
+ "windows-sys 0.61.2",
+]
+[[package]]
+name = "num-format"
+version = "0.4.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a652d9771a63711fd3c3deb670acfbe5c30a4072e664d7a3bf5a9e1056ac72c3"
+dependencies = [
+ "arrayvec",
+ "itoa",
+]
+[[package]]
+name = "num-traits"
+version = "0.2.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
+dependencies = [
+ "autocfg",
+]
+[[package]]
+name = "once_cell"
+version = "1.21.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "42f5e15c9953c5e4ccceeb2e7382a716482c34515315f7b03532b8b4e8393d2d"
+[[package]]
+name = "ordered-float"
+version = "4.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7bb71e1b3fa6ca1c61f383464aaf2bb0e2f8e772a1f01d486832464de363b951"
+dependencies = [
+ "num-traits",
+]
+[[package]]
+name = "owo-colors"
+version = "4.2.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9c6901729fa79e91a0913333229e9ca5dc725089d1c363b2f4b4760709dc4a52"
+[[package]]
+name = "parking_lot"
+version = "0.12.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "93857453250e3077bd71ff98b6a65ea6621a19bb0f559a85248955ac12c45a1a"
+dependencies = [
+ "lock_api",
+ "parking_lot_core",
+]
+[[package]]
+name = "parking_lot_core"
+version = "0.9.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2621685985a2ebf1c516881c026032ac7deafcda1a2c9b7850dc81e3dfcb64c1"
+dependencies = [
+ "cfg-if",
+ "libc",
+ "redox_syscall",
+ "smallvec",
+ "windows-link",
+]
+[[package]]
+name = "percent-encoding"
+version = "2.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9b4f627cb1b25917193a259e49bdad08f671f8d9708acfd5fe0a8c1455d87220"
+[[package]]
+name = "petgraph"
+version = "0.6.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b4c5cc86750666a3ed20bdaf5ca2a0344f9c67674cae0515bec2da16fbaa47db"
+dependencies = [
+ "fixedbitset",
+ "indexmap",
+]
+[[package]]
+name = "pin-project-lite"
+version = "0.2.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3b3cff922bd51709b605d9ead9aa71031d81447142d828eb4a6eba76fe619f9b"
+[[package]]
+name = "pin-utils"
+version = "0.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8b870d8c151b6f2fb93e84a13146138f05d02ed11c7e7c54f8826aaaf7c9f184"
+[[package]]
+name = "potential_utf"
+version = "0.1.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b73949432f5e2a09657003c25bca5e19a0e9c84f8058ca374f49e0ebe605af77"
+dependencies = [
+ "zerovec",
+]
+[[package]]
+name = "ppv-lite86"
+version = "0.2.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "85eae3c4ed2f50dcfe72643da4befc30deadb458a9b590d720cde2f2b1e97da9"
+dependencies = [
+ "zerocopy",
+]
+[[package]]
+name = "proc-macro2"
+version = "1.0.104"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9695f8df41bb4f3d222c95a67532365f569318332d03d5f3f67f37b20e6ebdf0"
+dependencies = [
+ "unicode-ident",
+]
+[[package]]
+name = "quinn"
+version = "0.11.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b9e20a958963c291dc322d98411f541009df2ced7b5a4f2bd52337638cfccf20"
+dependencies = [
+ "bytes",
+ "cfg_aliases",
+ "pin-project-lite",
+ "quinn-proto",
+ "quinn-udp",
+ "rustc-hash",
+ "rustls",
+ "socket2",
+ "thiserror",
+ "tokio",
+ "tracing",
+ "web-time",
+]
+[[package]]
+name = "quinn-proto"
+version = "0.11.13"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f1906b49b0c3bc04b5fe5d86a77925ae6524a19b816ae38ce1e426255f1d8a31"
+dependencies = [
+ "bytes",
+ "getrandom 0.3.4",
+ "lru-slab",
+ "rand 0.9.2",
+ "ring",
+ "rustc-hash",
+ "rustls",
+ "rustls-pki-types",
+ "slab",
+ "thiserror",
+ "tinyvec",
+ "tracing",
+ "web-time",
+]
+[[package]]
+name = "quinn-udp"
+version = "0.5.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "addec6a0dcad8a8d96a771f815f0eaf55f9d1805756410b39f5fa81332574cbd"
+dependencies = [
+ "cfg_aliases",
+ "libc",
+ "once_cell",
+ "socket2",
+ "tracing",
+ "windows-sys 0.60.2",
+]
+[[package]]
+name = "quote"
+version = "1.0.42"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a338cc41d27e6cc6dce6cefc13a0729dfbb81c262b1f519331575dd80ef3067f"
+dependencies = [
+ "proc-macro2",
+]
+[[package]]
+name = "r-efi"
+version = "5.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "69cdb34c158ceb288df11e18b4bd39de994f6657d83847bdffdbd7f346754b0f"
+[[package]]
+name = "rand"
+version = "0.8.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "34af8d1a0e25924bc5b7c43c079c942339d8f0a8b57c39049bef581b46327404"
+dependencies = [
+ "libc",
+ "rand_chacha 0.3.1",
+ "rand_core 0.6.4",
+]
+[[package]]
+name = "rand"
+version = "0.9.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6db2770f06117d490610c7488547d543617b21bfa07796d7a12f6f1bd53850d1"
+dependencies = [
+ "rand_chacha 0.9.0",
+ "rand_core 0.9.3",
+]
+[[package]]
+name = "rand_chacha"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6c10a63a0fa32252be49d21e7709d4d4baf8d231c2dbce1eaa8141b9b127d88"
+dependencies = [
+ "ppv-lite86",
+ "rand_core 0.6.4",
+]
+[[package]]
+name = "rand_chacha"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d3022b5f1df60f26e1ffddd6c66e8aa15de382ae63b3a0c1bfc0e4d3e3f325cb"
+dependencies = [
+ "ppv-lite86",
+ "rand_core 0.9.3",
+]
+[[package]]
+name = "rand_core"
+version = "0.6.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ec0be4795e2f6a28069bec0b5ff3e2ac9bafc99e6a9a7dc3547996c5c816922c"
+dependencies = [
+ "getrandom 0.2.16",
+]
+[[package]]
+name = "rand_core"
+version = "0.9.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "99d9a13982dcf210057a8a78572b2217b667c3beacbf3a0d8b454f6f82837d38"
+dependencies = [
+ "getrandom 0.3.4",
+]
+[[package]]
+name = "rayon"
+version = "1.11.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "368f01d005bf8fd9b1206fb6fa653e6c4a81ceb1466406b81792d87c5677a58f"
+dependencies = [
+ "either",
+ "rayon-core",
+]
+[[package]]
+name = "rayon-core"
+version = "1.13.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "22e18b0f0062d30d4230b2e85ff77fdfe4326feb054b9783a3460d8435c8ab91"
+dependencies = [
+ "crossbeam-deque",
+ "crossbeam-utils",
+]
+[[package]]
+name = "redox_syscall"
+version = "0.5.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ed2bf2547551a7053d6fdfafda3f938979645c44812fbfcda098faae3f1a362d"
+dependencies = [
+ "bitflags",
+]
+[[package]]
+name = "regex"
+version = "1.12.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "843bc0191f75f3e22651ae5f1e72939ab2f72a4bc30fa80a066bd66edefc24d4"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-automata",
+ "regex-syntax",
+]
+[[package]]
+name = "regex-automata"
+version = "0.4.13"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5276caf25ac86c8d810222b3dbb938e512c55c6831a10f3e6ed1c93b84041f1c"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-syntax",
+]
+[[package]]
+name = "regex-syntax"
+version = "0.8.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7a2d987857b319362043e95f5353c0535c1f58eec5336fdfcf626430af7def58"
+[[package]]
+name = "reqwest"
+version = "0.12.28"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "eddd3ca559203180a307f12d114c268abf583f59b03cb906fd0b3ff8646c1147"
+dependencies = [
+ "base64",
+ "bytes",
+ "futures-core",
+ "http",
+ "http-body",
+ "http-body-util",
+ "hyper",
+ "hyper-rustls",
+ "hyper-util",
+ "js-sys",
+ "log",
+ "percent-encoding",
+ "pin-project-lite",
+ "quinn",
+ "rustls",
+ "rustls-pki-types",
+ "serde",
+ "serde_json",
+ "serde_urlencoded",
+ "sync_wrapper",
+ "tokio",
+ "tokio-rustls",
+ "tower",
+ "tower-http",
+ "tower-service",
+ "url",
+ "wasm-bindgen",
+ "wasm-bindgen-futures",
+ "web-sys",
+ "webpki-roots",
+]
+[[package]]
+name = "ring"
+version = "0.17.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a4689e6c2294d81e88dc6261c768b63bc4fcdb852be6d1352498b114f61383b7"
+dependencies = [
+ "cc",
+ "cfg-if",
+ "getrandom 0.2.16",
+ "libc",
+ "untrusted",
+ "windows-sys 0.52.0",
+]
+[[package]]
+name = "rust-embed"
+version = "8.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "947d7f3fad52b283d261c4c99a084937e2fe492248cb9a68a8435a861b8798ca"
+dependencies = [
+ "rust-embed-impl",
+ "rust-embed-utils",
+ "walkdir",
+]
+[[package]]
+name = "rust-embed-impl"
+version = "8.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5fa2c8c9e8711e10f9c4fd2d64317ef13feaab820a4c51541f1a8c8e2e851ab2"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "rust-embed-utils",
+ "syn",
+ "walkdir",
+]
+[[package]]
+name = "rust-embed-utils"
+version = "8.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "60b161f275cb337fe0a44d924a5f4df0ed69c2c39519858f931ce61c779d3475"
+dependencies = [
+ "sha2",
+ "walkdir",
+]
+[[package]]
+name = "rustc-hash"
+version = "2.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "357703d41365b4b27c590e3ed91eabb1b663f07c4c084095e60cbed4362dff0d"
+[[package]]
+name = "rustls"
+version = "0.23.35"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "533f54bc6a7d4f647e46ad909549eda97bf5afc1585190ef692b4286b198bd8f"
+dependencies = [
+ "once_cell",
+ "ring",
+ "rustls-pki-types",
+ "rustls-webpki",
+ "subtle",
+ "zeroize",
+]
+[[package]]
+name = "rustls-pki-types"
+version = "1.13.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "21e6f2ab2928ca4291b86736a8bd920a277a399bba1589409d72154ff87c1282"
+dependencies = [
+ "web-time",
+ "zeroize",
+]
+[[package]]
+name = "rustls-webpki"
+version = "0.103.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2ffdfa2f5286e2247234e03f680868ac2815974dc39e00ea15adc445d0aafe52"
+dependencies = [
+ "ring",
+ "rustls-pki-types",
+ "untrusted",
+]
+[[package]]
+name = "rustversion"
+version = "1.0.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b39cdef0fa800fc44525c84ccb54a029961a8215f9619753635a9c0d2538d46d"
+[[package]]
+name = "ryu"
+version = "1.0.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a50f4cf475b65d88e057964e0e9bb1f0aa9bbb2036dc65c64596b42932536984"
+[[package]]
+name = "same-file"
+version = "1.0.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "93fc1dc3aaa9bfed95e02e6eadabb4baf7e3078b0bd1b4d7b6b0b68378900502"
+dependencies = [
+ "winapi-util",
+]
+[[package]]
+name = "scopeguard"
+version = "1.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "94143f37725109f92c262ed2cf5e59bce7498c01bcc1502d7b9afe439a4e9f49"
+[[package]]
+name = "serde"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9a8e94ea7f378bd32cbbd37198a4a91436180c5bb472411e48b5ec2e2124ae9e"
+dependencies = [
+ "serde_core",
+ "serde_derive",
+]
+[[package]]
+name = "serde_core"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41d385c7d4ca58e59fc732af25c3983b67ac852c1a25000afe1175de458b67ad"
+dependencies = [
+ "serde_derive",
+]
+[[package]]
+name = "serde_derive"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d540f220d3187173da220f885ab66608367b6574e925011a9353e4badda91d79"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+[[package]]
+name = "serde_json"
+version = "1.0.148"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3084b546a1dd6289475996f182a22aba973866ea8e8b02c51d9f46b1336a22da"
+dependencies = [
+ "itoa",
+ "memchr",
+ "serde",
+ "serde_core",
+ "zmij",
+]
+[[package]]
+name = "serde_path_to_error"
+version = "0.1.20"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "10a9ff822e371bb5403e391ecd83e182e0e77ba7f6fe0160b795797109d1b457"
+dependencies = [
+ "itoa",
+ "serde",
+ "serde_core",
+]
+[[package]]
+name = "serde_spanned"
+version = "0.6.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bf41e0cfaf7226dca15e8197172c295a782857fcb97fad1808a166870dee75a3"
+dependencies = [
+ "serde",
+]
+[[package]]
+name = "serde_urlencoded"
+version = "0.7.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d3491c14715ca2294c4d6a88f15e84739788c1d030eed8c110436aafdaa2f3fd"
+dependencies = [
+ "form_urlencoded",
+ "itoa",
+ "ryu",
+ "serde",
+]
+[[package]]
+name = "serde_yaml"
+version = "0.9.34+deprecated"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6a8b1a1a2ebf674015cc02edccce75287f1a0130d394307b36743c2f5d504b47"
+dependencies = [
+ "indexmap",
+ "itoa",
+ "ryu",
+ "serde",
+ "unsafe-libyaml",
+]
+[[package]]
+name = "sha2"
+version = "0.10.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a7507d819769d01a365ab707794a4084392c824f54a7a6a7862f8c3d0892b283"
+dependencies = [
+ "cfg-if",
+ "cpufeatures",
+ "digest",
+]
+[[package]]
+name = "sharded-slab"
+version = "0.1.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f40ca3c46823713e0d4209592e8d6e826aa57e928f09752619fc696c499637f6"
+dependencies = [
+ "lazy_static",
+]
+[[package]]
+name = "shlex"
+version = "1.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64"
+[[package]]
+name = "signal-hook-registry"
+version = "1.4.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c4db69cba1110affc0e9f7bcd48bbf87b3f4fc7c61fc9155afd4c469eb3d6c1b"
+dependencies = [
+ "errno",
+ "libc",
+]
+[[package]]
+name = "simd-adler32"
+version = "0.3.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e320a6c5ad31d271ad523dcf3ad13e2767ad8b1cb8f047f75a8aeaf8da139da2"
+[[package]]
+name = "slab"
+version = "0.4.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7a2ae44ef20feb57a68b23d846850f861394c2e02dc425a50098ae8c90267589"
+[[package]]
+name = "smallvec"
+version = "1.15.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "67b1b7a3b5fe4f1376887184045fcf45c69e92af734b7aaddc05fb777b6fbd03"
+[[package]]
+name = "socket2"
+version = "0.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "17129e116933cf371d018bb80ae557e889637989d8638274fb25622827b03881"
+dependencies = [
+ "libc",
+ "windows-sys 0.60.2",
+]
+[[package]]
+name = "solverforge"
+version = "0.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ebe455ae330096af2f36cdd131051b1c14bd995f258078c9555adcfe20678a8c"
+dependencies = [
+ "solverforge-config",
+ "solverforge-core",
+ "solverforge-macros",
+ "solverforge-scoring",
+ "solverforge-solver",
+]
+[[package]]
+name = "solverforge-config"
+version = "0.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9e4d590ad6e66553eb1f4013979f0def038555383f88b5b649fcbeb2da51363d"
+dependencies = [
+ "serde",
+ "serde_yaml",
+ "solverforge-core",
+ "thiserror",
+ "toml",
+]
+[[package]]
+name = "solverforge-core"
+version = "0.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9d58655c54f8b22ff3ddc5a51f5858187794756400de2702601364ca63f1bb98"
+dependencies = [
+ "num-traits",
+ "serde",
+ "thiserror",
+]
+[[package]]
+name = "solverforge-macros"
+version = "0.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "01b0dc41ba7d1a84ee0c5d2d898700710bff6d959f9be37738b523fd65d12284"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+[[package]]
+name = "solverforge-scoring"
+version = "0.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0c559e0bfd0668b53e67ce525136468ae934ef5e07ef1e52cc734a3c36375a09"
+dependencies = [
+ "solverforge-core",
+ "thiserror",
+]
+[[package]]
+name = "solverforge-solver"
+version = "0.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a7c2b34de23f929a63721203118bc5856248e768a959f87697ab6585eb5ee20a"
+dependencies = [
+ "rand 0.9.2",
+ "rand_chacha 0.9.0",
+ "rayon",
+ "serde",
+ "smallvec",
+ "solverforge-config",
+ "solverforge-core",
+ "solverforge-scoring",
+ "thiserror",
+ "tokio",
+ "tracing",
+]
+[[package]]
+name = "stable_deref_trait"
+version = "1.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6ce2be8dc25455e1f91df71bfa12ad37d7af1092ae736f3a6cd0e37bc7810596"
+[[package]]
+name = "subtle"
+version = "2.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "13c2bddecc57b384dee18652358fb23172facb8a2c51ccc10d74c157bdea3292"
+[[package]]
+name = "syn"
+version = "2.0.113"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "678faa00651c9eb72dd2020cbdf275d92eccb2400d568e419efdd64838145cb4"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+[[package]]
+name = "sync_wrapper"
+version = "1.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0bf256ce5efdfa370213c1dabab5935a12e49f2c58d15e9eac2870d3b4f27263"
+dependencies = [
+ "futures-core",
+]
+[[package]]
+name = "synstructure"
+version = "0.13.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "728a70f3dbaf5bab7f0c4b1ac8d7ae5ea60a4b5549c8a5914361c99147a709d2"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+[[package]]
+name = "thiserror"
+version = "2.0.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f63587ca0f12b72a0600bcba1d40081f830876000bb46dd2337a3051618f4fc8"
+dependencies = [
+ "thiserror-impl",
+]
+[[package]]
+name = "thiserror-impl"
+version = "2.0.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3ff15c8ecd7de3849db632e14d18d2571fa09dfc5ed93479bc4485c7a517c913"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+[[package]]
+name = "thread_local"
+version = "1.1.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f60246a4944f24f6e018aa17cdeffb7818b76356965d03b07d6a9886e8962185"
+dependencies = [
+ "cfg-if",
+]
+[[package]]
+name = "tinystr"
+version = "0.8.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "42d3e9c45c09de15d06dd8acf5f4e0e399e85927b7f00711024eb7ae10fa4869"
+dependencies = [
+ "displaydoc",
+ "zerovec",
+]
+[[package]]
+name = "tinyvec"
+version = "1.10.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bfa5fdc3bce6191a1dbc8c02d5c8bffcf557bafa17c124c5264a458f1b0613fa"
+dependencies = [
+ "tinyvec_macros",
+]
+[[package]]
+name = "tinyvec_macros"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1f3ccbac311fea05f86f61904b462b55fb3df8837a366dfc601a0161d0532f20"
+[[package]]
+name = "tokio"
+version = "1.49.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "72a2903cd7736441aac9df9d7688bd0ce48edccaadf181c3b90be801e81d3d86"
+dependencies = [
+ "bytes",
+ "libc",
+ "mio",
+ "parking_lot",
+ "pin-project-lite",
+ "signal-hook-registry",
+ "socket2",
+ "tokio-macros",
+ "windows-sys 0.61.2",
+]
+[[package]]
+name = "tokio-macros"
+version = "2.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "af407857209536a95c8e56f8231ef2c2e2aff839b22e07a1ffcbc617e9db9fa5"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+[[package]]
+name = "tokio-rustls"
+version = "0.26.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1729aa945f29d91ba541258c8df89027d5792d85a8841fb65e8bf0f4ede4ef61"
+dependencies = [
+ "rustls",
+ "tokio",
+]
+[[package]]
+name = "tokio-stream"
+version = "0.1.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "32da49809aab5c3bc678af03902d4ccddea2a87d028d86392a4b1560c6906c70"
+dependencies = [
+ "futures-core",
+ "pin-project-lite",
+ "tokio",
+]
+[[package]]
+name = "tokio-util"
+version = "0.7.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ae9cec805b01e8fc3fd2fe289f89149a9b66dd16786abd8b19cfa7b48cb0098"
+dependencies = [
+ "bytes",
+ "futures-core",
+ "futures-sink",
+ "pin-project-lite",
+ "tokio",
+]
+[[package]]
+name = "toml"
+version = "0.8.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dc1beb996b9d83529a9e75c17a1686767d148d70663143c7854d8b4a09ced362"
+dependencies = [
+ "serde",
+ "serde_spanned",
+ "toml_datetime",
+ "toml_edit",
+]
+[[package]]
+name = "toml_datetime"
+version = "0.6.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "22cddaf88f4fbc13c51aebbf5f8eceb5c7c5a9da2ac40a13519eb5b0a0e8f11c"
+dependencies = [
+ "serde",
+]
+[[package]]
+name = "toml_edit"
+version = "0.22.27"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41fe8c660ae4257887cf66394862d21dbca4a6ddd26f04a3560410406a2f819a"
+dependencies = [
+ "indexmap",
+ "serde",
+ "serde_spanned",
+ "toml_datetime",
+ "toml_write",
+ "winnow",
+]
+[[package]]
+name = "toml_write"
+version = "0.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5d99f8c9a7727884afe522e9bd5edbfc91a3312b36a77b5fb8926e4c31a41801"
+[[package]]
+name = "tower"
+version = "0.5.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d039ad9159c98b70ecfd540b2573b97f7f52c3e8d9f8ad57a24b916a536975f9"
+dependencies = [
+ "futures-core",
+ "futures-util",
+ "pin-project-lite",
+ "sync_wrapper",
+ "tokio",
+ "tower-layer",
+ "tower-service",
+ "tracing",
+]
+[[package]]
+name = "tower-http"
+version = "0.6.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d4e6559d53cc268e5031cd8429d05415bc4cb4aefc4aa5d6cc35fbf5b924a1f8"
+dependencies = [
+ "bitflags",
+ "bytes",
+ "futures-core",
+ "futures-util",
+ "http",
+ "http-body",
+ "http-body-util",
+ "http-range-header",
+ "httpdate",
+ "iri-string",
+ "mime",
+ "mime_guess",
+ "percent-encoding",
+ "pin-project-lite",
+ "tokio",
+ "tokio-util",
+ "tower",
+ "tower-layer",
+ "tower-service",
+ "tracing",
+]
+[[package]]
+name = "tower-layer"
+version = "0.3.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "121c2a6cda46980bb0fcd1647ffaf6cd3fc79a013de288782836f6df9c48780e"
+[[package]]
+name = "tower-service"
+version = "0.3.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8df9b6e13f2d32c91b9bd719c00d1958837bc7dec474d94952798cc8e69eeec3"
+[[package]]
+name = "tracing"
+version = "0.1.44"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "63e71662fa4b2a2c3a26f570f037eb95bb1f85397f3cd8076caed2f026a6d100"
+dependencies = [
+ "log",
+ "pin-project-lite",
+ "tracing-attributes",
+ "tracing-core",
+]
+[[package]]
+name = "tracing-attributes"
+version = "0.1.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7490cfa5ec963746568740651ac6781f701c9c5ea257c58e057f3ba8cf69e8da"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+[[package]]
+name = "tracing-core"
+version = "0.1.36"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "db97caf9d906fbde555dd62fa95ddba9eecfd14cb388e4f491a66d74cd5fb79a"
+dependencies = [
+ "once_cell",
+ "valuable",
+]
+[[package]]
+name = "tracing-log"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ee855f1f400bd0e5c02d150ae5de3840039a3f54b025156404e34c23c03f47c3"
+dependencies = [
+ "log",
+ "once_cell",
+ "tracing-core",
+]
+[[package]]
+name = "tracing-subscriber"
+version = "0.3.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2f30143827ddab0d256fd843b7a66d164e9f271cfa0dde49142c5ca0ca291f1e"
+dependencies = [
+ "matchers",
+ "nu-ansi-term",
+ "once_cell",
+ "regex-automata",
+ "sharded-slab",
+ "smallvec",
+ "thread_local",
+ "tracing",
+ "tracing-core",
+ "tracing-log",
+]
+[[package]]
+name = "try-lock"
+version = "0.2.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e421abadd41a4225275504ea4d6566923418b7f05506fbc9c0fe86ba7396114b"
+[[package]]
+name = "typenum"
+version = "1.19.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "562d481066bde0658276a35467c4af00bdc6ee726305698a55b86e61d7ad82bb"
+[[package]]
+name = "unicase"
+version = "2.8.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "75b844d17643ee918803943289730bec8aac480150456169e647ed0b576ba539"
+[[package]]
+name = "unicode-ident"
+version = "1.0.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9312f7c4f6ff9069b165498234ce8be658059c6728633667c526e27dc2cf1df5"
+[[package]]
+name = "unsafe-libyaml"
+version = "0.2.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "673aac59facbab8a9007c7f6108d11f63b603f7cabff99fabf650fea5c32b861"
+[[package]]
+name = "untrusted"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8ecb6da28b8a351d773b68d5825ac39017e680750f980f3a1a85cd8dd28a47c1"
+[[package]]
+name = "url"
+version = "2.5.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "08bc136a29a3d1758e07a9cca267be308aeebf5cfd5a10f3f67ab2097683ef5b"
+dependencies = [
+ "form_urlencoded",
+ "idna",
+ "percent-encoding",
+ "serde",
+]
+[[package]]
+name = "utf8_iter"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b6c140620e7ffbb22c2dee59cafe6084a59b5ffc27a8859a5f0d494b5d52b6be"
+[[package]]
+name = "utoipa"
+version = "5.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2fcc29c80c21c31608227e0912b2d7fddba57ad76b606890627ba8ee7964e993"
+dependencies = [
+ "indexmap",
+ "serde",
+ "serde_json",
+ "utoipa-gen",
+]
+[[package]]
+name = "utoipa-gen"
+version = "5.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6d79d08d92ab8af4c5e8a6da20c47ae3f61a0f1dabc1997cdf2d082b757ca08b"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "regex",
+ "syn",
+]
+[[package]]
+name = "utoipa-swagger-ui"
+version = "9.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d047458f1b5b65237c2f6dc6db136945667f40a7668627b3490b9513a3d43a55"
+dependencies = [
+ "axum",
+ "base64",
+ "mime_guess",
+ "regex",
+ "rust-embed",
+ "serde",
+ "serde_json",
+ "url",
+ "utoipa",
+ "zip",
+]
+[[package]]
+name = "uuid"
+version = "1.19.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e2e054861b4bd027cd373e18e8d8d8e6548085000e41290d95ce0c373a654b4a"
+dependencies = [
+ "getrandom 0.3.4",
+ "js-sys",
+ "serde_core",
+ "wasm-bindgen",
+]
+[[package]]
+name = "valuable"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ba73ea9cf16a25df0c8caa16c51acb937d5712a8429db78a3ee29d5dcacd3a65"
+[[package]]
+name = "vehicle-routing"
+version = "0.4.1"
+dependencies = [
+ "async-stream",
+ "axum",
+ "chrono",
+ "num-format",
+ "ordered-float",
+ "owo-colors",
+ "parking_lot",
+ "petgraph",
+ "rand 0.8.5",
+ "reqwest",
+ "serde",
+ "serde_json",
+ "solverforge",
+ "tokio",
+ "tokio-stream",
+ "tower",
+ "tower-http",
+ "tracing",
+ "tracing-subscriber",
+ "utoipa",
+ "utoipa-swagger-ui",
+ "uuid",
+]
+[[package]]
+name = "version_check"
+version = "0.9.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0b928f33d975fc6ad9f86c8f283853ad26bdd5b10b7f1542aa2fa15e2289105a"
+[[package]]
+name = "walkdir"
+version = "2.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "29790946404f91d9c5d06f9874efddea1dc06c5efe94541a7d6863108e3a5e4b"
+dependencies = [
+ "same-file",
+ "winapi-util",
+]
+[[package]]
+name = "want"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bfa7760aed19e106de2c7c0b581b509f2f25d3dacaf737cb82ac61bc6d760b0e"
+dependencies = [
+ "try-lock",
+]
+[[package]]
+name = "wasi"
+version = "0.11.1+wasi-snapshot-preview1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ccf3ec651a847eb01de73ccad15eb7d99f80485de043efb2f370cd654f4ea44b"
+[[package]]
+name = "wasip2"
+version = "1.0.1+wasi-0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0562428422c63773dad2c345a1882263bbf4d65cf3f42e90921f787ef5ad58e7"
+dependencies = [
+ "wit-bindgen",
+]
+[[package]]
+name = "wasm-bindgen"
+version = "0.2.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0d759f433fa64a2d763d1340820e46e111a7a5ab75f993d1852d70b03dbb80fd"
+dependencies = [
+ "cfg-if",
+ "once_cell",
+ "rustversion",
+ "wasm-bindgen-macro",
+ "wasm-bindgen-shared",
+]
+[[package]]
+name = "wasm-bindgen-futures"
+version = "0.4.56"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "836d9622d604feee9e5de25ac10e3ea5f2d65b41eac0d9ce72eb5deae707ce7c"
+dependencies = [
+ "cfg-if",
+ "js-sys",
+ "once_cell",
+ "wasm-bindgen",
+ "web-sys",
+]
+[[package]]
+name = "wasm-bindgen-macro"
+version = "0.2.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "48cb0d2638f8baedbc542ed444afc0644a29166f1595371af4fecf8ce1e7eeb3"
+dependencies = [
+ "quote",
+ "wasm-bindgen-macro-support",
+]
+[[package]]
+name = "wasm-bindgen-macro-support"
+version = "0.2.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cefb59d5cd5f92d9dcf80e4683949f15ca4b511f4ac0a6e14d4e1ac60c6ecd40"
+dependencies = [
+ "bumpalo",
+ "proc-macro2",
+ "quote",
+ "syn",
+ "wasm-bindgen-shared",
+]
+[[package]]
+name = "wasm-bindgen-shared"
+version = "0.2.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cbc538057e648b67f72a982e708d485b2efa771e1ac05fec311f9f63e5800db4"
+dependencies = [
+ "unicode-ident",
+]
+[[package]]
+name = "web-sys"
+version = "0.3.83"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9b32828d774c412041098d182a8b38b16ea816958e07cf40eec2bc080ae137ac"
+dependencies = [
+ "js-sys",
+ "wasm-bindgen",
+]
+[[package]]
+name = "web-time"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5a6580f308b1fad9207618087a65c04e7a10bc77e02c8e84e9b00dd4b12fa0bb"
+dependencies = [
+ "js-sys",
+ "wasm-bindgen",
+]
+[[package]]
+name = "webpki-roots"
+version = "1.0.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "12bed680863276c63889429bfd6cab3b99943659923822de1c8a39c49e4d722c"
+dependencies = [
+ "rustls-pki-types",
+]
+[[package]]
+name = "winapi-util"
+version = "0.1.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c2a7b1c03c876122aa43f3020e6c3c3ee5c05081c9a00739faf7503aeba10d22"
+dependencies = [
+ "windows-sys 0.61.2",
+]
+[[package]]
+name = "windows-core"
+version = "0.62.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b8e83a14d34d0623b51dce9581199302a221863196a1dde71a7663a4c2be9deb"
+dependencies = [
+ "windows-implement",
+ "windows-interface",
+ "windows-link",
+ "windows-result",
+ "windows-strings",
+]
+[[package]]
+name = "windows-implement"
+version = "0.60.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "053e2e040ab57b9dc951b72c264860db7eb3b0200ba345b4e4c3b14f67855ddf"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+[[package]]
+name = "windows-interface"
+version = "0.59.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3f316c4a2570ba26bbec722032c4099d8c8bc095efccdc15688708623367e358"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+[[package]]
+name = "windows-link"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
+[[package]]
+name = "windows-result"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7781fa89eaf60850ac3d2da7af8e5242a5ea78d1a11c49bf2910bb5a73853eb5"
+dependencies = [
+ "windows-link",
+]
+[[package]]
+name = "windows-strings"
+version = "0.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7837d08f69c77cf6b07689544538e017c1bfcf57e34b4c0ff58e6c2cd3b37091"
+dependencies = [
+ "windows-link",
+]
+[[package]]
+name = "windows-sys"
+version = "0.52.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "282be5f36a8ce781fad8c8ae18fa3f9beff57ec1b52cb3de0789201425d9a33d"
+dependencies = [
+ "windows-targets 0.52.6",
+]
+[[package]]
+name = "windows-sys"
+version = "0.60.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f2f500e4d28234f72040990ec9d39e3a6b950f9f22d3dba18416c35882612bcb"
+dependencies = [
+ "windows-targets 0.53.5",
+]
+[[package]]
+name = "windows-sys"
+version = "0.61.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ae137229bcbd6cdf0f7b80a31df61766145077ddf49416a728b02cb3921ff3fc"
+dependencies = [
+ "windows-link",
+]
+[[package]]
+name = "windows-targets"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9b724f72796e036ab90c1021d4780d4d3d648aca59e491e6b98e725b84e99973"
+dependencies = [
+ "windows_aarch64_gnullvm 0.52.6",
+ "windows_aarch64_msvc 0.52.6",
+ "windows_i686_gnu 0.52.6",
+ "windows_i686_gnullvm 0.52.6",
+ "windows_i686_msvc 0.52.6",
+ "windows_x86_64_gnu 0.52.6",
+ "windows_x86_64_gnullvm 0.52.6",
+ "windows_x86_64_msvc 0.52.6",
+]
+[[package]]
+name = "windows-targets"
+version = "0.53.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4945f9f551b88e0d65f3db0bc25c33b8acea4d9e41163edf90dcd0b19f9069f3"
+dependencies = [
+ "windows-link",
+ "windows_aarch64_gnullvm 0.53.1",
+ "windows_aarch64_msvc 0.53.1",
+ "windows_i686_gnu 0.53.1",
+ "windows_i686_gnullvm 0.53.1",
+ "windows_i686_msvc 0.53.1",
+ "windows_x86_64_gnu 0.53.1",
+ "windows_x86_64_gnullvm 0.53.1",
+ "windows_x86_64_msvc 0.53.1",
+]
+[[package]]
+name = "windows_aarch64_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "32a4622180e7a0ec044bb555404c800bc9fd9ec262ec147edd5989ccd0c02cd3"
+[[package]]
+name = "windows_aarch64_gnullvm"
+version = "0.53.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a9d8416fa8b42f5c947f8482c43e7d89e73a173cead56d044f6a56104a6d1b53"
+[[package]]
+name = "windows_aarch64_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "09ec2a7bb152e2252b53fa7803150007879548bc709c039df7627cabbd05d469"
+[[package]]
+name = "windows_aarch64_msvc"
+version = "0.53.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b9d782e804c2f632e395708e99a94275910eb9100b2114651e04744e9b125006"
+[[package]]
+name = "windows_i686_gnu"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8e9b5ad5ab802e97eb8e295ac6720e509ee4c243f69d781394014ebfe8bbfa0b"
+[[package]]
+name = "windows_i686_gnu"
+version = "0.53.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "960e6da069d81e09becb0ca57a65220ddff016ff2d6af6a223cf372a506593a3"
+[[package]]
+name = "windows_i686_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0eee52d38c090b3caa76c563b86c3a4bd71ef1a819287c19d586d7334ae8ed66"
+[[package]]
+name = "windows_i686_gnullvm"
+version = "0.53.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fa7359d10048f68ab8b09fa71c3daccfb0e9b559aed648a8f95469c27057180c"
+[[package]]
+name = "windows_i686_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "240948bc05c5e7c6dabba28bf89d89ffce3e303022809e73deaefe4f6ec56c66"
+[[package]]
+name = "windows_i686_msvc"
+version = "0.53.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1e7ac75179f18232fe9c285163565a57ef8d3c89254a30685b57d83a38d326c2"
+[[package]]
+name = "windows_x86_64_gnu"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "147a5c80aabfbf0c7d901cb5895d1de30ef2907eb21fbbab29ca94c5b08b1a78"
+[[package]]
+name = "windows_x86_64_gnu"
+version = "0.53.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9c3842cdd74a865a8066ab39c8a7a473c0778a3f29370b5fd6b4b9aa7df4a499"
+[[package]]
+name = "windows_x86_64_gnullvm"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "24d5b23dc417412679681396f2b49f3de8c1473deb516bd34410872eff51ed0d"
+[[package]]
+name = "windows_x86_64_gnullvm"
+version = "0.53.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0ffa179e2d07eee8ad8f57493436566c7cc30ac536a3379fdf008f47f6bb7ae1"
+[[package]]
+name = "windows_x86_64_msvc"
+version = "0.52.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec"
+[[package]]
+name = "windows_x86_64_msvc"
+version = "0.53.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d6bbff5f0aada427a1e5a6da5f1f98158182f26556f345ac9e04d36d0ebed650"
+[[package]]
+name = "winnow"
+version = "0.7.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5a5364e9d77fcdeeaa6062ced926ee3381faa2ee02d3eb83a5c27a8825540829"
+dependencies = [
+ "memchr",
+]
+[[package]]
+name = "wit-bindgen"
+version = "0.46.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f17a85883d4e6d00e8a97c586de764dabcc06133f7f1d55dce5cdc070ad7fe59"
+[[package]]
+name = "writeable"
+version = "0.6.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9edde0db4769d2dc68579893f2306b26c6ecfbe0ef499b013d731b7b9247e0b9"
+[[package]]
+name = "yoke"
+version = "0.8.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "72d6e5c6afb84d73944e5cedb052c4680d5657337201555f9f2a16b7406d4954"
+dependencies = [
+ "stable_deref_trait",
+ "yoke-derive",
+ "zerofrom",
+]
+[[package]]
+name = "yoke-derive"
+version = "0.8.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b659052874eb698efe5b9e8cf382204678a0086ebf46982b79d6ca3182927e5d"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+ "synstructure",
+]
+[[package]]
+name = "zerocopy"
+version = "0.8.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fd74ec98b9250adb3ca554bdde269adf631549f51d8a8f8f0a10b50f1cb298c3"
+dependencies = [
+ "zerocopy-derive",
+]
+[[package]]
+name = "zerocopy-derive"
+version = "0.8.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d8a8d209fdf45cf5138cbb5a506f6b52522a25afccc534d1475dad8e31105c6a"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+[[package]]
+name = "zerofrom"
+version = "0.1.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "50cc42e0333e05660c3587f3bf9d0478688e15d870fab3346451ce7f8c9fbea5"
+dependencies = [
+ "zerofrom-derive",
+]
+[[package]]
+name = "zerofrom-derive"
+version = "0.1.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d71e5d6e06ab090c67b5e44993ec16b72dcbaabc526db883a360057678b48502"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+ "synstructure",
+]
+[[package]]
+name = "zeroize"
+version = "1.8.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b97154e67e32c85465826e8bcc1c59429aaaf107c1e4a9e53c8d8ccd5eff88d0"
+[[package]]
+name = "zerotrie"
+version = "0.2.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2a59c17a5562d507e4b54960e8569ebee33bee890c70aa3fe7b97e85a9fd7851"
+dependencies = [
+ "displaydoc",
+ "yoke",
+ "zerofrom",
+]
+[[package]]
+name = "zerovec"
+version = "0.11.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6c28719294829477f525be0186d13efa9a3c602f7ec202ca9e353d310fb9a002"
+dependencies = [
+ "yoke",
+ "zerofrom",
+ "zerovec-derive",
+]
+[[package]]
+name = "zerovec-derive"
+version = "0.11.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "eadce39539ca5cb3985590102671f2567e659fca9666581ad3411d59207951f3"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+[[package]]
+name = "zip"
+version = "3.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "12598812502ed0105f607f941c386f43d441e00148fce9dec3ca5ffb0bde9308"
+dependencies = [
+ "arbitrary",
+ "crc32fast",
+ "flate2",
+ "indexmap",
+ "memchr",
+ "zopfli",
+]
+[[package]]
+name = "zlib-rs"
+version = "0.5.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "40990edd51aae2c2b6907af74ffb635029d5788228222c4bb811e9351c0caad3"
+[[package]]
+name = "zmij"
+version = "1.0.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "30e0d8dffbae3d840f64bda38e28391faef673a7b5a6017840f2a106c8145868"
+[[package]]
+name = "zopfli"
+version = "0.8.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f05cd8797d63865425ff89b5c4a48804f35ba0ce8d125800027ad6017d2b5249"
+dependencies = [
+ "bumpalo",
+ "crc32fast",
+ "log",
+ "simd-adler32",
+]

Cargo.toml ADDED Viewed

	@@ -0,0 +1,31 @@

+[package]
+name = "vehicle-routing"
+version = "0.4.1"
+edition = "2021"
+description = "Vehicle routing quickstart for SolverForge"
+publish = false
+[dependencies]
+solverforge = { version = "0.5.1", features = ["serde"] }
+rand = "0.8"
+axum = "0.8"
+tokio = { version = "1", features = ["full"] }
+tower-http = { version = "0.6", features = ["fs", "cors"] }
+tower = "0.5"
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+uuid = { version = "1", features = ["v4", "serde"] }
+parking_lot = "0.12"
+tracing = "0.1"
+tracing-subscriber = { version = "0.3", features = ["env-filter"] }
+owo-colors = "4.2"
+num-format = "0.4.4"
+chrono = { version = "0.4", features = ["serde"] }
+utoipa = { version = "5", features = ["axum_extras"] }
+utoipa-swagger-ui = { version = "9", features = ["axum"] }
+petgraph = "0.6"
+reqwest = { version = "0.12", default-features = false, features = ["json", "rustls-tls"] }
+ordered-float = "4"
+async-stream = "0.3"
+tokio-stream = "0.1"

Dockerfile ADDED Viewed

	@@ -0,0 +1,41 @@

+# Multi-stage build for SolverForge Employee Scheduling (Rust)
+#
+# Build context: rust/employee-scheduling/
+# Uses published solverforge crate from crates.io
+FROM rust:1.83-alpine AS builder
+# Install build dependencies
+RUN apk add --no-cache musl-dev
+WORKDIR /build
+# Copy workspace files
+COPY Cargo.toml Cargo.lock ./
+COPY src/ ./src/
+COPY static/ ./static/
+# Build release binary with musl target for static linking
+RUN cargo build --release --target x86_64-unknown-linux-musl
+# Runtime stage - minimal Alpine image
+FROM alpine:latest
+RUN apk add --no-cache ca-certificates
+WORKDIR /app
+# Copy binary from builder (musl static binary)
+COPY --from=builder /build/target/x86_64-unknown-linux-musl/release/employee-scheduling ./employee-scheduling
+# Copy static files
+COPY --from=builder /build/static/ ./static/
+# Copy solver config
+COPY --from=builder /build/solver.toml ./solver.toml
+# Expose port 7860 (HF Spaces default)
+EXPOSE 7860
+# Run the application
+CMD ["./vehicle-routing1"]

README.md CHANGED Viewed

@@ -1,12 +1,14 @@
 ---
-title: Vehicle Routing Rust Pre
-emoji: ⚡
-colorFrom: red
-colorTo: yellow
 sdk: docker
 pinned: false
 license: apache-2.0
-short_description: Pre-Release SolverForge Quickstart for VRP
 ---
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

 ---
+title: Vehicle Routing (Rust Pre-Release)
+emoji: 🛻
+colorFrom: yellow
+colorTo: red
 sdk: docker
+app_port: 7860
 pinned: false
 license: apache-2.0
+short_description: SolverForge Quickstart for Vehicle Routing in Rust
 ---
+Visit [solverforge.org](https://www.solverforge.org).

src/api.rs ADDED Viewed

	@@ -0,0 +1,1252 @@

+//! REST API for Vehicle Routing Problem.
+//!
+//! Provides endpoints for:
+//! - Demo data retrieval
+//! - Route plan management (create, get, stop)
+//! - Route geometry for map visualization
+//! - Swagger UI at /q/swagger-ui
+use axum::{
+    body::Body,
+    extract::{Path, State},
+    http::{header, StatusCode},
+    response::{IntoResponse, Response},
+    routing::{delete, get, post, put},
+    Json, Router,
+};
+use chrono::{NaiveDateTime, NaiveTime};
+use serde::{Deserialize, Serialize};
+use std::collections::HashMap;
+use std::sync::Arc;
+use tower_http::cors::{Any, CorsLayer};
+use utoipa::{OpenApi, ToSchema};
+use utoipa_swagger_ui::SwaggerUi;
+use uuid::Uuid;
+use crate::demo_data::{available_datasets, generate_by_name};
+use crate::domain::{Vehicle, VehicleRoutePlan, Visit};
+use crate::geometry::{encode_routes, EncodedSegment};
+use crate::solver::{SolverConfig, SolverService, SolverStatus};
+use solverforge::prelude::HardSoftScore;
+use std::time::Duration;
+// ============================================================================
+// Date/Time Utilities
+// ============================================================================
+/// Reference date for time calculations (matches Python frontend).
+const BASE_DATE: &str = "2025-01-05";
+/// Converts seconds from midnight to ISO datetime string.
+///
+/// # Examples
+///
+/// ```
+/// use vehicle_routing::api::seconds_to_iso;
+///
+/// assert_eq!(seconds_to_iso(0), "2025-01-05T00:00:00");
+/// assert_eq!(seconds_to_iso(8 * 3600), "2025-01-05T08:00:00");
+/// assert_eq!(seconds_to_iso(8 * 3600 + 30 * 60 + 45), "2025-01-05T08:30:45");
+/// ```
+pub fn seconds_to_iso(seconds: i64) -> String {
+    let hours = (seconds / 3600) % 24;
+    let mins = (seconds % 3600) / 60;
+    let secs = seconds % 60;
+    format!("{}T{:02}:{:02}:{:02}", BASE_DATE, hours, mins, secs)
+}
+/// Parses ISO datetime string to seconds from midnight.
+///
+/// # Examples
+///
+/// ```
+/// use vehicle_routing::api::iso_to_seconds;
+///
+/// assert_eq!(iso_to_seconds("2025-01-05T08:00:00"), 8 * 3600);
+/// assert_eq!(iso_to_seconds("2025-01-05T08:30:45"), 8 * 3600 + 30 * 60 + 45);
+/// ```
+pub fn iso_to_seconds(iso: &str) -> i64 {
+    if let Ok(dt) = NaiveDateTime::parse_from_str(iso, "%Y-%m-%dT%H:%M:%S") {
+        let midnight = NaiveDateTime::new(dt.date(), NaiveTime::from_hms_opt(0, 0, 0).unwrap());
+        (dt - midnight).num_seconds()
+    } else {
+        0
+    }
+}
+/// Application state shared across handlers.
+pub struct AppState {
+    pub solver: SolverService,
+}
+impl AppState {
+    pub fn new() -> Self {
+        Self {
+            solver: SolverService::new(),
+        }
+    }
+}
+impl Default for AppState {
+    fn default() -> Self {
+        Self::new()
+    }
+}
+/// Creates the API router with CORS and Swagger UI enabled.
+pub fn create_router() -> Router {
+    let state = Arc::new(AppState::new());
+    let cors = CorsLayer::new()
+        .allow_origin(Any)
+        .allow_methods(Any)
+        .allow_headers(Any);
+    Router::new()
+        // Health & Info
+        .route("/health", get(health))
+        .route("/info", get(info))
+        // Demo data
+        .route("/demo-data", get(list_demo_data))
+        .route("/demo-data/{name}", get(get_demo_data))
+        .route("/demo-data/{name}/stream", get(get_demo_data_stream))
+        // Route plans
+        .route("/route-plans", post(create_route_plan))
+        .route("/route-plans", get(list_route_plans))
+        .route("/route-plans/{id}", get(get_route_plan))
+        .route("/route-plans/{id}/status", get(get_route_plan_status))
+        .route("/route-plans/{id}", delete(stop_solving))
+        .route("/route-plans/{id}/geometry", get(get_route_geometry))
+        // Analysis and recommendations
+        .route("/route-plans/analyze", put(analyze_route_plan))
+        .route("/route-plans/recommendation", post(recommend_assignment))
+        .route("/route-plans/recommendation/apply", post(apply_recommendation))
+        // Swagger UI at /q/swagger-ui (Quarkus-style path)
+        .merge(SwaggerUi::new("/q/swagger-ui").url("/api-docs/openapi.json", ApiDoc::openapi()))
+        .layer(cors)
+        .with_state(state)
+}
+// ============================================================================
+// Health & Info
+// ============================================================================
+/// Health check response.
+#[derive(Debug, Serialize, ToSchema)]
+pub struct HealthResponse {
+    /// Status indicator ("UP" when healthy).
+    pub status: &'static str,
+}
+/// GET /health - Health check endpoint.
+#[utoipa::path(
+    get,
+    path = "/health",
+    responses((status = 200, description = "Service is healthy", body = HealthResponse))
+)]
+async fn health() -> Json<HealthResponse> {
+    Json(HealthResponse { status: "UP" })
+}
+/// Application info response.
+#[derive(Debug, Serialize, ToSchema)]
+#[serde(rename_all = "camelCase")]
+pub struct InfoResponse {
+    /// Application name.
+    pub name: &'static str,
+    /// Application version.
+    pub version: &'static str,
+    /// Solver engine name.
+    pub solver_engine: &'static str,
+}
+/// GET /info - Application info endpoint.
+#[utoipa::path(
+    get,
+    path = "/info",
+    responses((status = 200, description = "Application info", body = InfoResponse))
+)]
+async fn info() -> Json<InfoResponse> {
+    Json(InfoResponse {
+        name: "Vehicle Routing",
+        version: env!("CARGO_PKG_VERSION"),
+        solver_engine: "SolverForge-RS",
+    })
+}
+// ============================================================================
+// Demo Data
+// ============================================================================
+/// GET /demo-data - List available demo datasets.
+#[utoipa::path(
+    get,
+    path = "/demo-data",
+    responses((status = 200, description = "List of demo dataset names", body = Vec<String>))
+)]
+async fn list_demo_data() -> Json<Vec<&'static str>> {
+    Json(available_datasets().to_vec())
+}
+/// GET /demo-data/{name} - Get a specific demo dataset.
+#[utoipa::path(
+    get,
+    path = "/demo-data/{name}",
+    params(("name" = String, Path, description = "Demo dataset name")),
+    responses(
+        (status = 200, description = "Demo data retrieved", body = RoutePlanDto),
+        (status = 404, description = "Dataset not found")
+    )
+)]
+async fn get_demo_data(Path(name): Path<String>) -> Result<Json<RoutePlanDto>, StatusCode> {
+    match generate_by_name(&name) {
+        Some(plan) => Ok(Json(RoutePlanDto::from_plan(&plan, None))),
+        None => Err(StatusCode::NOT_FOUND),
+    }
+}
+/// GET /demo-data/{name}/stream - Get demo data with SSE progress updates.
+///
+/// Returns Server-Sent Events (SSE) stream with progress and final solution.
+/// Downloads OSM road network and computes real driving times.
+/// Compatible with frontend's EventSource API.
+///
+/// Progress phases:
+/// - `network` (0-15%): Loading road network from cache or downloading
+/// - `matrix` (15-75%): Computing travel time matrix (Dijkstra per location)
+/// - `geometry` (75-95%): Computing route geometries for visualization
+/// - `complete` (100%): Ready
+async fn get_demo_data_stream(Path(name): Path<String>) -> impl IntoResponse {
+    use crate::routing::{BoundingBox, RoadNetwork};
+    // Generate the demo data
+    let mut plan = match generate_by_name(&name) {
+        Some(p) => p,
+        None => {
+            let error = r#"data: {"event":"error","message":"Demo data not found"}"#;
+            return Response::builder()
+                .status(StatusCode::OK)
+                .header(header::CONTENT_TYPE, "text/event-stream")
+                .header(header::CACHE_CONTROL, "no-cache")
+                .body(Body::from(format!("{}\n\n", error)))
+                .unwrap();
+        }
+    };
+    // Build bounding box from plan
+    let bbox = BoundingBox::new(
+        plan.south_west_corner[0],
+        plan.south_west_corner[1],
+        plan.north_east_corner[0],
+        plan.north_east_corner[1],
+    )
+    .expand(0.05);
+    // Extract coordinates for routing
+    let coords: Vec<(f64, f64)> = plan
+        .locations
+        .iter()
+        .map(|l| (l.latitude, l.longitude))
+        .collect();
+    let n = coords.len();
+    // Build SSE stream with granular progress
+    let stream = async_stream::stream! {
+        // Phase 1: Network loading (0-15%)
+        yield Ok::<_, std::convert::Infallible>(
+            format!("data: {{\"event\":\"progress\",\"phase\":\"network\",\"message\":\"Loading road network...\",\"percent\":5,\"detail\":\"{} locations\"}}\n\n", n)
+        );
+        let network = match RoadNetwork::load_or_fetch(&bbox).await {
+            Ok(net) => {
+                yield Ok(format!(
+                    "data: {{\"event\":\"progress\",\"phase\":\"network\",\"message\":\"Road network ready\",\"percent\":15,\"detail\":\"{} nodes, {} edges\"}}\n\n",
+                    net.node_count(), net.edge_count()
+                ));
+                net
+            }
+            Err(e) => {
+                tracing::warn!("Road routing failed, using haversine: {}", e);
+                plan.finalize();
+                yield Ok("data: {\"event\":\"progress\",\"phase\":\"fallback\",\"message\":\"Using straight-line distances\",\"percent\":95}\n\n".to_string());
+                // Build response DTO and complete
+                let dto = RoutePlanDto::from_plan(&plan, None);
+                let solution_json = serde_json::to_string(&dto).unwrap_or_else(|_| "{}".to_string());
+                yield Ok(format!(
+                    "data: {{\"event\":\"progress\",\"phase\":\"complete\",\"message\":\"Ready!\",\"percent\":100}}\n\n\
+                     data: {{\"event\":\"complete\",\"solution\":{}}}\n\n",
+                    solution_json
+                ));
+                return;
+            }
+        };
+        // Phase 2: Matrix computation (15-75%) via channel for real-time progress
+        let (matrix_tx, mut matrix_rx) = tokio::sync::mpsc::unbounded_channel::<(usize, usize)>();
+        let network_for_matrix = std::sync::Arc::clone(&network);
+        let coords_for_matrix = coords.clone();
+        let matrix_handle = tokio::task::spawn_blocking(move || {
+            network_for_matrix.compute_matrix_with_progress(&coords_for_matrix, |row, total| {
+                let _ = matrix_tx.send((row, total));
+            })
+        });
+        // Stream matrix progress
+        while let Some((row, total)) = matrix_rx.recv().await {
+            // Progress from 15% to 75% (60% range)
+            let pct = 15 + (row + 1) * 60 / total;
+            yield Ok(format!(
+                "data: {{\"event\":\"progress\",\"phase\":\"matrix\",\"message\":\"Computing routes\",\"percent\":{},\"detail\":\"{}/{} locations\"}}\n\n",
+                pct, row + 1, total
+            ));
+        }
+        // Get matrix result
+        let matrix = match matrix_handle.await {
+            Ok(m) => m,
+            Err(e) => {
+                tracing::error!("Matrix computation failed: {}", e);
+                plan.finalize();
+                let dto = RoutePlanDto::from_plan(&plan, None);
+                let solution_json = serde_json::to_string(&dto).unwrap_or_else(|_| "{}".to_string());
+                yield Ok(format!(
+                    "data: {{\"event\":\"progress\",\"phase\":\"complete\",\"message\":\"Ready (fallback)\",\"percent\":100}}\n\n\
+                     data: {{\"event\":\"complete\",\"solution\":{}}}\n\n",
+                    solution_json
+                ));
+                return;
+            }
+        };
+        plan.travel_time_matrix = matrix;
+        // Phase 3: Geometry computation (75-95%) via channel
+        let (geo_tx, mut geo_rx) = tokio::sync::mpsc::unbounded_channel::<(usize, usize)>();
+        let network_for_geo = std::sync::Arc::clone(&network);
+        let coords_for_geo = coords.clone();
+        let geo_handle = tokio::task::spawn_blocking(move || {
+            network_for_geo.compute_all_geometries_with_progress(&coords_for_geo, |row, total| {
+                let _ = geo_tx.send((row, total));
+            })
+        });
+        // Stream geometry progress
+        while let Some((row, total)) = geo_rx.recv().await {
+            // Progress from 75% to 95% (20% range)
+            let pct = 75 + (row + 1) * 20 / total;
+            yield Ok(format!(
+                "data: {{\"event\":\"progress\",\"phase\":\"geometry\",\"message\":\"Generating routes\",\"percent\":{},\"detail\":\"{}/{} paths\"}}\n\n",
+                pct, row + 1, total
+            ));
+        }
+        // Get geometry result
+        let geometries = match geo_handle.await {
+            Ok(g) => g,
+            Err(e) => {
+                tracing::error!("Geometry computation failed: {}", e);
+                std::collections::HashMap::new()
+            }
+        };
+        plan.route_geometries = geometries;
+        // Build response DTO
+        let dto = RoutePlanDto::from_plan(&plan, None);
+        let solution_json = serde_json::to_string(&dto).unwrap_or_else(|_| "{}".to_string());
+        // Complete (100%)
+        yield Ok(format!(
+            "data: {{\"event\":\"progress\",\"phase\":\"complete\",\"message\":\"Ready!\",\"percent\":100}}\n\n\
+             data: {{\"event\":\"complete\",\"solution\":{}}}\n\n",
+            solution_json
+        ));
+    };
+    let body = Body::from_stream(stream);
+    Response::builder()
+        .status(StatusCode::OK)
+        .header(header::CONTENT_TYPE, "text/event-stream")
+        .header(header::CACHE_CONTROL, "no-cache")
+        .header(header::CONNECTION, "keep-alive")
+        .body(body)
+        .unwrap()
+}
+// ============================================================================
+// DTOs (Python API Compatible)
+// ============================================================================
+/// Visit DTO matching Python API structure.
+///
+/// All times are ISO datetime strings (e.g., "2025-01-05T08:30:00").
+/// Location is `[latitude, longitude]` array.
+#[derive(Debug, Clone, Serialize, Deserialize, ToSchema)]
+#[serde(rename_all = "camelCase")]
+pub struct VisitDto {
+    /// Unique visit identifier.
+    pub id: String,
+    /// Customer name.
+    pub name: String,
+    /// Location as `[latitude, longitude]`.
+    pub location: [f64; 2],
+    /// Quantity demanded.
+    pub demand: i32,
+    /// Earliest service start time (ISO datetime).
+    pub min_start_time: String,
+    /// Latest service end time (ISO datetime).
+    pub max_end_time: String,
+    /// Service duration in seconds.
+    pub service_duration: i32,
+    /// Assigned vehicle ID (null if unassigned).
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub vehicle: Option<String>,
+    /// Previous visit in route (null if first or unassigned).
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub previous_visit: Option<String>,
+    /// Next visit in route (null if last or unassigned).
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub next_visit: Option<String>,
+    /// Arrival time at visit (ISO datetime).
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub arrival_time: Option<String>,
+    /// Service start time (ISO datetime).
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub start_service_time: Option<String>,
+    /// Departure time from visit (ISO datetime).
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub departure_time: Option<String>,
+    /// Driving time from previous stop in seconds.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub driving_time_seconds_from_previous_standstill: Option<i32>,
+}
+/// Vehicle DTO matching Python API structure.
+///
+/// Visits are referenced by ID only; full visit data is in the plan's `visits` array.
+#[derive(Debug, Clone, Serialize, Deserialize, ToSchema)]
+#[serde(rename_all = "camelCase")]
+pub struct VehicleDto {
+    /// Unique vehicle identifier.
+    pub id: String,
+    /// Vehicle name for display.
+    pub name: String,
+    /// Maximum capacity.
+    pub capacity: i32,
+    /// Home depot location as `[latitude, longitude]`.
+    pub home_location: [f64; 2],
+    /// Departure time from depot (ISO datetime).
+    pub departure_time: String,
+    /// Visit IDs in route order.
+    pub visits: Vec<String>,
+    /// Total demand of assigned visits.
+    pub total_demand: i32,
+    /// Total driving time in seconds.
+    pub total_driving_time_seconds: i32,
+    /// Arrival time back at depot (ISO datetime).
+    pub arrival_time: String,
+}
+/// Termination configuration for the solver.
+///
+/// Supports multiple termination conditions that combine with OR logic.
+#[derive(Debug, Clone, Serialize, Deserialize, ToSchema, Default)]
+#[serde(rename_all = "camelCase")]
+pub struct TerminationConfigDto {
+    /// Stop after this many seconds.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub seconds_spent_limit: Option<u64>,
+    /// Stop after this many seconds without improvement.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub unimproved_seconds_spent_limit: Option<u64>,
+    /// Stop after this many steps.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub step_count_limit: Option<u64>,
+    /// Stop after this many steps without improvement.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub unimproved_step_count_limit: Option<u64>,
+}
+/// Full route plan DTO matching Python API structure.
+///
+/// Contains ALL visits in a flat list; assignment is indicated by `vehicle` field.
+#[derive(Debug, Clone, Serialize, Deserialize, ToSchema)]
+#[serde(rename_all = "camelCase")]
+pub struct RoutePlanDto {
+    /// Problem name.
+    pub name: String,
+    /// South-west corner of bounding box as `[latitude, longitude]`.
+    pub south_west_corner: [f64; 2],
+    /// North-east corner of bounding box as `[latitude, longitude]`.
+    pub north_east_corner: [f64; 2],
+    /// Earliest vehicle departure time (ISO datetime).
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub start_date_time: Option<String>,
+    /// Latest vehicle arrival time (ISO datetime).
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub end_date_time: Option<String>,
+    /// Total driving time across all vehicles in seconds.
+    pub total_driving_time_seconds: i32,
+    /// All vehicles.
+    pub vehicles: Vec<VehicleDto>,
+    /// All visits (assigned and unassigned).
+    pub visits: Vec<VisitDto>,
+    /// Current score (e.g., "0hard/-14400soft").
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub score: Option<String>,
+    /// Solver status ("NOT_SOLVING", "SOLVING_ACTIVE", etc.).
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub solver_status: Option<String>,
+    /// Termination configuration.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub termination: Option<TerminationConfigDto>,
+    /// Precomputed travel time matrix (optional, from real roads).
+    /// Row/column order: depot locations first, then visit locations.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub travel_time_matrix: Option<Vec<Vec<i64>>>,
+}
+impl RoutePlanDto {
+    /// Converts domain model to DTO for API responses.
+    ///
+    /// Builds flat visit list with vehicle assignments and timing info.
+    pub fn from_plan(plan: &VehicleRoutePlan, status: Option<SolverStatus>) -> Self {
+        // Build vehicle ID lookup: visit_idx -> (vehicle_id, position in route)
+        let mut visit_vehicle: HashMap<usize, (String, usize)> = HashMap::new();
+        for v in &plan.vehicles {
+            for (pos, &visit_idx) in v.visits.iter().enumerate() {
+                visit_vehicle.insert(visit_idx, (v.id.to_string(), pos));
+            }
+        }
+        // Build visit ID lookup for next/previous references
+        let visit_id = |idx: usize| -> String { format!("v{}", idx) };
+        // Calculate timing for all vehicles
+        let mut visit_timings: HashMap<usize, (i64, i64, i64, i32)> = HashMap::new(); // (arrival, service_start, departure, driving_time)
+        for v in &plan.vehicles {
+            let timings = plan.calculate_route_times(v);
+            let mut prev_loc = v.home_location.index;
+            for timing in timings.iter() {
+                let driving_time = plan.travel_time(prev_loc, plan.visits[timing.visit_idx].location.index);
+                let service_start = timing.arrival.max(plan.visits[timing.visit_idx].min_start_time);
+                visit_timings.insert(
+                    timing.visit_idx,
+                    (timing.arrival, service_start, timing.departure, driving_time as i32),
+                );
+                prev_loc = plan.visits[timing.visit_idx].location.index;
+            }
+        }
+        // Build ALL visits with assignment info
+        let visits: Vec<VisitDto> = plan
+            .visits
+            .iter()
+            .filter_map(|visit| {
+                let loc = plan.locations.get(visit.location.index)?;
+                let (vehicle_id, vehicle_pos) = visit_vehicle.get(&visit.index).cloned().unzip();
+                let vehicle_for_visit = vehicle_id.as_ref().and_then(|vid| {
+                    plan.vehicles.iter().find(|v| v.id.to_string() == *vid)
+                });
+                // Get previous/next visit IDs
+                let (prev_visit, next_visit) = if let (Some(v), Some(pos)) = (vehicle_for_visit, vehicle_pos) {
+                    let prev = if pos > 0 { Some(visit_id(v.visits[pos - 1])) } else { None };
+                    let next = if pos + 1 < v.visits.len() { Some(visit_id(v.visits[pos + 1])) } else { None };
+                    (prev, next)
+                } else {
+                    (None, None)
+                };
+                let timing = visit_timings.get(&visit.index);
+                Some(VisitDto {
+                    id: visit_id(visit.index),
+                    name: visit.name.clone(),
+                    location: [loc.latitude, loc.longitude],
+                    demand: visit.demand,
+                    min_start_time: seconds_to_iso(visit.min_start_time),
+                    max_end_time: seconds_to_iso(visit.max_end_time),
+                    service_duration: visit.service_duration as i32,
+                    vehicle: vehicle_id,
+                    previous_visit: prev_visit,
+                    next_visit,
+                    arrival_time: timing.map(|t| seconds_to_iso(t.0)),
+                    start_service_time: timing.map(|t| seconds_to_iso(t.1)),
+                    departure_time: timing.map(|t| seconds_to_iso(t.2)),
+                    driving_time_seconds_from_previous_standstill: timing.map(|t| t.3),
+                })
+            })
+            .collect();
+        // Build vehicles with visit ID references
+        let vehicles: Vec<VehicleDto> = plan
+            .vehicles
+            .iter()
+            .map(|v| {
+                let home_loc = plan
+                    .locations
+                    .get(v.home_location.index)
+                    .map(|l| [l.latitude, l.longitude])
+                    .unwrap_or([0.0, 0.0]);
+                let total_driving = plan.total_driving_time(v);
+                let route_times = plan.calculate_route_times(v);
+                // Calculate arrival time back at depot
+                let arrival = if v.visits.is_empty() {
+                    v.departure_time
+                } else if let Some(last_timing) = route_times.last() {
+                    let last_visit = &plan.visits[last_timing.visit_idx];
+                    let return_travel = plan.travel_time(last_visit.location.index, v.home_location.index);
+                    last_timing.departure + return_travel
+                } else {
+                    v.departure_time
+                };
+                // Compute total demand by summing visit demands
+                let total_demand: i32 = v
+                    .visits
+                    .iter()
+                    .filter_map(|&idx| plan.visits.get(idx))
+                    .map(|visit| visit.demand)
+                    .sum();
+                VehicleDto {
+                    id: v.id.to_string(),
+                    name: v.name.clone(),
+                    capacity: v.capacity,
+                    home_location: home_loc,
+                    departure_time: seconds_to_iso(v.departure_time),
+                    visits: v.visits.iter().map(|&idx| visit_id(idx)).collect(),
+                    total_demand,
+                    total_driving_time_seconds: total_driving as i32,
+                    arrival_time: seconds_to_iso(arrival),
+                }
+            })
+            .collect();
+        // Calculate plan-level times
+        let start_dt = plan.vehicles.iter().map(|v| v.departure_time).min();
+        let end_dt = vehicles.iter().map(|v| iso_to_seconds(&v.arrival_time)).max();
+        Self {
+            name: plan.name.clone(),
+            south_west_corner: plan.south_west_corner,
+            north_east_corner: plan.north_east_corner,
+            start_date_time: start_dt.map(seconds_to_iso),
+            end_date_time: end_dt.map(seconds_to_iso),
+            total_driving_time_seconds: plan.total_driving_time_all() as i32,
+            vehicles,
+            visits,
+            score: plan.score.map(|s| format!("{}", s)),
+            solver_status: status.map(|s| s.as_str().to_string()),
+            termination: None,
+            travel_time_matrix: if plan.travel_time_matrix.is_empty() {
+                None
+            } else {
+                Some(plan.travel_time_matrix.clone())
+            },
+        }
+    }
+    /// Converts DTO to domain model for solving.
+    pub fn to_domain(&self) -> VehicleRoutePlan {
+        use crate::domain::Location;
+        // Build locations (depots first, then visit locations)
+        let mut locations = Vec::new();
+        let mut depot_indices: HashMap<(i64, i64), usize> = HashMap::new();
+        // Add unique depot locations
+        for vdto in &self.vehicles {
+            let key = (
+                (vdto.home_location[0] * 1e6) as i64,
+                (vdto.home_location[1] * 1e6) as i64,
+            );
+            depot_indices.entry(key).or_insert_with(|| {
+                let idx = locations.len();
+                locations.push(Location::new(idx, vdto.home_location[0], vdto.home_location[1]));
+                idx
+            });
+        }
+        // Build visit ID to index mapping
+        let visit_id_to_idx: HashMap<&str, usize> = self
+            .visits
+            .iter()
+            .enumerate()
+            .map(|(i, v)| (v.id.as_str(), i))
+            .collect();
+        // Add visit locations
+        let visit_start_idx = locations.len();
+        for (i, vdto) in self.visits.iter().enumerate() {
+            locations.push(Location::new(
+                visit_start_idx + i,
+                vdto.location[0],
+                vdto.location[1],
+            ));
+        }
+        // Build visits - now needs Location object, not index
+        let visits: Vec<Visit> = self
+            .visits
+            .iter()
+            .enumerate()
+            .map(|(i, vdto)| {
+                let loc = locations[visit_start_idx + i].clone();
+                Visit::new(i, &vdto.name, loc)
+                    .with_demand(vdto.demand)
+                    .with_time_window(
+                        iso_to_seconds(&vdto.min_start_time),
+                        iso_to_seconds(&vdto.max_end_time),
+                    )
+                    .with_service_duration(vdto.service_duration as i64)
+            })
+            .collect();
+        // Build vehicles - now needs Location object, not index
+        let vehicles: Vec<Vehicle> = self
+            .vehicles
+            .iter()
+            .enumerate()
+            .map(|(i, vdto)| {
+                let key = (
+                    (vdto.home_location[0] * 1e6) as i64,
+                    (vdto.home_location[1] * 1e6) as i64,
+                );
+                let home_idx = depot_indices[&key];
+                let home_loc = locations[home_idx].clone();
+                // Map visit IDs to indices
+                let visit_indices: Vec<usize> = vdto
+                    .visits
+                    .iter()
+                    .filter_map(|vid| visit_id_to_idx.get(vid.as_str()).copied())
+                    .collect();
+                let mut v = Vehicle::new(i, &vdto.name, vdto.capacity, home_loc);
+                v.departure_time = iso_to_seconds(&vdto.departure_time);
+                v.visits = visit_indices;
+                v
+            })
+            .collect();
+        let mut plan = VehicleRoutePlan::new(&self.name, locations, visits, vehicles);
+        plan.south_west_corner = self.south_west_corner;
+        plan.north_east_corner = self.north_east_corner;
+        // Use provided matrix (from real roads) if available, otherwise compute haversine
+        if let Some(matrix) = &self.travel_time_matrix {
+            plan.travel_time_matrix = matrix.clone();
+        } else {
+            plan.finalize();
+        }
+        plan
+    }
+}
+// ============================================================================
+// Route Plan Handlers
+// ============================================================================
+/// POST /route-plans - Create and start solving a route plan.
+#[utoipa::path(
+    post,
+    path = "/route-plans",
+    request_body = RoutePlanDto,
+    responses((status = 200, description = "Job ID", body = String))
+)]
+async fn create_route_plan(
+    State(state): State<Arc<AppState>>,
+    Json(dto): Json<RoutePlanDto>,
+) -> Result<String, StatusCode> {
+    let id = Uuid::new_v4().to_string();
+    let mut plan = dto.to_domain();
+    // Initialize road routing (uses cached network - instant after first download)
+    if let Err(e) = plan.init_routing().await {
+        tracing::error!("Road routing initialization failed: {}", e);
+        return Err(StatusCode::SERVICE_UNAVAILABLE);
+    }
+    // Convert termination config from DTO
+    let config = if let Some(term) = &dto.termination {
+        SolverConfig {
+            time_limit: term.seconds_spent_limit.map(Duration::from_secs),
+            unimproved_time_limit: term.unimproved_seconds_spent_limit.map(Duration::from_secs),
+            step_limit: term.step_count_limit,
+            unimproved_step_limit: term.unimproved_step_count_limit,
+        }
+    } else {
+        SolverConfig::default_config()
+    };
+    let job = state.solver.create_job_with_config(id.clone(), plan, config);
+    state.solver.start_solving(job);
+    Ok(id)
+}
+/// GET /route-plans - List all route plan IDs.
+#[utoipa::path(
+    get,
+    path = "/route-plans",
+    responses((status = 200, description = "List of job IDs", body = Vec<String>))
+)]
+async fn list_route_plans(State(state): State<Arc<AppState>>) -> Json<Vec<String>> {
+    Json(state.solver.list_jobs())
+}
+/// GET /route-plans/{id} - Get current route plan state.
+#[utoipa::path(
+    get,
+    path = "/route-plans/{id}",
+    params(("id" = String, Path, description = "Route plan ID")),
+    responses(
+        (status = 200, description = "Route plan retrieved", body = RoutePlanDto),
+        (status = 404, description = "Not found")
+    )
+)]
+async fn get_route_plan(
+    State(state): State<Arc<AppState>>,
+    Path(id): Path<String>,
+) -> Result<Json<RoutePlanDto>, StatusCode> {
+    match state.solver.get_job(&id) {
+        Some(job) => {
+            let guard = job.read();
+            Ok(Json(RoutePlanDto::from_plan(
+                &guard.plan,
+                Some(guard.status),
+            )))
+        }
+        None => Err(StatusCode::NOT_FOUND),
+    }
+}
+/// Status response.
+#[derive(Debug, Serialize, ToSchema)]
+#[serde(rename_all = "camelCase")]
+pub struct StatusResponse {
+    /// Current score.
+    pub score: Option<String>,
+    /// Solver status.
+    pub solver_status: String,
+}
+/// GET /route-plans/{id}/status - Get route plan status only.
+#[utoipa::path(
+    get,
+    path = "/route-plans/{id}/status",
+    params(("id" = String, Path, description = "Route plan ID")),
+    responses(
+        (status = 200, description = "Status retrieved", body = StatusResponse),
+        (status = 404, description = "Not found")
+    )
+)]
+async fn get_route_plan_status(
+    State(state): State<Arc<AppState>>,
+    Path(id): Path<String>,
+) -> Result<Json<StatusResponse>, StatusCode> {
+    match state.solver.get_job(&id) {
+        Some(job) => {
+            let guard = job.read();
+            Ok(Json(StatusResponse {
+                score: guard.plan.score.map(|s| format!("{}", s)),
+                solver_status: guard.status.as_str().to_string(),
+            }))
+        }
+        None => Err(StatusCode::NOT_FOUND),
+    }
+}
+/// DELETE /route-plans/{id} - Stop solving and get final solution.
+#[utoipa::path(
+    delete,
+    path = "/route-plans/{id}",
+    params(("id" = String, Path, description = "Route plan ID")),
+    responses(
+        (status = 200, description = "Solving stopped", body = RoutePlanDto),
+        (status = 404, description = "Not found")
+    )
+)]
+async fn stop_solving(
+    State(state): State<Arc<AppState>>,
+    Path(id): Path<String>,
+) -> Result<Json<RoutePlanDto>, StatusCode> {
+    state.solver.stop_solving(&id);
+    match state.solver.remove_job(&id) {
+        Some(job) => {
+            let guard = job.read();
+            Ok(Json(RoutePlanDto::from_plan(
+                &guard.plan,
+                Some(SolverStatus::NotSolving),
+            )))
+        }
+        None => Err(StatusCode::NOT_FOUND),
+    }
+}
+/// Geometry response with encoded polylines for map rendering.
+#[derive(Debug, Serialize, ToSchema)]
+#[serde(rename_all = "camelCase")]
+pub struct GeometryResponse {
+    /// Encoded route segments per vehicle.
+    pub segments: Vec<EncodedSegment>,
+}
+/// GET /route-plans/{id}/geometry - Get encoded polylines for routes.
+#[utoipa::path(
+    get,
+    path = "/route-plans/{id}/geometry",
+    params(("id" = String, Path, description = "Route plan ID")),
+    responses(
+        (status = 200, description = "Geometry retrieved", body = GeometryResponse),
+        (status = 404, description = "Not found")
+    )
+)]
+async fn get_route_geometry(
+    State(state): State<Arc<AppState>>,
+    Path(id): Path<String>,
+) -> Result<Json<GeometryResponse>, StatusCode> {
+    match state.solver.get_job(&id) {
+        Some(job) => {
+            let guard = job.read();
+            let segments = encode_routes(&guard.plan);
+            Ok(Json(GeometryResponse { segments }))
+        }
+        None => Err(StatusCode::NOT_FOUND),
+    }
+}
+// ============================================================================
+// Score Analysis
+// ============================================================================
+/// Match analysis for a constraint violation.
+#[derive(Debug, Clone, Serialize, ToSchema)]
+pub struct MatchAnalysisDto {
+    /// Constraint name.
+    pub name: String,
+    /// Score impact of this match.
+    pub score: String,
+    /// Description of the match.
+    pub justification: String,
+}
+/// Constraint analysis showing all matches.
+#[derive(Debug, Clone, Serialize, ToSchema)]
+pub struct ConstraintAnalysisDto {
+    /// Constraint name.
+    pub name: String,
+    /// Constraint weight (score per violation).
+    pub weight: String,
+    /// Total score from this constraint.
+    pub score: String,
+    /// Individual matches.
+    pub matches: Vec<MatchAnalysisDto>,
+}
+/// Response from score analysis endpoint.
+#[derive(Debug, Serialize, ToSchema)]
+pub struct AnalyzeResponse {
+    /// Per-constraint breakdown.
+    pub constraints: Vec<ConstraintAnalysisDto>,
+}
+/// PUT /route-plans/analyze - Analyze constraint violations.
+#[utoipa::path(
+    put,
+    path = "/route-plans/analyze",
+    request_body = RoutePlanDto,
+    responses((status = 200, description = "Constraint analysis", body = AnalyzeResponse))
+)]
+async fn analyze_route_plan(Json(dto): Json<RoutePlanDto>) -> Json<AnalyzeResponse> {
+    use crate::constraints::{calculate_late_minutes, calculate_excess_capacity};
+    let plan = dto.to_domain();
+    // Calculate constraint scores
+    let cap_total: i64 = plan.vehicles.iter()
+        .map(|v| calculate_excess_capacity(&plan, v) as i64)
+        .sum();
+    let tw_total: i64 = plan.vehicles.iter()
+        .map(|v| calculate_late_minutes(&plan, v))
+        .sum();
+    let travel_total: i64 = plan.vehicles.iter()
+        .map(|v| plan.total_driving_time(v))
+        .sum();
+    let cap_score = HardSoftScore::of_hard(-cap_total);
+    let tw_score = HardSoftScore::of_hard(-tw_total);
+    let travel_score = HardSoftScore::of_soft(-travel_total);
+    // Helper to compute total demand
+    let total_demand = |v: &Vehicle| -> i32 {
+        v.visits.iter()
+            .filter_map(|&idx| plan.visits.get(idx))
+            .map(|visit| visit.demand)
+            .sum()
+    };
+    // Build detailed matches for capacity constraint
+    let cap_matches: Vec<MatchAnalysisDto> = plan.vehicles.iter()
+        .filter(|v| total_demand(v) > v.capacity)
+        .map(|v| {
+            let demand = total_demand(v);
+            let excess = demand - v.capacity;
+            MatchAnalysisDto {
+                name: "Vehicle capacity".to_string(),
+                score: format!("{}hard/0soft", -excess),
+                justification: format!("{} is over capacity by {} (demand {} > capacity {})",
+                    v.name, excess, demand, v.capacity),
+            }
+        })
+        .collect();
+    // Build detailed matches for time window constraint
+    let mut tw_matches: Vec<MatchAnalysisDto> = Vec::new();
+    for vehicle in &plan.vehicles {
+        let timings = plan.calculate_route_times(vehicle);
+        for timing in &timings {
+            if let Some(visit) = plan.get_visit(timing.visit_idx) {
+                if timing.departure > visit.max_end_time {
+                    let late_secs = timing.departure - visit.max_end_time;
+                    let late_mins = (late_secs + 59) / 60;
+                    tw_matches.push(MatchAnalysisDto {
+                        name: "Service finished after max end time".to_string(),
+                        score: format!("{}hard/0soft", -late_mins),
+                        justification: format!("{} finishes {} mins late (ends at {}, max {})",
+                            visit.name, late_mins,
+                            seconds_to_iso(timing.departure),
+                            seconds_to_iso(visit.max_end_time)),
+                    });
+                }
+            }
+        }
+    }
+    // Build matches for travel time
+    let travel_matches: Vec<MatchAnalysisDto> = plan.vehicles.iter()
+        .filter(|v| !v.visits.is_empty())
+        .map(|v| {
+            let time = plan.total_driving_time(v);
+            MatchAnalysisDto {
+                name: "Minimize travel time".to_string(),
+                score: format!("0hard/{}soft", -time),
+                justification: format!("{} drives {} seconds", v.name, time),
+            }
+        })
+        .collect();
+    let constraints = vec![
+        ConstraintAnalysisDto {
+            name: "Vehicle capacity".to_string(),
+            weight: "1hard/0soft".to_string(),
+            score: format!("{}", cap_score),
+            matches: cap_matches,
+        },
+        ConstraintAnalysisDto {
+            name: "Service finished after max end time".to_string(),
+            weight: "1hard/0soft".to_string(),
+            score: format!("{}", tw_score),
+            matches: tw_matches,
+        },
+        ConstraintAnalysisDto {
+            name: "Minimize travel time".to_string(),
+            weight: "0hard/1soft".to_string(),
+            score: format!("{}", travel_score),
+            matches: travel_matches,
+        },
+    ];
+    Json(AnalyzeResponse { constraints })
+}
+// ============================================================================
+// Recommendation
+// ============================================================================
+/// Recommended assignment for a visit.
+#[derive(Debug, Clone, Serialize, Deserialize, ToSchema)]
+#[serde(rename_all = "camelCase")]
+pub struct VehicleRecommendation {
+    /// Vehicle ID to assign to.
+    pub vehicle_id: String,
+    /// Position in vehicle's route.
+    pub index: usize,
+}
+/// Recommendation response with score impact.
+#[derive(Debug, Clone, Serialize, ToSchema)]
+#[serde(rename_all = "camelCase")]
+pub struct RecommendedAssignment {
+    /// The recommendation.
+    pub proposition: VehicleRecommendation,
+    /// Score difference if applied.
+    pub score_diff: String,
+}
+/// Request for visit recommendations.
+#[derive(Debug, Deserialize, ToSchema)]
+#[serde(rename_all = "camelCase")]
+pub struct RecommendationRequest {
+    /// Current solution.
+    pub solution: RoutePlanDto,
+    /// Visit ID to find recommendations for.
+    pub visit_id: String,
+}
+/// Request to apply a recommendation.
+#[derive(Debug, Deserialize, ToSchema)]
+#[serde(rename_all = "camelCase")]
+pub struct ApplyRecommendationRequest {
+    /// Current solution.
+    pub solution: RoutePlanDto,
+    /// Visit ID to assign.
+    pub visit_id: String,
+    /// Vehicle ID to assign to.
+    pub vehicle_id: String,
+    /// Position in vehicle's route.
+    pub index: usize,
+}
+/// POST /route-plans/recommendation - Get recommendations for assigning a visit.
+#[utoipa::path(
+    post,
+    path = "/route-plans/recommendation",
+    request_body = RecommendationRequest,
+    responses((status = 200, description = "Recommendations", body = Vec<RecommendedAssignment>))
+)]
+async fn recommend_assignment(Json(request): Json<RecommendationRequest>) -> Json<Vec<RecommendedAssignment>> {
+    use crate::constraints::calculate_score;
+    let mut plan = request.solution.to_domain();
+    // Find the visit index by ID
+    let visit_id_num: usize = request.visit_id.trim_start_matches('v').parse().unwrap_or(usize::MAX);
+    if visit_id_num >= plan.visits.len() {
+        return Json(vec![]);
+    }
+    // Remove visit from any current assignment
+    for vehicle in &mut plan.vehicles {
+        vehicle.visits.retain(|&v| v != visit_id_num);
+    }
+    plan.finalize();
+    // Get baseline score
+    let baseline = calculate_score(&plan);
+    // Try inserting at each position in each vehicle
+    let mut recommendations: Vec<(RecommendedAssignment, HardSoftScore)> = Vec::new();
+    for (v_idx, vehicle) in plan.vehicles.iter().enumerate() {
+        for insert_pos in 0..=vehicle.visits.len() {
+            // Clone and insert
+            let mut test_plan = plan.clone();
+            test_plan.vehicles[v_idx].visits.insert(insert_pos, visit_id_num);
+            test_plan.finalize();
+            let new_score = calculate_score(&test_plan);
+            let diff = new_score - baseline;
+            recommendations.push((
+                RecommendedAssignment {
+                    proposition: VehicleRecommendation {
+                        vehicle_id: vehicle.id.to_string(),
+                        index: insert_pos,
+                    },
+                    score_diff: format!("{}", diff),
+                },
+                diff,
+            ));
+        }
+    }
+    // Sort by score (best first) and take top 5
+    recommendations.sort_by(|a, b| b.1.cmp(&a.1));
+    let top5: Vec<RecommendedAssignment> = recommendations.into_iter().take(5).map(|(r, _)| r).collect();
+    Json(top5)
+}
+/// POST /route-plans/recommendation/apply - Apply a recommendation.
+#[utoipa::path(
+    post,
+    path = "/route-plans/recommendation/apply",
+    request_body = ApplyRecommendationRequest,
+    responses((status = 200, description = "Updated solution", body = RoutePlanDto))
+)]
+async fn apply_recommendation(Json(request): Json<ApplyRecommendationRequest>) -> Json<RoutePlanDto> {
+    let mut plan = request.solution.to_domain();
+    // Find the visit index by ID
+    let visit_id_num: usize = request.visit_id.trim_start_matches('v').parse().unwrap_or(usize::MAX);
+    let vehicle_id_num: usize = request.vehicle_id.parse().unwrap_or(usize::MAX);
+    // Remove visit from any current assignment
+    for vehicle in &mut plan.vehicles {
+        vehicle.visits.retain(|&v| v != visit_id_num);
+    }
+    // Insert at specified position
+    if let Some(vehicle) = plan.vehicles.iter_mut().find(|v| v.id == vehicle_id_num) {
+        let insert_idx = request.index.min(vehicle.visits.len());
+        vehicle.visits.insert(insert_idx, visit_id_num);
+    }
+    plan.finalize();
+    // Recalculate score
+    use crate::constraints::calculate_score;
+    plan.score = Some(calculate_score(&plan));
+    Json(RoutePlanDto::from_plan(&plan, None))
+}
+// ============================================================================
+// OpenAPI Documentation
+// ============================================================================
+#[derive(OpenApi)]
+#[openapi(
+    paths(
+        health,
+        info,
+        list_demo_data,
+        get_demo_data,
+        create_route_plan,
+        list_route_plans,
+        get_route_plan,
+        get_route_plan_status,
+        stop_solving,
+        get_route_geometry,
+        analyze_route_plan,
+        recommend_assignment,
+        apply_recommendation,
+    ),
+    components(schemas(
+        HealthResponse,
+        InfoResponse,
+        VisitDto,
+        VehicleDto,
+        RoutePlanDto,
+        TerminationConfigDto,
+        StatusResponse,
+        GeometryResponse,
+        MatchAnalysisDto,
+        ConstraintAnalysisDto,
+        AnalyzeResponse,
+        VehicleRecommendation,
+        RecommendedAssignment,
+        RecommendationRequest,
+        ApplyRecommendationRequest,
+    ))
+)]
+struct ApiDoc;

src/console.rs ADDED Viewed

	@@ -0,0 +1,361 @@

+//! Colorful console output for solver metrics.
+use num_format::{Locale, ToFormattedString};
+use owo_colors::OwoColorize;
+use std::time::{Duration, Instant};
+/// ASCII art banner for solver startup.
+pub fn print_banner() {
+    let banner = r#"
+  ____        _                _____
+ / ___|  ___ | |_   _____ _ __|  ___|__  _ __ __ _  ___
+ \___ \ / _ \| \ \ / / _ \ '__| |_ / _ \| '__/ _` |/ _ \
+  ___) | (_) | |\ V /  __/ |  |  _| (_) | | | (_| |  __/
+ |____/ \___/|_| \_/ \___|_|  |_|  \___/|_|  \__, |\___|
+                                             |___/
+"#;
+    println!("{}", banner.cyan().bold());
+    println!(
+        "  {} {}\n",
+        format!("v{}", env!("CARGO_PKG_VERSION")).bright_black(),
+        "Vehicle Routing".bright_cyan()
+    );
+}
+/// Prints "Solving started" message.
+pub fn print_solving_started(
+    time_spent_ms: u64,
+    best_score: &str,
+    entity_count: usize,
+    variable_count: usize,
+    value_count: usize,
+) {
+    println!(
+        "{} {} {} time spent ({}), best score ({}), random ({})",
+        timestamp().bright_black(),
+        "INFO".bright_green(),
+        "[Solver]".bright_cyan(),
+        format!("{}ms", time_spent_ms).yellow(),
+        format_score(best_score),
+        "StdRng".white()
+    );
+    // Problem scale
+    let scale = calculate_problem_scale(entity_count, value_count);
+    println!(
+        "{} {} {} entity count ({}), variable count ({}), value count ({}), problem scale ({})",
+        timestamp().bright_black(),
+        "INFO".bright_green(),
+        "[Solver]".bright_cyan(),
+        entity_count.to_formatted_string(&Locale::en).bright_yellow(),
+        variable_count.to_formatted_string(&Locale::en).bright_yellow(),
+        value_count.to_formatted_string(&Locale::en).bright_yellow(),
+        scale.bright_magenta()
+    );
+}
+/// Prints a phase start message.
+pub fn print_phase_start(phase_name: &str, phase_index: usize) {
+    println!(
+        "{} {} {} {} phase ({}) started",
+        timestamp().bright_black(),
+        "INFO".bright_green(),
+        format!("[{}]", phase_name).bright_cyan(),
+        phase_name.white().bold(),
+        phase_index.to_string().yellow()
+    );
+}
+/// Prints a phase end message with metrics.
+pub fn print_phase_end(
+    phase_name: &str,
+    phase_index: usize,
+    duration: Duration,
+    steps_accepted: u64,
+    moves_evaluated: u64,
+    best_score: &str,
+) {
+    let moves_per_sec = if duration.as_secs_f64() > 0.0 {
+        (moves_evaluated as f64 / duration.as_secs_f64()) as u64
+    } else {
+        0
+    };
+    let acceptance_rate = if moves_evaluated > 0 {
+        (steps_accepted as f64 / moves_evaluated as f64) * 100.0
+    } else {
+        0.0
+    };
+    println!(
+        "{} {} {} {} phase ({}) ended: time spent ({}), best score ({}), move evaluation speed ({}/sec), step total ({}, {:.1}% accepted)",
+        timestamp().bright_black(),
+        "INFO".bright_green(),
+        format!("[{}]", phase_name).bright_cyan(),
+        phase_name.white().bold(),
+        phase_index.to_string().yellow(),
+        format_duration(duration).yellow(),
+        format_score(best_score),
+        moves_per_sec.to_formatted_string(&Locale::en).bright_magenta().bold(),
+        steps_accepted.to_formatted_string(&Locale::en).white(),
+        acceptance_rate
+    );
+}
+/// Prints a step progress update with moves/sec prominently displayed.
+pub fn print_step_progress(
+    step: u64,
+    elapsed: Duration,
+    moves_evaluated: u64,
+    score: &str,
+) {
+    let moves_per_sec = if elapsed.as_secs_f64() > 0.0 {
+        (moves_evaluated as f64 / elapsed.as_secs_f64()) as u64
+    } else {
+        0
+    };
+    println!(
+        "    {} Step {:>7} │ {} │ {}/sec │ {}",
+        "→".bright_blue(),
+        step.to_formatted_string(&Locale::en).white(),
+        format!("{:>6}", format_duration(elapsed)).bright_black(),
+        format!("{:>8}", moves_per_sec.to_formatted_string(&Locale::en)).bright_magenta().bold(),
+        format_score(score)
+    );
+}
+/// Prints solver completion summary.
+pub fn print_solving_ended(
+    total_duration: Duration,
+    total_moves: u64,
+    phase_count: usize,
+    final_score: &str,
+    is_feasible: bool,
+) {
+    let moves_per_sec = if total_duration.as_secs_f64() > 0.0 {
+        (total_moves as f64 / total_duration.as_secs_f64()) as u64
+    } else {
+        0
+    };
+    println!(
+        "{} {} {} Solving ended: time spent ({}), best score ({}), move evaluation speed ({}/sec), phase total ({})",
+        timestamp().bright_black(),
+        "INFO".bright_green(),
+        "[Solver]".bright_cyan(),
+        format_duration(total_duration).yellow(),
+        format_score(final_score),
+        moves_per_sec.to_formatted_string(&Locale::en).bright_magenta().bold(),
+        phase_count.to_string().white()
+    );
+    // Pretty summary box (60 chars wide, 56 char content area)
+    println!();
+    println!("{}", "╔═════════════════════��════════════════════════════════════╗".bright_cyan());
+    let status_text = if is_feasible {
+        "✓ FEASIBLE SOLUTION FOUND"
+    } else {
+        "✗ INFEASIBLE (hard constraints violated)"
+    };
+    let status_colored = if is_feasible {
+        status_text.bright_green().bold().to_string()
+    } else {
+        status_text.bright_red().bold().to_string()
+    };
+    let status_padding = 56 - status_text.chars().count();
+    let left_pad = status_padding / 2;
+    let right_pad = status_padding - left_pad;
+    println!(
+        "{}{}{}{}{}",
+        "║".bright_cyan(),
+        " ".repeat(left_pad),
+        status_colored,
+        " ".repeat(right_pad),
+        "║".bright_cyan()
+    );
+    println!("{}", "╠══════════════════════════════════════════════════════════╣".bright_cyan());
+    let score_str = final_score;
+    println!(
+        "{}  {:<18}{:>36}  {}",
+        "║".bright_cyan(),
+        "Final Score:",
+        score_str,
+        "║".bright_cyan()
+    );
+    let time_str = format!("{:.2}s", total_duration.as_secs_f64());
+    println!(
+        "{}  {:<18}{:>36}  {}",
+        "║".bright_cyan(),
+        "Solving Time:",
+        time_str,
+        "║".bright_cyan()
+    );
+    let speed_str = format!("{}/sec", moves_per_sec.to_formatted_string(&Locale::en));
+    println!(
+        "{}  {:<18}{:>36}  {}",
+        "║".bright_cyan(),
+        "Move Speed:",
+        speed_str,
+        "║".bright_cyan()
+    );
+    println!("{}", "╚══════════════════════════════════════════════════════════╝".bright_cyan());
+    println!();
+}
+/// Prints VRP-specific configuration.
+pub fn print_config(vehicles: usize, visits: usize, locations: usize) {
+    println!(
+        "{} {} {} Problem: vehicles ({}), visits ({}), locations ({})",
+        timestamp().bright_black(),
+        "INFO".bright_green(),
+        "[Solver]".bright_cyan(),
+        vehicles.to_formatted_string(&Locale::en).bright_yellow(),
+        visits.to_formatted_string(&Locale::en).bright_yellow(),
+        locations.to_formatted_string(&Locale::en).bright_yellow()
+    );
+}
+/// Formats a duration nicely.
+fn format_duration(d: Duration) -> String {
+    let total_ms = d.as_millis();
+    if total_ms < 1000 {
+        format!("{}ms", total_ms)
+    } else if total_ms < 60_000 {
+        format!("{:.2}s", d.as_secs_f64())
+    } else {
+        let mins = total_ms / 60_000;
+        let secs = (total_ms % 60_000) / 1000;
+        format!("{}m {}s", mins, secs)
+    }
+}
+/// Formats a score with colors based on feasibility.
+fn format_score(score: &str) -> String {
+    // Parse HardSoftScore format like "-2hard/5soft" or "0hard/10soft"
+    if score.contains("hard") {
+        let parts: Vec<&str> = score.split('/').collect();
+        if parts.len() == 2 {
+            let hard = parts[0].trim_end_matches("hard");
+            let soft = parts[1].trim_end_matches("soft");
+            let hard_num: f64 = hard.parse().unwrap_or(0.0);
+            let soft_num: f64 = soft.parse().unwrap_or(0.0);
+            let hard_str = if hard_num < 0.0 {
+                format!("{}hard", hard).bright_red().to_string()
+            } else {
+                format!("{}hard", hard).bright_green().to_string()
+            };
+            let soft_str = if soft_num < 0.0 {
+                format!("{}soft", soft).yellow().to_string()
+            } else if soft_num > 0.0 {
+                format!("{}soft", soft).bright_green().to_string()
+            } else {
+                format!("{}soft", soft).white().to_string()
+            };
+            return format!("{}/{}", hard_str, soft_str);
+        }
+    }
+    // Simple score
+    if let Ok(n) = score.parse::<i32>() {
+        if n < 0 {
+            return score.bright_red().to_string();
+        } else if n > 0 {
+            return score.bright_green().to_string();
+        }
+    }
+    score.white().to_string()
+}
+/// Returns a timestamp string.
+fn timestamp() -> String {
+    std::time::SystemTime::now()
+        .duration_since(std::time::UNIX_EPOCH)
+        .map(|d| {
+            let secs = d.as_secs();
+            let millis = d.subsec_millis();
+            format!("{}.{:03}", secs, millis)
+        })
+        .unwrap_or_else(|_| "0.000".to_string())
+}
+/// Calculates an approximate problem scale.
+fn calculate_problem_scale(entity_count: usize, value_count: usize) -> String {
+    if entity_count == 0 || value_count == 0 {
+        return "0".to_string();
+    }
+    // value_count ^ entity_count
+    let log_scale = (entity_count as f64) * (value_count as f64).log10();
+    let exponent = log_scale.floor() as i32;
+    let mantissa = 10f64.powf(log_scale - exponent as f64);
+    format!("{:.3} × 10^{}", mantissa, exponent)
+}
+/// A timer for tracking phase/step durations.
+pub struct PhaseTimer {
+    start: Instant,
+    phase_name: String,
+    phase_index: usize,
+    steps_accepted: u64,
+    moves_evaluated: u64,
+    last_score: String,
+}
+impl PhaseTimer {
+    pub fn start(phase_name: impl Into<String>, phase_index: usize) -> Self {
+        let name = phase_name.into();
+        print_phase_start(&name, phase_index);
+        Self {
+            start: Instant::now(),
+            phase_name: name,
+            phase_index,
+            steps_accepted: 0,
+            moves_evaluated: 0,
+            last_score: String::new(),
+        }
+    }
+    pub fn record_accepted(&mut self, score: &str) {
+        self.steps_accepted += 1;
+        self.last_score = score.to_string();
+    }
+    pub fn record_move(&mut self) {
+        self.moves_evaluated += 1;
+    }
+    pub fn elapsed(&self) -> Duration {
+        self.start.elapsed()
+    }
+    pub fn moves_evaluated(&self) -> u64 {
+        self.moves_evaluated
+    }
+    pub fn finish(self) {
+        print_phase_end(
+            &self.phase_name,
+            self.phase_index,
+            self.start.elapsed(),
+            self.steps_accepted,
+            self.moves_evaluated,
+            &self.last_score,
+        );
+    }
+    pub fn steps_accepted(&self) -> u64 {
+        self.steps_accepted
+    }
+}

src/constraints.rs ADDED Viewed

	@@ -0,0 +1,195 @@

+//! Score calculator for Vehicle Routing Problem.
+//!
+//! # Constraints
+//!
+//! - **Vehicle capacity** (hard): Total demand must not exceed vehicle capacity
+//! - **Time windows** (hard): Service must complete before max end time
+//! - **Minimize travel time** (soft): Reduce total driving time
+//!
+//! # Design
+//!
+//! Uses a simple score calculator function with full solution access.
+//! No global state or RwLock overhead - direct array indexing into the plan's
+//! travel time matrix and visits.
+use solverforge::prelude::*;
+use crate::domain::{Vehicle, VehicleRoutePlan};
+/// Calculates the score for a vehicle routing solution.
+///
+/// # Hard constraints
+/// - Vehicle capacity: penalize excess demand
+/// - Time windows: penalize late arrivals
+///
+/// # Soft constraints
+/// - Minimize total travel time (in minutes)
+///
+/// # Examples
+///
+/// ```
+/// use vehicle_routing::constraints::calculate_score;
+/// use vehicle_routing::domain::{Location, Visit, Vehicle, VehicleRoutePlan};
+/// use solverforge::prelude::Score;  // For is_feasible()
+///
+/// let depot = Location::new(0, 0.0, 0.0);
+/// let locations = vec![depot.clone()];
+/// let visits = vec![Visit::new(0, "A", depot.clone()).with_demand(5)];
+/// let mut vehicle = Vehicle::new(0, "V1", 10, depot);
+/// vehicle.visits = vec![0];
+///
+/// let mut plan = VehicleRoutePlan::new("test", locations, visits, vec![vehicle]);
+/// plan.finalize();
+///
+/// let score = calculate_score(&plan);
+/// assert!(score.is_feasible()); // Demand 5 <= capacity 10
+/// ```
+pub fn calculate_score(plan: &VehicleRoutePlan) -> HardSoftScore {
+    let mut hard = 0i64;
+    let mut soft = 0i64;
+    for vehicle in &plan.vehicles {
+        // =====================================================================
+        // HARD: Vehicle Capacity
+        // =====================================================================
+        let total_demand: i32 = vehicle
+            .visits
+            .iter()
+            .filter_map(|&idx| plan.visits.get(idx))
+            .map(|v| v.demand)
+            .sum();
+        if total_demand > vehicle.capacity {
+            hard -= (total_demand - vehicle.capacity) as i64;
+        }
+        // =====================================================================
+        // HARD: Time Windows
+        // =====================================================================
+        let late_minutes = calculate_late_minutes_for_vehicle(plan, vehicle);
+        if late_minutes > 0 {
+            hard -= late_minutes;
+        }
+        // =====================================================================
+        // SOFT: Minimize Travel Time
+        // =====================================================================
+        let driving_seconds = plan.total_driving_time(vehicle);
+        soft -= driving_seconds / 60; // Convert to minutes
+    }
+    HardSoftScore::of(hard, soft)
+}
+/// Calculates total late minutes for a vehicle's route.
+///
+/// A visit is late if service finishes after `max_end_time`.
+fn calculate_late_minutes_for_vehicle(plan: &VehicleRoutePlan, vehicle: &Vehicle) -> i64 {
+    if vehicle.visits.is_empty() {
+        return 0;
+    }
+    let mut total_late = 0i64;
+    let mut current_time = vehicle.departure_time;
+    let mut current_loc_idx = vehicle.home_location.index;
+    for &visit_idx in &vehicle.visits {
+        let Some(visit) = plan.visits.get(visit_idx) else {
+            continue;
+        };
+        // Travel to this visit
+        let travel = plan.travel_time(current_loc_idx, visit.location.index);
+        let arrival = current_time + travel;
+        // Service starts at max(arrival, min_start_time)
+        let service_start = arrival.max(visit.min_start_time);
+        let service_end = service_start + visit.service_duration;
+        // Check if late (service finishes after max_end_time)
+        if service_end > visit.max_end_time {
+            let late_seconds = service_end - visit.max_end_time;
+            // Round up to minutes
+            total_late += (late_seconds + 59) / 60;
+        }
+        current_time = service_end;
+        current_loc_idx = visit.location.index;
+    }
+    total_late
+}
+// ============================================================================
+// Helper functions (for analyze endpoint)
+// ============================================================================
+/// Calculates total late minutes for a vehicle's route (public API).
+///
+/// # Examples
+///
+/// ```
+/// use vehicle_routing::constraints::calculate_late_minutes;
+/// use vehicle_routing::domain::{Location, Visit, Vehicle, VehicleRoutePlan};
+///
+/// let depot = Location::new(0, 0.0, 0.0);
+/// let customer = Location::new(1, 0.0, 1.0);  // ~111 km away, ~2.2 hours at 50 km/h
+///
+/// let locations = vec![depot.clone(), customer.clone()];
+/// let visits = vec![
+///     Visit::new(0, "A", customer)
+///         .with_time_window(0, 8 * 3600 + 30 * 60)  // Must finish by 8:30am
+///         .with_service_duration(300),  // 5 min service
+/// ];
+/// let mut vehicle = Vehicle::new(0, "V1", 100, depot);
+/// vehicle.departure_time = 8 * 3600;  // Depart at 8am
+/// vehicle.visits = vec![0];
+///
+/// let mut plan = VehicleRoutePlan::new("test", locations, visits, vec![vehicle.clone()]);
+/// plan.finalize();
+///
+/// // Vehicle departs 8am, travels ~2.2 hours, arrives ~10:13am
+/// // Service ends ~10:18am, but max_end is 8:30am
+/// // Late by ~108 minutes
+/// let late = calculate_late_minutes(&plan, &vehicle);
+/// assert!(late > 100);
+/// ```
+#[inline]
+pub fn calculate_late_minutes(plan: &VehicleRoutePlan, vehicle: &Vehicle) -> i64 {
+    calculate_late_minutes_for_vehicle(plan, vehicle)
+}
+/// Calculates excess demand for a vehicle (0 if under capacity).
+///
+/// # Examples
+///
+/// ```
+/// use vehicle_routing::constraints::calculate_excess_capacity;
+/// use vehicle_routing::domain::{Location, Visit, Vehicle, VehicleRoutePlan};
+///
+/// let depot = Location::new(0, 0.0, 0.0);
+/// let locations = vec![depot.clone()];
+/// let visits = vec![
+///     Visit::new(0, "A", depot.clone()).with_demand(60),
+///     Visit::new(1, "B", depot.clone()).with_demand(50),
+/// ];
+/// let mut vehicle = Vehicle::new(0, "V1", 100, depot);
+/// vehicle.visits = vec![0, 1]; // Total demand = 110
+///
+/// let mut plan = VehicleRoutePlan::new("test", locations, visits, vec![vehicle.clone()]);
+/// plan.finalize();
+///
+/// // Excess = 110 - 100 = 10
+/// assert_eq!(calculate_excess_capacity(&plan, &vehicle), 10);
+/// ```
+#[inline]
+pub fn calculate_excess_capacity(plan: &VehicleRoutePlan, vehicle: &Vehicle) -> i32 {
+    let total_demand: i32 = vehicle
+        .visits
+        .iter()
+        .filter_map(|&idx| plan.visits.get(idx))
+        .map(|v| v.demand)
+        .sum();
+    (total_demand - vehicle.capacity).max(0)
+}

src/demo_data.rs ADDED Viewed

	@@ -0,0 +1,449 @@

+//! Demo data generators for Vehicle Routing Problem.
+//!
+//! Provides realistic demo datasets for three cities:
+//! - Philadelphia (49 visits, 6 vehicles)
+//! - Hartford (30 visits, 6 vehicles)
+//! - Firenze (48 visits, 6 vehicles)
+//!
+//! Uses real street addresses and weighted customer types:
+//! - Residential (50%): 17:00-20:00, demand 1-2
+//! - Business (30%): 09:00-17:00, demand 3-6
+//! - Restaurant (20%): 06:00-10:00, demand 5-10
+use rand::rngs::StdRng;
+use rand::{Rng, SeedableRng};
+use crate::domain::{Location, Vehicle, VehicleRoutePlan, Visit};
+/// Vehicle names using phonetic alphabet.
+const VEHICLE_NAMES: [&str; 10] = [
+    "Alpha", "Bravo", "Charlie", "Delta", "Echo",
+    "Foxtrot", "Golf", "Hotel", "India", "Juliet",
+];
+/// Customer type with time window and demand characteristics.
+#[derive(Clone, Copy)]
+enum CustomerType {
+    /// Evening deliveries (17:00-20:00), small orders
+    Residential,
+    /// Business hours (09:00-17:00), medium orders
+    Business,
+    /// Early morning (06:00-10:00), large orders
+    Restaurant,
+}
+impl CustomerType {
+    fn time_window(&self) -> (i64, i64) {
+        match self {
+            CustomerType::Residential => (17 * 3600, 20 * 3600),
+            CustomerType::Business => (9 * 3600, 17 * 3600),
+            CustomerType::Restaurant => (6 * 3600, 10 * 3600),
+        }
+    }
+    fn demand_range(&self) -> (i32, i32) {
+        match self {
+            CustomerType::Residential => (1, 2),
+            CustomerType::Business => (3, 6),
+            CustomerType::Restaurant => (5, 10),
+        }
+    }
+    fn service_duration_range(&self) -> (i64, i64) {
+        match self {
+            CustomerType::Residential => (5 * 60, 10 * 60),
+            CustomerType::Business => (15 * 60, 30 * 60),
+            CustomerType::Restaurant => (20 * 60, 40 * 60),
+        }
+    }
+    /// Weighted random selection: 50% residential, 30% business, 20% restaurant.
+    fn random(rng: &mut StdRng) -> Self {
+        let r: u32 = rng.gen_range(1..=100);
+        if r <= 50 {
+            CustomerType::Residential
+        } else if r <= 80 {
+            CustomerType::Business
+        } else {
+            CustomerType::Restaurant
+        }
+    }
+}
+/// Location data with name, coordinates, and optional type.
+struct LocationData {
+    name: &'static str,
+    lat: f64,
+    lng: f64,
+    customer_type: Option<CustomerType>,
+}
+/// Demo dataset configuration.
+struct DemoConfig {
+    seed: u64,
+    visit_count: usize,
+    vehicle_count: usize,
+    vehicle_start_time: i64,
+    min_capacity: i32,
+    max_capacity: i32,
+}
+// ============================================================================
+// Philadelphia Data
+// ============================================================================
+const PHILADELPHIA_DEPOTS: &[LocationData] = &[
+    LocationData { name: "Central Depot - City Hall", lat: 39.9526, lng: -75.1652, customer_type: None },
+    LocationData { name: "South Philly Depot", lat: 39.9256, lng: -75.1697, customer_type: None },
+    LocationData { name: "University City Depot", lat: 39.9522, lng: -75.1932, customer_type: None },
+    LocationData { name: "North Philly Depot", lat: 39.9907, lng: -75.1556, customer_type: None },
+    LocationData { name: "Fishtown Depot", lat: 39.9712, lng: -75.1340, customer_type: None },
+    LocationData { name: "West Philly Depot", lat: 39.9601, lng: -75.2175, customer_type: None },
+];
+const PHILADELPHIA_VISITS: &[LocationData] = &[
+    // Restaurants
+    LocationData { name: "Reading Terminal Market", lat: 39.9535, lng: -75.1589, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Parc Restaurant", lat: 39.9493, lng: -75.1727, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Zahav", lat: 39.9430, lng: -75.1474, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Vetri Cucina", lat: 39.9499, lng: -75.1659, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Talula's Garden", lat: 39.9470, lng: -75.1709, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Fork", lat: 39.9493, lng: -75.1539, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Morimoto", lat: 39.9488, lng: -75.1559, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Vernick Food & Drink", lat: 39.9508, lng: -75.1718, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Friday Saturday Sunday", lat: 39.9492, lng: -75.1715, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Royal Izakaya", lat: 39.9410, lng: -75.1509, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Laurel", lat: 39.9392, lng: -75.1538, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Marigold Kitchen", lat: 39.9533, lng: -75.1920, customer_type: Some(CustomerType::Restaurant) },
+    // Businesses
+    LocationData { name: "Comcast Center", lat: 39.9543, lng: -75.1690, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Liberty Place", lat: 39.9520, lng: -75.1685, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "BNY Mellon Center", lat: 39.9505, lng: -75.1660, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "One Liberty Place", lat: 39.9520, lng: -75.1685, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Aramark Tower", lat: 39.9550, lng: -75.1705, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "PSFS Building", lat: 39.9510, lng: -75.1618, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Three Logan Square", lat: 39.9567, lng: -75.1720, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Two Commerce Square", lat: 39.9551, lng: -75.1675, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Penn Medicine", lat: 39.9495, lng: -75.1935, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Children's Hospital", lat: 39.9482, lng: -75.1950, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Drexel University", lat: 39.9566, lng: -75.1899, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Temple University", lat: 39.9812, lng: -75.1554, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Jefferson Hospital", lat: 39.9487, lng: -75.1577, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Pennsylvania Hospital", lat: 39.9445, lng: -75.1545, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "FMC Tower", lat: 39.9499, lng: -75.1780, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Cira Centre", lat: 39.9560, lng: -75.1822, customer_type: Some(CustomerType::Business) },
+    // Residential
+    LocationData { name: "Rittenhouse Square", lat: 39.9496, lng: -75.1718, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Washington Square West", lat: 39.9468, lng: -75.1545, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Society Hill", lat: 39.9425, lng: -75.1478, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Old City", lat: 39.9510, lng: -75.1450, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Northern Liberties", lat: 39.9650, lng: -75.1420, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Fishtown", lat: 39.9712, lng: -75.1340, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Queen Village", lat: 39.9380, lng: -75.1520, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Bella Vista", lat: 39.9395, lng: -75.1598, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Graduate Hospital", lat: 39.9425, lng: -75.1768, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Fairmount", lat: 39.9680, lng: -75.1750, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Spring Garden", lat: 39.9620, lng: -75.1620, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Art Museum Area", lat: 39.9656, lng: -75.1810, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Brewerytown", lat: 39.9750, lng: -75.1850, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "East Passyunk", lat: 39.9310, lng: -75.1605, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Point Breeze", lat: 39.9285, lng: -75.1780, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Pennsport", lat: 39.9320, lng: -75.1450, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Powelton Village", lat: 39.9610, lng: -75.1950, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Spruce Hill", lat: 39.9530, lng: -75.2100, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Cedar Park", lat: 39.9490, lng: -75.2200, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Kensington", lat: 39.9850, lng: -75.1280, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Port Richmond", lat: 39.9870, lng: -75.1120, customer_type: Some(CustomerType::Residential) },
+];
+// ============================================================================
+// Hartford Data
+// ============================================================================
+const HARTFORD_DEPOTS: &[LocationData] = &[
+    LocationData { name: "Downtown Hartford Depot", lat: 41.7658, lng: -72.6734, customer_type: None },
+    LocationData { name: "Asylum Hill Depot", lat: 41.7700, lng: -72.6900, customer_type: None },
+    LocationData { name: "South End Depot", lat: 41.7400, lng: -72.6750, customer_type: None },
+    LocationData { name: "West End Depot", lat: 41.7680, lng: -72.7100, customer_type: None },
+    LocationData { name: "Barry Square Depot", lat: 41.7450, lng: -72.6800, customer_type: None },
+    LocationData { name: "Clay Arsenal Depot", lat: 41.7750, lng: -72.6850, customer_type: None },
+];
+const HARTFORD_VISITS: &[LocationData] = &[
+    // Restaurants
+    LocationData { name: "Max Downtown", lat: 41.7670, lng: -72.6730, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Trumbull Kitchen", lat: 41.7650, lng: -72.6750, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Salute", lat: 41.7630, lng: -72.6740, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Peppercorns Grill", lat: 41.7690, lng: -72.6680, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Feng Asian Bistro", lat: 41.7640, lng: -72.6725, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "On20", lat: 41.7655, lng: -72.6728, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "First and Last Tavern", lat: 41.7620, lng: -72.7050, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Agave Grill", lat: 41.7580, lng: -72.6820, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Bear's Smokehouse", lat: 41.7550, lng: -72.6780, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "City Steam Brewery", lat: 41.7630, lng: -72.6750, customer_type: Some(CustomerType::Restaurant) },
+    // Businesses
+    LocationData { name: "Travelers Tower", lat: 41.7658, lng: -72.6734, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Hartford Steam Boiler", lat: 41.7680, lng: -72.6700, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Aetna Building", lat: 41.7700, lng: -72.6900, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Connecticut Convention Center", lat: 41.7615, lng: -72.6820, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Hartford Hospital", lat: 41.7547, lng: -72.6858, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Connecticut Children's", lat: 41.7560, lng: -72.6850, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Trinity College", lat: 41.7474, lng: -72.6909, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Connecticut Science Center", lat: 41.7650, lng: -72.6695, customer_type: Some(CustomerType::Business) },
+    // Residential
+    LocationData { name: "West End Hartford", lat: 41.7680, lng: -72.7000, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Asylum Hill", lat: 41.7720, lng: -72.6850, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Frog Hollow", lat: 41.7580, lng: -72.6900, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Barry Square", lat: 41.7450, lng: -72.6800, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "South End", lat: 41.7400, lng: -72.6750, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Blue Hills", lat: 41.7850, lng: -72.7050, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Parkville", lat: 41.7650, lng: -72.7100, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Behind the Rocks", lat: 41.7550, lng: -72.7050, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Charter Oak", lat: 41.7495, lng: -72.6650, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Sheldon Charter Oak", lat: 41.7510, lng: -72.6700, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Clay Arsenal", lat: 41.7750, lng: -72.6850, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Upper Albany", lat: 41.7780, lng: -72.6950, customer_type: Some(CustomerType::Residential) },
+];
+// ============================================================================
+// Firenze Data
+// ============================================================================
+const FIRENZE_DEPOTS: &[LocationData] = &[
+    LocationData { name: "Centro Storico Depot", lat: 43.7696, lng: 11.2558, customer_type: None },
+    LocationData { name: "Santa Maria Novella Depot", lat: 43.7745, lng: 11.2487, customer_type: None },
+    LocationData { name: "Campo di Marte Depot", lat: 43.7820, lng: 11.2820, customer_type: None },
+    LocationData { name: "Rifredi Depot", lat: 43.7950, lng: 11.2410, customer_type: None },
+    LocationData { name: "Novoli Depot", lat: 43.7880, lng: 11.2220, customer_type: None },
+    LocationData { name: "Gavinana Depot", lat: 43.7520, lng: 11.2680, customer_type: None },
+];
+const FIRENZE_VISITS: &[LocationData] = &[
+    // Restaurants
+    LocationData { name: "Trattoria Mario", lat: 43.7750, lng: 11.2530, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Buca Mario", lat: 43.7698, lng: 11.2505, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Il Latini", lat: 43.7705, lng: 11.2495, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Osteria dell'Enoteca", lat: 43.7680, lng: 11.2545, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Trattoria Sostanza", lat: 43.7735, lng: 11.2470, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "All'Antico Vinaio", lat: 43.7690, lng: 11.2570, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Mercato Centrale", lat: 43.7762, lng: 11.2540, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Cibreo", lat: 43.7702, lng: 11.2670, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Ora d'Aria", lat: 43.7710, lng: 11.2610, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Buca Lapi", lat: 43.7720, lng: 11.2535, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Il Palagio", lat: 43.7680, lng: 11.2550, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Enoteca Pinchiorri", lat: 43.7695, lng: 11.2620, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "La Giostra", lat: 43.7745, lng: 11.2650, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Fishing Lab", lat: 43.7730, lng: 11.2560, customer_type: Some(CustomerType::Restaurant) },
+    LocationData { name: "Trattoria Cammillo", lat: 43.7665, lng: 11.2520, customer_type: Some(CustomerType::Restaurant) },
+    // Businesses
+    LocationData { name: "Palazzo Vecchio", lat: 43.7693, lng: 11.2563, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Uffizi Gallery", lat: 43.7677, lng: 11.2553, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Gucci Garden", lat: 43.7692, lng: 11.2556, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Ferragamo Museum", lat: 43.7700, lng: 11.2530, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Ospedale Santa Maria", lat: 43.7830, lng: 11.2690, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Universita degli Studi", lat: 43.7765, lng: 11.2555, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Palazzo Strozzi", lat: 43.7706, lng: 11.2515, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Biblioteca Nazionale", lat: 43.7660, lng: 11.2650, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Teatro del Maggio", lat: 43.7780, lng: 11.2470, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Palazzo Pitti", lat: 43.7650, lng: 11.2500, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Accademia Gallery", lat: 43.7768, lng: 11.2590, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Ospedale Meyer", lat: 43.7910, lng: 11.2520, customer_type: Some(CustomerType::Business) },
+    LocationData { name: "Polo Universitario", lat: 43.7920, lng: 11.2180, customer_type: Some(CustomerType::Business) },
+    // Residential
+    LocationData { name: "Santo Spirito", lat: 43.7665, lng: 11.2470, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "San Frediano", lat: 43.7680, lng: 11.2420, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Santa Croce", lat: 43.7688, lng: 11.2620, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "San Lorenzo", lat: 43.7755, lng: 11.2540, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "San Marco", lat: 43.7780, lng: 11.2585, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Sant'Ambrogio", lat: 43.7705, lng: 11.2680, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Campo di Marte", lat: 43.7820, lng: 11.2820, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Novoli", lat: 43.7880, lng: 11.2220, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Rifredi", lat: 43.7950, lng: 11.2410, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Le Cure", lat: 43.7890, lng: 11.2580, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Careggi", lat: 43.8020, lng: 11.2530, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Peretola", lat: 43.7960, lng: 11.2050, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Isolotto", lat: 43.7620, lng: 11.2200, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Gavinana", lat: 43.7520, lng: 11.2680, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Galluzzo", lat: 43.7400, lng: 11.2480, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Porta Romana", lat: 43.7610, lng: 11.2560, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Bellosguardo", lat: 43.7650, lng: 11.2350, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Arcetri", lat: 43.7500, lng: 11.2530, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Fiesole", lat: 43.8055, lng: 11.2935, customer_type: Some(CustomerType::Residential) },
+    LocationData { name: "Settignano", lat: 43.7850, lng: 11.3100, customer_type: Some(CustomerType::Residential) },
+];
+// ============================================================================
+// Generator Functions
+// ============================================================================
+fn generate_demo_data(
+    name: &str,
+    config: &DemoConfig,
+    depots: &[LocationData],
+    visit_data: &[LocationData],
+) -> VehicleRoutePlan {
+    let mut rng = StdRng::seed_from_u64(config.seed);
+    // Build locations: depots first, then visit locations
+    let mut locations = Vec::new();
+    let mut location_idx = 0;
+    // Add depot locations
+    for depot in depots.iter().take(config.vehicle_count) {
+        locations.push(Location::new(location_idx, depot.lat, depot.lng));
+        location_idx += 1;
+    }
+    // Shuffle visit data for variety
+    let mut shuffled_visits: Vec<_> = visit_data.iter().collect();
+    for i in (1..shuffled_visits.len()).rev() {
+        let j = rng.gen_range(0..=i);
+        shuffled_visits.swap(i, j);
+    }
+    // Add visit locations
+    for visit in shuffled_visits.iter().take(config.visit_count) {
+        locations.push(Location::new(location_idx, visit.lat, visit.lng));
+        location_idx += 1;
+    }
+    // Create vehicles - now needs Location object, not index
+    let depot_count = config.vehicle_count.min(depots.len());
+    let vehicles: Vec<_> = (0..config.vehicle_count)
+        .map(|i| {
+            let capacity = rng.gen_range(config.min_capacity..=config.max_capacity);
+            let home_loc = locations[i].clone();  // Depot locations are first
+            Vehicle::new(
+                i,
+                VEHICLE_NAMES[i % VEHICLE_NAMES.len()],
+                capacity,
+                home_loc,
+            )
+            .with_departure_time(config.vehicle_start_time)
+        })
+        .collect();
+    // Create visits - now needs Location object, not index
+    let visits: Vec<_> = shuffled_visits
+        .iter()
+        .take(config.visit_count)
+        .enumerate()
+        .map(|(i, loc_data)| {
+            let ctype = loc_data.customer_type.unwrap_or_else(|| CustomerType::random(&mut rng));
+            let (min_time, max_time) = ctype.time_window();
+            let (min_demand, max_demand) = ctype.demand_range();
+            let (min_service, max_service) = ctype.service_duration_range();
+            let demand = rng.gen_range(min_demand..=max_demand);
+            let service_duration = rng.gen_range(min_service..=max_service);
+            let visit_loc = locations[depot_count + i].clone();  // Visit locations are after depots
+            Visit::new(i, loc_data.name, visit_loc)
+                .with_demand(demand)
+                .with_time_window(min_time, max_time)
+                .with_service_duration(service_duration)
+        })
+        .collect();
+    let mut plan = VehicleRoutePlan::new(name, locations, visits, vehicles);
+    plan.finalize();
+    plan
+}
+/// Generates Philadelphia demo data (49 visits, 10 vehicles).
+///
+/// # Examples
+///
+/// ```
+/// use vehicle_routing::demo_data::generate_philadelphia;
+///
+/// let plan = generate_philadelphia();
+/// assert_eq!(plan.name, "Philadelphia");
+/// assert_eq!(plan.visits.len(), 49);
+/// assert_eq!(plan.vehicles.len(), 10);
+/// ```
+pub fn generate_philadelphia() -> VehicleRoutePlan {
+    let config = DemoConfig {
+        seed: 0,
+        visit_count: PHILADELPHIA_VISITS.len(),
+        vehicle_count: 10,
+        vehicle_start_time: 6 * 3600, // 6am
+        min_capacity: 15,
+        max_capacity: 30,
+    };
+    generate_demo_data("Philadelphia", &config, PHILADELPHIA_DEPOTS, PHILADELPHIA_VISITS)
+}
+/// Generates Hartford demo data (30 visits, 10 vehicles).
+///
+/// # Examples
+///
+/// ```
+/// use vehicle_routing::demo_data::generate_hartford;
+///
+/// let plan = generate_hartford();
+/// assert_eq!(plan.name, "Hartford");
+/// assert_eq!(plan.visits.len(), 30);
+/// assert_eq!(plan.vehicles.len(), 10);
+/// ```
+pub fn generate_hartford() -> VehicleRoutePlan {
+    let config = DemoConfig {
+        seed: 1,
+        visit_count: HARTFORD_VISITS.len(),
+        vehicle_count: 10,
+        vehicle_start_time: 6 * 3600,
+        min_capacity: 20,
+        max_capacity: 30,
+    };
+    generate_demo_data("Hartford", &config, HARTFORD_DEPOTS, HARTFORD_VISITS)
+}
+/// Generates Firenze demo data (48 visits, 10 vehicles).
+///
+/// # Examples
+///
+/// ```
+/// use vehicle_routing::demo_data::generate_firenze;
+///
+/// let plan = generate_firenze();
+/// assert_eq!(plan.name, "Firenze");
+/// assert_eq!(plan.visits.len(), 48);
+/// assert_eq!(plan.vehicles.len(), 10);
+/// ```
+pub fn generate_firenze() -> VehicleRoutePlan {
+    let config = DemoConfig {
+        seed: 2,
+        visit_count: FIRENZE_VISITS.len(),
+        vehicle_count: 10,
+        vehicle_start_time: 6 * 3600,
+        min_capacity: 20,
+        max_capacity: 40,
+    };
+    generate_demo_data("Firenze", &config, FIRENZE_DEPOTS, FIRENZE_VISITS)
+}
+/// Returns all available demo dataset names.
+pub fn available_datasets() -> &'static [&'static str] {
+    &["PHILADELPHIA", "HARTFORD", "FIRENZE"]
+}
+/// Generates demo data by name.
+///
+/// # Examples
+///
+/// ```
+/// use vehicle_routing::demo_data::generate_by_name;
+///
+/// let plan = generate_by_name("PHILADELPHIA").unwrap();
+/// assert_eq!(plan.name, "Philadelphia");
+///
+/// assert!(generate_by_name("UNKNOWN").is_none());
+/// ```
+pub fn generate_by_name(name: &str) -> Option<VehicleRoutePlan> {
+    match name.to_uppercase().as_str() {
+        "PHILADELPHIA" => Some(generate_philadelphia()),
+        "HARTFORD" => Some(generate_hartford()),
+        "FIRENZE" => Some(generate_firenze()),
+        _ => None,
+    }
+}

src/domain.rs ADDED Viewed

	@@ -0,0 +1,568 @@

+//! Domain model for Vehicle Routing Problem.
+//!
+//! # Overview
+//!
+//! Models a vehicle routing problem with:
+//! - Geographic [`Location`]s with haversine distance calculation
+//! - Customer [`Visit`]s with time windows, demand, and service duration
+//! - [`Vehicle`]s with capacity constraints and routes
+//! - [`VehicleRoutePlan`] as the complete planning solution
+//!
+//! # Design
+//!
+//! All scoring uses direct access to the plan's travel time matrix.
+//! No global state or RwLock overhead.
+use serde::{Deserialize, Serialize};
+use solverforge::prelude::*;
+use std::collections::HashMap;
+/// Average driving speed in km/h for travel time estimation.
+pub const AVERAGE_SPEED_KMPH: f64 = 50.0;
+/// Earth radius in meters for haversine calculation.
+const EARTH_RADIUS_M: f64 = 6_371_000.0;
+/// A geographic location with latitude and longitude.
+///
+/// Supports haversine distance calculation for travel time estimation.
+///
+/// # Examples
+///
+/// ```
+/// use vehicle_routing::domain::Location;
+///
+/// let philadelphia = Location::new(0, 39.9526, -75.1652);
+/// let new_york = Location::new(1, 40.7128, -74.0060);
+///
+/// // Distance is approximately 130 km
+/// let distance = philadelphia.distance_meters(&new_york);
+/// assert!(distance > 120_000.0 && distance < 140_000.0);
+///
+/// // Travel time at 50 km/h is approximately 2.6 hours
+/// let travel_secs = philadelphia.travel_time_seconds(&new_york);
+/// assert!(travel_secs > 8000 && travel_secs < 10000);
+/// ```
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct Location {
+    /// Index in `VehicleRoutePlan.locations`.
+    pub index: usize,
+    /// Latitude in degrees (-90 to 90).
+    pub latitude: f64,
+    /// Longitude in degrees (-180 to 180).
+    pub longitude: f64,
+}
+impl PartialEq for Location {
+    fn eq(&self, other: &Self) -> bool {
+        self.index == other.index
+    }
+}
+impl Eq for Location {}
+impl std::hash::Hash for Location {
+    fn hash<H: std::hash::Hasher>(&self, state: &mut H) {
+        self.index.hash(state);
+    }
+}
+impl Location {
+    /// Creates a new location.
+    pub fn new(index: usize, latitude: f64, longitude: f64) -> Self {
+        Self {
+            index,
+            latitude,
+            longitude,
+        }
+    }
+    /// Calculates the great-circle distance in meters using the haversine formula.
+    ///
+    /// # Examples
+    ///
+    /// ```
+    /// use vehicle_routing::domain::Location;
+    ///
+    /// let a = Location::new(0, 0.0, 0.0);
+    /// let b = Location::new(1, 0.0, 1.0);
+    ///
+    /// // 1 degree of longitude at equator is about 111 km
+    /// let dist = a.distance_meters(&b);
+    /// assert!(dist > 110_000.0 && dist < 112_000.0);
+    /// ```
+    pub fn distance_meters(&self, other: &Location) -> f64 {
+        if self.latitude == other.latitude && self.longitude == other.longitude {
+            return 0.0;
+        }
+        let lat1 = self.latitude.to_radians();
+        let lat2 = other.latitude.to_radians();
+        let lon1 = self.longitude.to_radians();
+        let lon2 = other.longitude.to_radians();
+        // Haversine formula
+        let dlat = lat2 - lat1;
+        let dlon = lon2 - lon1;
+        let a = (dlat / 2.0).sin().powi(2) + lat1.cos() * lat2.cos() * (dlon / 2.0).sin().powi(2);
+        let c = 2.0 * a.sqrt().asin();
+        EARTH_RADIUS_M * c
+    }
+    /// Calculates travel time in seconds assuming average driving speed.
+    ///
+    /// Uses [`AVERAGE_SPEED_KMPH`] (50 km/h) for conversion.
+    pub fn travel_time_seconds(&self, other: &Location) -> i64 {
+        let meters = self.distance_meters(other);
+        // seconds = meters / (km/h * 1000 / 3600) = meters * 3.6 / km/h
+        (meters * 3.6 / AVERAGE_SPEED_KMPH).round() as i64
+    }
+}
+/// A customer visit with time window and demand constraints.
+///
+/// # Time Window
+///
+/// - `min_start_time`: Earliest time service can begin (vehicle may wait)
+/// - `max_end_time`: Latest time service must finish (hard constraint)
+/// - `service_duration`: Time required to complete the visit
+///
+/// All times are in seconds from midnight.
+///
+/// # Examples
+///
+/// ```
+/// use vehicle_routing::domain::{Visit, Location};
+///
+/// let location = Location::new(0, 39.95, -75.17);
+///
+/// // A restaurant delivery: 6am-10am window, 5-minute service
+/// let visit = Visit::new(0, "Restaurant A", location)
+///     .with_demand(8)
+///     .with_time_window(6 * 3600, 10 * 3600)
+///     .with_service_duration(300);
+///
+/// assert_eq!(visit.demand, 8);
+/// assert_eq!(visit.min_start_time, 21600); // 6 * 3600
+/// ```
+#[problem_fact]
+#[derive(Serialize, Deserialize)]
+pub struct Visit {
+    /// Index in `VehicleRoutePlan.visits`.
+    pub index: usize,
+    /// Customer name.
+    pub name: String,
+    /// The geographic location of this visit.
+    pub location: Location,
+    /// Quantity demanded (must fit in vehicle capacity).
+    pub demand: i32,
+    /// Earliest service start time (seconds from midnight).
+    #[serde(rename = "minStartTime")]
+    pub min_start_time: i64,
+    /// Latest service end time (seconds from midnight).
+    #[serde(rename = "maxEndTime")]
+    pub max_end_time: i64,
+    /// Service duration in seconds.
+    #[serde(rename = "serviceDuration")]
+    pub service_duration: i64,
+}
+impl Visit {
+    /// Creates a new visit with default time window (all day).
+    pub fn new(index: usize, name: impl Into<String>, location: Location) -> Self {
+        Self {
+            index,
+            name: name.into(),
+            location,
+            demand: 1,
+            min_start_time: 0,
+            max_end_time: 24 * 3600,
+            service_duration: 0,
+        }
+    }
+    /// Sets the demand.
+    pub fn with_demand(mut self, demand: i32) -> Self {
+        self.demand = demand;
+        self
+    }
+    /// Sets the time window (min_start_time, max_end_time) in seconds from midnight.
+    pub fn with_time_window(mut self, min_start: i64, max_end: i64) -> Self {
+        self.min_start_time = min_start;
+        self.max_end_time = max_end;
+        self
+    }
+    /// Sets the service duration in seconds.
+    pub fn with_service_duration(mut self, duration: i64) -> Self {
+        self.service_duration = duration;
+        self
+    }
+}
+/// A delivery vehicle with capacity and assigned route.
+///
+/// The route is stored as a list of visit indices in order.
+///
+/// # Examples
+///
+/// ```
+/// use vehicle_routing::domain::{Vehicle, Location};
+///
+/// let depot = Location::new(0, 39.95, -75.17);
+/// let vehicle = Vehicle::new(0, "Truck 1", 100, depot)
+///     .with_departure_time(8 * 3600);  // Departs at 8am
+///
+/// assert_eq!(vehicle.capacity, 100);
+/// assert!(vehicle.visits.is_empty());
+/// ```
+#[planning_entity]
+#[derive(Serialize, Deserialize)]
+pub struct Vehicle {
+    /// Unique vehicle ID.
+    #[planning_id]
+    pub id: usize,
+    /// Vehicle name for display.
+    pub name: String,
+    /// Maximum capacity (sum of visit demands must not exceed).
+    pub capacity: i32,
+    /// Home depot location.
+    #[serde(rename = "homeLocation")]
+    pub home_location: Location,
+    /// Departure time from depot (seconds from midnight).
+    #[serde(rename = "departureTime")]
+    pub departure_time: i64,
+    /// Ordered list of visit indices (the route).
+    #[serde(default)]
+    pub visits: Vec<usize>,
+}
+impl Vehicle {
+    /// Creates a new vehicle with empty route.
+    pub fn new(id: usize, name: impl Into<String>, capacity: i32, home_location: Location) -> Self {
+        Self {
+            id,
+            name: name.into(),
+            capacity,
+            home_location,
+            departure_time: 8 * 3600, // Default 8am
+            visits: Vec::new(),
+        }
+    }
+    /// Sets the departure time in seconds from midnight.
+    pub fn with_departure_time(mut self, time: i64) -> Self {
+        self.departure_time = time;
+        self
+    }
+}
+/// Arrival and departure times for a visit in a route.
+#[derive(Debug, Clone, Copy)]
+pub struct VisitTiming {
+    /// Visit index.
+    pub visit_idx: usize,
+    /// Arrival time at the visit (seconds from midnight).
+    pub arrival: i64,
+    /// Departure time from the visit (seconds from midnight).
+    pub departure: i64,
+}
+/// The complete vehicle routing solution.
+///
+/// Contains all problem facts (locations, visits) and planning entities (vehicles).
+/// Call `finalize()` after construction to populate the travel time matrix.
+///
+/// # Examples
+///
+/// ```
+/// use vehicle_routing::domain::{Location, Visit, Vehicle, VehicleRoutePlan};
+///
+/// let depot = Location::new(0, 39.95, -75.17);  // Philadelphia
+/// let customer_loc = Location::new(1, 40.00, -75.10);
+///
+/// let locations = vec![depot.clone(), customer_loc.clone()];
+/// let visits = vec![
+///     Visit::new(0, "Customer 1", customer_loc).with_demand(5),
+/// ];
+/// let vehicles = vec![
+///     Vehicle::new(0, "Truck 1", 100, depot),
+/// ];
+///
+/// let mut plan = VehicleRoutePlan::new("Philadelphia", locations, visits, vehicles);
+/// plan.finalize();
+///
+/// // Travel time matrix is now populated
+/// assert!(plan.travel_time(0, 1) > 0);
+/// ```
+#[planning_solution]
+#[derive(Serialize, Deserialize)]
+pub struct VehicleRoutePlan {
+    /// Problem name.
+    pub name: String,
+    /// South-west corner of bounding box (for map display).
+    #[serde(rename = "southWestCorner")]
+    pub south_west_corner: [f64; 2],
+    /// North-east corner of bounding box (for map display).
+    #[serde(rename = "northEastCorner")]
+    pub north_east_corner: [f64; 2],
+    /// All locations (depot and customer locations).
+    #[problem_fact_collection]
+    pub locations: Vec<Location>,
+    /// All customer visits.
+    #[problem_fact_collection]
+    pub visits: Vec<Visit>,
+    /// All vehicles.
+    #[planning_entity_collection]
+    pub vehicles: Vec<Vehicle>,
+    /// Current score.
+    #[planning_score]
+    pub score: Option<HardSoftScore>,
+    /// Solver status for REST API.
+    #[serde(rename = "solverStatus", skip_serializing_if = "Option::is_none")]
+    pub solver_status: Option<String>,
+    /// Precomputed travel times: `travel_time_matrix[from][to]` in seconds.
+    #[serde(skip)]
+    pub travel_time_matrix: Vec<Vec<i64>>,
+    /// Route geometries: `(from_loc, to_loc)` -> list of (lat, lng) waypoints.
+    #[serde(skip)]
+    pub route_geometries: HashMap<(usize, usize), Vec<(f64, f64)>>,
+}
+impl VehicleRoutePlan {
+    /// Creates a new vehicle route plan.
+    pub fn new(
+        name: impl Into<String>,
+        locations: Vec<Location>,
+        visits: Vec<Visit>,
+        vehicles: Vec<Vehicle>,
+    ) -> Self {
+        // Compute bounding box from locations
+        let (sw, ne) = Self::compute_bounds(&locations);
+        Self {
+            name: name.into(),
+            south_west_corner: sw,
+            north_east_corner: ne,
+            locations,
+            visits,
+            vehicles,
+            score: None,
+            solver_status: None,
+            travel_time_matrix: Vec::new(),
+            route_geometries: HashMap::new(),
+        }
+    }
+    /// Computes bounding box from locations.
+    fn compute_bounds(locations: &[Location]) -> ([f64; 2], [f64; 2]) {
+        if locations.is_empty() {
+            return ([0.0, 0.0], [0.0, 0.0]);
+        }
+        let mut min_lat = f64::MAX;
+        let mut max_lat = f64::MIN;
+        let mut min_lon = f64::MAX;
+        let mut max_lon = f64::MIN;
+        for loc in locations {
+            min_lat = min_lat.min(loc.latitude);
+            max_lat = max_lat.max(loc.latitude);
+            min_lon = min_lon.min(loc.longitude);
+            max_lon = max_lon.max(loc.longitude);
+        }
+        // No padding here - init_routing() adds expansion
+        ([min_lat, min_lon], [max_lat, max_lon])
+    }
+    /// Populates travel time matrix using haversine distances.
+    ///
+    /// Must be called after construction and before solving.
+    /// For real road routing, use `init_routing()` instead.
+    pub fn finalize(&mut self) {
+        let n = self.locations.len();
+        self.travel_time_matrix = vec![vec![0; n]; n];
+        for i in 0..n {
+            for j in 0..n {
+                if i != j {
+                    self.travel_time_matrix[i][j] =
+                        self.locations[i].travel_time_seconds(&self.locations[j]);
+                }
+            }
+        }
+    }
+    /// Initializes with real road routing from OSM data.
+    ///
+    /// Downloads road network via Overpass API (cached), builds graph,
+    /// and computes travel times using Dijkstra shortest paths.
+    /// Also stores route geometries for visualization.
+    pub async fn init_routing(&mut self) -> Result<(), crate::routing::RoutingError> {
+        use crate::routing::{BoundingBox, RoadNetwork};
+        // Build bounding box from plan bounds (with expansion)
+        let bbox = BoundingBox::new(
+            self.south_west_corner[0],
+            self.south_west_corner[1],
+            self.north_east_corner[0],
+            self.north_east_corner[1],
+        )
+        .expand(0.05); // 5% expansion to catch nearby roads
+        // Load or fetch road network
+        let network = RoadNetwork::load_or_fetch(&bbox).await?;
+        // Extract coordinates
+        let coords: Vec<(f64, f64)> = self
+            .locations
+            .iter()
+            .map(|l| (l.latitude, l.longitude))
+            .collect();
+        // Compute travel time matrix
+        self.travel_time_matrix = network.compute_matrix(&coords);
+        // Compute route geometries for visualization
+        self.route_geometries = network.compute_all_geometries(&coords);
+        Ok(())
+    }
+    /// Returns the bounding box for this plan.
+    pub fn bounding_box(&self) -> crate::routing::BoundingBox {
+        crate::routing::BoundingBox::new(
+            self.south_west_corner[0],
+            self.south_west_corner[1],
+            self.north_east_corner[0],
+            self.north_east_corner[1],
+        )
+    }
+    /// Gets travel time between two locations in seconds.
+    ///
+    /// Returns 0 if indices are out of bounds or matrix not initialized.
+    #[inline]
+    pub fn travel_time(&self, from_idx: usize, to_idx: usize) -> i64 {
+        self.travel_time_matrix
+            .get(from_idx)
+            .and_then(|row| row.get(to_idx))
+            .copied()
+            .unwrap_or(0)
+    }
+    /// Gets route geometry between two locations.
+    ///
+    /// Returns the waypoints if real road routing was initialized,
+    /// or `None` if using haversine fallback.
+    #[inline]
+    pub fn route_geometry(&self, from_idx: usize, to_idx: usize) -> Option<&[(f64, f64)]> {
+        self.route_geometries.get(&(from_idx, to_idx)).map(|v| v.as_slice())
+    }
+    /// Gets a location by index.
+    #[inline]
+    pub fn get_location(&self, idx: usize) -> Option<&Location> {
+        self.locations.get(idx)
+    }
+    /// Gets a visit by index.
+    #[inline]
+    pub fn get_visit(&self, idx: usize) -> Option<&Visit> {
+        self.visits.get(idx)
+    }
+    /// Calculates arrival and departure times for each visit in a vehicle's route.
+    ///
+    /// Returns a vector of [`VisitTiming`] in route order.
+    ///
+    /// # Examples
+    ///
+    /// ```
+    /// use vehicle_routing::domain::{Location, Visit, Vehicle, VehicleRoutePlan};
+    ///
+    /// let depot = Location::new(0, 0.0, 0.0);
+    /// let customer_loc = Location::new(1, 0.0, 0.01); // ~1.1 km away
+    ///
+    /// let locations = vec![depot.clone(), customer_loc.clone()];
+    /// let visits = vec![
+    ///     Visit::new(0, "A", customer_loc)
+    ///         .with_service_duration(300)
+    ///         .with_time_window(0, 86400),
+    /// ];
+    /// let mut vehicle = Vehicle::new(0, "V1", 100, depot);
+    /// vehicle.departure_time = 8 * 3600; // 8am
+    /// vehicle.visits = vec![0];
+    ///
+    /// let mut plan = VehicleRoutePlan::new("test", locations, visits, vec![vehicle]);
+    /// plan.finalize();
+    ///
+    /// let timings = plan.calculate_route_times(&plan.vehicles[0]);
+    /// assert_eq!(timings.len(), 1);
+    /// assert!(timings[0].arrival > 8 * 3600); // Arrives after departure
+    /// assert_eq!(timings[0].departure, timings[0].arrival + 300); // Service takes 5 min
+    /// ```
+    pub fn calculate_route_times(&self, vehicle: &Vehicle) -> Vec<VisitTiming> {
+        let mut timings = Vec::with_capacity(vehicle.visits.len());
+        let mut current_time = vehicle.departure_time;
+        let mut current_loc = vehicle.home_location.index;
+        for &visit_idx in &vehicle.visits {
+            let Some(visit) = self.visits.get(visit_idx) else {
+                continue;
+            };
+            // Travel to this visit
+            let travel = self.travel_time(current_loc, visit.location.index);
+            let arrival = current_time + travel;
+            // Service starts at max(arrival, min_start_time)
+            let service_start = arrival.max(visit.min_start_time);
+            let departure = service_start + visit.service_duration;
+            timings.push(VisitTiming {
+                visit_idx,
+                arrival,
+                departure,
+            });
+            current_time = departure;
+            current_loc = visit.location.index;
+        }
+        timings
+    }
+    /// Calculates total driving time for a vehicle's route in seconds.
+    ///
+    /// Includes travel from depot, between visits, and back to depot.
+    pub fn total_driving_time(&self, vehicle: &Vehicle) -> i64 {
+        if vehicle.visits.is_empty() {
+            return 0;
+        }
+        let mut total = 0i64;
+        let mut current_loc = vehicle.home_location.index;
+        for &visit_idx in &vehicle.visits {
+            if let Some(visit) = self.visits.get(visit_idx) {
+                total += self.travel_time(current_loc, visit.location.index);
+                current_loc = visit.location.index;
+            }
+        }
+        // Return to depot
+        total += self.travel_time(current_loc, vehicle.home_location.index);
+        total
+    }
+    /// Calculates total driving time across all vehicles.
+    pub fn total_driving_time_all(&self) -> i64 {
+        self.vehicles.iter().map(|v| self.total_driving_time(v)).sum()
+    }
+}

src/geometry.rs ADDED Viewed

	@@ -0,0 +1,308 @@

+//! Geometry utilities for route visualization.
+//!
+//! Implements Google Polyline encoding for efficient route transmission.
+//! See: <https://developers.google.com/maps/documentation/utilities/polylinealgorithm>
+use crate::domain::{Vehicle, VehicleRoutePlan};
+use utoipa::ToSchema;
+/// Encodes a sequence of coordinates using Google Polyline Algorithm.
+///
+/// The algorithm encodes latitude/longitude pairs as an ASCII string for
+/// efficient transmission. Each coordinate is encoded as the difference
+/// from the previous point, with 5 decimal places of precision.
+///
+/// # Examples
+///
+/// ```
+/// use vehicle_routing::geometry::encode_polyline;
+///
+/// // Single point encodes to non-empty string
+/// let encoded = encode_polyline(&[(38.5, -120.2)]);
+/// assert!(!encoded.is_empty());
+///
+/// // Empty input gives empty output
+/// let empty = encode_polyline(&[]);
+/// assert!(empty.is_empty());
+///
+/// // Two points create a line
+/// let line = encode_polyline(&[(38.5, -120.2), (40.7, -120.95)]);
+/// assert!(!line.is_empty());
+/// ```
+pub fn encode_polyline(coords: &[(f64, f64)]) -> String {
+    if coords.is_empty() {
+        return String::new();
+    }
+    let mut result = String::new();
+    let mut prev_lat = 0i64;
+    let mut prev_lng = 0i64;
+    for &(lat, lng) in coords {
+        // Convert to fixed-point with 5 decimal places
+        let lat_e5 = (lat * 1e5).round() as i64;
+        let lng_e5 = (lng * 1e5).round() as i64;
+        // Encode deltas
+        encode_value(lat_e5 - prev_lat, &mut result);
+        encode_value(lng_e5 - prev_lng, &mut result);
+        prev_lat = lat_e5;
+        prev_lng = lng_e5;
+    }
+    result
+}
+/// Encodes a single signed value using the polyline algorithm.
+fn encode_value(value: i64, output: &mut String) {
+    // Left-shift and invert if negative
+    let mut encoded = if value < 0 {
+        !((value) << 1)
+    } else {
+        (value) << 1
+    };
+    // Break into 5-bit chunks, OR with 0x20 if more chunks follow
+    while encoded >= 0x20 {
+        output.push(char::from_u32(((encoded & 0x1f) | 0x20) as u32 + 63).unwrap());
+        encoded >>= 5;
+    }
+    output.push(char::from_u32(encoded as u32 + 63).unwrap());
+}
+/// Decodes a Google Polyline string back to coordinates.
+///
+/// # Examples
+///
+/// ```
+/// use vehicle_routing::geometry::{encode_polyline, decode_polyline};
+///
+/// let original = vec![(38.5, -120.2), (40.7, -120.95), (43.252, -126.453)];
+/// let encoded = encode_polyline(&original);
+/// let decoded = decode_polyline(&encoded);
+///
+/// // Check round-trip (within 5 decimal places precision)
+/// assert_eq!(decoded.len(), original.len());
+/// for (orig, dec) in original.iter().zip(decoded.iter()) {
+///     assert!((orig.0 - dec.0).abs() < 0.00001);
+///     assert!((orig.1 - dec.1).abs() < 0.00001);
+/// }
+/// ```
+pub fn decode_polyline(encoded: &str) -> Vec<(f64, f64)> {
+    let mut coords = Vec::new();
+    let mut lat = 0i64;
+    let mut lng = 0i64;
+    let bytes = encoded.as_bytes();
+    let mut i = 0;
+    while i < bytes.len() {
+        // Decode latitude delta
+        let (lat_delta, consumed) = decode_value(&bytes[i..]);
+        i += consumed;
+        lat += lat_delta;
+        if i >= bytes.len() {
+            break;
+        }
+        // Decode longitude delta
+        let (lng_delta, consumed) = decode_value(&bytes[i..]);
+        i += consumed;
+        lng += lng_delta;
+        coords.push((lat as f64 / 1e5, lng as f64 / 1e5));
+    }
+    coords
+}
+/// Decodes a single value, returning (value, bytes_consumed).
+fn decode_value(bytes: &[u8]) -> (i64, usize) {
+    let mut result = 0i64;
+    let mut shift = 0;
+    let mut consumed = 0;
+    for &b in bytes {
+        consumed += 1;
+        let chunk = (b as i64) - 63;
+        result |= (chunk & 0x1f) << shift;
+        shift += 5;
+        if chunk < 0x20 {
+            break;
+        }
+    }
+    // Invert if negative (check LSB)
+    if result & 1 != 0 {
+        result = !(result >> 1);
+    } else {
+        result >>= 1;
+    }
+    (result, consumed)
+}
+/// Encoded route segment for a vehicle's route.
+#[derive(Debug, Clone, serde::Serialize, ToSchema)]
+pub struct EncodedSegment {
+    /// Vehicle index.
+    pub vehicle_idx: usize,
+    /// Vehicle name.
+    pub vehicle_name: String,
+    /// Encoded polyline string (Google format).
+    pub polyline: String,
+    /// Number of points in the route.
+    pub point_count: usize,
+}
+/// Generates encoded polylines for all vehicle routes.
+///
+/// Returns segments for each vehicle with non-empty routes.
+///
+/// # Examples
+///
+/// ```
+/// use vehicle_routing::domain::{Location, Visit, Vehicle, VehicleRoutePlan};
+/// use vehicle_routing::geometry::encode_routes;
+///
+/// let depot = Location::new(0, 39.95, -75.16);
+/// let loc_a = Location::new(1, 39.96, -75.17);
+/// let loc_b = Location::new(2, 39.94, -75.15);
+///
+/// let locations = vec![depot.clone(), loc_a.clone(), loc_b.clone()];
+/// let visits = vec![
+///     Visit::new(0, "A", loc_a),
+///     Visit::new(1, "B", loc_b),
+/// ];
+/// let mut vehicle = Vehicle::new(0, "Alpha", 100, depot);
+/// vehicle.visits = vec![0, 1];  // A -> B
+///
+/// let mut plan = VehicleRoutePlan::new("test", locations, visits, vec![vehicle]);
+///
+/// // Set up route geometries (normally done by init_routing)
+/// // Route: depot(0) -> A(1) -> B(2) -> depot(0)
+/// plan.route_geometries.insert((0, 1), vec![(39.95, -75.16), (39.96, -75.17)]);
+/// plan.route_geometries.insert((1, 2), vec![(39.96, -75.17), (39.94, -75.15)]);
+/// plan.route_geometries.insert((2, 0), vec![(39.94, -75.15), (39.95, -75.16)]);
+///
+/// let segments = encode_routes(&plan);
+/// assert_eq!(segments.len(), 1);  // One vehicle with visits
+/// assert_eq!(segments[0].vehicle_name, "Alpha");
+/// assert_eq!(segments[0].point_count, 4);  // depot -> A -> B -> depot
+/// ```
+pub fn encode_routes(plan: &VehicleRoutePlan) -> Vec<EncodedSegment> {
+    plan.vehicles
+        .iter()
+        .filter(|v| !v.visits.is_empty())
+        .map(|vehicle| {
+            let coords = get_route_coords(plan, vehicle);
+            let polyline = encode_polyline(&coords);
+            EncodedSegment {
+                vehicle_idx: vehicle.id,
+                vehicle_name: vehicle.name.clone(),
+                polyline,
+                point_count: coords.len(),
+            }
+        })
+        .collect()
+}
+/// Gets coordinates for a vehicle's complete route (depot -> visits -> depot).
+///
+/// Uses stored route geometries from road network routing.
+/// Returns empty if route geometries are not initialized.
+fn get_route_coords(plan: &VehicleRoutePlan, vehicle: &Vehicle) -> Vec<(f64, f64)> {
+    let mut coords = Vec::new();
+    let depot_idx = vehicle.home_location.index;
+    // Build the sequence of location indices: depot -> visits -> depot
+    let visit_loc_indices: Vec<usize> = vehicle
+        .visits
+        .iter()
+        .filter_map(|&v| plan.get_visit(v).map(|visit| visit.location.index))
+        .collect();
+    let route: Vec<usize> = std::iter::once(depot_idx)
+        .chain(visit_loc_indices)
+        .chain(std::iter::once(depot_idx))
+        .collect();
+    // Process each leg
+    for i in 0..route.len().saturating_sub(1) {
+        let from_idx = route[i];
+        let to_idx = route[i + 1];
+        if let Some(geometry) = plan.route_geometry(from_idx, to_idx) {
+            // Use stored road geometry
+            // Skip first point of subsequent segments to avoid duplicates
+            let skip = if coords.is_empty() { 0 } else { 1 };
+            coords.extend(geometry.iter().skip(skip).copied());
+        } else {
+            // Fallback: use direct lat/lng when road geometry unavailable
+            if coords.is_empty() {
+                if let Some(from_loc) = plan.get_location(from_idx) {
+                    coords.push((from_loc.latitude, from_loc.longitude));
+                }
+            }
+            if let Some(to_loc) = plan.get_location(to_idx) {
+                coords.push((to_loc.latitude, to_loc.longitude));
+            }
+        }
+    }
+    coords
+}
+#[cfg(test)]
+mod tests {
+    use super::*;
+    #[test]
+    fn test_encode_decode_roundtrip() {
+        let coords = vec![
+            (38.5, -120.2),
+            (40.7, -120.95),
+            (43.252, -126.453),
+        ];
+        let encoded = encode_polyline(&coords);
+        let decoded = decode_polyline(&encoded);
+        assert_eq!(decoded.len(), coords.len());
+        for (orig, dec) in coords.iter().zip(decoded.iter()) {
+            assert!((orig.0 - dec.0).abs() < 0.00001);
+            assert!((orig.1 - dec.1).abs() < 0.00001);
+        }
+    }
+    #[test]
+    fn test_known_encoding() {
+        // Known encoding from Google's examples
+        let coords = vec![(38.5, -120.2), (40.7, -120.95), (43.252, -126.453)];
+        let encoded = encode_polyline(&coords);
+        // The encoding should be deterministic
+        assert!(!encoded.is_empty());
+        // Verify we can decode it back
+        let decoded = decode_polyline(&encoded);
+        assert_eq!(decoded.len(), 3);
+    }
+    #[test]
+    fn test_empty_coords() {
+        let encoded = encode_polyline(&[]);
+        assert!(encoded.is_empty());
+        let decoded = decode_polyline("");
+        assert!(decoded.is_empty());
+    }
+    #[test]
+    fn test_single_point() {
+        let coords = vec![(0.0, 0.0)];
+        let encoded = encode_polyline(&coords);
+        let decoded = decode_polyline(&encoded);
+        assert_eq!(decoded.len(), 1);
+        assert!((decoded[0].0).abs() < 0.00001);
+        assert!((decoded[0].1).abs() < 0.00001);
+    }
+}

src/lib.rs ADDED Viewed

	@@ -0,0 +1,26 @@

+//! Vehicle Routing Quickstart for SolverForge
+//!
+//! Solves vehicle routing problems with time windows, capacity constraints,
+//! and travel time minimization using Late Acceptance local search.
+//!
+//! # Domain Model
+//!
+//! - [`Location`](domain::Location): Geographic point with haversine distance
+//! - [`Visit`](domain::Visit): Customer to visit with time window and demand
+//! - [`Vehicle`](domain::Vehicle): Delivery vehicle with capacity and route
+//! - [`VehicleRoutePlan`](domain::VehicleRoutePlan): Complete planning solution
+//!
+//! # Constraints
+//!
+//! - **Vehicle capacity** (hard): Total demand must not exceed vehicle capacity
+//! - **Time windows** (hard): Service must finish before max end time
+//! - **Travel time** (soft): Minimize total driving time
+pub mod api;
+pub mod console;
+pub mod constraints;
+pub mod demo_data;
+pub mod domain;
+pub mod geometry;
+pub mod routing;
+pub mod solver;

src/main.rs ADDED Viewed

	@@ -0,0 +1,60 @@

+//! Vehicle Routing Quickstart - Axum Server
+//!
+//! Run with: cargo run -p vehicle-routing
+//! Then open: http://localhost:8082
+use owo_colors::OwoColorize;
+use std::net::SocketAddr;
+use std::path::PathBuf;
+use tower_http::cors::{Any, CorsLayer};
+use tower_http::services::ServeDir;
+use tracing_subscriber::EnvFilter;
+use vehicle_routing::console;
+#[tokio::main]
+async fn main() {
+    // Initialize tracing (logs from vehicle_routing at INFO level)
+    tracing_subscriber::fmt()
+        .with_env_filter(
+            EnvFilter::from_default_env()
+                .add_directive("vehicle_routing=info".parse().unwrap()),
+        )
+        .init();
+    // Print colorful banner
+    console::print_banner();
+    // CORS for development
+    let cors = CorsLayer::new()
+        .allow_origin(Any)
+        .allow_methods(Any)
+        .allow_headers(Any);
+    // Determine static files path (works from workspace root or example dir)
+    let static_path = if PathBuf::from("examples/vehicle-routing/static").exists() {
+        "examples/vehicle-routing/static"
+    } else {
+        "static"
+    };
+    // Build router with static file fallback
+    let app = vehicle_routing::api::create_router()
+        .fallback_service(ServeDir::new(static_path))
+        .layer(cors);
+    // Bind and serve
+    let addr = SocketAddr::from(([0, 0, 0, 0], 7860));
+    println!(
+        "{} Server listening on {}",
+        "▸".bright_green(),
+        format!("http://{}", addr).bright_cyan().underline()
+    );
+    println!(
+        "{} Open {} in your browser\n",
+        "▸".bright_green(),
+        "http://localhost:7860".bright_cyan().underline()
+    );
+    let listener = tokio::net::TcpListener::bind(addr).await.unwrap();
+    axum::serve(listener, app).await.unwrap();
+}

src/routing.rs ADDED Viewed

	@@ -0,0 +1,822 @@

+//! Local OSM road routing using Overpass API and petgraph.
+//!
+//! Downloads OpenStreetMap road network data via Overpass API,
+//! builds a graph locally, and computes shortest paths with Dijkstra.
+//! Results are cached in memory (per-process) and `.osm_cache/` (persistent).
+use ordered_float::OrderedFloat;
+use petgraph::algo::{astar, dijkstra};
+use petgraph::graph::{DiGraph, NodeIndex};
+use serde::{Deserialize, Serialize};
+use std::collections::HashMap;
+use std::path::Path;
+use std::sync::{Arc, OnceLock};
+use tokio::sync::RwLock;
+use tracing::{debug, error, info};
+/// In-memory cache of road networks, keyed by bbox cache key.
+/// First request downloads, subsequent requests reuse the cached network.
+static NETWORK_CACHE: OnceLock<RwLock<HashMap<String, Arc<RoadNetwork>>>> = OnceLock::new();
+fn network_cache() -> &'static RwLock<HashMap<String, Arc<RoadNetwork>>> {
+    NETWORK_CACHE.get_or_init(|| RwLock::new(HashMap::new()))
+}
+/// Overpass API URL.
+const OVERPASS_URL: &str = "https://overpass-api.de/api/interpreter";
+/// Cache directory for downloaded OSM data.
+const CACHE_DIR: &str = ".osm_cache";
+/// Default driving speed in m/s (50 km/h = 13.89 m/s).
+const DEFAULT_SPEED_MPS: f64 = 50.0 * 1000.0 / 3600.0;
+/// Error type for routing operations.
+#[derive(Debug)]
+pub enum RoutingError {
+    /// Network request failed.
+    Network(String),
+    /// Failed to parse OSM data.
+    Parse(String),
+    /// I/O error.
+    Io(std::io::Error),
+    /// No route found.
+    NoRoute,
+}
+impl std::fmt::Display for RoutingError {
+    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
+        match self {
+            RoutingError::Network(msg) => write!(f, "Network error: {}", msg),
+            RoutingError::Parse(msg) => write!(f, "Parse error: {}", msg),
+            RoutingError::Io(e) => write!(f, "I/O error: {}", e),
+            RoutingError::NoRoute => write!(f, "No route found"),
+        }
+    }
+}
+impl std::error::Error for RoutingError {}
+impl From<std::io::Error> for RoutingError {
+    fn from(e: std::io::Error) -> Self {
+        RoutingError::Io(e)
+    }
+}
+/// Bounding box for OSM queries.
+#[derive(Debug, Clone, Copy)]
+pub struct BoundingBox {
+    pub min_lat: f64,
+    pub min_lng: f64,
+    pub max_lat: f64,
+    pub max_lng: f64,
+}
+impl BoundingBox {
+    /// Creates a new bounding box.
+    pub fn new(min_lat: f64, min_lng: f64, max_lat: f64, max_lng: f64) -> Self {
+        Self {
+            min_lat,
+            min_lng,
+            max_lat,
+            max_lng,
+        }
+    }
+    /// Expands the bounding box by a factor (e.g., 0.1 = 10% on each side).
+    pub fn expand(&self, factor: f64) -> Self {
+        let lat_range = self.max_lat - self.min_lat;
+        let lng_range = self.max_lng - self.min_lng;
+        let lat_pad = lat_range * factor;
+        let lng_pad = lng_range * factor;
+        Self {
+            min_lat: self.min_lat - lat_pad,
+            min_lng: self.min_lng - lng_pad,
+            max_lat: self.max_lat + lat_pad,
+            max_lng: self.max_lng + lng_pad,
+        }
+    }
+    /// Returns a cache key for this bounding box.
+    fn cache_key(&self) -> String {
+        format!(
+            "{:.4}_{:.4}_{:.4}_{:.4}",
+            self.min_lat, self.min_lng, self.max_lat, self.max_lng
+        )
+    }
+}
+/// Node data in the road graph.
+#[derive(Debug, Clone)]
+struct NodeData {
+    lat: f64,
+    lng: f64,
+}
+/// Edge data in the road graph.
+#[derive(Debug, Clone)]
+struct EdgeData {
+    /// Travel time in seconds.
+    travel_time_s: f64,
+    /// Distance in meters.
+    distance_m: f64,
+    /// Intermediate geometry points (for future full path reconstruction).
+    #[allow(dead_code)]
+    geometry: Vec<(f64, f64)>,
+}
+/// Result of a route computation.
+#[derive(Debug, Clone)]
+pub struct RouteResult {
+    /// Travel time in seconds.
+    pub duration_seconds: i64,
+    /// Distance in meters.
+    pub distance_meters: f64,
+    /// Full route geometry (lat, lng pairs).
+    pub geometry: Vec<(f64, f64)>,
+}
+/// Road network graph built from OSM data.
+pub struct RoadNetwork {
+    /// Directed graph with travel times as edge weights.
+    graph: DiGraph<NodeData, EdgeData>,
+    /// Map from (lat_e7, lng_e7) to node index.
+    coord_to_node: HashMap<(i64, i64), NodeIndex>,
+}
+impl RoadNetwork {
+    /// Creates an empty road network.
+    pub fn new() -> Self {
+        Self {
+            graph: DiGraph::new(),
+            coord_to_node: HashMap::new(),
+        }
+    }
+    /// Loads or fetches road network for a bounding box.
+    ///
+    /// Uses three-tier caching:
+    /// 1. In-memory cache (instant, per-process)
+    /// 2. File cache (fast, persists across restarts)
+    /// 3. Overpass API download (slow, ~5-30s)
+    ///
+    /// Thread-safe: concurrent requests for the same bbox will wait for
+    /// the first download to complete rather than downloading multiple times.
+    pub async fn load_or_fetch(bbox: &BoundingBox) -> Result<Arc<Self>, RoutingError> {
+        let cache_key = bbox.cache_key();
+        // 1. Check in-memory cache (fast path, read lock)
+        {
+            let cache = network_cache().read().await;
+            if let Some(network) = cache.get(&cache_key) {
+                info!("Using in-memory cached road network for {}", cache_key);
+                return Ok(Arc::clone(network));
+            }
+        }
+        // 2. Acquire write lock and double-check (another request may have loaded it)
+        let mut cache = network_cache().write().await;
+        if let Some(network) = cache.get(&cache_key) {
+            info!("Using in-memory cached road network for {}", cache_key);
+            return Ok(Arc::clone(network));
+        }
+        // 3. Try loading from file cache
+        tokio::fs::create_dir_all(CACHE_DIR).await?;
+        let cache_path = Path::new(CACHE_DIR).join(format!("{}.json", cache_key));
+        let network = if tokio::fs::try_exists(&cache_path).await.unwrap_or(false) {
+            info!("Loading road network from file cache: {:?}", cache_path);
+            match Self::load_from_cache(&cache_path).await {
+                Ok(n) => n,
+                Err(e) => {
+                    // File cache failed (corrupted/old version), download fresh
+                    info!("File cache invalid ({}), downloading fresh", e);
+                    let n = Self::from_bbox(bbox).await?;
+                    n.save_to_cache(&cache_path).await?;
+                    info!("Saved road network to file cache: {:?}", cache_path);
+                    n
+                }
+            }
+        } else {
+            // 4. Download from Overpass API
+            info!("Downloading road network from Overpass API");
+            let n = Self::from_bbox(bbox).await?;
+            n.save_to_cache(&cache_path).await?;
+            info!("Saved road network to file cache: {:?}", cache_path);
+            n
+        };
+        // Store in memory cache
+        let network = Arc::new(network);
+        cache.insert(cache_key, Arc::clone(&network));
+        Ok(network)
+    }
+    /// Downloads and builds road network from Overpass API.
+    pub async fn from_bbox(bbox: &BoundingBox) -> Result<Self, RoutingError> {
+        let query = format!(
+            r#"[out:json][timeout:120];
+(
+  way["highway"~"^(motorway|trunk|primary|secondary|tertiary|residential|unclassified|service|living_street)$"]
+    ({},{},{},{});
+);
+(._;>;);
+out body;"#,
+            bbox.min_lat, bbox.min_lng, bbox.max_lat, bbox.max_lng
+        );
+        debug!("Overpass query:\n{}", query);
+        info!("Preparing Overpass query for bbox: {:.4},{:.4} to {:.4},{:.4}",
+            bbox.min_lat, bbox.min_lng, bbox.max_lat, bbox.max_lng);
+        let client = reqwest::Client::builder()
+            .connect_timeout(std::time::Duration::from_secs(30))
+            .read_timeout(std::time::Duration::from_secs(180))
+            .timeout(std::time::Duration::from_secs(180))
+            .user_agent("SolverForge/0.4.0")
+            .build()
+            .map_err(|e| RoutingError::Network(e.to_string()))?;
+        info!("Sending request to Overpass API...");
+        let response = client
+            .post(OVERPASS_URL)
+            .body(query)
+            .header("Content-Type", "text/plain")
+            .send()
+            .await
+            .map_err(|e| {
+                error!("Overpass request failed: {}", e);
+                RoutingError::Network(e.to_string())
+            })?;
+        info!("Received response: status={}", response.status());
+        if !response.status().is_success() {
+            return Err(RoutingError::Network(format!(
+                "Overpass API returned status {}",
+                response.status()
+            )));
+        }
+        let osm_data: OverpassResponse = response
+            .json()
+            .await
+            .map_err(|e| RoutingError::Parse(e.to_string()))?;
+        info!(
+            "Downloaded {} OSM elements",
+            osm_data.elements.len()
+        );
+        Self::build_from_osm(&osm_data)
+    }
+    /// Builds the road network from parsed OSM data.
+    fn build_from_osm(osm: &OverpassResponse) -> Result<Self, RoutingError> {
+        let mut network = Self::new();
+        // First pass: collect all nodes
+        let mut nodes: HashMap<i64, (f64, f64)> = HashMap::new();
+        for elem in &osm.elements {
+            if elem.elem_type == "node" {
+                if let (Some(lat), Some(lon)) = (elem.lat, elem.lon) {
+                    nodes.insert(elem.id, (lat, lon));
+                }
+            }
+        }
+        info!("Parsed {} nodes", nodes.len());
+        // Second pass: process ways and build graph
+        let mut way_count = 0;
+        for elem in &osm.elements {
+            if elem.elem_type == "way" {
+                if let Some(ref node_ids) = elem.nodes {
+                    let highway = elem.tags.as_ref().and_then(|t| t.highway.as_deref());
+                    let oneway = elem.tags.as_ref().and_then(|t| t.oneway.as_deref());
+                    let speed = get_speed_for_highway(highway.unwrap_or("residential"));
+                    let is_oneway = matches!(oneway, Some("yes") | Some("1"));
+                    // Process consecutive node pairs
+                    for window in node_ids.windows(2) {
+                        let n1_id = window[0];
+                        let n2_id = window[1];
+                        let Some(&(lat1, lng1)) = nodes.get(&n1_id) else {
+                            continue;
+                        };
+                        let Some(&(lat2, lng2)) = nodes.get(&n2_id) else {
+                            continue;
+                        };
+                        // Get or create node indices
+                        let idx1 = network.get_or_create_node(lat1, lng1);
+                        let idx2 = network.get_or_create_node(lat2, lng2);
+                        // Calculate edge properties
+                        let distance = haversine_distance(lat1, lng1, lat2, lng2);
+                        let travel_time = distance / speed;
+                        let edge_data = EdgeData {
+                            travel_time_s: travel_time,
+                            distance_m: distance,
+                            geometry: vec![(lat1, lng1), (lat2, lng2)],
+                        };
+                        // Add forward edge
+                        network.graph.add_edge(idx1, idx2, edge_data.clone());
+                        // Add reverse edge if not oneway
+                        if !is_oneway {
+                            network.graph.add_edge(idx2, idx1, edge_data);
+                        }
+                    }
+                    way_count += 1;
+                }
+            }
+        }
+        info!(
+            "Built graph with {} nodes and {} edges from {} ways",
+            network.graph.node_count(),
+            network.graph.edge_count(),
+            way_count
+        );
+        Ok(network)
+    }
+    /// Gets or creates a node for the given coordinates.
+    fn get_or_create_node(&mut self, lat: f64, lng: f64) -> NodeIndex {
+        let key = coord_key(lat, lng);
+        if let Some(&idx) = self.coord_to_node.get(&key) {
+            idx
+        } else {
+            let idx = self.graph.add_node(NodeData { lat, lng });
+            self.coord_to_node.insert(key, idx);
+            idx
+        }
+    }
+    /// Finds the nearest road node to the given coordinates.
+    pub fn snap_to_road(&self, lat: f64, lng: f64) -> Option<NodeIndex> {
+        self.coord_to_node
+            .iter()
+            .min_by_key(|((lat_e7, lng_e7), _)| {
+                let node_lat = *lat_e7 as f64 / 1e7;
+                let node_lng = *lng_e7 as f64 / 1e7;
+                OrderedFloat(haversine_distance(lat, lng, node_lat, node_lng))
+            })
+            .map(|(_, &idx)| idx)
+    }
+    /// Computes shortest path between two coordinates.
+    ///
+    /// Returns the route with full geometry following roads.
+    pub fn route(&self, from: (f64, f64), to: (f64, f64)) -> Option<RouteResult> {
+        let start = self.snap_to_road(from.0, from.1)?;
+        let end = self.snap_to_road(to.0, to.1)?;
+        if start == end {
+            return Some(RouteResult {
+                duration_seconds: 0,
+                distance_meters: 0.0,
+                geometry: vec![from, to],
+            });
+        }
+        // Use A* with zero heuristic (equivalent to Dijkstra, but returns full path)
+        let (cost, path) = astar(
+            &self.graph,
+            start,
+            |n| n == end,
+            |e| OrderedFloat(e.weight().travel_time_s),
+            |_| OrderedFloat(0.0),
+        )?;
+        let total_time = cost.0;
+        // Build geometry from path nodes
+        let geometry: Vec<(f64, f64)> = path
+            .iter()
+            .filter_map(|&idx| self.graph.node_weight(idx).map(|n| (n.lat, n.lng)))
+            .collect();
+        // Sum actual edge distances along the path
+        let mut distance = 0.0;
+        for window in path.windows(2) {
+            if let Some(edge) = self.graph.find_edge(window[0], window[1]) {
+                if let Some(weight) = self.graph.edge_weight(edge) {
+                    distance += weight.distance_m;
+                }
+            }
+        }
+        Some(RouteResult {
+            duration_seconds: total_time.round() as i64,
+            distance_meters: distance,
+            geometry,
+        })
+    }
+    /// Computes route geometries for all location pairs.
+    ///
+    /// Returns a map from `(from_idx, to_idx)` to the route geometry.
+    pub fn compute_all_geometries(
+        &self,
+        locations: &[(f64, f64)],
+    ) -> HashMap<(usize, usize), Vec<(f64, f64)>> {
+        self.compute_all_geometries_with_progress(locations, |_, _| {})
+    }
+    /// Computes route geometries with row-level progress callback.
+    ///
+    /// The callback receives `(completed_row, total_rows)` after each source row is computed.
+    /// For n locations, this computes n*(n-1) routes, calling the callback n times.
+    ///
+    /// # Example
+    ///
+    /// ```
+    /// # use vehicle_routing::routing::RoadNetwork;
+    /// let network = RoadNetwork::new();
+    /// let locations = vec![(39.95, -75.16), (39.96, -75.17)];
+    /// let mut progress_calls = 0;
+    /// let geometries = network.compute_all_geometries_with_progress(&locations, |row, total| {
+    ///     progress_calls += 1;
+    ///     assert!(row < total);
+    /// });
+    /// assert_eq!(progress_calls, 2); // One call per source location
+    /// ```
+    pub fn compute_all_geometries_with_progress<F>(
+        &self,
+        locations: &[(f64, f64)],
+        mut on_row_complete: F,
+    ) -> HashMap<(usize, usize), Vec<(f64, f64)>>
+    where
+        F: FnMut(usize, usize),
+    {
+        let n = locations.len();
+        let mut geometries = HashMap::new();
+        for i in 0..n {
+            for j in 0..n {
+                if i == j {
+                    continue;
+                }
+                if let Some(result) = self.route(locations[i], locations[j]) {
+                    geometries.insert((i, j), result.geometry);
+                }
+            }
+            // Report progress after each source row
+            on_row_complete(i, n);
+        }
+        geometries
+    }
+    /// Computes all-pairs travel time matrix for given locations.
+    ///
+    /// Returns a matrix where `result[i][j]` is the travel time from location i to j.
+    pub fn compute_matrix(&self, locations: &[(f64, f64)]) -> Vec<Vec<i64>> {
+        self.compute_matrix_with_progress(locations, |_, _| {})
+    }
+    /// Computes all-pairs travel time matrix with row-level progress callback.
+    ///
+    /// The callback receives `(completed_row, total_rows)` after each row is computed.
+    /// This enables progress reporting during the O(n) Dijkstra runs.
+    ///
+    /// # Example
+    ///
+    /// ```
+    /// # use vehicle_routing::routing::RoadNetwork;
+    /// let network = RoadNetwork::new();
+    /// let locations = vec![(39.95, -75.16), (39.96, -75.17)];
+    /// let mut progress_calls = 0;
+    /// let matrix = network.compute_matrix_with_progress(&locations, |row, total| {
+    ///     progress_calls += 1;
+    ///     assert!(row < total);
+    /// });
+    /// assert_eq!(progress_calls, 2); // One call per row
+    /// assert_eq!(matrix.len(), 2);
+    /// ```
+    pub fn compute_matrix_with_progress<F>(
+        &self,
+        locations: &[(f64, f64)],
+        mut on_row_complete: F,
+    ) -> Vec<Vec<i64>>
+    where
+        F: FnMut(usize, usize),
+    {
+        let n = locations.len();
+        let mut matrix = vec![vec![0i64; n]; n];
+        // Snap all locations to nodes
+        let nodes: Vec<Option<NodeIndex>> = locations
+            .iter()
+            .map(|&(lat, lng)| self.snap_to_road(lat, lng))
+            .collect();
+        // Compute travel times row by row
+        for i in 0..n {
+            if let Some(from_node) = nodes[i] {
+                // Run Dijkstra from this node
+                let costs = dijkstra(&self.graph, from_node, None, |e| {
+                    OrderedFloat(e.weight().travel_time_s)
+                });
+                for j in 0..n {
+                    if i == j {
+                        continue;
+                    }
+                    if let Some(to_node) = nodes[j] {
+                        if let Some(cost) = costs.get(&to_node) {
+                            matrix[i][j] = cost.0.round() as i64;
+                        } else {
+                            // No route found, use haversine estimate
+                            let dist = haversine_distance(
+                                locations[i].0,
+                                locations[i].1,
+                                locations[j].0,
+                                locations[j].1,
+                            );
+                            matrix[i][j] = (dist / DEFAULT_SPEED_MPS).round() as i64;
+                        }
+                    }
+                }
+            } else {
+                // Location couldn't be snapped, use haversine for all
+                for j in 0..n {
+                    if i == j {
+                        continue;
+                    }
+                    let dist = haversine_distance(
+                        locations[i].0,
+                        locations[i].1,
+                        locations[j].0,
+                        locations[j].1,
+                    );
+                    matrix[i][j] = (dist / DEFAULT_SPEED_MPS).round() as i64;
+                }
+            }
+            // Report progress after each row
+            on_row_complete(i, n);
+        }
+        matrix
+    }
+    /// Returns the number of nodes in the graph.
+    pub fn node_count(&self) -> usize {
+        self.graph.node_count()
+    }
+    /// Returns the number of edges in the graph.
+    pub fn edge_count(&self) -> usize {
+        self.graph.edge_count()
+    }
+    /// Loads road network from cache file.
+    async fn load_from_cache(path: &Path) -> Result<Self, RoutingError> {
+        let data = tokio::fs::read_to_string(path).await?;
+        // Parse cached data, handling corrupted files
+        let cached: CachedNetwork = match serde_json::from_str(&data) {
+            Ok(c) => c,
+            Err(e) => {
+                info!("Cache file corrupted, will re-download: {}", e);
+                let _ = tokio::fs::remove_file(path).await;
+                return Err(RoutingError::Parse(e.to_string()));
+            }
+        };
+        // Check version - delete old format and re-download
+        if cached.version != CACHE_VERSION {
+            info!(
+                "Cache version mismatch (got {}, need {}), will re-download",
+                cached.version, CACHE_VERSION
+            );
+            let _ = tokio::fs::remove_file(path).await;
+            return Err(RoutingError::Parse("cache version mismatch".into()));
+        }
+        let mut network = Self::new();
+        // Rebuild graph from cached data
+        for node in &cached.nodes {
+            let idx = network.graph.add_node(NodeData {
+                lat: node.lat,
+                lng: node.lng,
+            });
+            let key = coord_key(node.lat, node.lng);
+            network.coord_to_node.insert(key, idx);
+        }
+        for edge in &cached.edges {
+            let from = NodeIndex::new(edge.from);
+            let to = NodeIndex::new(edge.to);
+            network.graph.add_edge(
+                from,
+                to,
+                EdgeData {
+                    travel_time_s: edge.travel_time_s,
+                    distance_m: edge.distance_m,
+                    geometry: vec![],
+                },
+            );
+        }
+        Ok(network)
+    }
+    /// Saves road network to cache file.
+    async fn save_to_cache(&self, path: &Path) -> Result<(), RoutingError> {
+        let nodes: Vec<CachedNode> = self
+            .graph
+            .node_indices()
+            .filter_map(|idx| {
+                self.graph.node_weight(idx).map(|n| CachedNode {
+                    lat: n.lat,
+                    lng: n.lng,
+                })
+            })
+            .collect();
+        let edges: Vec<CachedEdge> = self
+            .graph
+            .edge_indices()
+            .filter_map(|idx| {
+                let (from, to) = self.graph.edge_endpoints(idx)?;
+                let weight = self.graph.edge_weight(idx)?;
+                Some(CachedEdge {
+                    from: from.index(),
+                    to: to.index(),
+                    travel_time_s: weight.travel_time_s,
+                    distance_m: weight.distance_m,
+                })
+            })
+            .collect();
+        let cached = CachedNetwork {
+            version: CACHE_VERSION,
+            nodes,
+            edges,
+        };
+        let data = serde_json::to_string(&cached).map_err(|e| RoutingError::Parse(e.to_string()))?;
+        tokio::fs::write(path, data).await?;
+        Ok(())
+    }
+}
+impl Default for RoadNetwork {
+    fn default() -> Self {
+        Self::new()
+    }
+}
+// ============================================================================
+// OSM Data Structures (Overpass API)
+// ============================================================================
+#[derive(Debug, Deserialize)]
+struct OverpassResponse {
+    elements: Vec<OsmElement>,
+}
+#[derive(Debug, Deserialize)]
+struct OsmElement {
+    #[serde(rename = "type")]
+    elem_type: String,
+    id: i64,
+    lat: Option<f64>,
+    lon: Option<f64>,
+    nodes: Option<Vec<i64>>,
+    tags: Option<OsmTags>,
+}
+#[derive(Debug, Deserialize)]
+struct OsmTags {
+    highway: Option<String>,
+    oneway: Option<String>,
+    /// Maxspeed tag (for future use with dynamic speed calculation).
+    #[allow(dead_code)]
+    maxspeed: Option<String>,
+}
+// ============================================================================
+// Cache Data Structures
+// ============================================================================
+/// Cache format version. Bump this when changing the cache structure.
+const CACHE_VERSION: u32 = 1;
+#[derive(Debug, Serialize, Deserialize)]
+struct CachedNetwork {
+    /// Cache format version for automatic invalidation.
+    version: u32,
+    nodes: Vec<CachedNode>,
+    edges: Vec<CachedEdge>,
+}
+#[derive(Debug, Serialize, Deserialize)]
+struct CachedNode {
+    lat: f64,
+    lng: f64,
+}
+#[derive(Debug, Serialize, Deserialize)]
+struct CachedEdge {
+    from: usize,
+    to: usize,
+    travel_time_s: f64,
+    distance_m: f64,
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/// Converts coordinates to a hash key (7 decimal places precision).
+fn coord_key(lat: f64, lng: f64) -> (i64, i64) {
+    ((lat * 1e7).round() as i64, (lng * 1e7).round() as i64)
+}
+/// Returns speed in m/s for a highway type.
+fn get_speed_for_highway(highway: &str) -> f64 {
+    let kmh = match highway {
+        "motorway" | "motorway_link" => 100.0,
+        "trunk" | "trunk_link" => 80.0,
+        "primary" | "primary_link" => 60.0,
+        "secondary" | "secondary_link" => 50.0,
+        "tertiary" | "tertiary_link" => 40.0,
+        "residential" => 30.0,
+        "unclassified" => 30.0,
+        "service" => 20.0,
+        "living_street" => 10.0,
+        _ => 30.0,
+    };
+    kmh * 1000.0 / 3600.0
+}
+/// Haversine distance between two points in meters.
+fn haversine_distance(lat1: f64, lng1: f64, lat2: f64, lng2: f64) -> f64 {
+    const R: f64 = 6_371_000.0; // Earth radius in meters
+    let lat1_rad = lat1.to_radians();
+    let lat2_rad = lat2.to_radians();
+    let dlat = (lat2 - lat1).to_radians();
+    let dlng = (lng2 - lng1).to_radians();
+    let a = (dlat / 2.0).sin().powi(2)
+        + lat1_rad.cos() * lat2_rad.cos() * (dlng / 2.0).sin().powi(2);
+    let c = 2.0 * a.sqrt().asin();
+    R * c
+}
+#[cfg(test)]
+mod tests {
+    use super::*;
+    #[test]
+    fn test_haversine_distance() {
+        // Philadelphia City Hall to Liberty Bell (~500m)
+        let dist = haversine_distance(39.9526, -75.1635, 39.9496, -75.1503);
+        assert!((dist - 1200.0).abs() < 100.0); // Approximately 1.2 km
+    }
+    #[test]
+    fn test_coord_key() {
+        let key = coord_key(39.9526, -75.1635);
+        assert_eq!(key, (399526000, -751635000));
+    }
+    #[test]
+    fn test_bbox_expand() {
+        let bbox = BoundingBox::new(39.9, -75.2, 40.0, -75.1);
+        let expanded = bbox.expand(0.1);
+        assert!(expanded.min_lat < bbox.min_lat);
+        assert!(expanded.max_lat > bbox.max_lat);
+    }
+    #[test]
+    fn test_empty_network() {
+        let network = RoadNetwork::new();
+        assert_eq!(network.node_count(), 0);
+        assert_eq!(network.edge_count(), 0);
+    }
+    #[test]
+    fn test_snap_to_road_empty() {
+        let network = RoadNetwork::new();
+        assert!(network.snap_to_road(39.95, -75.16).is_none());
+    }
+}

src/solver.rs ADDED Viewed

	@@ -0,0 +1,625 @@

+//! Solver service for Vehicle Routing Problem.
+//!
+//! Uses Late Acceptance local search with 3-opt moves for efficient route optimization.
+//! Direct score calculation with full solution access (no global state).
+use parking_lot::RwLock;
+use rand::Rng;
+use solverforge::prelude::*;
+use std::collections::HashMap;
+use std::sync::Arc;
+use std::time::{Duration, Instant};
+use tokio::sync::oneshot;
+use tracing::{debug, info};
+use crate::console::{self, PhaseTimer};
+use crate::constraints::calculate_score;
+use crate::domain::VehicleRoutePlan;
+/// Default solving time: 30 seconds.
+const DEFAULT_TIME_LIMIT_SECS: u64 = 30;
+/// Late acceptance history size.
+const LATE_ACCEPTANCE_SIZE: usize = 400;
+/// Solver configuration with termination criteria.
+///
+/// Multiple termination conditions combine with OR logic (any triggers termination).
+#[derive(Debug, Clone, Default)]
+pub struct SolverConfig {
+    /// Stop after this duration.
+    pub time_limit: Option<Duration>,
+    /// Stop after this duration without improvement.
+    pub unimproved_time_limit: Option<Duration>,
+    /// Stop after this many steps.
+    pub step_limit: Option<u64>,
+    /// Stop after this many steps without improvement.
+    pub unimproved_step_limit: Option<u64>,
+}
+impl SolverConfig {
+    /// Creates a config with default 30-second time limit.
+    pub fn default_config() -> Self {
+        Self {
+            time_limit: Some(Duration::from_secs(DEFAULT_TIME_LIMIT_SECS)),
+            ..Default::default()
+        }
+    }
+    /// Checks if any termination condition is met.
+    fn should_terminate(
+        &self,
+        elapsed: Duration,
+        steps: u64,
+        time_since_improvement: Duration,
+        steps_since_improvement: u64,
+    ) -> bool {
+        if let Some(limit) = self.time_limit {
+            if elapsed >= limit {
+                return true;
+            }
+        }
+        if let Some(limit) = self.unimproved_time_limit {
+            if time_since_improvement >= limit {
+                return true;
+            }
+        }
+        if let Some(limit) = self.step_limit {
+            if steps >= limit {
+                return true;
+            }
+        }
+        if let Some(limit) = self.unimproved_step_limit {
+            if steps_since_improvement >= limit {
+                return true;
+            }
+        }
+        false
+    }
+}
+/// Status of a solving job.
+#[derive(Debug, Clone, Copy, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
+#[serde(rename_all = "SCREAMING_SNAKE_CASE")]
+pub enum SolverStatus {
+    /// Not currently solving.
+    NotSolving,
+    /// Actively solving.
+    Solving,
+}
+impl SolverStatus {
+    /// Returns the status as a SCREAMING_SNAKE_CASE string for API responses.
+    ///
+    /// ```
+    /// use vehicle_routing::solver::SolverStatus;
+    ///
+    /// assert_eq!(SolverStatus::NotSolving.as_str(), "NOT_SOLVING");
+    /// assert_eq!(SolverStatus::Solving.as_str(), "SOLVING");
+    /// ```
+    pub fn as_str(self) -> &'static str {
+        match self {
+            SolverStatus::NotSolving => "NOT_SOLVING",
+            SolverStatus::Solving => "SOLVING",
+        }
+    }
+}
+/// A solving job with current state.
+pub struct SolveJob {
+    /// Unique job identifier.
+    pub id: String,
+    /// Current status.
+    pub status: SolverStatus,
+    /// Current best solution.
+    pub plan: VehicleRoutePlan,
+    /// Solver configuration.
+    pub config: SolverConfig,
+    /// Stop signal sender.
+    stop_signal: Option<oneshot::Sender<()>>,
+}
+impl SolveJob {
+    /// Creates a new solve job with default config.
+    pub fn new(id: String, plan: VehicleRoutePlan) -> Self {
+        Self {
+            id,
+            status: SolverStatus::NotSolving,
+            plan,
+            config: SolverConfig::default_config(),
+            stop_signal: None,
+        }
+    }
+    /// Creates a new solve job with custom config.
+    pub fn with_config(id: String, plan: VehicleRoutePlan, config: SolverConfig) -> Self {
+        Self {
+            id,
+            status: SolverStatus::NotSolving,
+            plan,
+            config,
+            stop_signal: None,
+        }
+    }
+}
+/// Manages VRP solving jobs.
+///
+/// # Examples
+///
+/// ```
+/// use vehicle_routing::solver::SolverService;
+/// use vehicle_routing::demo_data::generate_philadelphia;
+///
+/// let service = SolverService::new();
+/// let plan = generate_philadelphia();
+///
+/// // Create a job (doesn't start solving yet)
+/// let job = service.create_job("test-1".to_string(), plan);
+/// assert_eq!(job.read().status, vehicle_routing::solver::SolverStatus::NotSolving);
+/// ```
+pub struct SolverService {
+    jobs: RwLock<HashMap<String, Arc<RwLock<SolveJob>>>>,
+}
+impl SolverService {
+    /// Creates a new solver service.
+    pub fn new() -> Self {
+        Self {
+            jobs: RwLock::new(HashMap::new()),
+        }
+    }
+    /// Creates a new job for the given plan with default config.
+    pub fn create_job(&self, id: String, plan: VehicleRoutePlan) -> Arc<RwLock<SolveJob>> {
+        let job = Arc::new(RwLock::new(SolveJob::new(id.clone(), plan)));
+        self.jobs.write().insert(id, job.clone());
+        job
+    }
+    /// Creates a new job with custom config.
+    pub fn create_job_with_config(
+        &self,
+        id: String,
+        plan: VehicleRoutePlan,
+        config: SolverConfig,
+    ) -> Arc<RwLock<SolveJob>> {
+        let job = Arc::new(RwLock::new(SolveJob::with_config(id.clone(), plan, config)));
+        self.jobs.write().insert(id, job.clone());
+        job
+    }
+    /// Gets a job by ID.
+    pub fn get_job(&self, id: &str) -> Option<Arc<RwLock<SolveJob>>> {
+        self.jobs.read().get(id).cloned()
+    }
+    /// Lists all job IDs.
+    pub fn list_jobs(&self) -> Vec<String> {
+        self.jobs.read().keys().cloned().collect()
+    }
+    /// Removes a job by ID.
+    pub fn remove_job(&self, id: &str) -> Option<Arc<RwLock<SolveJob>>> {
+        self.jobs.write().remove(id)
+    }
+    /// Starts solving a job in the background.
+    pub fn start_solving(&self, job: Arc<RwLock<SolveJob>>) {
+        let (tx, rx) = oneshot::channel();
+        let config = job.read().config.clone();
+        {
+            let mut job_guard = job.write();
+            job_guard.status = SolverStatus::Solving;
+            job_guard.stop_signal = Some(tx);
+        }
+        let job_clone = job.clone();
+        tokio::task::spawn_blocking(move || {
+            solve_blocking(job_clone, rx, config);
+        });
+    }
+    /// Stops a solving job.
+    pub fn stop_solving(&self, id: &str) -> bool {
+        if let Some(job) = self.get_job(id) {
+            let mut job_guard = job.write();
+            if let Some(stop_signal) = job_guard.stop_signal.take() {
+                let _ = stop_signal.send(());
+                job_guard.status = SolverStatus::NotSolving;
+                return true;
+            }
+        }
+        false
+    }
+}
+impl Default for SolverService {
+    fn default() -> Self {
+        Self::new()
+    }
+}
+/// Runs the solver in a blocking context.
+fn solve_blocking(
+    job: Arc<RwLock<SolveJob>>,
+    mut stop_rx: oneshot::Receiver<()>,
+    config: SolverConfig,
+) {
+    let mut solution = job.read().plan.clone();
+    let job_id = job.read().id.clone();
+    let solve_start = Instant::now();
+    // Print problem configuration
+    console::print_config(
+        solution.vehicles.len(),
+        solution.visits.len(),
+        solution.locations.len(),
+    );
+    info!(
+        job_id = %job_id,
+        visits = solution.visits.len(),
+        vehicles = solution.vehicles.len(),
+        "Starting VRP solver"
+    );
+    // Phase 1: Construction heuristic (round-robin)
+    let mut ch_timer = PhaseTimer::start("ConstructionHeuristic", 0);
+    let mut current_score = construction_heuristic(&mut solution, &mut ch_timer);
+    ch_timer.finish();
+    // Print solving started after construction
+    console::print_solving_started(
+        solve_start.elapsed().as_millis() as u64,
+        &current_score.to_string(),
+        solution.visits.len(),
+        solution.visits.len(),
+        solution.vehicles.len(),
+    );
+    // Update job with constructed solution
+    update_job(&job, &solution, current_score);
+    // Phase 2: Late Acceptance local search with 3-opt
+    let n_vehicles = solution.vehicles.len();
+    if n_vehicles == 0 {
+        info!("No vehicles to optimize");
+        console::print_solving_ended(
+            solve_start.elapsed(),
+            0,
+            1,
+            &current_score.to_string(),
+            current_score.is_feasible(),
+        );
+        finish_job(&job, &solution, current_score);
+        return;
+    }
+    let mut ls_timer = PhaseTimer::start("LateAcceptance", 1);
+    let mut late_scores = vec![current_score; LATE_ACCEPTANCE_SIZE];
+    let mut step: u64 = 0;
+    let mut rng = rand::thread_rng();
+    // Track best score and improvement times
+    let mut best_score = current_score;
+    let mut last_improvement_time = solve_start;
+    let mut last_improvement_step: u64 = 0;
+    loop {
+        // Check termination conditions
+        let elapsed = solve_start.elapsed();
+        let time_since_improvement = last_improvement_time.elapsed();
+        let steps_since_improvement = step - last_improvement_step;
+        if config.should_terminate(elapsed, step, time_since_improvement, steps_since_improvement) {
+            debug!("Termination condition met");
+            break;
+        }
+        // Check for stop signal
+        if stop_rx.try_recv().is_ok() {
+            info!("Solving terminated early by user");
+            break;
+        }
+        // Alternate between list-change and 2-opt moves
+        let accepted = if step % 3 == 0 {
+            // 2-opt move (intra-route segment reversal)
+            try_two_opt_move(&mut solution, &mut current_score, &late_scores, step, &mut rng, &mut ls_timer)
+        } else {
+            // List-change move (visit relocation)
+            try_list_change_move(&mut solution, &mut current_score, &late_scores, step, &mut rng, &mut ls_timer)
+        };
+        if accepted {
+            // Update late acceptance history
+            let late_idx = (step as usize) % LATE_ACCEPTANCE_SIZE;
+            late_scores[late_idx] = current_score;
+            // Track improvements
+            if current_score > best_score {
+                best_score = current_score;
+                last_improvement_time = Instant::now();
+                last_improvement_step = step;
+            }
+            // Periodic update
+            if ls_timer.steps_accepted().is_multiple_of(1000) {
+                update_job(&job, &solution, current_score);
+                debug!(
+                    step,
+                    moves_accepted = ls_timer.steps_accepted(),
+                    score = %current_score,
+                    elapsed_secs = solve_start.elapsed().as_secs(),
+                    "Progress update"
+                );
+            }
+            // Periodic console progress (every 10000 moves)
+            if ls_timer.moves_evaluated().is_multiple_of(10000) {
+                console::print_step_progress(
+                    ls_timer.steps_accepted(),
+                    ls_timer.elapsed(),
+                    ls_timer.moves_evaluated(),
+                    &current_score.to_string(),
+                );
+            }
+        }
+        step += 1;
+    }
+    ls_timer.finish();
+    let total_duration = solve_start.elapsed();
+    let total_moves = step;
+    info!(
+        job_id = %job_id,
+        duration_secs = total_duration.as_secs_f64(),
+        steps = step,
+        score = %current_score,
+        feasible = current_score.is_feasible(),
+        "Solving complete"
+    );
+    console::print_solving_ended(
+        total_duration,
+        total_moves,
+        2,
+        &current_score.to_string(),
+        current_score.is_feasible(),
+    );
+    finish_job(&job, &solution, current_score);
+}
+/// Construction heuristic: round-robin visit assignment.
+///
+/// Skips construction if all visits are already assigned (continue mode).
+fn construction_heuristic(solution: &mut VehicleRoutePlan, timer: &mut PhaseTimer) -> HardSoftScore {
+    let n_visits = solution.visits.len();
+    let n_vehicles = solution.vehicles.len();
+    if n_vehicles == 0 || n_visits == 0 {
+        return calculate_score(solution);
+    }
+    // Count already-assigned visits
+    let assigned_count: usize = solution.vehicles.iter().map(|v| v.visits.len()).sum();
+    // If all visits already assigned, skip construction (continue mode)
+    if assigned_count == n_visits {
+        info!("All visits already assigned, skipping construction heuristic");
+        return calculate_score(solution);
+    }
+    // Build set of already-assigned visits
+    let assigned: std::collections::HashSet<usize> = solution
+        .vehicles
+        .iter()
+        .flat_map(|v| v.visits.iter().copied())
+        .collect();
+    // Round-robin assignment for unassigned visits only
+    let mut vehicle_idx = 0;
+    for visit_idx in 0..n_visits {
+        if assigned.contains(&visit_idx) {
+            continue;
+        }
+        timer.record_move();
+        solution.vehicles[vehicle_idx].visits.push(visit_idx);
+        let score = calculate_score(solution);
+        timer.record_accepted(&score.to_string());
+        vehicle_idx = (vehicle_idx + 1) % n_vehicles;
+    }
+    calculate_score(solution)
+}
+/// Tries a list-change (visit relocation) move.
+/// Returns true if the move was accepted.
+fn try_list_change_move<R: Rng>(
+    solution: &mut VehicleRoutePlan,
+    current_score: &mut HardSoftScore,
+    late_scores: &[HardSoftScore],
+    step: u64,
+    rng: &mut R,
+    timer: &mut PhaseTimer,
+) -> bool {
+    let n_vehicles = solution.vehicles.len();
+    // Find a non-empty source vehicle
+    let non_empty: Vec<usize> = solution
+        .vehicles
+        .iter()
+        .enumerate()
+        .filter(|(_, v)| !v.visits.is_empty())
+        .map(|(i, _)| i)
+        .collect();
+    if non_empty.is_empty() {
+        return false;
+    }
+    let src_vehicle = non_empty[rng.gen_range(0..non_empty.len())];
+    let src_len = solution.vehicles[src_vehicle].visits.len();
+    let src_pos = rng.gen_range(0..src_len);
+    // Pick destination vehicle and position
+    let dst_vehicle = rng.gen_range(0..n_vehicles);
+    let dst_len = solution.vehicles[dst_vehicle].visits.len();
+    // Valid insertion position
+    let max_pos = if src_vehicle == dst_vehicle {
+        src_len
+    } else {
+        dst_len + 1
+    };
+    if max_pos == 0 {
+        return false;
+    }
+    let dst_pos = rng.gen_range(0..max_pos);
+    // Skip no-op moves
+    if src_vehicle == dst_vehicle {
+        let effective_dst = if dst_pos > src_pos { dst_pos - 1 } else { dst_pos };
+        if src_pos == effective_dst {
+            return false;
+        }
+    }
+    timer.record_move();
+    // Apply move
+    let visit_idx = solution.vehicles[src_vehicle].visits.remove(src_pos);
+    let adjusted_dst = if src_vehicle == dst_vehicle && dst_pos > src_pos {
+        dst_pos - 1
+    } else {
+        dst_pos
+    };
+    solution.vehicles[dst_vehicle].visits.insert(adjusted_dst, visit_idx);
+    // Evaluate
+    let new_score = calculate_score(solution);
+    let late_idx = (step as usize) % late_scores.len();
+    let late_score = late_scores[late_idx];
+    if new_score >= *current_score || new_score >= late_score {
+        // Accept
+        timer.record_accepted(&new_score.to_string());
+        *current_score = new_score;
+        true
+    } else {
+        // Reject - undo
+        solution.vehicles[dst_vehicle].visits.remove(adjusted_dst);
+        solution.vehicles[src_vehicle].visits.insert(src_pos, visit_idx);
+        false
+    }
+}
+/// Tries a 2-opt move (reverse a segment within a route).
+/// Returns true if the move was accepted.
+fn try_two_opt_move<R: Rng>(
+    solution: &mut VehicleRoutePlan,
+    current_score: &mut HardSoftScore,
+    late_scores: &[HardSoftScore],
+    step: u64,
+    rng: &mut R,
+    timer: &mut PhaseTimer,
+) -> bool {
+    // Find a vehicle with at least 2 visits
+    let eligible: Vec<usize> = solution
+        .vehicles
+        .iter()
+        .enumerate()
+        .filter(|(_, v)| v.visits.len() >= 2)
+        .map(|(i, _)| i)
+        .collect();
+    if eligible.is_empty() {
+        return false;
+    }
+    let vehicle_idx = eligible[rng.gen_range(0..eligible.len())];
+    let route_len = solution.vehicles[vehicle_idx].visits.len();
+    // Pick two cut points for 2-opt
+    let i = rng.gen_range(0..route_len);
+    let j = rng.gen_range(0..route_len);
+    if i == j {
+        return false;
+    }
+    let (start, end) = if i < j { (i, j) } else { (j, i) };
+    // Need at least 2 elements to reverse
+    if end - start < 1 {
+        return false;
+    }
+    timer.record_move();
+    // Apply 2-opt: reverse segment [start, end]
+    solution.vehicles[vehicle_idx].visits[start..=end].reverse();
+    // Evaluate
+    let new_score = calculate_score(solution);
+    let late_idx = (step as usize) % late_scores.len();
+    let late_score = late_scores[late_idx];
+    if new_score >= *current_score || new_score >= late_score {
+        // Accept
+        timer.record_accepted(&new_score.to_string());
+        *current_score = new_score;
+        true
+    } else {
+        // Reject - undo (reverse again)
+        solution.vehicles[vehicle_idx].visits[start..=end].reverse();
+        false
+    }
+}
+/// Updates job with current solution.
+fn update_job(job: &Arc<RwLock<SolveJob>>, solution: &VehicleRoutePlan, score: HardSoftScore) {
+    let mut job_guard = job.write();
+    job_guard.plan = solution.clone();
+    job_guard.plan.score = Some(score);
+}
+/// Finishes job and sets status.
+fn finish_job(job: &Arc<RwLock<SolveJob>>, solution: &VehicleRoutePlan, score: HardSoftScore) {
+    let mut job_guard = job.write();
+    job_guard.plan = solution.clone();
+    job_guard.plan.score = Some(score);
+    job_guard.status = SolverStatus::NotSolving;
+}
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use crate::demo_data::generate_philadelphia;
+    #[test]
+    fn test_construction_heuristic() {
+        let mut plan = generate_philadelphia();
+        // Create a timer but don't print (we're in a test)
+        let mut timer = PhaseTimer::start("ConstructionHeuristic", 0);
+        let score = construction_heuristic(&mut plan, &mut timer);
+        // All visits should be assigned
+        let total_visits: usize = plan.vehicles.iter().map(|v| v.visits.len()).sum();
+        assert_eq!(total_visits, 49); // Philadelphia has 49 visits
+        assert!(score.hard() <= 0); // May have some violations
+    }
+}

static/app.js ADDED Viewed

	@@ -0,0 +1,1627 @@

+let autoRefreshIntervalId = null;
+let initialized = false;
+let optimizing = false;
+let demoDataId = null;
+let scheduleId = null;
+let loadedRoutePlan = null;
+let newVisit = null;
+let visitMarker = null;
+let routeGeometries = null;  // Cache for encoded polyline geometries
+let useRealRoads = true;     // Routing mode toggle state (default: real roads)
+const solveButton = $("#solveButton");
+const stopSolvingButton = $("#stopSolvingButton");
+const vehiclesTable = $("#vehicles");
+const analyzeButton = $("#analyzeButton");
+/**
+ * Decode an encoded polyline string into an array of [lat, lng] coordinates.
+ * This is the Google polyline encoding algorithm.
+ * @param {string} encoded - The encoded polyline string
+ * @returns {Array<Array<number>>} Array of [lat, lng] coordinate pairs
+ */
+function decodePolyline(encoded) {
+  if (!encoded) return [];
+  const points = [];
+  let index = 0;
+  let lat = 0;
+  let lng = 0;
+  while (index < encoded.length) {
+    // Decode latitude
+    let shift = 0;
+    let result = 0;
+    let byte;
+    do {
+      byte = encoded.charCodeAt(index++) - 63;
+      result |= (byte & 0x1f) << shift;
+      shift += 5;
+    } while (byte >= 0x20);
+    const dlat = (result & 1) ? ~(result >> 1) : (result >> 1);
+    lat += dlat;
+    // Decode longitude
+    shift = 0;
+    result = 0;
+    do {
+      byte = encoded.charCodeAt(index++) - 63;
+      result |= (byte & 0x1f) << shift;
+      shift += 5;
+    } while (byte >= 0x20);
+    const dlng = (result & 1) ? ~(result >> 1) : (result >> 1);
+    lng += dlng;
+    // Polyline encoding uses precision of 5 decimal places
+    points.push([lat / 1e5, lng / 1e5]);
+  }
+  return points;
+}
+/**
+ * Fetch route geometries for the current schedule from the backend.
+ * @returns {Promise<Object|null>} The geometries object or null if unavailable
+ */
+async function fetchRouteGeometries() {
+  if (!scheduleId) return null;
+  try {
+    const response = await fetch(`/route-plans/${scheduleId}/geometry`);
+    if (response.ok) {
+      const data = await response.json();
+      // Transform segments array into map: { vehicleId: [polyline] }
+      const geometries = {};
+      for (const segment of data.segments || []) {
+        const vehicleId = String(segment.vehicle_idx);
+        if (!geometries[vehicleId]) {
+          geometries[vehicleId] = [];
+        }
+        geometries[vehicleId].push(segment.polyline);
+      }
+      return Object.keys(geometries).length > 0 ? geometries : null;
+    }
+  } catch (e) {
+    console.warn('Could not fetch route geometries:', e);
+  }
+  return null;
+}
+/*************************************** Loading Overlay Functions **************************************/
+function showLoadingOverlay(title = "Loading Demo Data", message = "Initializing...") {
+  $("#loadingTitle").text(title);
+  $("#loadingMessage").text(message);
+  $("#loadingProgress").css("width", "0%");
+  $("#loadingDetail").text("");
+  $("#loadingOverlay").removeClass("hidden");
+}
+function hideLoadingOverlay() {
+  $("#loadingOverlay").addClass("hidden");
+}
+function updateLoadingProgress(message, percent, detail = "") {
+  $("#loadingMessage").text(message);
+  $("#loadingProgress").css("width", `${percent}%`);
+  $("#loadingDetail").text(detail);
+}
+/**
+ * Load demo data with progress updates via Server-Sent Events.
+ * Used when Real Roads mode is enabled.
+ */
+function loadDemoDataWithProgress(demoId) {
+  return new Promise((resolve, reject) => {
+    const routingMode = useRealRoads ? "real_roads" : "haversine";
+    const url = `/demo-data/${demoId}/stream?routing=${routingMode}`;
+    showLoadingOverlay(
+      useRealRoads ? "Loading Real Road Data" : "Loading Demo Data",
+      "Connecting..."
+    );
+    const eventSource = new EventSource(url);
+    let solution = null;
+    eventSource.onmessage = function(event) {
+      try {
+        const data = JSON.parse(event.data);
+        if (data.event === "progress") {
+          let statusIcon = "";
+          if (data.phase === "network") {
+            statusIcon = '<i class="fas fa-download me-2"></i>';
+          } else if (data.phase === "routes") {
+            statusIcon = '<i class="fas fa-route me-2"></i>';
+          } else if (data.phase === "complete") {
+            statusIcon = '<i class="fas fa-check-circle me-2 text-success"></i>';
+          }
+          updateLoadingProgress(data.message, data.percent, data.detail || "");
+        } else if (data.event === "complete") {
+          solution = data.solution;
+          // Store geometries from the response if available
+          if (data.geometries) {
+            routeGeometries = data.geometries;
+          }
+          eventSource.close();
+          hideLoadingOverlay();
+          resolve(solution);
+        } else if (data.event === "error") {
+          eventSource.close();
+          hideLoadingOverlay();
+          reject(new Error(data.message));
+        }
+      } catch (e) {
+        console.error("Error parsing SSE event:", e);
+      }
+    };
+    eventSource.onerror = function(error) {
+      eventSource.close();
+      hideLoadingOverlay();
+      reject(new Error("Connection lost while loading data"));
+    };
+  });
+}
+/*************************************** Map constants and variable definitions  **************************************/
+const homeLocationMarkerByIdMap = new Map();
+const visitMarkerByIdMap = new Map();
+const map = L.map("map", { doubleClickZoom: false }).setView(
+  [51.505, -0.09],
+  13,
+);
+const visitGroup = L.layerGroup().addTo(map);
+const homeLocationGroup = L.layerGroup().addTo(map);
+const routeGroup = L.layerGroup().addTo(map);
+/************************************ Time line constants and variable definitions ************************************/
+let byVehicleTimeline;
+let byVisitTimeline;
+const byVehicleGroupData = new vis.DataSet();
+const byVehicleItemData = new vis.DataSet();
+const byVisitGroupData = new vis.DataSet();
+const byVisitItemData = new vis.DataSet();
+const byVehicleTimelineOptions = {
+  timeAxis: { scale: "hour" },
+  orientation: { axis: "top" },
+  xss: { disabled: true }, // Items are XSS safe through JQuery
+  stack: false,
+  stackSubgroups: false,
+  zoomMin: 1000 * 60 * 60, // A single hour in milliseconds
+  zoomMax: 1000 * 60 * 60 * 24, // A single day in milliseconds
+};
+const byVisitTimelineOptions = {
+  timeAxis: { scale: "hour" },
+  orientation: { axis: "top" },
+  verticalScroll: true,
+  xss: { disabled: true }, // Items are XSS safe through JQuery
+  stack: false,
+  stackSubgroups: false,
+  zoomMin: 1000 * 60 * 60, // A single hour in milliseconds
+  zoomMax: 1000 * 60 * 60 * 24, // A single day in milliseconds
+};
+/************************************ Initialize ************************************/
+// Vehicle management state
+let addingVehicleMode = false;
+let pickingVehicleLocation = false;
+let tempVehicleMarker = null;
+let vehicleDeparturePicker = null;
+// Route highlighting state
+let highlightedVehicleId = null;
+let routeNumberMarkers = [];  // Markers showing 1, 2, 3... on route stops
+$(document).ready(function () {
+  replaceQuickstartSolverForgeAutoHeaderFooter();
+  // Initialize timelines after DOM is ready with a small delay to ensure Bootstrap tabs are rendered
+  setTimeout(function () {
+    const byVehiclePanel = document.getElementById("byVehiclePanel");
+    const byVisitPanel = document.getElementById("byVisitPanel");
+    if (byVehiclePanel) {
+      byVehicleTimeline = new vis.Timeline(
+        byVehiclePanel,
+        byVehicleItemData,
+        byVehicleGroupData,
+        byVehicleTimelineOptions,
+      );
+    }
+    if (byVisitPanel) {
+      byVisitTimeline = new vis.Timeline(
+        byVisitPanel,
+        byVisitItemData,
+        byVisitGroupData,
+        byVisitTimelineOptions,
+      );
+    }
+  }, 100);
+  L.tileLayer("https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png", {
+    maxZoom: 19,
+    attribution:
+      '&copy; <a href="https://www.openstreetmap.org/">OpenStreetMap</a> contributors',
+  }).addTo(map);
+  solveButton.click(solve);
+  stopSolvingButton.click(stopSolving);
+  analyzeButton.click(analyze);
+  refreshSolvingButtons(false);
+  // HACK to allow vis-timeline to work within Bootstrap tabs
+  $("#byVehicleTab").on("shown.bs.tab", function (event) {
+    if (byVehicleTimeline) {
+      byVehicleTimeline.redraw();
+    }
+  });
+  $("#byVisitTab").on("shown.bs.tab", function (event) {
+    if (byVisitTimeline) {
+      byVisitTimeline.redraw();
+    }
+  });
+  // Map click handler - context aware
+  map.on("click", function (e) {
+    if (addingVehicleMode) {
+      // Set vehicle home location
+      setVehicleHomeLocation(e.latlng.lat, e.latlng.lng);
+    } else if (!optimizing) {
+      // Add new visit
+      visitMarker = L.circleMarker(e.latlng);
+      visitMarker.setStyle({ color: "green" });
+      visitMarker.addTo(map);
+      openRecommendationModal(e.latlng.lat, e.latlng.lng);
+    }
+  });
+  // Remove visit marker when modal closes
+  $("#newVisitModal").on("hidden.bs.modal", function () {
+    if (visitMarker) {
+      map.removeLayer(visitMarker);
+    }
+  });
+  // Vehicle management
+  $("#addVehicleBtn").click(openAddVehicleModal);
+  $("#removeVehicleBtn").click(removeLastVehicle);
+  $("#confirmAddVehicle").click(confirmAddVehicle);
+  $("#pickLocationBtn").click(pickVehicleLocationOnMap);
+  // Clean up when add vehicle modal closes (only if not picking location)
+  $("#addVehicleModal").on("hidden.bs.modal", function () {
+    if (!pickingVehicleLocation) {
+      addingVehicleMode = false;
+      if (tempVehicleMarker) {
+        map.removeLayer(tempVehicleMarker);
+        tempVehicleMarker = null;
+      }
+    }
+  });
+  // Real Roads toggle handler
+  $(document).on('change', '#realRoadRouting', function() {
+    useRealRoads = $(this).is(':checked');
+    // If we have a demo dataset loaded, reload it with the new routing mode
+    if (demoDataId && !optimizing) {
+      scheduleId = null;
+      initialized = false;
+      homeLocationGroup.clearLayers();
+      homeLocationMarkerByIdMap.clear();
+      visitGroup.clearLayers();
+      visitMarkerByIdMap.clear();
+      routeGeometries = null;
+      refreshRoutePlan();
+    }
+  });
+  setupAjax();
+  fetchDemoData();
+});
+/*************************************** Vehicle Management **************************************/
+function openAddVehicleModal() {
+  if (optimizing) {
+    alert("Cannot add vehicles while solving. Please stop solving first.");
+    return;
+  }
+  if (!loadedRoutePlan) {
+    alert("Please load a dataset first.");
+    return;
+  }
+  addingVehicleMode = true;
+  // Suggest next vehicle name
+  $("#vehicleName").val("").attr("placeholder", `e.g., ${getNextVehicleName()}`);
+  // Set default values based on existing vehicles
+  const existingVehicle = loadedRoutePlan.vehicles[0];
+  if (existingVehicle) {
+    $("#vehicleCapacity").val(existingVehicle.capacity || 25);
+    const defaultLat = existingVehicle.homeLocation[0];
+    const defaultLng = existingVehicle.homeLocation[1];
+    $("#vehicleHomeLat").val(defaultLat.toFixed(6));
+    $("#vehicleHomeLng").val(defaultLng.toFixed(6));
+  }
+  // Initialize departure time picker
+  const tomorrow = JSJoda.LocalDate.now().plusDays(1);
+  const defaultDeparture = tomorrow.atTime(JSJoda.LocalTime.of(6, 0));
+  if (vehicleDeparturePicker) {
+    vehicleDeparturePicker.destroy();
+  }
+  vehicleDeparturePicker = flatpickr("#vehicleDepartureTime", {
+    enableTime: true,
+    dateFormat: "Y-m-d H:i",
+    defaultDate: defaultDeparture.format(JSJoda.DateTimeFormatter.ofPattern('yyyy-M-d HH:mm'))
+  });
+  $("#addVehicleModal").modal("show");
+}
+function pickVehicleLocationOnMap() {
+  // Hide modal temporarily while user picks location
+  pickingVehicleLocation = true;
+  addingVehicleMode = true;
+  $("#addVehicleModal").modal("hide");
+  // Show hint on map
+  $("#mapHint").html('<i class="fas fa-crosshairs"></i> Click on the map to set vehicle depot location').removeClass("hidden");
+}
+function setVehicleHomeLocation(lat, lng) {
+  $("#vehicleHomeLat").val(lat.toFixed(6));
+  $("#vehicleHomeLng").val(lng.toFixed(6));
+  $("#vehicleLocationPreview").html(`<i class="fas fa-check text-success"></i> Location set: ${lat.toFixed(4)}, ${lng.toFixed(4)}`);
+  // Show temporary marker
+  if (tempVehicleMarker) {
+    map.removeLayer(tempVehicleMarker);
+  }
+  tempVehicleMarker = L.marker([lat, lng], {
+    icon: L.divIcon({
+      className: 'temp-vehicle-marker',
+      html: `<div style="
+        background-color: #6366f1;
+        border: 3px solid white;
+        border-radius: 4px;
+        width: 28px;
+        height: 28px;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        box-shadow: 0 2px 4px rgba(0,0,0,0.4);
+        animation: pulse 1s infinite;
+      "><i class="fas fa-warehouse" style="color: white; font-size: 12px;"></i></div>`,
+      iconSize: [28, 28],
+      iconAnchor: [14, 14]
+    })
+  });
+  tempVehicleMarker.addTo(map);
+  // If we were picking location, re-open the modal
+  if (pickingVehicleLocation) {
+    pickingVehicleLocation = false;
+    addingVehicleMode = false;
+    $("#addVehicleModal").modal("show");
+    // Restore normal map hint
+    $("#mapHint").html('<i class="fas fa-mouse-pointer"></i> Click on the map to add a new visit');
+  }
+}
+// Extended phonetic alphabet for generating vehicle names
+const PHONETIC_NAMES = ["Alpha", "Bravo", "Charlie", "Delta", "Echo", "Foxtrot", "Golf", "Hotel", "India", "Juliet", "Kilo", "Lima", "Mike", "November", "Oscar", "Papa", "Quebec", "Romeo", "Sierra", "Tango", "Uniform", "Victor", "Whiskey", "X-ray", "Yankee", "Zulu"];
+function getNextVehicleName() {
+  if (!loadedRoutePlan) return "Alpha";
+  const usedNames = new Set(loadedRoutePlan.vehicles.map(v => v.name));
+  for (const name of PHONETIC_NAMES) {
+    if (!usedNames.has(name)) return name;
+  }
+  // Fallback if all names used
+  return `Vehicle ${loadedRoutePlan.vehicles.length + 1}`;
+}
+async function confirmAddVehicle() {
+  const vehicleName = $("#vehicleName").val().trim() || getNextVehicleName();
+  const capacity = parseInt($("#vehicleCapacity").val());
+  const lat = parseFloat($("#vehicleHomeLat").val());
+  const lng = parseFloat($("#vehicleHomeLng").val());
+  const departureTime = $("#vehicleDepartureTime").val();
+  if (!capacity || capacity < 1) {
+    alert("Please enter a valid capacity (minimum 1).");
+    return;
+  }
+  if (isNaN(lat) || isNaN(lng)) {
+    alert("Please set a valid home location by clicking on the map or entering coordinates.");
+    return;
+  }
+  if (!departureTime) {
+    alert("Please set a departure time.");
+    return;
+  }
+  // Generate new vehicle ID
+  const maxId = Math.max(...loadedRoutePlan.vehicles.map(v => parseInt(v.id)), 0);
+  const newId = String(maxId + 1);
+  // Format departure time
+  const formattedDeparture = JSJoda.LocalDateTime.parse(
+    departureTime,
+    JSJoda.DateTimeFormatter.ofPattern('yyyy-M-d HH:mm')
+  ).format(JSJoda.DateTimeFormatter.ISO_LOCAL_DATE_TIME);
+  // Create new vehicle
+  const newVehicle = {
+    id: newId,
+    name: vehicleName,
+    capacity: capacity,
+    homeLocation: [lat, lng],
+    departureTime: formattedDeparture,
+    visits: [],
+    totalDemand: 0,
+    totalDrivingTimeSeconds: 0,
+    arrivalTime: formattedDeparture
+  };
+  // Add to solution
+  loadedRoutePlan.vehicles.push(newVehicle);
+  // Close modal and refresh
+  $("#addVehicleModal").modal("hide");
+  addingVehicleMode = false;
+  if (tempVehicleMarker) {
+    map.removeLayer(tempVehicleMarker);
+    tempVehicleMarker = null;
+  }
+  // Refresh display
+  await renderRoutes(loadedRoutePlan);
+  renderTimelines(loadedRoutePlan);
+  showNotification(`Vehicle "${vehicleName}" added successfully!`, "success");
+}
+async function removeLastVehicle() {
+  if (optimizing) {
+    alert("Cannot remove vehicles while solving. Please stop solving first.");
+    return;
+  }
+  if (!loadedRoutePlan || loadedRoutePlan.vehicles.length <= 1) {
+    alert("Cannot remove the last vehicle. At least one vehicle is required.");
+    return;
+  }
+  const lastVehicle = loadedRoutePlan.vehicles[loadedRoutePlan.vehicles.length - 1];
+  if (lastVehicle.visits && lastVehicle.visits.length > 0) {
+    if (!confirm(`Vehicle ${lastVehicle.id} has ${lastVehicle.visits.length} assigned visits. These will become unassigned. Continue?`)) {
+      return;
+    }
+    // Unassign visits from the vehicle
+    lastVehicle.visits.forEach(visitId => {
+      const visit = loadedRoutePlan.visits.find(v => v.id === visitId);
+      if (visit) {
+        visit.vehicle = null;
+        visit.previousVisit = null;
+        visit.nextVisit = null;
+        visit.arrivalTime = null;
+        visit.departureTime = null;
+      }
+    });
+  }
+  // Remove vehicle
+  loadedRoutePlan.vehicles.pop();
+  // Remove marker
+  const marker = homeLocationMarkerByIdMap.get(lastVehicle.id);
+  if (marker) {
+    homeLocationGroup.removeLayer(marker);
+    homeLocationMarkerByIdMap.delete(lastVehicle.id);
+  }
+  // Refresh display
+  await renderRoutes(loadedRoutePlan);
+  renderTimelines(loadedRoutePlan);
+  showNotification(`Vehicle "${lastVehicle.name || lastVehicle.id}" removed.`, "info");
+}
+async function removeVehicle(vehicleId) {
+  if (optimizing) {
+    alert("Cannot remove vehicles while solving. Please stop solving first.");
+    return;
+  }
+  const vehicleIndex = loadedRoutePlan.vehicles.findIndex(v => v.id === vehicleId);
+  if (vehicleIndex === -1) return;
+  if (loadedRoutePlan.vehicles.length <= 1) {
+    alert("Cannot remove the last vehicle. At least one vehicle is required.");
+    return;
+  }
+  const vehicle = loadedRoutePlan.vehicles[vehicleIndex];
+  if (vehicle.visits && vehicle.visits.length > 0) {
+    if (!confirm(`Vehicle ${vehicle.id} has ${vehicle.visits.length} assigned visits. These will become unassigned. Continue?`)) {
+      return;
+    }
+    // Unassign visits
+    vehicle.visits.forEach(visitId => {
+      const visit = loadedRoutePlan.visits.find(v => v.id === visitId);
+      if (visit) {
+        visit.vehicle = null;
+        visit.previousVisit = null;
+        visit.nextVisit = null;
+        visit.arrivalTime = null;
+        visit.departureTime = null;
+      }
+    });
+  }
+  // Remove vehicle
+  loadedRoutePlan.vehicles.splice(vehicleIndex, 1);
+  // Remove marker
+  const marker = homeLocationMarkerByIdMap.get(vehicleId);
+  if (marker) {
+    homeLocationGroup.removeLayer(marker);
+    homeLocationMarkerByIdMap.delete(vehicleId);
+  }
+  // Refresh display
+  await renderRoutes(loadedRoutePlan);
+  renderTimelines(loadedRoutePlan);
+  showNotification(`Vehicle "${vehicle.name || vehicleId}" removed.`, "info");
+}
+function showNotification(message, type = "info") {
+  const alertClass = type === "success" ? "alert-success" : type === "error" ? "alert-danger" : "alert-info";
+  const icon = type === "success" ? "fa-check-circle" : type === "error" ? "fa-exclamation-circle" : "fa-info-circle";
+  const notification = $(`
+    <div class="alert ${alertClass} alert-dismissible fade show" role="alert" style="min-width: 300px;">
+      <i class="fas ${icon} me-2"></i>${message}
+      <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
+    </div>
+  `);
+  $("#notificationPanel").append(notification);
+  // Auto-dismiss after 3 seconds
+  setTimeout(() => {
+    notification.alert('close');
+  }, 3000);
+}
+/*************************************** Route Highlighting **************************************/
+function toggleVehicleHighlight(vehicleId) {
+  if (highlightedVehicleId === vehicleId) {
+    // Already highlighted - clear it
+    clearRouteHighlight();
+  } else {
+    // Highlight this vehicle's route
+    highlightVehicleRoute(vehicleId);
+  }
+}
+function clearRouteHighlight() {
+  // Remove number markers
+  routeNumberMarkers.forEach(marker => map.removeLayer(marker));
+  routeNumberMarkers = [];
+  // Reset all vehicle icons to normal and restore opacity
+  if (loadedRoutePlan) {
+    loadedRoutePlan.vehicles.forEach(vehicle => {
+      const marker = homeLocationMarkerByIdMap.get(vehicle.id);
+      if (marker) {
+        marker.setIcon(createVehicleHomeIcon(vehicle, false));
+        marker.setOpacity(1);
+      }
+    });
+    // Reset all visit markers to normal and restore opacity
+    loadedRoutePlan.visits.forEach(visit => {
+      const marker = visitMarkerByIdMap.get(visit.id);
+      if (marker) {
+        const customerType = getCustomerType(visit);
+        const isAssigned = visit.vehicle != null;
+        marker.setIcon(createCustomerTypeIcon(customerType, isAssigned, false));
+        marker.setOpacity(1);
+      }
+    });
+  }
+  // Reset route lines
+  renderRouteLines();
+  // Update vehicle table highlighting
+  $("#vehicles tr").removeClass("table-active");
+  highlightedVehicleId = null;
+}
+function highlightVehicleRoute(vehicleId) {
+  // Clear any existing highlight first
+  clearRouteHighlight();
+  highlightedVehicleId = vehicleId;
+  if (!loadedRoutePlan) return;
+  const vehicle = loadedRoutePlan.vehicles.find(v => v.id === vehicleId);
+  if (!vehicle) return;
+  const vehicleColor = colorByVehicle(vehicle);
+  // Highlight the vehicle's home marker
+  const homeMarker = homeLocationMarkerByIdMap.get(vehicleId);
+  if (homeMarker) {
+    homeMarker.setIcon(createVehicleHomeIcon(vehicle, true));
+  }
+  // Dim other vehicles
+  loadedRoutePlan.vehicles.forEach(v => {
+    if (v.id !== vehicleId) {
+      const marker = homeLocationMarkerByIdMap.get(v.id);
+      if (marker) {
+        marker.setIcon(createVehicleHomeIcon(v, false));
+        marker.setOpacity(0.3);
+      }
+    }
+  });
+  // Get visit order for this vehicle
+  const visitByIdMap = new Map(loadedRoutePlan.visits.map(v => [v.id, v]));
+  const vehicleVisits = vehicle.visits.map(visitId => visitByIdMap.get(visitId)).filter(v => v);
+  // Highlight and number the visits on this route
+  let stopNumber = 1;
+  vehicleVisits.forEach(visit => {
+    const marker = visitMarkerByIdMap.get(visit.id);
+    if (marker) {
+      const customerType = getCustomerType(visit);
+      marker.setIcon(createCustomerTypeIcon(customerType, true, true, vehicleColor));
+      marker.setOpacity(1);
+      // Add number marker
+      const numberMarker = L.marker(visit.location, {
+        icon: createRouteNumberIcon(stopNumber, vehicleColor),
+        interactive: false,
+        zIndexOffset: 1000
+      });
+      numberMarker.addTo(map);
+      routeNumberMarkers.push(numberMarker);
+      stopNumber++;
+    }
+  });
+  // Dim visits not on this route
+  loadedRoutePlan.visits.forEach(visit => {
+    if (!vehicle.visits.includes(visit.id)) {
+      const marker = visitMarkerByIdMap.get(visit.id);
+      if (marker) {
+        marker.setOpacity(0.25);
+      }
+    }
+  });
+  // Highlight just this route, dim others
+  renderRouteLines(vehicleId);
+  // Highlight the row in the vehicle table
+  $("#vehicles tr").removeClass("table-active");
+  $(`#vehicle-row-${vehicleId}`).addClass("table-active");
+  // Add start marker (S) at depot
+  const startMarker = L.marker(vehicle.homeLocation, {
+    icon: createRouteNumberIcon("S", vehicleColor),
+    interactive: false,
+    zIndexOffset: 1000
+  });
+  startMarker.addTo(map);
+  routeNumberMarkers.push(startMarker);
+}
+function createRouteNumberIcon(number, color) {
+  return L.divIcon({
+    className: 'route-number-marker',
+    html: `<div style="
+      background-color: ${color};
+      color: white;
+      font-weight: bold;
+      font-size: 12px;
+      width: 22px;
+      height: 22px;
+      border-radius: 50%;
+      border: 2px solid white;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      box-shadow: 0 2px 4px rgba(0,0,0,0.4);
+      margin-left: 16px;
+      margin-top: -28px;
+    ">${number}</div>`,
+    iconSize: [22, 22],
+    iconAnchor: [0, 0]
+  });
+}
+async function renderRouteLines(highlightedId = null) {
+  routeGroup.clearLayers();
+  if (!loadedRoutePlan) return;
+  // Fetch geometries during solving (routes change)
+  if (scheduleId) {
+    routeGeometries = await fetchRouteGeometries();
+  }
+  const visitByIdMap = new Map(loadedRoutePlan.visits.map(visit => [visit.id, visit]));
+  for (let vehicle of loadedRoutePlan.vehicles) {
+    const homeLocation = vehicle.homeLocation;
+    const locations = vehicle.visits.map(visitId => visitByIdMap.get(visitId)?.location).filter(l => l);
+    const isHighlighted = highlightedId === null || vehicle.id === highlightedId;
+    const color = colorByVehicle(vehicle);
+    const weight = isHighlighted && highlightedId !== null ? 5 : 3;
+    const opacity = isHighlighted ? 1 : 0.2;
+    const vehicleGeometry = routeGeometries?.[vehicle.id];
+    if (vehicleGeometry && vehicleGeometry.length > 0) {
+      // Draw real road routes using decoded polylines
+      for (const encodedSegment of vehicleGeometry) {
+        if (encodedSegment) {
+          const points = decodePolyline(encodedSegment);
+          if (points.length > 0) {
+            L.polyline(points, {
+              color: color,
+              weight: weight,
+              opacity: opacity
+            }).addTo(routeGroup);
+          }
+        }
+      }
+    } else if (locations.length > 0) {
+      // Fallback to straight lines if no geometry available
+      L.polyline([homeLocation, ...locations, homeLocation], {
+        color: color,
+        weight: weight,
+        opacity: opacity
+      }).addTo(routeGroup);
+    }
+  }
+}
+function colorByVehicle(vehicle) {
+  return vehicle === null ? null : pickColor("vehicle" + vehicle.id);
+}
+// Customer type definitions matching demo_data.py
+const CUSTOMER_TYPES = {
+  RESTAURANT: { label: "Restaurant", icon: "fa-utensils", color: "#f59e0b", windowStart: "06:00", windowEnd: "10:00", minService: 20, maxService: 40 },
+  BUSINESS: { label: "Business", icon: "fa-building", color: "#3b82f6", windowStart: "09:00", windowEnd: "17:00", minService: 15, maxService: 30 },
+  RESIDENTIAL: { label: "Residential", icon: "fa-home", color: "#10b981", windowStart: "17:00", windowEnd: "20:00", minService: 5, maxService: 10 },
+};
+function getCustomerType(visit) {
+  const startTime = showTimeOnly(visit.minStartTime).toString();
+  const endTime = showTimeOnly(visit.maxEndTime).toString();
+  for (const [type, config] of Object.entries(CUSTOMER_TYPES)) {
+    if (startTime === config.windowStart && endTime === config.windowEnd) {
+      return { type, ...config };
+    }
+  }
+  return { type: "UNKNOWN", label: "Custom", icon: "fa-question", color: "#6b7280", windowStart: startTime, windowEnd: endTime };
+}
+function formatDrivingTime(drivingTimeInSeconds) {
+  return `${Math.floor(drivingTimeInSeconds / 3600)}h ${Math.round((drivingTimeInSeconds % 3600) / 60)}m`;
+}
+function homeLocationPopupContent(vehicle) {
+  const color = colorByVehicle(vehicle);
+  const visitCount = vehicle.visits ? vehicle.visits.length : 0;
+  const vehicleName = vehicle.name || `Vehicle ${vehicle.id}`;
+  return `<div style="min-width: 150px;">
+    <h5 style="color: ${color};"><i class="fas fa-truck"></i> ${vehicleName}</h5>
+    <p class="mb-1"><strong>Depot Location</strong></p>
+    <p class="mb-1"><i class="fas fa-box"></i> Capacity: ${vehicle.capacity}</p>
+    <p class="mb-1"><i class="fas fa-route"></i> Visits: ${visitCount}</p>
+    <p class="mb-0"><i class="fas fa-clock"></i> Departs: ${showTimeOnly(vehicle.departureTime)}</p>
+  </div>`;
+}
+function visitPopupContent(visit) {
+  const customerType = getCustomerType(visit);
+  const serviceDurationMinutes = Math.round(visit.serviceDuration / 60);
+  const arrival = visit.arrivalTime
+    ? `<h6>Arrival at ${showTimeOnly(visit.arrivalTime)}.</h6>`
+    : "";
+  return `<h5><i class="fas ${customerType.icon}" style="color: ${customerType.color}"></i> ${visit.name}</h5>
+    <h6><span class="badge" style="background-color: ${customerType.color}">${customerType.label}</span></h6>
+    <h6>Cargo: ${visit.demand} units</h6>
+    <h6>Service time: ${serviceDurationMinutes} min</h6>
+    <h6>Window: ${showTimeOnly(visit.minStartTime)} - ${showTimeOnly(visit.maxEndTime)}</h6>
+    ${arrival}`;
+}
+function showTimeOnly(localDateTimeString) {
+  return JSJoda.LocalDateTime.parse(localDateTimeString).toLocalTime();
+}
+function createVehicleHomeIcon(vehicle, isHighlighted = false) {
+  const color = colorByVehicle(vehicle);
+  const size = isHighlighted ? 36 : 28;
+  const fontSize = isHighlighted ? 14 : 11;
+  const borderWidth = isHighlighted ? 4 : 3;
+  const shadow = isHighlighted
+    ? `0 0 0 4px ${color}40, 0 4px 8px rgba(0,0,0,0.5)`
+    : '0 2px 4px rgba(0,0,0,0.4)';
+  return L.divIcon({
+    className: 'vehicle-home-marker',
+    html: `<div style="
+      background-color: ${color};
+      border: ${borderWidth}px solid white;
+      border-radius: 50%;
+      width: ${size}px;
+      height: ${size}px;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      box-shadow: ${shadow};
+      transition: all 0.2s ease;
+    "><i class="fas fa-truck" style="color: white; font-size: ${fontSize}px;"></i></div>`,
+    iconSize: [size, size],
+    iconAnchor: [size/2, size/2],
+    popupAnchor: [0, -size/2]
+  });
+}
+function getHomeLocationMarker(vehicle) {
+  let marker = homeLocationMarkerByIdMap.get(vehicle.id);
+  if (marker) {
+    marker.setIcon(createVehicleHomeIcon(vehicle));
+    return marker;
+  }
+  marker = L.marker(vehicle.homeLocation, {
+    icon: createVehicleHomeIcon(vehicle)
+  });
+  marker.addTo(homeLocationGroup).bindPopup();
+  homeLocationMarkerByIdMap.set(vehicle.id, marker);
+  return marker;
+}
+function createCustomerTypeIcon(customerType, isAssigned = false, isHighlighted = false, highlightColor = null) {
+  const borderColor = isHighlighted && highlightColor
+    ? highlightColor
+    : (isAssigned ? customerType.color : '#6b7280');
+  const size = isHighlighted ? 38 : 32;
+  const fontSize = isHighlighted ? 16 : 14;
+  const borderWidth = isHighlighted ? 4 : 3;
+  const shadow = isHighlighted
+    ? `0 0 0 4px ${highlightColor}40, 0 4px 8px rgba(0,0,0,0.4)`
+    : '0 2px 4px rgba(0,0,0,0.3)';
+  return L.divIcon({
+    className: 'customer-marker',
+    html: `<div style="
+      background-color: white;
+      border: ${borderWidth}px solid ${borderColor};
+      border-radius: 50%;
+      width: ${size}px;
+      height: ${size}px;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      box-shadow: ${shadow};
+      transition: all 0.2s ease;
+    "><i class="fas ${customerType.icon}" style="color: ${customerType.color}; font-size: ${fontSize}px;"></i></div>`,
+    iconSize: [size, size],
+    iconAnchor: [size/2, size/2],
+    popupAnchor: [0, -size/2]
+  });
+}
+function getVisitMarker(visit) {
+  let marker = visitMarkerByIdMap.get(visit.id);
+  const customerType = getCustomerType(visit);
+  const isAssigned = visit.vehicle != null;
+  if (marker) {
+    // Update icon if assignment status changed
+    marker.setIcon(createCustomerTypeIcon(customerType, isAssigned));
+    return marker;
+  }
+  marker = L.marker(visit.location, {
+    icon: createCustomerTypeIcon(customerType, isAssigned)
+  });
+  marker.addTo(visitGroup).bindPopup();
+  visitMarkerByIdMap.set(visit.id, marker);
+  return marker;
+}
+async function renderRoutes(solution) {
+  if (!initialized) {
+    const bounds = [solution.southWestCorner, solution.northEastCorner];
+    map.fitBounds(bounds);
+  }
+  // Vehicles
+  vehiclesTable.children().remove();
+  const canRemove = solution.vehicles.length > 1;
+  solution.vehicles.forEach(function (vehicle) {
+    getHomeLocationMarker(vehicle).setPopupContent(
+      homeLocationPopupContent(vehicle),
+    );
+    const { id, capacity, totalDemand, totalDrivingTimeSeconds } = vehicle;
+    const percentage = Math.min((totalDemand / capacity) * 100, 100);
+    const overCapacity = totalDemand > capacity;
+    const color = colorByVehicle(vehicle);
+    const progressBarColor = overCapacity ? 'bg-danger' : '';
+    const isHighlighted = highlightedVehicleId === id;
+    const visitCount = vehicle.visits ? vehicle.visits.length : 0;
+    const vehicleName = vehicle.name || `Vehicle ${id}`;
+    vehiclesTable.append(`
+      <tr id="vehicle-row-${id}" class="vehicle-row ${isHighlighted ? 'table-active' : ''}" style="cursor: pointer;">
+        <td onclick="toggleVehicleHighlight('${id}')">
+          <div style="background-color: ${color}; width: 1.5rem; height: 1.5rem; border-radius: 50%; display: flex; align-items: center; justify-content: center; ${isHighlighted ? 'box-shadow: 0 0 0 3px ' + color + '40;' : ''}">
+            <i class="fas fa-truck" style="color: white; font-size: 0.65rem;"></i>
+          </div>
+        </td>
+        <td onclick="toggleVehicleHighlight('${id}')">
+          <strong>${vehicleName}</strong>
+          <br><small class="text-muted">${visitCount} stops</small>
+        </td>
+        <td onclick="toggleVehicleHighlight('${id}')">
+          <div class="progress" style="height: 18px;" data-bs-toggle="tooltip" data-bs-placement="left"
+            title="Cargo: ${totalDemand} / Capacity: ${capacity}${overCapacity ? ' (OVER CAPACITY!)' : ''}">
+            <div class="progress-bar ${progressBarColor}" role="progressbar" style="width: ${percentage}%; font-size: 0.7rem; transition: width 0.3s ease;">
+              ${totalDemand}/${capacity}
+            </div>
+          </div>
+        </td>
+        <td onclick="toggleVehicleHighlight('${id}')" style="font-size: 0.85rem;">
+          ${formatDrivingTime(totalDrivingTimeSeconds)}
+        </td>
+        <td>
+          ${canRemove ? `<button class="btn btn-sm btn-outline-danger p-0 px-1" onclick="event.stopPropagation(); removeVehicle('${id}')" title="Remove vehicle ${vehicleName}">
+            <i class="fas fa-times" style="font-size: 0.7rem;"></i>
+          </button>` : ''}
+        </td>
+      </tr>`);
+  });
+  // Visits
+  solution.visits.forEach(function (visit) {
+    getVisitMarker(visit).setPopupContent(visitPopupContent(visit));
+  });
+  // Route - use the dedicated function which handles highlighting (await to ensure geometries load)
+  await renderRouteLines(highlightedVehicleId);
+  // Summary
+  $("#score").text(solution.score ? `Score: ${solution.score}` : "Score: ?");
+  $("#drivingTime").text(formatDrivingTime(solution.totalDrivingTimeSeconds));
+}
+function renderTimelines(routePlan) {
+  byVehicleGroupData.clear();
+  byVisitGroupData.clear();
+  byVehicleItemData.clear();
+  byVisitItemData.clear();
+  // Build lookup maps for O(1) access
+  const vehicleById = new Map(routePlan.vehicles.map(v => [v.id, v]));
+  const visitById = new Map(routePlan.visits.map(v => [v.id, v]));
+  const visitOrderMap = new Map();
+  // Build stop order for each visit
+  routePlan.vehicles.forEach(vehicle => {
+    vehicle.visits.forEach((visitId, index) => {
+      visitOrderMap.set(visitId, index + 1);
+    });
+  });
+  // Vehicle groups with names and status summary
+  $.each(routePlan.vehicles, function (index, vehicle) {
+    const vehicleName = vehicle.name || `Vehicle ${vehicle.id}`;
+    const { totalDemand, capacity } = vehicle;
+    const percentage = Math.min((totalDemand / capacity) * 100, 100);
+    const overCapacity = totalDemand > capacity;
+    // Count late visits for this vehicle
+    const vehicleVisits = vehicle.visits.map(id => visitById.get(id)).filter(v => v);
+    const lateCount = vehicleVisits.filter(v => {
+      if (!v.departureTime) return false;
+      const departure = JSJoda.LocalDateTime.parse(v.departureTime);
+      const maxEnd = JSJoda.LocalDateTime.parse(v.maxEndTime);
+      return departure.isAfter(maxEnd);
+    }).length;
+    const statusIcon = lateCount > 0
+      ? `<i class="fas fa-exclamation-triangle timeline-status-late timeline-status-icon" title="${lateCount} late"></i>`
+      : vehicle.visits.length > 0
+        ? `<i class="fas fa-check-circle timeline-status-ontime timeline-status-icon" title="All on-time"></i>`
+        : '';
+    const progressBarClass = overCapacity ? 'bg-danger' : '';
+    const vehicleWithLoad = `
+      <h5 class="card-title mb-1">${vehicleName}${statusIcon}</h5>
+      <div class="progress" style="height: 16px;" title="Cargo: ${totalDemand} / ${capacity}">
+        <div class="progress-bar ${progressBarClass}" role="progressbar" style="width: ${percentage}%">
+          ${totalDemand}/${capacity}
+        </div>
+      </div>`;
+    byVehicleGroupData.add({ id: vehicle.id, content: vehicleWithLoad });
+  });
+  $.each(routePlan.visits, function (index, visit) {
+    const minStartTime = JSJoda.LocalDateTime.parse(visit.minStartTime);
+    const maxEndTime = JSJoda.LocalDateTime.parse(visit.maxEndTime);
+    const serviceDuration = JSJoda.Duration.ofSeconds(visit.serviceDuration);
+    const customerType = getCustomerType(visit);
+    const stopNumber = visitOrderMap.get(visit.id);
+    const visitGroupElement = $(`<div/>`).append(
+      $(`<h5 class="card-title mb-1"/>`).html(
+        `<i class="fas ${customerType.icon}" style="color: ${customerType.color}"></i> ${visit.name}`
+      ),
+    ).append(
+      $(`<small class="text-muted"/>`).text(customerType.label)
+    );
+    byVisitGroupData.add({
+      id: visit.id,
+      content: visitGroupElement.html(),
+    });
+    // Time window per visit.
+    byVisitItemData.add({
+      id: visit.id + "_readyToDue",
+      group: visit.id,
+      start: visit.minStartTime,
+      end: visit.maxEndTime,
+      type: "background",
+      style: "background-color: #8AE23433",
+    });
+    if (visit.vehicle == null) {
+      const byJobJobElement = $(`<div/>`).append(
+        $(`<span/>`).html(`<i class="fas fa-exclamation-circle text-danger me-1"></i>Unassigned`),
+      );
+      // Unassigned are shown at the beginning of the visit's time window; the length is the service duration.
+      byVisitItemData.add({
+        id: visit.id + "_unassigned",
+        group: visit.id,
+        content: byJobJobElement.html(),
+        start: minStartTime.toString(),
+        end: minStartTime.plus(serviceDuration).toString(),
+        style: "background-color: #EF292999",
+      });
+    } else {
+      const arrivalTime = JSJoda.LocalDateTime.parse(visit.arrivalTime);
+      const beforeReady = arrivalTime.isBefore(minStartTime);
+      const departureTime = JSJoda.LocalDateTime.parse(visit.departureTime);
+      const afterDue = departureTime.isAfter(maxEndTime);
+      // Get vehicle info for display
+      const vehicleInfo = vehicleById.get(visit.vehicle);
+      const vehicleName = vehicleInfo ? (vehicleInfo.name || `Vehicle ${visit.vehicle}`) : `Vehicle ${visit.vehicle}`;
+      // Stop badge for service segment
+      const stopBadge = stopNumber ? `<span class="timeline-stop-badge">${stopNumber}</span>` : '';
+      // Status icon based on timing
+      const statusIcon = afterDue
+        ? `<i class="fas fa-exclamation-triangle timeline-status-late timeline-status-icon" title="Late"></i>`
+        : `<i class="fas fa-check timeline-status-ontime timeline-status-icon" title="On-time"></i>`;
+      const byVehicleElement = $(`<div/>`)
+        .append($(`<span/>`).html(
+          `${stopBadge}<i class="fas ${customerType.icon}" style="color: ${customerType.color}"></i> ${visit.name}${statusIcon}`
+        ));
+      const byVisitElement = $(`<div/>`)
+        .append(
+          $(`<span/>`).html(
+            `${stopBadge}${vehicleName}${statusIcon}`
+          ),
+        );
+      const byVehicleTravelElement = $(`<div/>`).append(
+        $(`<span/>`).html(`<i class="fas fa-route text-warning me-1"></i>Travel`),
+      );
+      const previousDeparture = arrivalTime.minusSeconds(
+        visit.drivingTimeSecondsFromPreviousStandstill,
+      );
+      byVehicleItemData.add({
+        id: visit.id + "_travel",
+        group: visit.vehicle,
+        subgroup: visit.vehicle,
+        content: byVehicleTravelElement.html(),
+        start: previousDeparture.toString(),
+        end: visit.arrivalTime,
+        style: "background-color: #f7dd8f90",
+      });
+      if (beforeReady) {
+        const byVehicleWaitElement = $(`<div/>`).append(
+          $(`<span/>`).html(`<i class="fas fa-clock timeline-status-early me-1"></i>Wait`),
+        );
+        byVehicleItemData.add({
+          id: visit.id + "_wait",
+          group: visit.vehicle,
+          subgroup: visit.vehicle,
+          content: byVehicleWaitElement.html(),
+          start: visit.arrivalTime,
+          end: visit.minStartTime,
+          style: "background-color: #93c5fd80",
+        });
+      }
+      let serviceElementBackground = afterDue ? "#EF292999" : "#83C15955";
+      byVehicleItemData.add({
+        id: visit.id + "_service",
+        group: visit.vehicle,
+        subgroup: visit.vehicle,
+        content: byVehicleElement.html(),
+        start: visit.startServiceTime,
+        end: visit.departureTime,
+        style: "background-color: " + serviceElementBackground,
+      });
+      byVisitItemData.add({
+        id: visit.id,
+        group: visit.id,
+        content: byVisitElement.html(),
+        start: visit.startServiceTime,
+        end: visit.departureTime,
+        style: "background-color: " + serviceElementBackground,
+      });
+    }
+  });
+  $.each(routePlan.vehicles, function (index, vehicle) {
+    if (vehicle.visits.length > 0) {
+      let lastVisit = routePlan.visits
+        .filter(
+          (visit) => visit.id == vehicle.visits[vehicle.visits.length - 1],
+        )
+        .pop();
+      if (lastVisit) {
+        byVehicleItemData.add({
+          id: vehicle.id + "_travelBackToHomeLocation",
+          group: vehicle.id,
+          subgroup: vehicle.id,
+          content: $(`<div/>`)
+            .append($(`<span/>`).html(`<i class="fas fa-home text-secondary me-1"></i>Return`))
+            .html(),
+          start: lastVisit.departureTime,
+          end: vehicle.arrivalTime,
+          style: "background-color: #f7dd8f90",
+        });
+      }
+    }
+  });
+  if (!initialized) {
+    if (byVehicleTimeline) {
+      byVehicleTimeline.setWindow(
+        routePlan.startDateTime,
+        routePlan.endDateTime,
+      );
+    }
+    if (byVisitTimeline) {
+      byVisitTimeline.setWindow(routePlan.startDateTime, routePlan.endDateTime);
+    }
+  }
+}
+function analyze() {
+  // see score-analysis.js
+  analyzeScore(loadedRoutePlan, "/route-plans/analyze");
+}
+function openRecommendationModal(lat, lng) {
+  if (!('score' in loadedRoutePlan) || optimizing) {
+    map.removeLayer(visitMarker);
+    visitMarker = null;
+    let message = "Please click the Solve button before adding new visits.";
+    if (optimizing) {
+      message = "Please wait for the solving process to finish.";
+    }
+    alert(message);
+    return;
+  }
+  // see recommended-fit.js
+  const visitId = Math.max(...loadedRoutePlan.visits.map(c => parseInt(c.id))) + 1;
+  newVisit = {id: visitId, location: [lat, lng]};
+  addNewVisit(visitId, lat, lng, map, visitMarker);
+}
+function getRecommendationsModal() {
+  let formValid = true;
+  formValid = validateFormField(newVisit, 'name', '#inputName') && formValid;
+  formValid = validateFormField(newVisit, 'demand', '#inputDemand') && formValid;
+  formValid = validateFormField(newVisit, 'minStartTime', '#inputMinStartTime') && formValid;
+  formValid = validateFormField(newVisit, 'maxEndTime', '#inputMaxStartTime') && formValid;
+  formValid = validateFormField(newVisit, 'serviceDuration', '#inputDuration') && formValid;
+  if (formValid) {
+    const updatedMinStartTime = JSJoda.LocalDateTime.parse(
+      newVisit['minStartTime'],
+      JSJoda.DateTimeFormatter.ofPattern('yyyy-M-d HH:mm')
+    ).format(JSJoda.DateTimeFormatter.ISO_LOCAL_DATE_TIME);
+    const updatedMaxEndTime = JSJoda.LocalDateTime.parse(
+      newVisit['maxEndTime'],
+      JSJoda.DateTimeFormatter.ofPattern('yyyy-M-d HH:mm')
+    ).format(JSJoda.DateTimeFormatter.ISO_LOCAL_DATE_TIME);
+    const updatedVisit = {
+      ...newVisit,
+      serviceDuration: parseInt(newVisit['serviceDuration']) * 60, // Convert minutes to seconds
+      minStartTime: updatedMinStartTime,
+      maxEndTime: updatedMaxEndTime
+    };
+    let updatedVisitList = [...loadedRoutePlan['visits']];
+    updatedVisitList.push(updatedVisit);
+    let updatedSolution = {...loadedRoutePlan, visits: updatedVisitList};
+    // see recommended-fit.js
+    requestRecommendations(updatedVisit.id, updatedSolution, "/route-plans/recommendation");
+  }
+}
+function validateFormField(target, fieldName, inputName) {
+  target[fieldName] = $(inputName).val();
+  if ($(inputName).val() == "") {
+    $(inputName).addClass("is-invalid");
+  } else {
+    $(inputName).removeClass("is-invalid");
+  }
+  return $(inputName).val() != "";
+}
+function applyRecommendationModal(recommendations) {
+  let checkedRecommendation = null;
+  recommendations.forEach((recommendation, index) => {
+    if ($('#option' + index).is(":checked")) {
+      checkedRecommendation = recommendations[index];
+    }
+  });
+  if (!checkedRecommendation) {
+    alert("Please select a recommendation.");
+    return;
+  }
+  const updatedMinStartTime = JSJoda.LocalDateTime.parse(
+    newVisit['minStartTime'],
+    JSJoda.DateTimeFormatter.ofPattern('yyyy-M-d HH:mm')
+  ).format(JSJoda.DateTimeFormatter.ISO_LOCAL_DATE_TIME);
+  const updatedMaxEndTime = JSJoda.LocalDateTime.parse(
+    newVisit['maxEndTime'],
+    JSJoda.DateTimeFormatter.ofPattern('yyyy-M-d HH:mm')
+  ).format(JSJoda.DateTimeFormatter.ISO_LOCAL_DATE_TIME);
+  const updatedVisit = {
+    ...newVisit,
+    serviceDuration: parseInt(newVisit['serviceDuration']) * 60, // Convert minutes to seconds
+    minStartTime: updatedMinStartTime,
+    maxEndTime: updatedMaxEndTime
+  };
+  let updatedVisitList = [...loadedRoutePlan['visits']];
+  updatedVisitList.push(updatedVisit);
+  let updatedSolution = {...loadedRoutePlan, visits: updatedVisitList};
+  // see recommended-fit.js
+  applyRecommendation(
+    updatedSolution,
+    newVisit.id,
+    checkedRecommendation.proposition.vehicleId,
+    checkedRecommendation.proposition.index,
+    "/route-plans/recommendation/apply"
+  );
+}
+async function updateSolutionWithNewVisit(newSolution) {
+  loadedRoutePlan = newSolution;
+  await renderRoutes(newSolution);
+  renderTimelines(newSolution);
+  $('#newVisitModal').modal('hide');
+}
+// TODO: move the general functionality to the webjar.
+function setupAjax() {
+  $.ajaxSetup({
+    headers: {
+      "Content-Type": "application/json",
+      Accept: "application/json,text/plain", // plain text is required by solve() returning UUID of the solver job
+    },
+  });
+  // Extend jQuery to support $.put() and $.delete()
+  jQuery.each(["put", "delete"], function (i, method) {
+    jQuery[method] = function (url, data, callback, type) {
+      if (jQuery.isFunction(data)) {
+        type = type || callback;
+        callback = data;
+        data = undefined;
+      }
+      return jQuery.ajax({
+        url: url,
+        type: method,
+        dataType: type,
+        data: data,
+        success: callback,
+      });
+    };
+  });
+}
+function solve() {
+  // Clear geometry cache - will be refreshed when solution updates
+  routeGeometries = null;
+  // Disable button immediately to prevent double-clicks
+  $("#solveButton").prop("disabled", true).addClass("disabled");
+  $.ajax({
+    url: "/route-plans",
+    type: "POST",
+    data: JSON.stringify(loadedRoutePlan),
+    contentType: "application/json",
+    dataType: "text",
+    success: function (data) {
+      scheduleId = data.replace(/"/g, ""); // Remove quotes from UUID
+      $("#solveButton").prop("disabled", false).removeClass("disabled");
+      refreshSolvingButtons(true);
+    },
+    error: function (xhr, ajaxOptions, thrownError) {
+      showError("Start solving failed.", xhr);
+      $("#solveButton").prop("disabled", false).removeClass("disabled");
+      refreshSolvingButtons(false);
+    },
+  });
+}
+function refreshSolvingButtons(solving) {
+  optimizing = solving;
+  if (solving) {
+    $("#solveButton").hide();
+    $("#visitButton").hide();
+    $("#stopSolvingButton").show();
+    $("#solvingSpinner").addClass("active");
+    $("#mapHint").addClass("hidden");
+    if (autoRefreshIntervalId == null) {
+      autoRefreshIntervalId = setInterval(refreshRoutePlan, 2000);
+    }
+  } else {
+    $("#solveButton").show();
+    $("#visitButton").show();
+    $("#stopSolvingButton").hide();
+    $("#solvingSpinner").removeClass("active");
+    $("#mapHint").removeClass("hidden");
+    if (autoRefreshIntervalId != null) {
+      clearInterval(autoRefreshIntervalId);
+      autoRefreshIntervalId = null;
+    }
+  }
+}
+async function refreshRoutePlan() {
+  let path = "/route-plans/" + scheduleId;
+  let isLoadingDemoData = scheduleId === null;
+  if (isLoadingDemoData) {
+    if (demoDataId === null) {
+      alert("Please select a test data set.");
+      return;
+    }
+    // Clear geometry cache when loading new demo data
+    routeGeometries = null;
+    try {
+      let routePlan;
+      if (useRealRoads) {
+        // Use SSE streaming for real roads to show progress
+        routePlan = await loadDemoDataWithProgress(demoDataId);
+      } else {
+        // Use simple GET for haversine (instant, no loading overlay)
+        routePlan = await $.getJSON(`/demo-data/${demoDataId}`);
+      }
+      loadedRoutePlan = routePlan;
+      refreshSolvingButtons(
+        routePlan.solverStatus != null &&
+          routePlan.solverStatus !== "NOT_SOLVING",
+      );
+      await renderRoutes(routePlan);
+      renderTimelines(routePlan);
+      initialized = true;
+    } catch (error) {
+      showError("Getting demo data has failed: " + error.message, {});
+      refreshSolvingButtons(false);
+    }
+    return;
+  }
+  // Loading existing route plan (during solving)
+  try {
+    const routePlan = await $.getJSON(path);
+    loadedRoutePlan = routePlan;
+    refreshSolvingButtons(
+      routePlan.solverStatus != null &&
+        routePlan.solverStatus !== "NOT_SOLVING",
+    );
+    await renderRoutes(routePlan);
+    renderTimelines(routePlan);
+    initialized = true;
+  } catch (error) {
+    showError("Getting route plan has failed.", error);
+    refreshSolvingButtons(false);
+  }
+}
+function stopSolving() {
+  $.delete("/route-plans/" + scheduleId, function () {
+    refreshSolvingButtons(false);
+    refreshRoutePlan();
+  }).fail(function (xhr, ajaxOptions, thrownError) {
+    showError("Stop solving failed.", xhr);
+  });
+}
+function fetchDemoData() {
+  $.get("/demo-data", function (data) {
+    data.forEach(function (item) {
+      $("#testDataButton").append(
+        $(
+          '<a id="' +
+            item +
+            'TestData" class="dropdown-item" href="#">' +
+            item +
+            "</a>",
+        ),
+      );
+      $("#" + item + "TestData").click(function () {
+        switchDataDropDownItemActive(item);
+        scheduleId = null;
+        demoDataId = item;
+        initialized = false;
+        homeLocationGroup.clearLayers();
+        homeLocationMarkerByIdMap.clear();
+        visitGroup.clearLayers();
+        visitMarkerByIdMap.clear();
+        refreshRoutePlan();
+      });
+    });
+    demoDataId = data[0];
+    switchDataDropDownItemActive(demoDataId);
+    refreshRoutePlan();
+  }).fail(function (xhr, ajaxOptions, thrownError) {
+    // disable this page as there is no data
+    $("#demo").empty();
+    $("#demo").html(
+      '<h1><p style="justify-content: center">No test data available</p></h1>',
+    );
+  });
+}
+function switchDataDropDownItemActive(newItem) {
+  activeCssClass = "active";
+  $("#testDataButton > a." + activeCssClass).removeClass(activeCssClass);
+  $("#" + newItem + "TestData").addClass(activeCssClass);
+}
+function copyTextToClipboard(id) {
+  var text = $("#" + id)
+    .text()
+    .trim();
+  var dummy = document.createElement("textarea");
+  document.body.appendChild(dummy);
+  dummy.value = text;
+  dummy.select();
+  document.execCommand("copy");
+  document.body.removeChild(dummy);
+}
+function replaceQuickstartSolverForgeAutoHeaderFooter() {
+  const solverforgeHeader = $("header#solverforge-auto-header");
+  if (solverforgeHeader != null) {
+    solverforgeHeader.css("background-color", "#ffffff");
+    solverforgeHeader.append(
+      $(`<div class="container-fluid">
+        <nav class="navbar sticky-top navbar-expand-lg shadow-sm mb-3" style="background-color: #ffffff;">
+          <a class="navbar-brand" href="https://www.solverforge.org">
+            <img src="/webjars/solverforge/img/solverforge-horizontal.svg" alt="SolverForge logo" width="400">
+          </a>
+          <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation">
+            <span class="navbar-toggler-icon"></span>
+          </button>
+          <div class="collapse navbar-collapse" id="navbarNav">
+            <ul class="nav nav-pills">
+              <li class="nav-item active" id="navUIItem">
+                <button class="nav-link active" id="navUI" data-bs-toggle="pill" data-bs-target="#demo" type="button" style="color: #1f2937;">Demo UI</button>
+              </li>
+              <li class="nav-item" id="navRestItem">
+                <button class="nav-link" id="navRest" data-bs-toggle="pill" data-bs-target="#rest" type="button" style="color: #1f2937;">Guide</button>
+              </li>
+              <li class="nav-item" id="navOpenApiItem">
+                <button class="nav-link" id="navOpenApi" data-bs-toggle="pill" data-bs-target="#openapi" type="button" style="color: #1f2937;">REST API</button>
+              </li>
+            </ul>
+          </div>
+          <div class="ms-auto d-flex align-items-center gap-3">
+              <div class="form-check form-switch d-flex align-items-center" data-bs-toggle="tooltip" data-bs-placement="bottom" title="Enable real road routing using OpenStreetMap data. Slower initial load (~5-15s for download), but shows accurate road routes instead of straight lines.">
+                  <input class="form-check-input" type="checkbox" id="realRoadRouting" checked style="width: 2.5em; height: 1.25em; cursor: pointer;">
+                  <label class="form-check-label ms-2" for="realRoadRouting" style="white-space: nowrap; cursor: pointer;">
+                      <i class="fas fa-road"></i> Real Roads
+                  </label>
+              </div>
+              <div class="dropdown">
+                  <button class="btn dropdown-toggle" type="button" id="dropdownMenuButton" data-bs-toggle="dropdown" aria-haspopup="true" aria-expanded="false" style="background-color: #10b981; color: #ffffff; border-color: #10b981;">
+                      Data
+                  </button>
+                  <div id="testDataButton" class="dropdown-menu" aria-labelledby="dropdownMenuButton"></div>
+              </div>
+          </div>
+        </nav>
+      </div>`),
+    );
+  }
+  const solverforgeFooter = $("footer#solverforge-auto-footer");
+  if (solverforgeFooter != null) {
+    solverforgeFooter.append(
+      $(`<footer class="bg-black text-white-50">
+               <div class="container">
+                 <div class="hstack gap-3 p-4">
+                   <div class="ms-auto"><a class="text-white" href="https://www.solverforge.org">SolverForge</a></div>
+                   <div class="vr"></div>
+                   <div><a class="text-white" href="https://www.solverforge.org/docs">Documentation</a></div>
+                   <div class="vr"></div>
+                   <div><a class="text-white" href="https://github.com/SolverForge/solverforge-legacy">Code</a></div>
+                   <div class="vr"></div>
+                   <div class="me-auto"><a class="text-white" href="mailto:info@solverforge.org">Support</a></div>
+                 </div>
+               </div>
+             </footer>`),
+    );
+  }
+}

static/index.html ADDED Viewed

	@@ -0,0 +1,473 @@

+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+  <title>Vehicle Routing - SolverForge for Rust</title>
+  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/bootstrap/5.3.3/css/bootstrap.min.css">
+  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/leaflet/1.9.4/leaflet.css">
+  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.5.2/css/all.min.css">
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/vis-timeline@7.7.2/styles/vis-timeline-graph2d.min.css"
+        integrity="sha256-svzNasPg1yR5gvEaRei2jg+n4Pc3sVyMUWeS6xRAh6U=" crossorigin="anonymous">
+  <link rel="stylesheet" href="/webjars/solverforge/css/solverforge-webui.css"/>
+  <link rel="icon" href="/webjars/solverforge/img/solverforge-favicon.svg" type="image/svg+xml">
+  <style>
+    /* Customer marker icons */
+    .customer-marker, .vehicle-home-marker, .temp-vehicle-marker {
+      background: transparent !important;
+      border: none !important;
+    }
+    /* Pulse animation for new vehicle placement */
+    @keyframes pulse {
+      0% { transform: scale(1); box-shadow: 0 2px 4px rgba(0,0,0,0.4); }
+      50% { transform: scale(1.1); box-shadow: 0 4px 8px rgba(99, 102, 241, 0.6); }
+      100% { transform: scale(1); box-shadow: 0 2px 4px rgba(0,0,0,0.4); }
+    }
+    /* Customer type buttons in modal */
+    .customer-type-btn {
+      transition: all 0.2s ease;
+      padding: 0.75rem 0.5rem;
+    }
+    .customer-type-btn:hover {
+      transform: translateY(-2px);
+      box-shadow: 0 4px 8px rgba(0,0,0,0.15);
+    }
+    /* Vehicle table styling */
+    #vehicles tr.vehicle-row {
+      transition: background-color 0.2s ease;
+    }
+    #vehicles tr.vehicle-row:hover {
+      background-color: rgba(99, 102, 241, 0.1);
+    }
+    #vehicles tr.vehicle-row.table-active {
+      background-color: rgba(99, 102, 241, 0.15) !important;
+    }
+    /* Route number markers */
+    .route-number-marker {
+      background: transparent !important;
+      border: none !important;
+    }
+    /* Notification panel */
+    #notificationPanel {
+      z-index: 1050;
+    }
+    /* Click hint for vehicle rows */
+    #vehicles tr.vehicle-row td:not(:last-child) {
+      cursor: pointer;
+    }
+    /* Solving spinner */
+    #solvingSpinner {
+      display: none;
+      width: 1.25rem;
+      height: 1.25rem;
+      border: 2px solid #10b981;
+      border-top-color: transparent;
+      border-radius: 50%;
+      animation: spin 0.75s linear infinite;
+      vertical-align: middle;
+    }
+    #solvingSpinner.active {
+      display: inline-block;
+    }
+    @keyframes spin {
+      to { transform: rotate(360deg); }
+    }
+    /* Progress bar text should stay horizontal and inside */
+    .progress-bar {
+      overflow: visible;
+      white-space: nowrap;
+    }
+    /* Map hint overlay */
+    .map-hint {
+      position: absolute;
+      bottom: 20px;
+      left: 50%;
+      transform: translateX(-50%);
+      background-color: rgba(255, 255, 255, 0.95);
+      padding: 8px 16px;
+      border-radius: 20px;
+      box-shadow: 0 2px 8px rgba(0,0,0,0.2);
+      font-size: 0.9rem;
+      color: #374151;
+      z-index: 1000;
+      pointer-events: none;
+      transition: opacity 0.3s ease;
+    }
+    .map-hint i {
+      color: #10b981;
+      margin-right: 6px;
+    }
+    .map-hint.hidden {
+      opacity: 0;
+    }
+    /* Timeline stop badges */
+    .timeline-stop-badge {
+      background-color: #6366f1;
+      color: white;
+      padding: 1px 6px;
+      border-radius: 10px;
+      font-size: 0.7rem;
+      font-weight: bold;
+      margin-right: 4px;
+    }
+    .timeline-status-icon {
+      margin-left: 4px;
+      font-size: 0.85rem;
+    }
+    .timeline-status-ontime { color: #10b981; }
+    .timeline-status-late { color: #ef4444; }
+    .timeline-status-early { color: #3b82f6; }
+    .vis-item .vis-item-content {
+      font-size: 0.85rem;
+      padding: 2px 4px;
+    }
+    .vis-labelset .vis-label {
+      padding: 4px 8px;
+    }
+    /* Loading overlay */
+    .loading-overlay {
+      position: fixed;
+      top: 0;
+      left: 0;
+      right: 0;
+      bottom: 0;
+      background: rgba(255, 255, 255, 0.95);
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      z-index: 2000;
+      transition: opacity 0.3s ease;
+    }
+    .loading-overlay.hidden {
+      opacity: 0;
+      pointer-events: none;
+    }
+    .loading-content {
+      text-align: center;
+      padding: 2rem;
+    }
+    .loading-spinner {
+      width: 60px;
+      height: 60px;
+      border: 4px solid #e5e7eb;
+      border-top-color: #10b981;
+      border-radius: 50%;
+      animation: spin 1s linear infinite;
+      margin: 0 auto 1.5rem;
+    }
+    @keyframes spin {
+      to { transform: rotate(360deg); }
+    }
+    /* Real Roads toggle styling */
+    #realRoadRouting:checked {
+      background-color: #10b981;
+      border-color: #10b981;
+    }
+  </style>
+</head>
+<body>
+<header id="solverforge-auto-header">
+  <!-- Filled in by app.js -->
+</header>
+<div class="tab-content">
+  <div id="demo" class="tab-pane fade show active container-fluid">
+    <div class="sticky-top d-flex justify-content-center align-items-center">
+      <div id="notificationPanel" style="position: absolute; top: .5rem;"></div>
+    </div>
+    <h1>Vehicle routing with capacity and time windows</h1>
+    <p>Generate optimal route plan of a vehicle fleet with limited vehicle capacity and time windows.</p>
+    <div class="container-fluid mb-2">
+      <div class="row justify-content-start">
+        <div class="col-9">
+          <ul class="nav nav-pills col" role="tablist">
+            <li class="nav-item" role="presentation">
+              <button class="nav-link active" id="mapTab" data-bs-toggle="tab" data-bs-target="#mapPanel"
+                      type="button"
+                      role="tab" aria-controls="mapPanel" aria-selected="false">Map
+              </button>
+            </li>
+            <li class="nav-item" role="presentation">
+              <button class="nav-link" id="byVehicleTab" data-bs-toggle="tab" data-bs-target="#byVehiclePanel"
+                      type="button" role="tab" aria-controls="byVehiclePanel" aria-selected="false">By vehicle
+              </button>
+            </li>
+            <li class="nav-item" role="presentation">
+              <button class="nav-link" id="byVisitTab" data-bs-toggle="tab" data-bs-target="#byVisitPanel"
+                      type="button" role="tab" aria-controls="byVisitPanel" aria-selected="false">By visit
+              </button>
+            </li>
+          </ul>
+        </div>
+        <div class="col-3">
+          <button id="solveButton" type="button" class="btn btn-success">
+            <i class="fas fa-play"></i> Solve
+          </button>
+          <button id="stopSolvingButton" type="button" class="btn btn-danger p-2">
+            <i class="fas fa-stop"></i> Stop solving
+          </button>
+          <span id="solvingSpinner" class="ms-2"></span>
+          <span id="score" class="score ms-2 align-middle fw-bold">Score: ?</span>
+          <button id="analyzeButton" type="button" class="ms-2 btn btn-secondary">
+            <span class="fas fa-question"></span>
+          </button>
+        </div>
+      </div>
+    </div>
+    <div class="tab-content">
+      <div class="tab-pane fade show active" id="mapPanel" role="tabpanel" aria-labelledby="mapTab">
+        <div class="row">
+          <div class="col-7 col-lg-8 col-xl-9 position-relative">
+            <div id="map" style="width: 100%; height: 100vh;"></div>
+            <div id="mapHint" class="map-hint">
+              <i class="fas fa-mouse-pointer"></i> Click on the map to add a new visit
+            </div>
+          </div>
+          <div class="col-5 col-lg-4 col-xl-3" style="height: 100vh; overflow-y: scroll;">
+            <div class="row pt-2 row-cols-1">
+              <div class="col">
+                <h5>
+                  Solution summary
+                </h5>
+                <table class="table">
+                  <tr>
+                    <td>Total driving time:</td>
+                    <td><span id="drivingTime">unknown</span></td>
+                  </tr>
+                </table>
+              </div>
+              <div class="col mb-3">
+                <h5>Time Windows</h5>
+                <div class="d-flex flex-column gap-1">
+                  <div><i class="fas fa-utensils" style="color: #f59e0b; width: 20px;"></i> <strong>Restaurant</strong> <small class="text-muted">06:00-10:00 · 20-40 min</small></div>
+                  <div><i class="fas fa-building" style="color: #3b82f6; width: 20px;"></i> <strong>Business</strong> <small class="text-muted">09:00-17:00 · 15-30 min</small></div>
+                  <div><i class="fas fa-home" style="color: #10b981; width: 20px;"></i> <strong>Residential</strong> <small class="text-muted">17:00-20:00 · 5-10 min</small></div>
+                </div>
+              </div>
+              <div class="col">
+                <div class="d-flex justify-content-between align-items-center mb-2">
+                  <div>
+                    <h5 class="mb-0">Vehicles</h5>
+                    <small class="text-muted"><i class="fas fa-hand-pointer"></i> Click to highlight route</small>
+                  </div>
+                  <div class="btn-group btn-group-sm" role="group" aria-label="Vehicle management">
+                    <button type="button" class="btn btn-outline-danger" id="removeVehicleBtn" title="Remove last vehicle">
+                      <i class="fas fa-minus"></i>
+                    </button>
+                    <button type="button" class="btn btn-outline-success" id="addVehicleBtn" title="Add new vehicle">
+                      <i class="fas fa-plus"></i>
+                    </button>
+                  </div>
+                </div>
+                <table class="table-sm w-100">
+                  <thead>
+                  <tr>
+                    <th class="col-1"></th>
+                    <th class="col-3">Name</th>
+                    <th class="col-3">
+                      Cargo
+                      <i class="fas fa-info-circle" data-bs-toggle="tooltip" data-bs-placement="top"
+                         data-html="true"
+                         title="Units to deliver on this route. Each customer requires cargo units (e.g., packages, crates). Bar shows current load vs. vehicle capacity."></i>
+                    </th>
+                    <th class="col-2">Drive</th>
+                    <th class="col-1"></th>
+                  </tr>
+                  </thead>
+                  <tbody id="vehicles"></tbody>
+                </table>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+      <div class="tab-pane fade" id="byVehiclePanel" role="tabpanel" aria-labelledby="byVehicleTab">
+      </div>
+      <div class="tab-pane fade" id="byVisitPanel" role="tabpanel" aria-labelledby="byVisitTab">
+      </div>
+    </div>
+  </div>
+  <div id="rest" class="tab-pane fade container-fluid">
+    <h1>REST API Guide</h1>
+    <h2>Vehicle routing with vehicle capacity and time windows - integration via cURL</h2>
+    <h3>1. Download demo data</h3>
+    <pre>
+              <button class="btn btn-outline-dark btn-sm float-end"
+                      onclick="copyTextToClipboard('curl1')">Copy</button>
+              <code id="curl1">curl -X GET -H 'Accept:application/json' http://localhost:8082/demo-data/FIRENZE -o sample.json</code>
+    </pre>
+    <h3>2. Post the sample data for solving</h3>
+    <p>The POST operation returns a <code>jobId</code> that should be used in subsequent commands.</p>
+    <pre>
+              <button class="btn btn-outline-dark btn-sm float-end"
+                      onclick="copyTextToClipboard('curl2')">Copy</button>
+              <code id="curl2">curl -X POST -H 'Content-Type:application/json' http://localhost:8082/route-plans -d@sample.json</code>
+    </pre>
+    <h3>3. Get the current status and score</h3>
+    <pre>
+              <button class="btn btn-outline-dark btn-sm float-end"
+                      onclick="copyTextToClipboard('curl3')">Copy</button>
+              <code id="curl3">curl -X GET -H 'Accept:application/json' http://localhost:8082/route-plans/{jobId}/status</code>
+    </pre>
+    <h3>4. Get the complete route plan</h3>
+    <pre>
+              <button class="btn btn-outline-dark btn-sm float-end"
+                      onclick="copyTextToClipboard('curl4')">Copy</button>
+              <code id="curl4">curl -X GET -H 'Accept:application/json' http://localhost:8082/route-plans/{jobId}</code>
+    </pre>
+    <h3>5. Terminate solving early</h3>
+    <pre>
+              <button class="btn btn-outline-dark btn-sm float-end"
+                      onclick="copyTextToClipboard('curl5')">Copy</button>
+              <code id="curl5">curl -X DELETE -H 'Accept:application/json' http://localhost:8082/route-plans/{jobId}</code>
+    </pre>
+  </div>
+  <div id="openapi" class="tab-pane fade container-fluid">
+    <h1>REST API Reference</h1>
+    <div class="ratio ratio-1x1">
+      <!-- "scrolling" attribute is obsolete, but e.g. Chrome does not support "overflow:hidden" -->
+      <iframe src="/q/swagger-ui" style="overflow:hidden;" scrolling="no"></iframe>
+    </div>
+  </div>
+</div>
+<div class="modal fadebd-example-modal-lg" id="scoreAnalysisModal" tabindex="-1" aria-labelledby="scoreAnalysisModalLabel" aria-hidden="true">
+  <div class="modal-dialog modal-lg modal-dialog-scrollable">
+    <div class="modal-content">
+      <div class="modal-header">
+        <h1 class="modal-title fs-5" id="scoreAnalysisModalLabel">Score analysis <span id="scoreAnalysisScoreLabel"></span></h1>
+        <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
+      </div>
+      <div class="modal-body" id="scoreAnalysisModalContent">
+        <!-- Filled in by app.js -->
+      </div>
+      <div class="modal-footer">
+        <button type="button" class="btn btn-primary" data-bs-dismiss="modal">Close</button>
+      </div>
+    </div>
+  </div>
+</div>
+<form id='visitForm' class='needs-validation' novalidate>
+    <div class="modal fadebd-example-modal-lg" id="newVisitModal" tabindex="-1"
+         aria-labelledby="newVisitModalLabel"
+         aria-hidden="true">
+        <div class="modal-dialog modal-lg modal-dialog-scrollable">
+            <div class="modal-content">
+                <div class="modal-header">
+                    <h1 class="modal-title fs-5" id="newVisitModalLabel">Add New Visit</h1>
+                    <button type="button" class="btn-close" data-bs-dismiss="modal"
+                            aria-label="Close"></button>
+                </div>
+                <div class="modal-body" id="newVisitModalContent">
+                    <!-- Filled in by app.js -->
+                </div>
+                <div class="modal-footer" id="newVisitModalFooter">
+                </div>
+            </div>
+        </div>
+    </div>
+</form>
+<!-- Add Vehicle Modal -->
+<div class="modal fade" id="addVehicleModal" tabindex="-1" aria-labelledby="addVehicleModalLabel" aria-hidden="true">
+  <div class="modal-dialog">
+    <div class="modal-content">
+      <div class="modal-header">
+        <h5 class="modal-title" id="addVehicleModalLabel"><i class="fas fa-truck"></i> Add New Vehicle</h5>
+        <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
+      </div>
+      <div class="modal-body">
+        <div class="mb-3">
+          <label for="vehicleName" class="form-label">Name</label>
+          <input type="text" class="form-control" id="vehicleName" placeholder="e.g., Kilo">
+          <div class="form-text">Unique name for the vehicle</div>
+        </div>
+        <div class="mb-3">
+          <label for="vehicleCapacity" class="form-label">Capacity</label>
+          <input type="number" class="form-control" id="vehicleCapacity" value="25" min="1">
+          <div class="form-text">Maximum cargo the vehicle can carry</div>
+        </div>
+        <div class="mb-3">
+          <label for="vehicleDepartureTime" class="form-label">Departure Time</label>
+          <input type="text" class="form-control" id="vehicleDepartureTime">
+        </div>
+        <div class="mb-3">
+          <label class="form-label">Home Location</label>
+          <div class="d-flex gap-2 mb-2">
+            <button type="button" class="btn btn-outline-primary btn-sm" id="pickLocationBtn">
+              <i class="fas fa-map-marker-alt"></i> Pick on Map
+            </button>
+            <span class="text-muted small align-self-center">or enter coordinates:</span>
+          </div>
+          <div class="row g-2">
+            <div class="col-6">
+              <input type="number" step="any" class="form-control" id="vehicleHomeLat" placeholder="Latitude">
+            </div>
+            <div class="col-6">
+              <input type="number" step="any" class="form-control" id="vehicleHomeLng" placeholder="Longitude">
+            </div>
+          </div>
+          <div id="vehicleLocationPreview" class="mt-2 text-muted small"></div>
+        </div>
+      </div>
+      <div class="modal-footer">
+        <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Cancel</button>
+        <button type="button" class="btn btn-success" id="confirmAddVehicle"><i class="fas fa-plus"></i> Add Vehicle</button>
+      </div>
+    </div>
+  </div>
+</div>
+<!-- Loading/Progress Overlay -->
+<div id="loadingOverlay" class="loading-overlay hidden">
+  <div class="loading-content">
+    <div class="loading-spinner"></div>
+    <h5 id="loadingTitle">Loading Demo Data</h5>
+    <p id="loadingMessage" class="text-muted mb-2">Initializing...</p>
+    <div class="progress" style="width: 300px; height: 8px;">
+      <div id="loadingProgress" class="progress-bar progress-bar-striped progress-bar-animated" role="progressbar" style="width: 0%"></div>
+    </div>
+    <small id="loadingDetail" class="text-muted mt-2 d-block"></small>
+  </div>
+</div>
+<footer id="solverforge-auto-footer"></footer>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/flatpickr/4.6.13/flatpickr.min.js"></script>
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/flatpickr/4.6.13/flatpickr.min.css">
+<script src="https://cdnjs.cloudflare.com/ajax/libs/leaflet/1.9.4/leaflet.js"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.7.1/jquery.min.js"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/2.11.8/umd/popper.min.js"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/bootstrap/5.3.3/js/bootstrap.bundle.min.js"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/js-joda/1.11.0/js-joda.min.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/vis-timeline@7.7.2/standalone/umd/vis-timeline-graph2d.min.js"
+        integrity="sha256-Jy2+UO7rZ2Dgik50z3XrrNpnc5+2PAx9MhL2CicodME=" crossorigin="anonymous"></script>
+<script src="/webjars/solverforge/js/solverforge-webui.js"></script>
+<script src="/score-analysis.js"></script>
+<script src="/recommended-fit.js"></script>
+<script src="/app.js"></script>
+</body>
+</html>

static/recommended-fit.js ADDED Viewed

	@@ -0,0 +1,206 @@

+/**
+ * Recommended Fit functionality for adding new visits with recommendations.
+ *
+ * This module provides:
+ * - Modal form for adding new visits
+ * - Integration with the recommendation API
+ * - Application of selected recommendations
+ */
+// Customer type configurations (must match CUSTOMER_TYPES in app.js and demo_data.py)
+const VISIT_CUSTOMER_TYPES = {
+    RESIDENTIAL: { label: "Residential", icon: "fa-home", color: "#10b981", windowStart: "17:00", windowEnd: "20:00", minDemand: 1, maxDemand: 2, minService: 5, maxService: 10 },
+    BUSINESS: { label: "Business", icon: "fa-building", color: "#3b82f6", windowStart: "09:00", windowEnd: "17:00", minDemand: 3, maxDemand: 6, minService: 15, maxService: 30 },
+    RESTAURANT: { label: "Restaurant", icon: "fa-utensils", color: "#f59e0b", windowStart: "06:00", windowEnd: "10:00", minDemand: 5, maxDemand: 10, minService: 20, maxService: 40 },
+};
+function addNewVisit(id, lat, lng, map, marker) {
+    $('#newVisitModal').modal('show');
+    const visitModalContent = $("#newVisitModalContent");
+    visitModalContent.children().remove();
+    let visitForm = "";
+    // Customer Type Selection (prominent at the top)
+    visitForm += "<div class='form-group mb-3'>" +
+        "  <label class='form-label fw-bold'>Customer Type</label>" +
+        "  <div class='row g-2' id='customerTypeButtons'>";
+    Object.entries(VISIT_CUSTOMER_TYPES).forEach(([type, config]) => {
+        const isDefault = type === 'RESIDENTIAL';
+        visitForm += `
+            <div class='col-4'>
+                <button type='button' class='btn w-100 customer-type-btn ${isDefault ? 'active' : ''}'
+                        data-type='${type}'
+                        style='border: 2px solid ${config.color}; ${isDefault ? `background-color: ${config.color}; color: white;` : `color: ${config.color};`}'>
+                    <i class='fas ${config.icon}'></i><br>
+                    <span class='fw-bold'>${config.label}</span><br>
+                    <small>${config.windowStart}-${config.windowEnd}</small>
+                </button>
+            </div>`;
+    });
+    visitForm += "  </div>" +
+        "</div>";
+    // Name and Location row
+    visitForm += "<div class='form-group mb-3'>" +
+        "  <div class='row g-2'>" +
+        "    <div class='col-4'>" +
+        "      <label for='inputName' class='form-label'>Name</label>" +
+        `      <input type='text' class='form-control' id='inputName' value='visit${id}' required>` +
+        "      <div class='invalid-feedback'>Field is required</div>" +
+        "    </div>" +
+        "    <div class='col-4'>" +
+        "      <label for='inputLatitude' class='form-label'>Latitude</label>" +
+        `      <input type='text' disabled class='form-control' id='inputLatitude' value='${lat.toFixed(6)}'>` +
+        "    </div>" +
+        "    <div class='col-4'>" +
+        "      <label for='inputLongitude' class='form-label'>Longitude</label>" +
+        `      <input type='text' disabled class='form-control' id='inputLongitude' value='${lng.toFixed(6)}'>` +
+        "    </div>" +
+        "  </div>" +
+        "</div>";
+    // Cargo and Duration row
+    visitForm += "<div class='form-group mb-3'>" +
+        "  <div class='row g-2'>" +
+        "    <div class='col-6'>" +
+        "      <label for='inputDemand' class='form-label'>Cargo (units) <small class='text-muted' id='demandHint'>(1-2 typical)</small></label>" +
+        "      <input type='number' class='form-control' id='inputDemand' value='1' min='1' required>" +
+        "      <div class='invalid-feedback'>Field is required</div>" +
+        "    </div>" +
+        "    <div class='col-6'>" +
+        "      <label for='inputDuration' class='form-label'>Service Duration <small class='text-muted' id='durationHint'>(5-10 min typical)</small></label>" +
+        "      <input type='number' class='form-control' id='inputDuration' value='7' min='1' required>" +
+        "      <div class='invalid-feedback'>Field is required</div>" +
+        "    </div>" +
+        "  </div>" +
+        "</div>";
+    // Time window row
+    visitForm += "<div class='form-group mb-3'>" +
+        "  <div class='row g-2'>" +
+        "    <div class='col-6'>" +
+        "      <label for='inputMinStartTime' class='form-label'>Time Window Start</label>" +
+        "      <input class='form-control' id='inputMinStartTime' required>" +
+        "      <div class='invalid-feedback'>Field is required</div>" +
+        "    </div>" +
+        "    <div class='col-6'>" +
+        "      <label for='inputMaxStartTime' class='form-label'>Time Window End</label>" +
+        "      <input class='form-control' id='inputMaxStartTime' required>" +
+        "      <div class='invalid-feedback'>Field is required</div>" +
+        "    </div>" +
+        "  </div>" +
+        "</div>";
+    visitModalContent.append(visitForm);
+    // Initialize with Residential defaults
+    const defaultType = VISIT_CUSTOMER_TYPES.RESIDENTIAL;
+    const tomorrow = JSJoda.LocalDate.now().plusDays(1);
+    function parseTimeToDateTime(timeStr) {
+        const [hours, minutes] = timeStr.split(':').map(Number);
+        return tomorrow.atTime(JSJoda.LocalTime.of(hours, minutes));
+    }
+    let minStartPicker = flatpickr("#inputMinStartTime", {
+        enableTime: true,
+        dateFormat: "Y-m-d H:i",
+        defaultDate: parseTimeToDateTime(defaultType.windowStart).format(JSJoda.DateTimeFormatter.ofPattern('yyyy-M-d HH:mm'))
+    });
+    let maxEndPicker = flatpickr("#inputMaxStartTime", {
+        enableTime: true,
+        dateFormat: "Y-m-d H:i",
+        defaultDate: parseTimeToDateTime(defaultType.windowEnd).format(JSJoda.DateTimeFormatter.ofPattern('yyyy-M-d HH:mm'))
+    });
+    // Customer type button click handler
+    $(".customer-type-btn").click(function() {
+        const selectedType = $(this).data('type');
+        const config = VISIT_CUSTOMER_TYPES[selectedType];
+        // Update button styles
+        $(".customer-type-btn").each(function() {
+            const btnType = $(this).data('type');
+            const btnConfig = VISIT_CUSTOMER_TYPES[btnType];
+            $(this).removeClass('active');
+            $(this).css({
+                'background-color': 'transparent',
+                'color': btnConfig.color
+            });
+        });
+        $(this).addClass('active');
+        $(this).css({
+            'background-color': config.color,
+            'color': 'white'
+        });
+        // Update time windows
+        minStartPicker.setDate(parseTimeToDateTime(config.windowStart).format(JSJoda.DateTimeFormatter.ofPattern('yyyy-M-d HH:mm')));
+        maxEndPicker.setDate(parseTimeToDateTime(config.windowEnd).format(JSJoda.DateTimeFormatter.ofPattern('yyyy-M-d HH:mm')));
+        // Update demand hint and value
+        $("#demandHint").text(`(${config.minDemand}-${config.maxDemand} typical)`);
+        $("#inputDemand").val(config.minDemand);
+        // Update service duration hint and value (use midpoint of range)
+        const avgService = Math.round((config.minService + config.maxService) / 2);
+        $("#durationHint").text(`(${config.minService}-${config.maxService} min typical)`);
+        $("#inputDuration").val(avgService);
+    });
+    const visitModalFooter = $("#newVisitModalFooter");
+    visitModalFooter.children().remove();
+    visitModalFooter.append("<button id='recommendationButton' type='button' class='btn btn-success'><i class='fas fa-arrow-right'></i> Get Recommendations</button>");
+    $("#recommendationButton").click(getRecommendationsModal);
+}
+function requestRecommendations(visitId, solution, endpointPath) {
+    $.post(endpointPath, JSON.stringify({solution, visitId}), function (recommendations) {
+        const visitModalContent = $("#newVisitModalContent");
+        visitModalContent.children().remove();
+        if (!recommendations || recommendations.length === 0) {
+            visitModalContent.append("<div class='alert alert-warning'>No recommendations available. The recommendation API may not be fully implemented.</div>");
+            const visitModalFooter = $("#newVisitModalFooter");
+            visitModalFooter.children().remove();
+            visitModalFooter.append("<button type='button' class='btn btn-secondary' data-bs-dismiss='modal'>Close</button>");
+            return;
+        }
+        let visitOptions = "";
+        const visit = solution.visits.find(c => c.id === visitId);
+        recommendations.forEach((recommendation, index) => {
+            const scoreDiffDisplay = recommendation.scoreDiff || "N/A";
+            visitOptions += "<div class='form-check'>" +
+                `  <input class='form-check-input' type='radio' name='recommendationOptions' id='option${index}' value='option${index}' ${index === 0 ? 'checked=true' : ''}>` +
+                `  <label class='form-check-label' for='option${index}'>` +
+                `    Add <b>${visit.name}</b> to vehicle <b>${recommendation.proposition.vehicleId}</b> at position <b>${recommendation.proposition.index + 1}</b> (${scoreDiffDisplay})${index === 0 ? ' - <b>Best Solution</b>': ''}` +
+                "  </label>" +
+                "</div>";
+        });
+        visitModalContent.append(visitOptions);
+        const visitModalFooter = $("#newVisitModalFooter");
+        visitModalFooter.children().remove();
+        visitModalFooter.append("<button id='applyRecommendationButton' type='button' class='btn btn-success'><i class='fas fa-check'></i> Accept</button>");
+        $("#applyRecommendationButton").click(_ => applyRecommendationModal(recommendations));
+    }).fail(function (xhr, ajaxOptions, thrownError) {
+        showError("Recommendations request failed.", xhr);
+        $('#newVisitModal').modal('hide');
+    });
+}
+function applyRecommendation(solution, visitId, vehicleId, index, endpointPath) {
+    $.post(endpointPath, JSON.stringify({solution, visitId, vehicleId, index}), function (updatedSolution) {
+        updateSolutionWithNewVisit(updatedSolution);
+    }).fail(function (xhr, ajaxOptions, thrownError) {
+        showError("Apply recommendation request failed.", xhr);
+        $('#newVisitModal').modal('hide');
+    });
+}

static/score-analysis.js ADDED Viewed

	@@ -0,0 +1,96 @@

+function analyzeScore(solution, endpointPath) {
+    new bootstrap.Modal("#scoreAnalysisModal").show()
+    const scoreAnalysisModalContent = $("#scoreAnalysisModalContent");
+    scoreAnalysisModalContent.children().remove();
+    scoreAnalysisModalContent.text("");
+    if (solution.score == null) {
+        scoreAnalysisModalContent.text("Score not ready for analysis, try to run the solver first or wait until it advances.");
+    } else {
+        visualizeScoreAnalysis(scoreAnalysisModalContent, solution, endpointPath)
+    }
+}
+function visualizeScoreAnalysis(scoreAnalysisModalContent, solution, endpointPath) {
+    $('#scoreAnalysisScoreLabel').text(`(${solution.score})`);
+    $.put(endpointPath, JSON.stringify(solution), function (scoreAnalysis) {
+        let constraints = scoreAnalysis.constraints;
+        constraints.sort(compareConstraintsBySeverity);
+        constraints.map(addDerivedScoreAttributes);
+        scoreAnalysis.constraints = constraints;
+        const analysisTable = $(`<table class="table"/>`).css({textAlign: 'center'});
+        const analysisTHead = $(`<thead/>`).append($(`<tr/>`)
+            .append($(`<th></th>`))
+            .append($(`<th>Constraint</th>`).css({textAlign: 'left'}))
+            .append($(`<th>Type</th>`))
+            .append($(`<th># Matches</th>`))
+            .append($(`<th>Weight</th>`))
+            .append($(`<th>Score</th>`))
+            .append($(`<th></th>`)));
+        analysisTable.append(analysisTHead);
+        const analysisTBody = $(`<tbody/>`)
+        $.each(scoreAnalysis.constraints, function (index, constraintAnalysis) {
+            visualizeConstraintAnalysis(analysisTBody, index, constraintAnalysis)
+        });
+        analysisTable.append(analysisTBody);
+        scoreAnalysisModalContent.append(analysisTable);
+    }).fail(function (xhr, ajaxOptions, thrownError) {
+            showError("Score analysis failed.", xhr);
+        },
+        "text");
+}
+function compareConstraintsBySeverity(a, b) {
+    let aComponents = getScoreComponents(a.score), bComponents = getScoreComponents(b.score);
+    if (aComponents.hard < 0 && bComponents.hard > 0) return -1;
+    if (aComponents.hard > 0 && bComponents.soft < 0) return 1;
+    if (Math.abs(aComponents.hard) > Math.abs(bComponents.hard)) {
+        return -1;
+    } else {
+        if (aComponents.medium < 0 && bComponents.medium > 0) return -1;
+        if (aComponents.medium > 0 && bComponents.medium < 0) return 1;
+        if (Math.abs(aComponents.medium) > Math.abs(bComponents.medium)) {
+            return -1;
+        } else {
+            if (aComponents.soft < 0 && bComponents.soft > 0) return -1;
+            if (aComponents.soft > 0 && bComponents.soft < 0) return 1;
+            return Math.abs(bComponents.soft) - Math.abs(aComponents.soft);
+        }
+    }
+}
+function addDerivedScoreAttributes(constraint) {
+    let components = getScoreComponents(constraint.weight);
+    constraint.type = components.hard != 0 ? 'hard' : (components.medium != 0 ? 'medium' : 'soft');
+    constraint.weight = components[constraint.type];
+    let scores = getScoreComponents(constraint.score);
+    constraint.implicitScore = scores.hard != 0 ? scores.hard : (scores.medium != 0 ? scores.medium : scores.soft);
+}
+function getScoreComponents(score) {
+    let components = {hard: 0, medium: 0, soft: 0};
+    $.each([...score.matchAll(/(-?[0-9]+)(hard|medium|soft)/g)], function (i, parts) {
+        components[parts[2]] = parseInt(parts[1], 10);
+    });
+    return components;
+}
+function visualizeConstraintAnalysis(analysisTBody, constraintIndex, constraintAnalysis, recommendation = false, recommendationIndex = null) {
+    let icon = constraintAnalysis.type == "hard" && constraintAnalysis.implicitScore < 0 ? '<span class="fas fa-exclamation-triangle" style="color: red"></span>' : '';
+    if (!icon) icon = constraintAnalysis.weight < 0 && constraintAnalysis.matches.length == 0 ? '<span class="fas fa-check-circle" style="color: green"></span>' : '';
+    let row = $(`<tr/>`);
+    row.append($(`<td/>`).html(icon))
+        .append($(`<td/>`).text(constraintAnalysis.name).css({textAlign: 'left'}))
+        .append($(`<td/>`).text(constraintAnalysis.type))
+        .append($(`<td/>`).html(`<b>${constraintAnalysis.matches.length}</b>`))
+        .append($(`<td/>`).text(constraintAnalysis.weight))
+        .append($(`<td/>`).text(recommendation ? constraintAnalysis.score : constraintAnalysis.implicitScore));
+    analysisTBody.append(row);
+    row.append($(`<td/>`));
+}

static/webjars/solverforge/css/solverforge-webui.css ADDED Viewed

	@@ -0,0 +1,68 @@

+:root {
+    /* Keep in sync with .navbar height on a large screen. */
+    --ts-navbar-height: 109px;
+    --ts-green-1-rgb: #10b981;
+    --ts-green-2-rgb: #059669;
+    --ts-violet-1-rgb: #3E00FF;
+    --ts-violet-2-rgb: #3423A6;
+    --ts-violet-3-rgb: #2E1760;
+    --ts-violet-4-rgb: #200F4F;
+    --ts-violet-5-rgb: #000000; /* TODO FIXME */
+    --ts-violet-dark-1-rgb: #b6adfd;
+    --ts-violet-dark-2-rgb: #c1bbfd;
+    --ts-gray-rgb: #666666;
+    --ts-white-rgb: #FFFFFF;
+    --ts-light-rgb: #F2F2F2;
+    --ts-gray-border: #c5c5c5;
+    --tf-light-rgb-transparent: rgb(242,242,242,0.5); /* #F2F2F2 = rgb(242,242,242) */
+    --bs-body-bg: var(--ts-light-rgb); /* link to html bg */
+    --bs-link-color: var(--ts-violet-1-rgb);
+    --bs-link-hover-color: var(--ts-violet-2-rgb);
+    --bs-navbar-color: var(--ts-white-rgb);
+    --bs-navbar-hover-color: var(--ts-white-rgb);
+    --bs-nav-link-font-size: 18px;
+    --bs-nav-link-font-weight: 400;
+    --bs-nav-link-color: var(--ts-white-rgb);
+    --ts-nav-link-hover-border-color: var(--ts-violet-1-rgb);
+}
+.btn {
+    --bs-btn-border-radius: 1.5rem;
+}
+.btn-primary {
+    --bs-btn-bg: var(--ts-violet-1-rgb);
+    --bs-btn-border-color: var(--ts-violet-1-rgb);
+    --bs-btn-hover-bg: var(--ts-violet-2-rgb);
+    --bs-btn-hover-border-color: var(--ts-violet-2-rgb);
+    --bs-btn-active-bg: var(--ts-violet-2-rgb);
+    --bs-btn-active-border-bg: var(--ts-violet-2-rgb);
+    --bs-btn-disabled-bg: var(--ts-violet-1-rgb);
+    --bs-btn-disabled-border-color: var(--ts-violet-1-rgb);
+}
+.btn-outline-primary {
+    --bs-btn-color: var(--ts-violet-1-rgb);
+    --bs-btn-border-color: var(--ts-violet-1-rgb);
+    --bs-btn-hover-bg: var(--ts-violet-1-rgb);
+    --bs-btn-hover-border-color: var(--ts-violet-1-rgb);
+    --bs-btn-active-bg: var(--ts-violet-1-rgb);
+    --bs-btn-active-border-color: var(--ts-violet-1-rgb);
+    --bs-btn-disabled-color: var(--ts-violet-1-rgb);
+    --bs-btn-disabled-border-color: var(--ts-violet-1-rgb);
+}
+.navbar-dark {
+    --bs-link-color: var(--ts-violet-dark-1-rgb);
+    --bs-link-hover-color: var(--ts-violet-dark-2-rgb);
+    --bs-navbar-color: var(--ts-white-rgb);
+    --bs-navbar-hover-color: var(--ts-white-rgb);
+}
+.nav-pills {
+    --bs-nav-pills-link-active-bg: var(--ts-green-1-rgb);
+}
+.nav-pills .nav-link:hover {
+    color: var(--ts-green-1-rgb);
+}
+.nav-pills .nav-link.active:hover {
+    color: var(--ts-white-rgb);
+}

static/webjars/solverforge/img/solverforge-favicon.svg ADDED Viewed

static/webjars/solverforge/img/solverforge-horizontal-white.svg ADDED Viewed

static/webjars/solverforge/img/solverforge-horizontal.svg ADDED Viewed

static/webjars/solverforge/img/solverforge-logo-stacked.svg ADDED Viewed

static/webjars/solverforge/js/solverforge-webui.js ADDED Viewed

	@@ -0,0 +1,142 @@

+function replaceSolverForgeAutoHeaderFooter() {
+  const solverforgeHeader = $("header#solverforge-auto-header");
+  if (solverforgeHeader != null) {
+    solverforgeHeader.addClass("bg-black")
+    solverforgeHeader.append(
+      $(`<div class="container-fluid">
+        <nav class="navbar sticky-top navbar-expand-lg navbar-dark shadow mb-3">
+          <a class="navbar-brand" href="https://www.solverforge.org">
+            <img src="/solverforge/img/solverforge-horizontal-white.svg" alt="SolverForge logo" width="200">
+          </a>
+        </nav>
+      </div>`));
+  }
+  const solverforgeFooter = $("footer#solverforge-auto-footer");
+  if (solverforgeFooter != null) {
+    solverforgeFooter.append(
+      $(`<footer class="bg-black text-white-50">
+           <div class="container">
+             <div class="hstack gap-3 p-4">
+               <div class="ms-auto"><a class="text-white" href="https://www.solverforge.org">SolverForge</a></div>
+               <div class="vr"></div>
+               <div><a class="text-white" href="https://www.solverforge.org/docs">Documentation</a></div>
+               <div class="vr"></div>
+               <div><a class="text-white" href="https://github.com/SolverForge/solverforge-legacy">Code</a></div>
+               <div class="vr"></div>
+               <div class="me-auto"><a class="text-white" href="mailto:info@solverforge.org">Support</a></div>
+             </div>
+           </div>
+           <div id="applicationInfo" class="container text-center"></div>
+         </footer>`));
+      applicationInfo();
+  }
+}
+function showSimpleError(title) {
+    const notification = $(`<div class="toast" role="alert" aria-live="assertive" aria-atomic="true" style="min-width: 50rem"/>`)
+        .append($(`<div class="toast-header bg-danger">
+                 <strong class="me-auto text-dark">Error</strong>
+                 <button type="button" class="btn-close" data-bs-dismiss="toast" aria-label="Close"></button>
+               </div>`))
+        .append($(`<div class="toast-body"/>`)
+            .append($(`<p/>`).text(title))
+        );
+    $("#notificationPanel").append(notification);
+    notification.toast({delay: 30000});
+    notification.toast('show');
+}
+function showError(title, xhr) {
+  var serverErrorMessage = !xhr.responseJSON ? `${xhr.status}: ${xhr.statusText}` : xhr.responseJSON.message;
+  var serverErrorCode = !xhr.responseJSON ? `unknown` : xhr.responseJSON.code;
+  var serverErrorId = !xhr.responseJSON ? `----` : xhr.responseJSON.id;
+  var serverErrorDetails = !xhr.responseJSON ? `no details provided` : xhr.responseJSON.details;
+  if (xhr.responseJSON && !serverErrorMessage) {
+	  serverErrorMessage = JSON.stringify(xhr.responseJSON);
+	  serverErrorCode = xhr.statusText + '(' + xhr.status + ')';
+	  serverErrorId = `----`;
+  }
+  console.error(title + "\n" + serverErrorMessage + " : " + serverErrorDetails);
+  const notification = $(`<div class="toast" role="alert" aria-live="assertive" aria-atomic="true" style="min-width: 50rem"/>`)
+    .append($(`<div class="toast-header bg-danger">
+                 <strong class="me-auto text-dark">Error</strong>
+                 <button type="button" class="btn-close" data-bs-dismiss="toast" aria-label="Close"></button>
+               </div>`))
+    .append($(`<div class="toast-body"/>`)
+      .append($(`<p/>`).text(title))
+      .append($(`<pre/>`)
+        .append($(`<code/>`).text(serverErrorMessage + "\n\nCode: " + serverErrorCode + "\nError id: " + serverErrorId))
+      )
+    );
+  $("#notificationPanel").append(notification);
+  notification.toast({delay: 30000});
+  notification.toast('show');
+}
+// ****************************************************************************
+// Application info
+// ****************************************************************************
+function applicationInfo() {
+  $.getJSON("info", function (info) {
+       $("#applicationInfo").append("<small>" + info.application + " (version: " + info.version + ", built at: " + info.built + ")</small>");
+   }).fail(function (xhr, ajaxOptions, thrownError) {
+       console.warn("Unable to collect application information");
+   });
+}
+// ****************************************************************************
+// TangoColorFactory
+// ****************************************************************************
+const SEQUENCE_1 = [0x8AE234, 0xFCE94F, 0x729FCF, 0xE9B96E, 0xAD7FA8];
+const SEQUENCE_2 = [0x73D216, 0xEDD400, 0x3465A4, 0xC17D11, 0x75507B];
+var colorMap = new Map;
+var nextColorCount = 0;
+function pickColor(object) {
+  let color = colorMap[object];
+  if (color !== undefined) {
+    return color;
+  }
+  color = nextColor();
+  colorMap[object] = color;
+  return color;
+}
+function nextColor() {
+  let color;
+  let colorIndex = nextColorCount % SEQUENCE_1.length;
+  let shadeIndex = Math.floor(nextColorCount / SEQUENCE_1.length);
+  if (shadeIndex === 0) {
+    color = SEQUENCE_1[colorIndex];
+  } else if (shadeIndex === 1) {
+    color = SEQUENCE_2[colorIndex];
+  } else {
+    shadeIndex -= 3;
+    let floorColor = SEQUENCE_2[colorIndex];
+    let ceilColor = SEQUENCE_1[colorIndex];
+    let base = Math.floor((shadeIndex / 2) + 1);
+    let divisor = 2;
+    while (base >= divisor) {
+      divisor *= 2;
+    }
+    base = (base * 2) - divisor + 1;
+    let shadePercentage = base / divisor;
+    color = buildPercentageColor(floorColor, ceilColor, shadePercentage);
+  }
+  nextColorCount++;
+  return "#" + color.toString(16);
+}
+function buildPercentageColor(floorColor, ceilColor, shadePercentage) {
+  let red = (floorColor & 0xFF0000) + Math.floor(shadePercentage * ((ceilColor & 0xFF0000) - (floorColor & 0xFF0000))) & 0xFF0000;
+  let green = (floorColor & 0x00FF00) + Math.floor(shadePercentage * ((ceilColor & 0x00FF00) - (floorColor & 0x00FF00))) & 0x00FF00;
+  let blue = (floorColor & 0x0000FF) + Math.floor(shadePercentage * ((ceilColor & 0x0000FF) - (floorColor & 0x0000FF))) & 0x0000FF;
+  return red | green | blue;
+}