NodeMap ist eine modulare Kartenanwendung zur Visualisierung und Bearbeitung von GIS-Daten, POIs und Gerätestatus in einer interaktiven Leaflet-Karte.
Die Anwendung ist mit Next.js, React, Redux Toolkit, Tailwind CSS und Leaflet umgesetzt.

🌍 Live-Vorschau der Karte

🖥 Entwicklung & Test unter Windows 11 mit Node.js v18.17.1 und IIS
📦 MySQL 8.0 läuft lokal in einem Docker-Container (nur für Entwicklung)
🗄 Produktionsumgebung: TALAS.web und MySQL Server unter Windows Server

🧭 Zielumgebung

Windows-Produktionsserver (offline, kein Internet)
Kommunikation nur im lokalen Netzwerk
Nutzerzugriff per VPN + Remote Desktop (RDP)
Integration per iFrame in TALAS.web

🔄 Wie funktioniert das System?

TALAS.web ruft die App unter URL auf: http://<ip>/talas5/MessagesMap/mapTypC.aspx?m=12&u=484
Die App liest m und u aus der URL m(IdMap) u(IdUser)
MapComponent lädt POIs, Linien, Rechte, Geräte und Bereiche aus WebService von TALAS.web entsprechend
API-Endpunkte kommunizieren lokal mit Datenbankserver (MySQL)
Interaktive Bearbeitung (POI hinzufügen, verschieben, löschen) ist möglich
- Die Bearbeitungsfunktionen (POI hinzufügen, bearbeiten) sind nur aktiv, wenn der Nutzer das entsprechende Recht (ID 56) besitzt.
- Ist dies nicht der Fall, erscheint das Bearbeitungs-Icon ausgegraut mit Tooltip.

🧰 Erstinstallation auf Server

Voraussetzungen

Windows Server mit IIS
Sicherstellen, dass alle TALAS.web API-Endpunkte(WebService) erreichbar sind
Node.js & npm installiert (z. B. v18–20)
MySQL (lokal oder erreichbar)
Port 3000 freigegeben (Firewall)
IIS-Datei mapTypC.aspx vorhanden in C:\inetpub\wwwroot\talas5\MessagesMap\
Browser: Chrome ab Version 125.0.6420.142 empfohlen
Damit nicht ausversehen mapTiles gelöscht werden beim Code Update, werden die hier eingefügt, wenn vorhanden, müssen keine mapTiles manuell kopiert werden mapTiles auf dem server einzufügen:
C:\inetpub\wwwroot\talas5\TileMap

🔗 Integration in TALAS.web

Die App wird in einem iFrame geladen
Startet über ?m=X&u=Y für Map-/User-ID

Rechte und Inhalte werden automatisch geladen

z.B.
`http://10.10.0.13/talas5/MessagesMap/mapTypC.aspx?m=12&u=484`

Schritt-für-Schritt Anleitung

Projekt lokal klonen und kompilieren:

git clone http://10.10.0.12:3000/ISA/nodeMap
cd nodeMap
npm install
npm run build

ZIP-Paket vorbereiten (lokal):
- Verzeichnis .next/
- Verzeichnisse public/, node_modules/ falls nich vorhanden sind oder etwas hinzugefügt wurd (Bilder oder Bibliothek)
- Dateien .env.production, package.json falls nich vorhanden sind oder etwas hinzugefügt wurd (Umgebungsvariablen oder Bibliothek)
- optional: nssm.exe, StartNodeApp.bat, Start-Dev.ps1 um Windows Dienst zu erstellen falls noch nicht vorhanden ist Download: nssm
Auf Server kopieren nach: Ein Ordner temp auf dem Desktop erstellen->ZIP-Paket einfügen->entpacken->Inhalt in folgende Verzeichnis einfügen, weil verhindert Windows Server direkt kopieren in folgende Verzeichnis
```
C:\inetpub\wwwroot\talas5\nodeMap\
```
Kartenmaterial hinzufügen (falls nicht vorhanden):

Muss noch in Download-Server eingefügt werden, damit eine zentrale Stelle verfügbar ist
```
C:\inetpub\wwwroot\talas5\TileMap\
```
.env.production konfigurieren

Die Datei .env.production enthält alle benötigten Verbindungs- und Betriebsvariablen wie z. B. Datenbank-Zugang, Pfade und Mock-Option.

➡ Vollständige Anleitung & Beispieldatei:
📄 docs/guide/env.md

Dienst registrieren falls nicht vorhanden

Mit nssm.exe Windows-Dienst „nodeMapService“ erstellen
Ziel: StartNodeApp.bat
Anleitung: nssm

Starten:
Dienst starten , falls vorhanden einmal beenden und neustarten oder
```
npm start in Terminal für Debugging
```

Im Browser testen:

http://<ip>/talas5/MessagesMap/mapTypC.aspx?m=IdMap&u=IdUser
z.B.
http://<ip>/talas5/MessagesMap/mapTypC.aspx?m=12&u=484

🔁 Update-Richtlinien

Art	Ersetzte Dateien	Bemerkung
Kleines Update	`.next/`	`node_modules` nicht nötig
Großes Update	alle Dateien (wie Neuinstallation)	Dienst ggf. neu registrieren

Empfohlener Ablauf für kleines Update:

.next/ Verzeichnis nach Kompilieren kopieren und auf dem Server einfügen
Dienst oder npm start neu starten
Im Browser testen: http://<ip>/talas5/MessagesMap/mapTypC.aspx?m=IdMap&u=IdUser

✅ Tests & Qualitätssicherung

E2E-Tests: Cypress (nur in der Entwicklungsumgebung)
Unit-Tests: Aktuell keine Jest-Tests aufgrund Leaflet-Komplexität
Empfehlung: Manuelle Tests nach jedem Deployment durchführen (Checkliste vorbereiten)

🏷 Versionierung

wird mit husky Bibliothek automatisch erhöht bei "git commit message"

→ Wird in der Fußzeile angezeigt.

💾 Setup: Installationen & Tools

Tool	Version	Link
Node.js	20.12.1	nodejs
Chrome	optional	Chrome
NSSM.exe	2.24	nssm

Hinweis: Die Datei MapTypC.aspx in TALAS lädt NodeMap als iFrame über Port 3000.
Wenn die Seite nicht angezeigt wird, bitte sicherstellen:

Port 3000 ist in der Firewall freigegeben

Die IP im Scriptteil von MapTypC.aspx ist aktuell (z. B. 10.10.0.13)

Windows-Dienst NodeMapService ist aktiv oder npm start in Terminal ausgeführt

📁 Dokumentation & technische Leitfäden

Thema	Link
Benutzeranleitung	docs/guide/user-guide.md
Projektstruktur	project-structure.md
Webservices (TALAS)	webservices.md
Umgebungsvariablen	env.md
Mockdaten-Modus	mock-data.md
Zustandverwaltung (Redux)	redux-zustand.md
Abhängigkeiten	dependencies.md
Lokale Entwicklung	setup-dev.md
FAQ & Fehlerbehandlung	faq.md
Glossar	faq.md

README.md Unescape Escape

🌍 NodeMap – Kartenvisualisierung für TALAS.web (Next.js, Leaflet, Redux)