managarten/services/mana-geocoding
Till JS 32d9f25e7f docs(geocoding): update CLAUDE.md with deploy lessons learned
After the 2026-04-11 production deploy, several non-obvious gotchas
surfaced that needed documenting:

- Forward search: autocomplete→search fallback explained, so future-me
  knows why the handler hits two Pelias endpoints for address-style
  queries.
- Pelias infra: corrected object counts (13.4M actual, not 22M), noted
  the libpostal RAM surprise (~1.9 GB, much larger than Pelias docs
  suggest), and added real per-container RAM numbers from production.
- pelias.json: document that we dropped placeholder/pip/interpolation
  (not just how to run them) and why the cleaner degradation matters.
- Wrapper gotchas section: Bun idleTimeout, Colima bind-mount cache
  staleness, and the host.docker.internal-from-blackbox workaround.
- /health/pelias endpoint is now listed in the API table since it's
  the integration point with blackbox monitoring.
- Testing section added — explicitly "no automated tests yet", with a
  curl-based manual smoke test set a human can run after changes.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-11 17:59:34 +02:00
..
pelias fix(geocoding): drop unused Pelias services, raise Bun idleTimeout 2026-04-11 17:41:57 +02:00
src feat(geocoding): fall back to Pelias /search when /autocomplete is empty 2026-04-11 17:54:57 +02:00
CLAUDE.md docs(geocoding): update CLAUDE.md with deploy lessons learned 2026-04-11 17:59:34 +02:00
Dockerfile feat(monitoring): add mana-geocoding + Pelias to prod compose, Prometheus, Grafana, and status.mana.how 2026-04-11 16:11:01 +02:00
package.json feat(places): add self-hosted geocoding with Pelias (DACH) 2026-04-10 23:02:25 +02:00
tsconfig.json feat(places): add self-hosted geocoding with Pelias (DACH) 2026-04-10 23:02:25 +02:00