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

docs/guide/env.md

@@ -0,0 +1,39 @@
+<!-- /docs/guide/env.md-->
+
+# 🌐 Umgebungsvariablen (`.env.local` / `.env.production`)
+
+NodeMap verwendet Umgebungsvariablen zur Steuerung von API-Verhalten, Serverpfaden und Moduswahl
+(Mock oder Produktion).
+
+## 📂 Speicherort
+
+- **Lokal**: `.env.local` (für Entwicklung)
+- **Produktion**: `.env.production` (für `npm run build` & `npm start`)
+
+## 🔧 Wichtige Variablen
+
+| Variable                    | Beispielwert        | Beschreibung                                                          |
+| --------------------------- | ------------------- | --------------------------------------------------------------------- |
+| `DB_HOST`                   | `localhost`         | Adresse des Datenbankservers (MySQL)                                  |
+| `DB_PORT`                   | `3306`              | Port für die Datenbankverbindung                                      |
+| `DB_NAME`                   | `talas`             | Datenbankname                                                         |
+| `DB_USER`                   | `root`              | Benutzername für MySQL                                                |
+| `DB_PASSWORD`               | `geheim`            | Passwort für MySQL                                                    |
+| `NEXT_PUBLIC_API_PORT_MODE` | `prod` oder `dev`   | Steuert API-Routing bei Services (z. B. Portwechsel für lokal)        |
+| `NEXT_PUBLIC_USE_MOCKS`     | `true` oder `false` | Aktiviert den Mockdaten-Modus über `/api/mocks/...`                   |
+| `NEXT_PUBLIC_BASE_PATH`     | `/talas5` oder leer | Optionaler Pfad, falls App unter Subpfad läuft (z. B. IIS)            |
+| `NEXT_PUBLIC_DEBUG`         | `true` oder `false` | Aktiviert zusätzliche `console.log` Ausgaben für Debugging im Browser |
+
+## 📦 Beispiel `.env.production`
+
+```env
+DB_HOST=localhost
+DB_PORT=3306
+DB_NAME=talas
+DB_USER=root
+DB_PASSWORD=geheim
+NEXT_PUBLIC_API_PORT_MODE=prod
+NEXT_PUBLIC_USE_MOCKS=false
+NEXT_PUBLIC_BASE_PATH=/talas5
+NEXT_PUBLIC_DEBUG=false
+```