Files

ISA 40cb07b485 feat(docs): README.md optimiert und technische Dokumentation ausgelagert

- README.md für Offline-Betrieb und Kundenserver überarbeitet (ohne npm install)
- Benutzeranleitung und technische Themen nach /docs/guide/ ausgelagert
- Neue Dateien: env.md, mock-data.md, webservices.md, redux-zustand.md, project-structure.md, dependencies.md, user-guide.md
- Tabellenstruktur und Verlinkungen im README modernisiert
- Fokus auf klare Trennung: Entwickler-Doku vs. Kundenbereitstellung

2025-06-05 08:59:38 +02:00

1.8 KiB

Raw Blame History

🧪 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.local 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

1.8 KiB Raw Blame History

🧪 Mockdaten-Modus (NEXT_PUBLIC_USE_MOCKS=true)