trails/openspec/changes/poi-index/specs/rate-limiting/spec.md at 5dd4968626e98466a447cdcdcb7945aecea646c0

Ullrich Schäfer 5dd4968626 docs+openspec: prior-art research (Organic Maps, Endurain, wanderer) and 15 proposals

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>

2026-07-06 07:23:00 +02:00

764 B

Raw Blame History

REMOVED Requirements

Requirement: Overpass API rate limit

Reason: The /api/overpass proxy and its third-party upstream are removed; POIs are served from the instance's own index. Migration: The equivalent limit continues on the replacement endpoint — see "POI API rate limit" below. No client changes; the same error UI handles 429s.

ADDED Requirements

Requirement: POI API rate limit

The Planner SHALL limit /api/pois requests to 120 per IP per minute to protect the instance's database from abusive clients.

Scenario: POI rate limit exceeded

WHEN a single IP exceeds 120 POI requests in one minute
THEN /api/pois responds with 429 Too Many Requests
AND no database query is executed for rejected requests

764 B Raw Blame History