trails/openspec/specs/route-splitting/spec.md
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.1 KiB

Requirements

Requirement: Insert waypoint by clicking on route

The Planner SHALL allow users to insert a new waypoint by clicking the ghost marker that appears when hovering near the route.

Scenario: Click ghost marker to split

  • WHEN a ghost marker is visible on the route and the user clicks it
  • THEN a new waypoint is inserted at the ghost marker position between the appropriate adjacent waypoints, and the route recomputes

Scenario: Waypoint snaps to route

  • WHEN the ghost marker appears near the route
  • THEN it is positioned at the closest coordinate point on the existing route geometry, not at the raw cursor position

Scenario: No duplicate waypoint from map click

  • WHEN a user clicks the ghost marker to insert a waypoint
  • THEN the map click handler is suppressed so only one waypoint is inserted (not an additional one appended at the end)

Scenario: Split syncs to other participants

  • WHEN a user inserts a waypoint by clicking the ghost marker
  • THEN all other participants see the new waypoint appear in the waypoint list and on the map via Yjs sync