L13 Planung: Geocoding der Objekte über OpenStreetMap Nominatim

Provider-Interface (nominatim|none), strukturierte Suche mit User-Agent und Accept-Language, Drosselung 1/s je Prozess, Job geocode-site (Worker: Concurrency 1 + Limiter), Cache am Objekt, manuelle Koordinaten bleiben, Auslöser Anlage/Adressänderung/Import-Bestätigung nur per Queue, Backfill-Skript, Env-Beispiele. Tests mit Fake-Provider, Nominatim nie aufgerufen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

.env.example

@@ -129,6 +129,18 @@ AI_GENERATION_RETENTION_DAYS=180
 # Import-Extraktion ab. 0 = unbegrenzt.
 AI_MONTHLY_TOKEN_LIMIT=0
 
+# --- Craftvia: Planung – Karten & Geocoding (L13) ---
+# Adresse → Koordinaten nur serverseitig im Worker (Job geocode-site, max. 1 Anfrage/s),
+# Ergebnis wird am Objekt gespeichert. nominatim | none (none = keine Verortung, Objekte
+# erscheinen „ohne Ortsangabe“). Für Produktion eigenen/vertraglichen Dienst verwenden.
+GEOCODING_PROVIDER=nominatim
+# GEOCODING_URL=https://nominatim.openstreetmap.org
+# Eindeutiger User-Agent (Nominatim-Richtlinie); leer = "Craftvia/<version> (+APP_BASE_URL)".
+# GEOCODING_USER_AGENT=
+# Kartenkacheln der Live-Lage; der Host wird beim Build in die CSP (img-src) übernommen.
+# MAP_TILE_URL=https://tile.openstreetmap.org/{z}/{x}/{y}.png
+# MAP_ATTRIBUTION=© OpenStreetMap-Mitwirkende
+
 # --- Optionale Fundament-Variablen (Default leer) ---
 # MFA_ENC_KEY: Schlüssel für TOTP-Secrets at-rest (leer = aus AUTH_SECRET abgeleitet).
 # ⚠ Nach dem Setzen nicht mehr ändern.