Alpha stage commit

examples/overpass_queries.md

@@ -0,0 +1,45 @@
+# Example Overpass Queries for Prototyping
+
+Do not use public Overpass instances for production-scale app traffic. These queries are for small-area prototyping only.
+
+## Drinking water in a bounding box
+
+```overpass
+[out:json][timeout:25];
+(
+  node["amenity"="drinking_water"]({{bbox}});
+  way["amenity"="drinking_water"]({{bbox}});
+  relation["amenity"="drinking_water"]({{bbox}});
+  node["drinking_water"="yes"]({{bbox}});
+  node["natural"="spring"]({{bbox}});
+);
+out center tags;
+```
+
+## Bike shops and repair stations
+
+```overpass
+[out:json][timeout:25];
+(
+  node["shop"="bicycle"]({{bbox}});
+  way["shop"="bicycle"]({{bbox}});
+  node["amenity"="bicycle_repair_station"]({{bbox}});
+  node["service:bicycle:repair"="yes"]({{bbox}});
+);
+out center tags;
+```
+
+## Campsites, huts, and shelters
+
+```overpass
+[out:json][timeout:25];
+(
+  node["tourism"="camp_site"]({{bbox}});
+  way["tourism"="camp_site"]({{bbox}});
+  node["tourism"="wilderness_hut"]({{bbox}});
+  way["tourism"="wilderness_hut"]({{bbox}});
+  node["amenity"="shelter"]({{bbox}});
+  way["amenity"="shelter"]({{bbox}});
+);
+out center tags;
+```

examples/sample_segment_scoring.json

@@ -0,0 +1,25 @@
+{
+  "profile": "loaded_gravel",
+  "segment": {
+    "distanceM": 1800,
+    "avgGradePercent": 9.8,
+    "maxGradePercent": 16.2,
+    "surface": "gravel",
+    "smoothness": "bad",
+    "highway": "track",
+    "bicycleAccess": "unknown",
+    "legalAccessConfidence": "unknown",
+    "trafficStress": 0.1,
+    "officialCycleRoute": false,
+    "protectedAreaOverlap": true,
+    "sourceConfidence": "medium"
+  },
+  "expected": {
+    "hikeABikeRisk": "high",
+    "warnings": [
+      "STEEP_LOADED_BIKE_CLIMB",
+      "UNKNOWN_ACCESS",
+      "PROTECTED_AREA_OVERLAP"
+    ]
+  }
+}

examples/sample_stage_plan.json

@@ -0,0 +1,82 @@
+{
+  "routeId": "route_demo_001",
+  "stages": [
+    {
+      "dayIndex": 1,
+      "distanceKm": 72.4,
+      "ascentM": 980,
+      "surface": {
+        "paved": 0.56,
+        "gravel": 0.34,
+        "dirt": 0.1
+      },
+      "sleep": [
+        {
+          "name": "Lakeside campsite",
+          "confidence": "high",
+          "detourKm": 0.8
+        }
+      ],
+      "water": [
+        {
+          "km": 18.2,
+          "name": "Village fountain"
+        },
+        {
+          "km": 50.9,
+          "name": "Cemetery tap"
+        }
+      ],
+      "food": [
+        {
+          "km": 43.0,
+          "name": "Supermarket"
+        }
+      ],
+      "warnings": [
+        "Last reliable water before 11 km climb"
+      ]
+    },
+    {
+      "dayIndex": 2,
+      "distanceKm": 81.7,
+      "ascentM": 1420,
+      "surface": {
+        "paved": 0.38,
+        "gravel": 0.52,
+        "dirt": 0.1
+      },
+      "sleep": [
+        {
+          "name": "Mountain hostel",
+          "confidence": "medium",
+          "detourKm": 2.1
+        }
+      ],
+      "water": [
+        {
+          "km": 14.3,
+          "name": "Spring"
+        },
+        {
+          "km": 61.1,
+          "name": "Public tap"
+        }
+      ],
+      "food": [
+        {
+          "km": 23.0,
+          "name": "Bakery"
+        },
+        {
+          "km": 65.4,
+          "name": "Gas station"
+        }
+      ],
+      "warnings": [
+        "One uncertain access segment",
+        "Steep loose climb at km 57"
+      ]
+    }
+  ]
+}

examples/sample_trip_request.json

@@ -0,0 +1,31 @@
+{
+  "start": {
+    "lat": 48.137,
+    "lon": 11.575
+  },
+  "end": {
+    "lat": 47.269,
+    "lon": 11.404
+  },
+  "startDate": "2026-07-10",
+  "endDate": "2026-07-14",
+  "profile": "loaded_gravel",
+  "sleepPreference": "mixed_budget",
+  "dailyDistanceKm": {
+    "min": 55,
+    "target": 75,
+    "max": 95
+  },
+  "dailyAscentM": {
+    "target": 1100,
+    "max": 1800
+  },
+  "maxLoadedGradePercent": 12,
+  "preferredUnpavedPercent": {
+    "min": 30,
+    "max": 70
+  },
+  "waterGapMaxKm": 40,
+  "foodGapMaxKm": 70,
+  "requireBailoutEveryKm": 90
+}