trails/openspec/specs/route-coloring/spec.md at 0b9b99984ead3e86f2dc8f9ed59dac2d8db28609

Ullrich Schäfer 0b9b99984e Fix all OpenSpec validation failures (36/36 passing)

- Add ## Purpose sections and convert delta headers to ## Requirements
  on all 25 specs
- Add SHALL keywords to requirements missing them (gpx-import,
  planner-session, planner-journal-handoff)
- Convert prose GPX format section to proper scenarios (no-go-areas)
- Create specs/ delta files for 7 changes that were missing them
  (activity-photos, local-dev-stack, multi-day-routes, route-discovery,
  route-sharing, visual-redesign, waypoint-notes)

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

2026-04-06 22:17:52 +02:00

2 KiB

Raw Blame History

Purpose

Multi-mode route visualization (plain, elevation gradient, surface type) with session-synced color mode selection.

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

2 KiB Raw Blame History