Files
nodeMap/docs/guide/mock-data.md
ISA 8894ce4411 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

1.8 KiB

🧪 Mockdaten-Modus (NEXT_PUBLIC_USE_MOCKS=true)

Dieses Projekt unterstützt einen optionalen Mockdaten-Modus, um Entwicklung und Tests ohne Backend/Webservice durchzuführen.


🔍 Zweck & Nutzen

  • Schneller Entwicklungsstart ohne aktive Serververbindung
  • Stabilere Testszenarien mit festen JSON-Daten
  • Vollständige Isolation von Backend-Fehlern während der UI-Entwicklung

⚙️ Aktivierung

Mockdaten werden aktiviert durch folgende Umgebungsvariable:

NEXT_PUBLIC_USE_MOCKS=true

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

NEXT_PUBLIC_USE_MOCKS=false

🧩 Funktionsweise

Wenn NEXT_PUBLIC_USE_MOCKS=true gesetzt ist:

  • Statt realer Webservices werden Endpunkte unter /pages/api/mocks/webservice/*.js aufgerufen
  • Diese geben vorbereitete JSON-Dateien unter /mockData/*.json zurück

📂 Beispiel-Aufruf im Mockmodus

// Beispiel aus fetchGisSystemStaticService.js
const url = useMocks
  ? "/api/mocks/webservice/GisSystemStatic"
  : `${apiUrl}/WebServiceMap.asmx/GisSystemStatic`;

🛡️ Sicherheit & Versionskontrolle

  • Alle .json-Dateien im Ordner /mockData/ sind über .gitignore vom Repository ausgeschlossen
  • So wird verhindert, dass versehentlich sensible Testdaten veröffentlicht werden

💡 Hinweise

  • Mockdaten sollen nur die wichtigsten API-Schnittstellen simulieren
  • Bei Änderungen am Datenmodell sollten auch die Mockdaten aktualisiert werden
  • Eine zentrale Thunk- & Service-Logik entscheidet automatisch, ob mock oder real

🔗 Weitere Informationen


Zurück zur Übersicht