Refactor code structure for improved readability and maintainability

README.md

@@ -1,4 +1,4 @@
-# SE Local Trenddata
+# SE Local Trenddata
 
 SE Local Trenddata ist eine webbasierte Trend-, Dashboard- und Quellenverwaltung fuer lokale Anlagen- und WAGO-Daten. Das Projekt besteht aus einem React-Frontend, einer Node.js/Express-API, MariaDB, Redis und einem Collector-Service fuer Protokollquellen wie Modbus TCP, OPC UA, BACnet IP und KNX IP.
 
@@ -671,3 +671,26 @@ Vor produktiver Nutzung:
 - Fuer vollstaendige Protokollintegration muessen je nach Feldbus noch Details wie Adressierung, Datentyp, Byteorder und Authentifizierung sauber projektspezifisch gepflegt werden.
 
 ---
+
+---
+
+## Konfiguration und Sicherheit
+
+Vor dem ersten Start `.env.example` nach `.env` kopieren und mindestens `JWT_SECRET`, `ADMIN_PASSWORD` und `REDIS_PASSWORD` durch eigene lange Zufallswerte ersetzen. Die lokale `.env` wird nicht versioniert.
+
+Redis ist ausschließlich innerhalb des Docker-Netzwerks erreichbar und verlangt ein Passwort. Für Diagnosezwecke:
+
+```powershell
+docker compose exec redis redis-cli -a $env:REDIS_PASSWORD ping
+```
+
+Alle Dienste können vor einem Deployment statisch geprüft werden:
+
+```powershell
+npm --prefix api run check
+npm --prefix collector run check
+npm --prefix symcon-collector run check
+npm --prefix bacnet-collector run check
+npm --prefix runner run check
+npm --prefix web run check
+```