Zentrale .env-Konfiguration für alle Umgebungsvariablen

README.md

@@ -10,6 +10,7 @@ Kein überladenes Dashboard. Keine Kacheln. Im Mittelpunkt steht eine extrem sch
 ```bash
 git clone <repo-url> LaunchPad
 cd LaunchPad
+cp .env.example .env   # optional anpassen, siehe unten
 docker compose up -d --build
 ```
 
@@ -78,23 +79,31 @@ Noch **nicht** enthalten (folgt in den nächsten Commits):
   — beide Backend-APIs existieren bereits vollständig
 - TanStack Router, Plugin-System, PWA-Manifest, shadcn/ui, RHF
 
-### FritzBox-Scan konfigurieren
+### Umgebungsvariablen (.env)
 
-Der FritzBox-Scan benötigt drei Umgebungsvariablen (z. B. in `docker-compose.yml`
-beim `backend`-Service oder lokal per `.env`):
+Alle Umgebungsvariablen sind in `.env.example` dokumentiert. Für die lokale
+Entwicklung und für Docker Compose:
 
-```
-FRITZBOX_HOST=192.168.1.1
-FRITZBOX_USERNAME=<TR-064-Benutzername>
-FRITZBOX_PASSWORD=<TR-064-Passwort>
-FRITZBOX_PORT=49000        # optional, Default 49000
+```bash
+cp .env.example .env
+# .env anpassen (v. a. FRITZBOX_* für den FritzBox-Scan)
 ```
 
-TR-064-Zugriff muss in der FritzBox unter *Heimnetz → Netzwerk → Netzwerkeinstellungen
-→ „Zugriff für Anwendungen zulassen"* aktiviert sein. Getestet wurde der komplette
-SOAP-/Digest-Auth-Ablauf gegen einen Mock-Server mit realistischer TR-064-Antwort
-(korrektes und falsches Passwort); ein Test gegen eine echte FritzBox war in dieser
-Entwicklungsumgebung nicht möglich (kein Netzwerkzugriff auf lokale Geräte).
+`.env` ist in `.gitignore` und wird nie committet. **Auf dem Server
+(`/opt/LaunchPad`) muss sie nach dem ersten `git pull` einmalig manuell
+angelegt werden**, da git-ignorierte Dateien nicht mitgepullt werden:
+
+```bash
+cd /opt/LaunchPad
+cp .env.example .env
+nano .env   # FRITZBOX_* eintragen
+docker compose up -d --build
+```
+
+Fehlt `.env` komplett, startet alles trotzdem mit den in `docker-compose.yml`
+hinterlegten Defaults – der FritzBox-Scan liefert dann kontrolliert `HTTP 400`
+statt abzustürzen. Für `pnpm dev:backend` (ohne Docker) wird `.env` automatisch
+über `dotenv` geladen (`apps/backend/src/env.ts`, wird als allererstes importiert).
 
 Siehe [`docs/ROADMAP.md`](./docs/ROADMAP.md) für die geplante Reihenfolge.