docs: .env.local durch .env.production & .env.development ersetzt + Rücklinks & Footer ergänzt

- Alle Hinweise in Markdown-Dateien aktualisiert: Verwendung von `.env.production` und `.env.development` statt `.env.local` - Footer-Abschnitte mit „Zurück zur Übersicht“-Link in allen relevanten `/docs/`-Dateien ergänzt - Inhaltliche Korrekturen und Ergänzungen in Architektur-, Setup-, FAQ-, und Mockdaten-Dokumentation - Inhaltsverzeichnis in `README.md` aktualisiert und funktionierende relative Links in Unterverzeichnissen sichergestellt - Ziel: bessere Lesbarkeit, Navigation und Klarheit für neue Entwickler
2025-06-24 09:00:49 +02:00
parent 0347ec9d98
commit 8894ce4411
21 changed files with 70 additions and 74 deletions
--- a/.env.development
+++ b/.env.development
@@ -25,4 +25,4 @@ NEXT_PUBLIC_USE_MOCKS=true
 NEXT_PUBLIC_BASE_PATH=/talas5
 # Oder leer lassen für direkten Zugriff ->  NEXT_PUBLIC_BASE_PATH=
 # App-Versionsnummer
-NEXT_PUBLIC_APP_VERSION=1.1.285
+NEXT_PUBLIC_APP_VERSION=1.1.286
--- a/.env.production
+++ b/.env.production
@@ -26,4 +26,4 @@ NEXT_PUBLIC_BASE_PATH=/talas5
 # Oder leer lassen für direkten Zugriff ->  NEXT_PUBLIC_BASE_PATH=

 # App-Versionsnummer
-NEXT_PUBLIC_APP_VERSION=1.1.285
+NEXT_PUBLIC_APP_VERSION=1.1.286
--- a/add-footer.ps1
+++ b/add-footer.ps1
@@ -1,27 +0,0 @@
-# Pfad zum docs-Ordner anpassen
-$root = "C:\Users\isa.LTW\Desktop\24.06.2025\NodeMap\24.06.2025 NodeMap\docs"
-
-# Alle .md-Dateien rekursiv holen, außer README.md
-$mdFiles = Get-ChildItem -Path $root -Recurse -Filter *.md | Where-Object { $_.Name -ne "README.md" }
-
-foreach ($file in $mdFiles) {
-    $content = Get-Content $file.FullName -Raw
-
-    if ($content -notmatch "\[Zurück zur Übersicht\]") {
-        # Pfad relativ zum Root-Ordner
-        $relativePath = $file.DirectoryName.Substring($root.Length).TrimStart('\')
-        $depth = if ($relativePath) { $relativePath.Split('\').Count } else { 0 }
-
-        # Rücksprungpfad berechnen
-        $backPath = ("../" * $depth) + "README.md"
-
-        # Footer-Text (ohne Emojis!)
-        $footer = "`n---`n`n[Zurück zur Übersicht]($backPath)`n`n"
-
-        # Footer anhängen
-        Add-Content -Path $file.FullName -Value $footer
-        Write-Host "✅ Footer hinzugefügt: $($file.FullName)"
-    } else {
-        Write-Host "🔄 Footer bereits vorhanden: $($file.FullName)"
-    }
-}
--- a/docs/README.md
+++ b/docs/README.md
@@ -128,7 +128,8 @@ Die komplette Anwendung verwendet Redux zur globalen Zustandverwaltung.

 Zur Entwicklung ohne echte API stehen lokale Mockdaten zur Verfügung:

- Aktivierung über `.env.local → NEXT_PUBLIC_USE_MOCKS=true`
+- Aktivierung über `.env.development → NEXT_PUBLIC_USE_MOCKS=true`
+- In `.env.production` sollte `NEXT_PUBLIC_USE_MOCKS=false` gesetzt sein
 - Nutzung z. B. in `pages/api/mocks/...`
 - Hinweise im UI zeigen aktivierten Mockmodus

--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -86,8 +86,14 @@ sequenceDiagram
 ## 🧩 Besonderheiten

 - **Konfigurierbarer basePath:**
-  Pfad wie `/talas5` ist optional und kann per `NEXT_PUBLIC_BASE_PATH` in `.env.local` gesetzt
+- **Konfigurierbarer basePath:**  
+  Pfad wie `/talas5` ist optional und kann per Umgebungsvariable `NEXT_PUBLIC_BASE_PATH` gesetzt
  werden.  
+  Die Konfiguration erfolgt je nach Umgebung über:
+
+  - `.env.development` für lokale Entwicklung
+  - `.env.production` für produktiven Einsatz
+
 - **Rechteabhängige UI:**  
  Funktionen (z. B. POI bearbeiten) basieren auf Benutzerrechten (`IdRight`) vom Server.
 - **Zentrale Komponentensteuerung:**  
--- a/docs/build-and-deploy.md
+++ b/docs/build-and-deploy.md
@@ -11,12 +11,13 @@ Ziel: Klarheit für Onboarding, Deployment-ZIP-Erstellung oder CI/CD.
 ## 📦 Wird beim `npm run build` in `.next/` gespeichert

 | Inhalt                                 | Beschreibung                                                             |
-| ---------------------- | -------------------------------------------------- |
+| -------------------------------------- | ------------------------------------------------------------------------ |
 | Kompilierte Seiten                     | Alle unter `/pages/`                                                     |
 | API-Routen                             | Alles aus `pages/api/`                                                   |
 | Assets aus `public/`                   | Werden im Build nicht verändert, aber ausgeliefert                       |
 | CSS-Dateien (Tailwind)                 | Werden gebundelt und minimiert                                           |
-| `.env.local`           | Wird eingelesen, aber nicht exportiert             |
+| `.env.production` / `.env.development` | Umgebungsabhängige Konfiguration. Wird eingelesen, aber nicht exportiert |
+
 | JS/TS-Quellcode | Wird zu Client- und Server-Bundles kompiliert |

 ---
@@ -43,7 +44,7 @@ Nur folgende Dateien/Ordner übertragen:
 public/
 package.json
 package-lock.json
-.env.local
+.env.production
 ```

 ---
--- a/docs/checklist.md
+++ b/docs/checklist.md
@@ -19,8 +19,8 @@ Bevor du einen Feature-, Refactor- oder Bugfix-Commit abschließt, geh diese Lis

 ## 📦 Konfiguration

- [ ] Ist `.env.local` aktuell und vollständig (für Entwickler/Testserver)?
- [ ] Wird jede Konfiguration ausschließlich über `.env.local` gesteuert?
+- [ ] Sind `.env.production` und `.env.development` aktuell und vollständig?
+- [ ] Wird jede Konfiguration **ausschließlich über `.env.*` Dateien** gesteuert?

 ---

--- a/docs/components/uiWidgets/VersionInfoModal.md
+++ b/docs/components/uiWidgets/VersionInfoModal.md
@@ -30,10 +30,10 @@ Die Komponente informiert Nutzer über:
 ## ⚙️ Props

 | Prop                    | Typ        | Beschreibung                                                                                |
-| ----------------------- | ---------- | -------------------------------------------------------------- |
+| ----------------------- | ---------- | ------------------------------------------------------------------------------------------- |
 | `showVersionInfoModal`  | `boolean`  | Steuert, ob das Modal angezeigt wird                                                        |
 | `closeVersionInfoModal` | `function` | Callback zum Schließen des Modals                                                           |
-| `APP_VERSION`           | `string`   | Versionstext (z. B. `1.1.188`), meist aus `.env.local` geladen |
+| `APP_VERSION`           | `string`   | Versionstext (z. B. `1.1.188`), meist aus `.env.production` oder `.env.development` geladen |

 ---

@@ -81,7 +81,7 @@ Die Komponente informiert Nutzer über:

 ## 📦 Verknüpfte Dateien

- `.env.local` enthält z. B. `NEXT_PUBLIC_APP_VERSION=1.1.188`
+- `.env.production` oder `.env.development` enthält z. B. `NEXT_PUBLIC_APP_VERSION=1.1.188`
 - Aufruf in `Footer` oder `Layout` zur Anzeige bei Klick auf „Version“

 ---
@@ -94,6 +94,4 @@ Die Komponente informiert Nutzer über:

 ---

---
-
 [Zurück zur Übersicht](../../README.md)
--- a/docs/config/README.md
+++ b/docs/config/README.md
@@ -2,7 +2,8 @@

 # ⚙️ Konfigurationsübersicht (/config)

-Dieses Verzeichnis enthält zentrale Konfigurationsdateien, die das Verhalten der gesamten App steuern.  
+Dieses Verzeichnis enthält zentrale Konfigurationsdateien, die das Verhalten der gesamten App
+steuern.  
 Hier sind die wichtigsten Dateien, ihre Aufgaben und Verlinkungen zur Dokumentation:

 ---
@@ -23,7 +24,7 @@ Hier sind die wichtigsten Dateien, ihre Aufgaben und Verlinkungen zur Dokumentat

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

- Berechnet den Basis-Pfad aus `.env.local`
+- Berechnet den Basis-Pfad aus `.env.production` oder `.env.development`
 - Liefert `BASE_URL`, z. B. `/talas5`

 ---
--- a/docs/config/config.md
+++ b/docs/config/config.md
@@ -11,7 +11,7 @@ Diese Datei enthält zentrale Konfigurationswerte, die abhängig von der Umgebun

 ## Ersetzungen von Umgebungsvariablen

-Vorher wurden folgende `.env.local` Variablen verwendet:
+Vorher wurden folgende `.env.production` / `.env.development` Variablen verwendet:

 - `NEXT_PUBLIC_BASE_URL`
 - `NEXT_PUBLIC_SERVER_URL`
@@ -46,7 +46,7 @@ const serverURL =
 - `USE_MOCK_API`: aktiviert lokale Mock-Daten
 - `serverURL`: Basis für Webservice-Aufrufe (`/talas5/...`)
 - `mapGisStationsStaticDistrictUrl`: komplette zusammengesetzte URL
- `useMockStationData`: true/false aus `.env.local`
+- `useMockStationData`: true/false aus `.env.production` / `.env.development`

 ---

--- a/docs/config/paths.md
+++ b/docs/config/paths.md
@@ -2,7 +2,8 @@

 # 📁 paths.js

-Berechnet den sauberen `BASE_URL`-Pfad basierend auf `.env.local → NEXT_PUBLIC_BASE_PATH`.  
+Berechnet den sauberen `BASE_URL`-Pfad basierend auf `.env.production` oder
+`.env.development → NEXT_PUBLIC_BASE_PATH`.  
 Entfernt führende und abschließende Slashes.

 ## Beispiel
--- a/docs/guide/env.md
+++ b/docs/guide/env.md
@@ -1,13 +1,13 @@
 <!-- /docs/guide/env.md-->

-# 🌐 Umgebungsvariablen (`.env.local` / `.env.production`)
+# 🌐 Umgebungsvariablen (`.env.production` / `.env.development`)

 NodeMap verwendet Umgebungsvariablen zur Steuerung von API-Verhalten, Serverpfaden und Moduswahl
 (Mock oder Produktion).

 ## 📂 Speicherort

- **Lokal**: `.env.local` (für Entwicklung)
+- **Entwicklung**: `.env.development`
 - **Produktion**: `.env.production` (für `npm run build` & `npm start`)

 ## 🔧 Wichtige Variablen
@@ -38,6 +38,20 @@ NEXT_PUBLIC_BASE_PATH=/talas5
 NEXT_PUBLIC_DEBUG=false
 ```

+## 📦 Beispiel `.env.development`
+
+```env
+DB_HOST=localhost
+DB_PORT=3306
+DB_NAME=talas
+DB_USER=root
+DB_PASSWORD=geheim
+NEXT_PUBLIC_API_PORT_MODE=dev
+NEXT_PUBLIC_USE_MOCKS=true
+NEXT_PUBLIC_BASE_PATH=/talas5
+NEXT_PUBLIC_DEBUG=true
+```
+
 ---

 [Zurück zur Übersicht](../README.md)
--- a/docs/guide/faq.md
+++ b/docs/guide/faq.md
@@ -30,7 +30,7 @@

 ### 🔹 Wie kann ich die Karte lokal testen, ohne Backend?

- Setze in `.env.local` die Variable `NEXT_PUBLIC_USE_MOCKS=true`.
+- Setze in `.env.development` die Variable `NEXT_PUBLIC_USE_MOCKS=true`.
 - Starte mit `npm run dev`.
 - Die App lädt jetzt Mockdaten aus `/mockData/`.

--- a/docs/guide/mock-data.md
+++ b/docs/guide/mock-data.md
@@ -21,7 +21,8 @@ Mockdaten werden aktiviert durch folgende Umgebungsvariable:
 NEXT_PUBLIC_USE_MOCKS=true
 ```

-Diese Variable wird in `.env.local` gesetzt und **nicht** für die Produktionsumgebung verwendet.  
+Diese Variable wird in `.env.development` gesetzt und **nicht** für die Produktionsumgebung
+verwendet.  
 Im Produktivbetrieb steht:

 ```env
--- a/docs/guide/onboarding-checklist.md
+++ b/docs/guide/onboarding-checklist.md
@@ -21,7 +21,7 @@ Projekt.

   ☐ Erledigt

-3. **`.env.local` anlegen**  
+3. **`.env.development` anlegen**  
   _Siehe [env.md](docs/guide/env.md) für Details._  
   ☐ Erledigt

--- a/docs/guide/project-structure.md
+++ b/docs/guide/project-structure.md
@@ -33,8 +33,7 @@ components/     → UI-Komponenten inkl. Karte und Layer-Control-Panel (`MapLaye
 ┃ ┗ 📜VersionInfoModal.js
 ┗ 📜TestScript.js

-
-config/         → zentrale Variablen (.env.local)
+config/         → zentrale Variablen (.env.development, .env.production)

 hooks/          → eigene React-Hooks

--- a/docs/guide/setup-dev.md
+++ b/docs/guide/setup-dev.md
@@ -31,7 +31,7 @@ NEXT_PUBLIC_USE_MOCKS=true

 - **Umgebungsvariablen lokal definieren:**

-Datei `.env.local` mit Inhalten wie:
+Datei `.env.development` mit Inhalten wie:

 ```
 NEXT_PUBLIC_API_URL=http://localhost:3001
--- a/docs/utils/devices/createAndSetDevices.md
+++ b/docs/utils/devices/createAndSetDevices.md
@@ -49,11 +49,11 @@ const mode = process.env.NEXT_PUBLIC_API_PORT_MODE;

 const baseUrl =
  mode === "dev"
-    ? \`\${window.location.protocol}//\${window.location.hostname}:80/talas5/\`
-    : \`\${window.location.origin}/talas5/\`;
+    ? `${window.location.protocol}//${window.location.hostname}:80/talas5/`
+    : `${window.location.origin}/talas5/`;
 ```

-➡ Dadurch wird verhindert, dass bei jeder Server-IP `.env.local` oder ein Build nötig ist.
+➡ Dadurch wird verhindert, dass bei jeder Server-IP `.env.development` oder ein Build nötig ist.

 ---

--- a/docs/utils/polylines/setupPolylines.md
+++ b/docs/utils/polylines/setupPolylines.md
@@ -13,7 +13,7 @@ Sie wird verwendet, um:
 - Stützpunkte visuell als Marker anzuzeigen
 - Marker kontextsensitiv mit Optionen (z. B. „Stützpunkt entfernen“, „Koordinaten anzeigen“)
  auszustatten
- Linien aktualisieren und neue Koordinaten in die Datenbank schreiben
+- Linien zu aktualisieren und neue Koordinaten in die Datenbank zu schreiben
 - Kontextmenü-Interaktionen zu ermöglichen

 ---
@@ -21,7 +21,7 @@ Sie wird verwendet, um:
 ## Besonderheiten

 - Marker mit speziellen Icons (Start, Ende, Zwischenpunkt)
- Interaktivität abhängig vom Bearbeitungsmodus (editMode aus `localStorage`)
+- Interaktivität abhängig vom Bearbeitungsmodus (`editMode` aus `localStorage`)
 - Kontextmenü pro Marker und Linie individuell steuerbar
 - API-Aufrufe zur Koordinaten-Aktualisierung:  
  `POST /api/talas_v5_DB/gisLines/updateLineCoordinates`
@@ -30,8 +30,9 @@ Sie wird verwendet, um:

 ## Dynamische URL mit Port-Steuerung

-Die Datei verwendet **keine feste API-Basis-URL** mehr aus `.env.local`.  
-Stattdessen wird `NEXT_PUBLIC_API_PORT_MODE` genutzt, um zwischen Entwicklungs- und
+Die Datei verwendet **keine feste API-Basis-URL** mehr aus `.env.development` oder
+`.env.production`.  
+Stattdessen wird `NEXT_PUBLIC_API_PORT_MODE` verwendet, um zwischen Entwicklungs- und
 Produktionsumgebung zu unterscheiden:

 ```env
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
  "name": "nodemap",
-  "version": "1.1.285",
+  "version": "1.1.286",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "nodemap",
-      "version": "1.1.285",
+      "version": "1.1.286",
      "dependencies": {
        "@emotion/react": "^11.13.3",
        "@emotion/styled": "^11.13.0",
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "nodemap",
-  "version": "1.1.285",
+  "version": "1.1.286",
  "dependencies": {
    "@emotion/react": "^11.13.3",
    "@emotion/styled": "^11.13.0",