Appearance
📚 Visual Use Cases Index Map
This index serves as a Map of Content (MOC) for currently supported or intentionally retained BikeTrack user stories. Retired editor experiments are no longer listed here.
🗺️ 1. Core Route Planning & Waypoint Navigation
Fundamental navigation drawing scenarios on the MapLibre canvas:
- UC-001: Round-Trip Loop Planner — Generating closed loop routes of specific distances.
- UC-002: Out & Back Route Generation — Duplicating and reversing a path in one click.
- UC-005: Route Auto-Healing Engine — Dynamic path healing when intermediate markers are moved.
- UC-007: Offgrid / Manual Track Drawing — Bypassing snapping to trace off-road mountain segments.
- UC-009: Smart One-Click Path Reversal — Reversing coordinates safely while retaining waypoints.
- UC-017: Structural Elevation Processing — Correct elevation math across bridges and through tunnels.
🖥️ 2. Map Canvas Controls & Interactive Physics
Spatial mathematics, drag gestures, and real-time visualization layers:
- UC-003: Waypoint Drag-and-Drop Handler — Moving markers on map with live path preview.
- UC-008: Elevation Chart Map Syncing — Synchronizing hover coordinate markers between chart and map canvas.
- UC-010: Surface Type Color-Coding — Color rendering matching surface (Green=Asphalt, Amber=Gravel, Red=Dirt).
- UC-011: Smart Coordinate Decimation (RDP) — Ramer-Douglas-Peucker route decimation to save coordinate memory.
- UC-029.2: Anti-Doxing Route Crop — Sliders to trim starting and ending points (e.g. 500m) to hide home locations.
- UC-029.2-Map: Visual Anti-Doxing Crops — Real-time map rendering of cropped vs active paths.
📍 3. POIs & Turn Sheets (Cue Sheets)
Adding waypoint information, cues, and safety markers:
- UC-006: Point of Interest (POI) Workspace — Adding custom markers (water, viewpoint) with categories.
- UC-013: Turn-by-Turn Cue Sheets — Generating printable and exportable turn direction sheets.
- UC-025: Cue Sheet Auto-Healing & Control Points — Re-associating turn cues when paths are edited.
- UC-029.4: Waypoint Context Additions — Right-click to directly inject custom waypoint pins.
📁 4. Route Library & File Formats
GPX parsing, third-party syncing, and folder collections:
- UC-026: GPX Export Hardware Extensions — Formatting export files to comply with Garmin/Wahoo standards.
- UC-029.1: Library Track Extraction — Creating planned tracks straight from imported ride logs.
- UC-029.3: Map Context Menu Imports — Fast GPX drag-and-drop actions on map to draw routes instantly.
- Folder Library Management — Organizing route folders and favorite libraries.
🔧 5. Garage Component Wear & Sync
Tracking components lifecycle, service checklists, and Strava:
- UC-027.1: Bike Component Inventory — Tracking drivetrain, brakes, and suspension pieces in categories.
- UC-027.2: Environmental Wear Physics Multiplier — Speeding up wear counters when riding off-road (Gravel/Dirt).
- UC-027.3: Service Reminders & Action Checklists — Service triggers, clean/lube logs, and replacements.
📊 6. Core Navigation Math & Integrations
Telemetry analysis, predictive calculations, and notifications:
- UC-015: Real-time Wind Vector Analysis — Headwind vs tailwind calculations based on NOAA weather vectors.
- UC-016: Ride Duration Physics (Naismith's Rule) — Estimating ride duration by taking into account elevation slopes.
- UC-023: Import Collision Guard — De-duplicating double Strava activity sync triggers.
- UC-028: Public Updates & Releases — Exposing release histories to riders.
🛡️ 7. Edge Cases & Resilience
Network fail-safes and robust recovery:
- UC-026.4: Network Failures & Error Handling — Validating UI state during server calculation timeouts.
- UC-026.5: Database Integration Guardrails — Database transaction retry policies.