trails-cool/trails
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
trails/openspec/specs/osm-tile-overlays/spec.md
Ullrich Schäfer 572d240ed1
Fix all openspec validation errors (45/45 pass) 
Main specs (7): Converted from delta format (## ADDED/MODIFIED) to
proper main spec format (## Purpose + ## Requirements)

Changes (3): Added missing spec files for e2e-test-reorganization,
journal-poi-details, and mobile-nearby-sync

Mobile testing: Added missing scenario for "No Vitest" requirement

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-12 22:41:51 +02:00

3.3 KiB
Raw Blame History

Purpose

Tile-based map overlays (hillshading, Waymarked Trails cycling/hiking/MTB routes) with support for multiple simultaneous overlays, proper attribution, and profile-aware auto-enabling.

Requirements

Requirement: Hillshading overlay

The Planner map SHALL offer a hillshading tile overlay that visualizes terrain relief.

Scenario: Enable hillshading

  • WHEN a user toggles "Hillshading" in the layer switcher
  • THEN semi-transparent terrain shading tiles are rendered on top of the base layer

Scenario: Hillshading with any base layer

  • WHEN hillshading is enabled and the user switches base layers
  • THEN hillshading remains visible on top of the new base layer

Requirement: Waymarked Trails cycling overlay

The Planner map SHALL offer a Waymarked Trails cycling overlay showing official cycle route networks.

Scenario: Enable cycling routes overlay

  • WHEN a user toggles "Cycling Routes" in the layer switcher
  • THEN official cycling routes (EuroVelo, national networks) are rendered as colored lines on the map from Waymarked Trails tiles

Scenario: Cycling overlay at different zoom levels

  • WHEN cycling routes overlay is enabled
  • THEN international routes are visible at low zoom and local routes appear at higher zoom levels

Requirement: Waymarked Trails hiking overlay

The Planner map SHALL offer a Waymarked Trails hiking overlay showing official hiking trail networks.

Scenario: Enable hiking routes overlay

  • WHEN a user toggles "Hiking Routes" in the layer switcher
  • THEN official hiking trails (GR routes, national trails) are rendered as colored lines on the map

Requirement: Waymarked Trails MTB overlay

The Planner map SHALL offer a Waymarked Trails MTB overlay showing official mountain bike trail networks.

Scenario: Enable MTB routes overlay

  • WHEN a user toggles "MTB Routes" in the layer switcher
  • THEN official MTB trails are rendered as colored lines on the map

Requirement: Multiple simultaneous overlays

The Planner map SHALL support enabling multiple tile overlays at the same time.

Scenario: Hillshading plus cycling routes

  • WHEN a user enables both "Hillshading" and "Cycling Routes"
  • THEN both overlays are visible simultaneously, with cycling routes rendered above hillshading

Requirement: Overlay tile attribution

Each tile overlay SHALL display proper attribution when enabled.

Scenario: Attribution updates

  • WHEN an overlay is toggled on
  • THEN its attribution text is added to the map attribution control
  • WHEN the overlay is toggled off
  • THEN its attribution text is removed

Requirement: Profile-aware overlay suggestions

The Planner SHALL auto-enable relevant tile overlays when the routing profile changes.

Scenario: Switch to cycling profile

  • WHEN the routing profile is changed to a cycling variant
  • THEN the Waymarked Trails cycling overlay is automatically enabled

Scenario: Switch to hiking profile

  • WHEN the routing profile is changed to a hiking variant
  • THEN the Waymarked Trails hiking overlay is automatically enabled

Scenario: User can disable auto-enabled overlays

  • WHEN an overlay was auto-enabled by a profile change
  • THEN the user can manually disable it and it stays disabled until the next profile change