nodeMap/docs/config/README.md

<!-- /docs/config/README.md -->

# ⚙️ Konfigurationsübersicht (/config)

Dieses Verzeichnis enthält die zentrale Pfad-Konfigurationsdatei, die für konsistente
URL-Generierung in NodeMap zuständig ist.

---

## 📁 [`paths.js`](./paths.md)

- Berechnet den Basis-Pfad aus `.env.production` oder `.env.development`
- Liefert `BASE_URL`, z. B. `/talas5`
- Wird in der gesamten App zur dynamischen URL-Erzeugung verwendet

---

Diese Konfiguration stellt sicher, dass NodeMap unabhängig von Hostname, Port oder
Verzeichnisstruktur funktioniert.

📄 Pfad: `/config/paths.js`

---

## OSM‑basierte, „open“ Quellen

Diese sind datenrechtlich offen (ODbL bzw. Community-Lizenzen), aber das „kostenlos“ gilt nicht im
Sinne unbegrenzter Tile‑Nutzung. Die Tile‑Server werden als Community‑Ressource bereitgestellt –
bitte Policies respektieren.

- osm-standard (OpenStreetMap)
- - Key: Nein
- - Nutzung: Fair‑Use; für produktive/hohe Last eigenen Tile‑Server/Provider verwenden.
- - Attribution: „© OpenStreetMap contributors“

- osm-humanitarian (HOT)
- - Key: Nein
- - Nutzung: Fair‑Use; für größere Last die Betreiber kontaktieren bzw. andere Infrastruktur nutzen.
- - Attribution: „© OpenStreetMap contributors <br>
-
- Humanitarian OpenStreetMap Team“ cyclosm
- - Key: Nein
- - Nutzung: Fair‑Use (bereitgestellt u. a. über OSM France). Für höhere Last
    Unterstützung/Hostingoptionen prüfen.
- - Attribution: „CyclOSM“ + „OpenStreetMap contributors“
- Praxis‑Tipps Kleine bis mittlere Nutzung: Die oben genannten „keyless“ Quellen sind oft
  ausreichend, solange du Attribution setzt und Limits respektierst. Produktion/hohe Last: Nutze
  einen Anbieter mit Vertrag/Key (z. B. Thunderforest, Tracestrack, MapTiler, Mapbox) oder hoste
  Tiles selbst. Schlüssel im Client: Für Thunderforest/Tracestrack stehen die Keys im Frontend. Das
  ist üblich, aber der Key ist sichtbar. Wenn du ihn verbergen willst, richte einen kleinen
  Tile‑Proxy auf deinem Server ein, der den Key serverseitig anhängt und optional cached.
  Attribution: Dein BaseMapPanel setzt bereits Attributionsstrings aus config.json. Achte darauf,
  dass sie je Quelle korrekt sind.

---

Kurzantwort: Für kommerzielle Nutzung sind OSM‑Community‑Tile‑Server nicht geeignet. Nutze einen
bezahlten Anbieter (z. B. Thunderforest, Tracestrack) oder hoste selbst. Attribution ist immer
Pflicht.

Links und Hinweise je Layer/Provider:

OpenStreetMap Standard (osm-standard)

Lizenz/Daten: ODbL, Attribution Pflicht Tile-Server-Policy (keine Produktion/hohe Last):
https://operations.osmfoundation.org/policies/tiles/ Urheberrecht/Attribution:
https://www.openstreetmap.org/copyright HOT Humanitarian (osm-humanitarian)

Community-Server (OSM France); keine Produktion/hohe Last Info/Policy OSM France Tiles:
https://tile.openstreetmap.fr/ HOT: https://www.hotosm.org/ CyclOSM (cyclosm)

Community-Server (OSM France); keine Produktion/hohe Last Projektseite: https://www.cyclosm.org/
Hinweise/Policy (OSM France): https://tile.openstreetmap.fr/ Wiki:
https://wiki.openstreetmap.org/wiki/CyclOSM Carto Light (carto-light / Positron)

Keylos nutzbar mit Attribution; Fair‑Use, für hohe Last über CARTO‑Pläne Basemaps:
https://carto.com/basemaps/ Attribution: https://carto.com/attributions Pricing (Plattform):
https://carto.com/pricing/ (bei großem Volumen Sales kontaktieren) Thunderforest (Cycle/Transport u.
a.)

Kommerziell mit API‑Key; Pläne von Free bis Pro Pricing: https://www.thunderforest.com/pricing/
Terms/Attribution: https://www.thunderforest.com/terms/ Tracestrack Topo

API‑Key erforderlich; kostenlose und bezahlte Pläne Übersicht/Pricing:
https://www.tracestrack.com/en/maps/ Nutzungsbedingungen: https://www.tracestrack.com/en/terms/
Empfehlung:

Produktion: Nimm Thunderforest oder Tracestrack (oder MapTiler: https://www.maptiler.com/pricing/)
oder hoste Tiles selbst. Attribution in der Karte anzeigen (OSM + jeweiliger Anbieter). Soll ich
diese Links samt klarer Hinweise kompakt in eure README.md einpflegen?

---

[Zurück zur Übersicht](../README.md)