poi-index: Grafana dashboard/alert, docs, privacy manifest
- planner dashboard: replace Overpass panels with POI index freshness + serving panels (age, rows/category, import status, API request rate/errors) - alerts: replace overpass-upstream-unhealthy with poi-index-stale (>6 weeks) - architecture.md: POI data flow now the self-hosted index - privacy manifest (DE+EN): Overpass is Journal-surface-backfill-only; Planner POIs served same-origin from /api/pois - self-host-overpass README + roadmap: superseded for POIs by poi-index - poi-extract README: self-hoster story (optional pipeline, regional extract, graceful empty index) - map-core tsconfig: exclude *.sync.test.ts from tsc to keep it zero-dep Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
parent
e703843b9b
commit
96de8831cf
9 changed files with 183 additions and 153 deletions
|
|
@ -790,8 +790,12 @@ Base layers:
|
|||
|
||||
Overlays (toggleable):
|
||||
- **OpenCampingMap** (campsites, shelters — essential for bikepacking)
|
||||
- **POI overlay**: Water points, shelters, bike repair stations
|
||||
(sourced from OSM Overpass API or pre-cached)
|
||||
- **POI overlay**: Water points, shelters, bike repair stations, etc. Served
|
||||
from the instance's own `planner.pois` index via `/api/pois` — a PostGIS
|
||||
table built monthly from an OSM extract (osmium filter on the BRouter host →
|
||||
guarded atomic import on the flagship). No third-party POI service is
|
||||
contacted; viewport coordinates never leave trails.cool. See the
|
||||
`poi-index` change and `infrastructure/brouter-host/poi-extract/`.
|
||||
- **Waymarked Trails** (hiking/cycling trail networks)
|
||||
|
||||
Implementation: Leaflet layer switcher with tile URLs. No API keys needed
|
||||
|
|
|
|||
|
|
@ -1,4 +1,4 @@
|
|||
# self-host-overpass (parked)
|
||||
# self-host-overpass (parked — superseded for POIs)
|
||||
|
||||
Full OpenSpec artifact set (`proposal.md`, `design.md`, `specs/`, `tasks.md`)
|
||||
for hosting our own Overpass API. Moved here from `openspec/changes/` so it
|
||||
|
|
@ -7,11 +7,22 @@ under `openspec/changes/` when ready to implement.
|
|||
|
||||
## Status
|
||||
|
||||
**Parked.** The interim proxy work (`/api/overpass` → `overpass.private.coffee`,
|
||||
see `apps/planner/app/routes/api.overpass.ts`) covers the day-one needs:
|
||||
User-Agent compliance, same-origin check, rate limiting, server-side cache
|
||||
with coalescing, bbox quantization, Grafana observability. That buys us time
|
||||
before we need to own the upstream.
|
||||
**Superseded for the Planner's POI overlays** by the
|
||||
[`poi-index`](../../../openspec/changes/poi-index/) change (shipped), which
|
||||
removes Overpass from the POI path entirely: instead of running the Overpass
|
||||
software, a monthly osmium extract feeds a self-hosted PostGIS `planner.pois`
|
||||
index served at `/api/pois`. That is lighter than this plan (no Overpass
|
||||
engine, no diff replication, no RAM ceiling) and covers every current POI need
|
||||
— all queries were simple tag-in-bbox lookups that never used Overpass QL.
|
||||
|
||||
The former interim proxy (`/api/overpass` → `overpass.private.coffee`) has been
|
||||
**removed**.
|
||||
|
||||
**Still relevant if** we ever need genuine Overpass QL (arbitrary ad-hoc
|
||||
queries, recursion, `around:`, set operations) that a precomputed category
|
||||
index can't answer — that's the remaining reason to revive this. The Journal's
|
||||
surface-breakdown backfill still queries public Overpass instances for way
|
||||
geometry; owning that upstream is the other revive trigger.
|
||||
|
||||
## When to revive
|
||||
|
||||
|
|
|
|||
|
|
@ -83,7 +83,7 @@ See `docs/ideas/` for pre-spec explorations:
|
|||
|
||||
- `mobile-activity-recording/` — GPS tracking and activity logging from a native app
|
||||
- `mobile-nearby-sync/` — BLE-based proximity discovery
|
||||
- `self-host-overpass/` — Self-hosted Overpass API for POI overlays
|
||||
- `self-host-overpass/` — Self-hosted Overpass API (superseded for POI overlays by the shipped `poi-index`; revive only if we need Overpass QL or to own the surface-backfill upstream)
|
||||
- `instance-administration.md` — admin role, registration toggle, suspend/ban, federation blocklists, reports
|
||||
- `social-interactions.md` — local likes + comments (the foundation the federated kudos/comments attach to)
|
||||
- `activity-participants.md` — tag co-riders on shared activities, confirm/decline, federated mentions
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue