trails-cool/trails
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
trails/openspec/specs/gpx-import/spec.md
Ullrich Schäfer a9f8ee61f0
Add GPX file import to planner + archive change 
Two import entry points:
- Home page: "Import GPX" button next to "Start Planning"
- In-session: drag-and-drop GPX onto the map (with confirmation)

Parses GPX client-side, extracts waypoints (Douglas-Peucker) and
no-go areas from extensions. Non-GPX files show error toast.

Also:
- Fix spec drift: non-GPX drop now shows error toast (was silent)
- Add E2E tests for import button, invalid GPX, and session creation
- Archive gpx-import-planner change, sync specs

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-03 17:31:44 +01:00

1.6 KiB
Raw Blame History

ADDED Requirements

Requirement: Import GPX from home page

Users SHALL be able to import a GPX file from the planner home page to start a new planning session.

Scenario: Upload GPX via file picker

  • WHEN a user clicks the "Import GPX" button on the home page and selects a GPX file
  • THEN the file is parsed client-side using parseGpxAsync
  • AND waypoints are extracted via extractWaypoints (Douglas-Peucker for single-segment tracks)
  • AND no-go areas are extracted from GPX extensions if present
  • AND a new session is created with the extracted data
  • AND the user is redirected to the new session

Scenario: Invalid GPX file

  • WHEN a user uploads a file that is not valid GPX
  • THEN an error message is shown
  • AND no session is created

Requirement: Import GPX via drag-and-drop

Users SHALL be able to drag a GPX file onto the map in an existing session.

Scenario: Drop GPX on map

  • WHEN a user drags a .gpx file onto the map area
  • THEN a visual drop zone indicator appears
  • AND on drop, the file is parsed client-side
  • AND a confirmation dialog asks whether to replace the current route
  • AND on confirm, the session's waypoints and no-go areas are replaced with the imported data

Scenario: Cancel import

  • WHEN a user drops a GPX file and the confirmation dialog appears
  • THEN clicking "Cancel" leaves the session unchanged

Requirement: Non-GPX files are rejected

Scenario: Drop non-GPX file

  • WHEN a user drops a non-GPX file on the map
  • THEN the file is ignored with a brief error toast