trails/openspec/specs/route-coloring/spec.md at 424e692ee0ce0a34d9e895cf38e136c982387039

Ullrich Schäfer ba044610b7

Add route interactions: click-to-split, drag-to-reshape, colored route rendering

- Enrich BRouter response with per-point 3D coordinates and segment boundary
  tracking (EnrichedRoute interface)
- ColoredRoute component: plain, elevation gradient (green→yellow→red), and
  surface color modes with invisible wide polyline for click targeting
- Click-to-split: click on route polyline inserts waypoint at nearest point,
  mapped to correct segment via boundary indices
- MidpointHandles: draggable CircleMarkers at route segment midpoints for
  reshaping, hidden below zoom 12, opaque on hover
- Color mode toggle (select) synced via Yjs routeData
- i18n keys for color mode labels (en + de)
- Unit tests for segment boundary tracking (13 tests)
- E2E tests for enriched route response and color mode toggle

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-26 22:36:42 +01:00

1.9 KiB

Raw Blame History

Requirements

Requirement: Route color modes

The Planner SHALL support multiple route color modes that visualize per-point data along the route.

Scenario: Default plain mode

WHEN a route is first displayed
THEN it renders as a single-color blue polyline (current behavior)

Scenario: Elevation color mode

WHEN a user selects the "Elevation" color mode
THEN the route polyline is colored with a gradient from green (low) through yellow (mid) to red (high), based on the elevation at each point

Scenario: Surface color mode

WHEN a user selects the "Surface" color mode and surface data is available from BRouter tiledesc
THEN the route polyline is colored by surface type (e.g., asphalt=gray, gravel=brown, path=green, track=orange)

Scenario: Surface data unavailable

WHEN a user selects "Surface" color mode but BRouter did not return surface data
THEN the route falls back to plain color mode

Requirement: Color mode toggle

The Planner SHALL provide a UI control to switch between route color modes.

Scenario: Toggle control location

WHEN a route is displayed
THEN a color mode select dropdown is visible in the session header

Scenario: Color mode persists in session

WHEN a user changes the color mode
THEN the selection is stored in the Yjs routeData map and synced to all participants

Requirement: Elevation chart color sync

The elevation profile chart SHALL use the same color gradient as the route when in elevation mode.

Scenario: Elevation mode chart coloring

WHEN the color mode is set to "Elevation"
THEN the elevation chart line and fill use the same green→yellow→red gradient as the route polyline

Scenario: Plain mode chart coloring

WHEN the color mode is "Plain" or "Surface"
THEN the elevation chart uses the default blue color

1.9 KiB Raw Blame History