trails/openspec/specs/rate-limiting/spec.md at 079ce5aba278293d56893aeeaa536318d698f45e

Ullrich Schäfer 8396041c26

openspec: archive poi-index; sync deltas into canonical specs

poi-index shipped and is live in production (self-hosted planet POI index,
8.4M rows serving /api/pois; Overpass removed from the Planner). Archive the
change and apply its spec deltas:

- new capability: poi-index
- osm-poi-overlays: POIs from the instance index, not Overpass
- rate-limiting: /api/pois limit replaces the Overpass proxy limit
- infrastructure: POI extract (BRouter host) + import (flagship) components

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-07-13 01:46:13 +02:00

1.1 KiB

Raw Blame History

Purpose

Request rate limiting for Planner session creation and BRouter API calls to prevent abuse.

Requirements

Requirement: Session creation rate limit

The Planner SHALL limit session creation to 10 per IP per hour.

Scenario: Rate limit exceeded

WHEN an IP creates more than 10 sessions in one hour
THEN the server responds with 429 Too Many Requests

Requirement: BRouter call rate limit

The Planner SHALL limit route computations to 300 per session per hour (the DEFAULT_MAX_REQUESTS value in apps/planner/app/lib/rate-limit.ts).

Scenario: Routing rate limit exceeded

WHEN a session exceeds 300 BRouter calls in one hour
THEN the server responds with 429 and the client shows a "slow down" message

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

1.1 KiB Raw Blame History