trails-cool/trails
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs+openspec: prior-art research (Organic Maps, Endurain, wanderer) and 15 proposals

Browse source 
Add docs/inspirations.md as the durable record of the 2026-07-05/06
prior-art research — per-project learnings with source paths, canonical
credit lines, and the changes each spawned — and extend the
acknowledgment lists in philosophy.md/architecture.md (Organic Maps,
Endurain, wanderer).

New OpenSpec changes (proposal/design/specs/tasks each):
- Organic Maps: elevation-profile-hardening, gpx-parser-robustness,
  hiking-time-estimate, poi-index, hiking-foot-profile
- Endurain: account-export, activity-duplicate-review,
  fit-parsing-hardening, activity-locations, self-hosting-guide,
  activity-privacy-controls
- wanderer: federation-hardening, link-share-tokens
- credits-page (user-visible acknowledgments)

Updated in-flight changes with wanderer prior-art sections:
route-federation, route-discovery.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Ullrich Schäfer 2026-07-06 07:23:00 +02:00
parent be4f7e4ae8
commit 5dd4968626
80 changed files with 2600 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

37
openspec/changes/activity-locations/specs/activity-locations/spec.md Normal file
View file

@ -0,0 +1,37 @@
## ADDED Requirements
### Requirement: Offline reverse geocoding
The Journal SHALL derive location labels from a bundled place dataset entirely on-instance; deriving a location SHALL NOT trigger any network request. The lookup SHALL return the nearest populated place with its region and ISO country for a coordinate, falling back to country-only beyond 30 km from any place and to no label beyond 200 km.
#### Scenario: No third-party calls
- **WHEN** an activity is saved and its location derived
- **THEN** no request leaves the instance
#### Scenario: Wilderness start
- **WHEN** a track starts 50 km from the nearest populated place
- **THEN** the label is the country only
### Requirement: Location labels on activities and routes
Activities and routes with geometry SHALL store a derived location label (place name + country) computed from the track's start point at save/import time for locally-created content. Remote (federated) activities SHALL NOT be re-derived locally. Detail pages and feed/list cards SHALL display the label with the country name localized.
#### Scenario: Label on import
- **WHEN** a Wahoo activity starting in Freiburg is imported
- **THEN** the activity shows "Freiburg im Breisgau, Deutschland" in a German locale
#### Scenario: No geometry, no label
- **WHEN** an activity has no GPS data
- **THEN** no location label is stored or shown
### Requirement: Label visibility follows geometry visibility
The location label SHALL be visible to a viewer only when that viewer may see the track's start (same masking as the map/geometry; governed by the activity privacy flags once those exist).
#### Scenario: Hidden geometry hides label
- **WHEN** a viewer is not permitted to see an activity's map/start
- **THEN** the location label is also absent for that viewer
### Requirement: Backfill of existing content
Existing local activities and routes with geometry SHALL receive labels via an idempotent one-shot background job.
#### Scenario: Backfill run
- **WHEN** the backfill job completes
- **THEN** previously saved activities with geometry display location labels