Willkommen in der Entwicklerdokumentation für NodeMap – einer modularen Kartenanwendung zur Visualisierung und Bearbeitung von GIS-Daten, POIs und Gerätestatus in einer interaktiven Leaflet-Karte.

Diese Anleitung führt dich Schritt für Schritt durch die wichtigsten Themen für lokale Entwicklung, Architekturverständnis und Erweiterung.

📚 Inhaltsverzeichnis

🔹 Einstieg & Übersicht

🧭 Architektur

Layer-Verbindung (Geräte)

⚙️ Konfiguration

Allgemeine Übersicht

🧩 Hauptkomponenten

🗺️ Kontextmenü

➕ POIs

📏 GIS-Polylinien

💡 UI-Komponenten

🧪 Weitere Tools

TestScript (Debug)

Projektüberblick

NodeMap wird von TALAS.web über einen iFrame geladen. Die Anwendung basiert auf folgenden Technologien:

Technologie	Zweck
Next.js	React-Framework (Frontend/SSR)
Leaflet	Kartendarstellung
Redux Toolkit	Zustandverwaltung
Tailwind CSS	Styling
MySQL	Datenbank
Node.js / IIS	Server und Auslieferung

👉 Mehr zur Systemarchitektur: architecture.md

Projektstruktur & Setup

Zielsystem

Offline-Umgebung
Windows-Server mit IIS
Datenzugriff über TALAS-Webservice oder lokale API

Lokale Entwicklung

➡ Entwicklungs-Setup
➡ Projektstruktur erklärt
➡ Abhängigkeiten & Tools
➡ Umgebungsvariablen (env-Dateien)

Webservices & API-Fluss

NodeMap verwendet zwei Quellen für Daten:

TALAS-WebServices (Port 80) – POIs, Geräte, Rechte, Linien usw.
Lokale Next.js API (Port 3000) – direkte Datenbankzugriffe via MySQL

➡ Webservices-Dokumentation

Zustandverwaltung Redux

Die komplette Anwendung verwendet Redux zur globalen Zustandverwaltung.

Architektur: Service → Thunk → Slice → Komponente
Beispiel: POIs, Marker, Linien, Rechte, Layer-Status
Redux DevTools werden unterstützt

➡ Zustandverwaltung mit Redux

Entwicklung & Testdaten

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

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

➡ Mockdaten & Entwicklung

Fehlerbehandlung & Glossar

Typische Probleme (z. B. Webservice nicht erreichbar, Layer nicht sichtbar) werden in der FAQ gesammelt.
Zudem gibt es eine Begriffsliste zur Orientierung:

➡ FAQ & häufige Fehler
➡ Glossar

Hinweis zum Deployment

📦 Die Anleitung für Server-Installation und ZIP-Deployment findest du in:
➡ Root-README.md

Tipp

Wenn du neu im Projekt bist, beginne mit dem Kapitel Projektstruktur & Setup und folge dann über die Webservices bis zu den Komponenten.

README.md Unescape Escape

📘 NodeMap – Entwicklerdokumentation