chore: drop dead env-var passthroughs from app-api; document backend URLs in both .env.example files

Author: Medformatik

apps/api/.env.example

@@ -60,16 +60,21 @@ MAPILLARY_TOKEN=
 MAPILLARY_CLIENT_ID=
 MAPILLARY_CLIENT_SECRET=
 
-# Self-hosted routing URLs (used by apps/api's road-snap / elevation /
-# isochrone helpers). The routing integrations are configured separately:
-# use `INTEGRATION_ROUTING_OSRM_ENDPOINT` / `INTEGRATION_ROUTING_VALHALLA_ENDPOINT`.
+# Self-hosted backend URLs used directly by apps/api (not by the routing /
+# geocoding / transit *integrations* — those have their own configSchema.endpoint,
+# configure via admin panel or INTEGRATION_<ID>_ENDPOINT).
+#
+#   - OSRM_URL, VALHALLA_URL → road-snap, elevation, isochrone helpers
+#   - MOTIS_URL              → motis manager (status + lifecycle)
+#   - OVERPASS_URL           → Overpass client in packages/core (shared helper)
+#   - NOMINATIM_URL          → packages/shared-mobility nominatim reverse-geocoder
+#   - TRANSITOUS_URL         → packages/shared-mobility rentals fetcher
 # OSRM_URL=http://localhost:5000
 # VALHALLA_URL=http://localhost:8002
-
-# Self-hosted MOTIS URL (used by apps/api's motis manager)
-# For the transit-motis / geocoding-motis integrations, use
-# `INTEGRATION_TRANSIT_MOTIS_ENDPOINT` / `INTEGRATION_GEOCODING_MOTIS_ENDPOINT`.
 # MOTIS_URL=http://localhost:8081
+# OVERPASS_URL=http://localhost:8082
+# NOMINATIM_URL=http://localhost:8088
+# TRANSITOUS_URL=https://api.transitous.org
 
 # Thunderforest OpenCycleMap (apps/api tile proxy)
 # Sign up for a free Hobby Project key at https://www.thunderforest.com/

infra/docker/.env.example

@@ -34,14 +34,27 @@ MAPTILER_KEY=
 MAPILLARY_TOKEN=
 
 # --- Self-hosted backend URLs ---------------------------------------------
-# Used by apps/api's direct-call helpers (road-snap, elevation, isochrone,
-# motis manager) and the core shared packages (overpass/transitous clients).
+# Used by apps/api's direct-call helpers and shared packages (not by the
+# routing / geocoding / transit *integrations* — those have their own
+# configSchema.endpoint, configure them via admin panel or
+# INTEGRATION_<ID>_ENDPOINT).
+#
+#   - OSRM_URL, VALHALLA_URL   → apps/api road-snap, elevation, isochrone
+#   - MOTIS_URL                → apps/api motis manager (status + lifecycle)
+#   - OVERPASS_URL             → packages/core/src/utils/overpass/client.ts
+#   - NOMINATIM_URL            → packages/shared-mobility/nominatim.ts
+#                                (station reverse-geocoding for bike / scooter
+#                                 / car sharing)
+#   - TRANSITOUS_URL           → packages/shared-mobility/motis-rentals.ts
+#                                (rental POIs for shared-mobility integrations)
+#
 # Leave commented to use the container-network default ("http://osrm:5000",
 # etc). Uncomment and set if your backends run outside the compose stack.
 # OSRM_URL=http://osrm:5000
 # VALHALLA_URL=http://valhalla:8002
 # MOTIS_URL=http://motis:8081
 # OVERPASS_URL=http://overpass:80
+# NOMINATIM_URL=http://nominatim:8080
 # TRANSITOUS_URL=https://api.transitous.org
 
 # --- Service tuning (forwarded into the backend containers) ---------------

services/app-api/service.json

@@ -16,12 +16,9 @@
       "REDIS_URL": "redis://redis:6379",
       "OSRM_URL": "${OSRM_URL:-http://osrm:5000}",
       "VALHALLA_URL": "${VALHALLA_URL:-http://valhalla:8002}",
-      "OTP_URL": "${OTP_URL:-http://otp:8080}",
       "MOTIS_URL": "${MOTIS_URL:-http://motis:8080}",
       "TRANSITOUS_URL": "${TRANSITOUS_URL:-https://api.transitous.org}",
-      "PELIAS_URL": "${PELIAS_URL:-http://pelias:4000}",
       "NOMINATIM_URL": "${NOMINATIM_URL:-http://nominatim:8080}",
-      "PHOTON_URL": "${PHOTON_URL:-http://photon:2322}",
       "OVERPASS_URL": "${OVERPASS_URL:-http://overpass:80}",
       "CORS_ORIGIN": "https://${DOMAIN:-localhost},http://localhost:3000",
       "BETTER_AUTH_URL": "https://${DOMAIN:-localhost}",