1.8 KiB
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.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/*.jsaufgerufen - Diese geben vorbereitete JSON-Dateien unter
/mockData/*.jsonzurü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.gitignorevom 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
mockoderreal