KI-AGENT: Lokalen Matrix-Entwicklungsstack ergänzen

matrix/README.md

@@ -94,3 +94,81 @@ docker compose up -d
 - Die aktuellen Ports für TURN und LiveKit müssen auf der Firewall des Servers freigegeben werden.
 - Federation sollte erst nach einer expliziten Entscheidung geöffnet werden. Für B2B-Kommunikation ist eine Allowlist sinnvoll.
 - Die Werte in `.env.example` sind Platzhalter und nicht produktionssicher.
+
+## Lokaler Entwicklungsstack
+
+Für lokale Entwicklung gibt es zusätzlich das Profil `matrix-dev`. Es nutzt direkte Localhost-Ports und braucht keine öffentlichen Domains, kein ACME und keine Traefik-Router.
+
+Lokale Dienste:
+
+- Synapse: `http://localhost:8008`
+- Element Web: `http://localhost:8080`
+- MatrixRTC JWT-Service: `http://localhost:8081`
+- LiveKit: `ws://localhost:7880`
+- TURN: `localhost:3478`
+
+### Lokale Synapse-Konfiguration erzeugen
+
+```bash
+docker compose --profile matrix-dev run --rm \
+  -e SYNAPSE_SERVER_NAME=localhost \
+  -e SYNAPSE_REPORT_STATS=no \
+  matrix-dev-synapse generate
+```
+
+Danach `matrix/dev/synapse/homeserver.yaml` für die lokale Compose anpassen:
+
+```yaml
+public_baseurl: "http://localhost:8008/"
+
+database:
+  name: psycopg2
+  args:
+    user: synapse
+    password: "synapse-dev-password"
+    database: synapse
+    host: matrix-dev-db
+    cp_min: 5
+    cp_max: 10
+
+redis:
+  enabled: true
+  host: matrix-dev-redis
+
+enable_registration: true
+enable_registration_without_verification: true
+
+turn_uris:
+  - "turn:localhost:3478?transport=udp"
+  - "turn:localhost:3478?transport=tcp"
+turn_shared_secret: "matrix-dev-turn-secret"
+turn_user_lifetime: "1h"
+
+experimental_features:
+  msc3266_enabled: true
+  msc4222_enabled: true
+```
+
+### Lokalen Stack starten
+
+```bash
+docker compose --profile matrix-dev up -d \
+  matrix-dev-db \
+  matrix-dev-redis \
+  matrix-dev-synapse \
+  matrix-dev-turn \
+  matrix-dev-livekit \
+  matrix-dev-rtc-jwt \
+  matrix-dev-element
+```
+
+Einen lokalen Admin-Nutzer kannst du danach im Synapse-Container anlegen:
+
+```bash
+docker compose --profile matrix-dev exec matrix-dev-synapse \
+  register_new_matrix_user -c /data/homeserver.yaml http://localhost:8008
+```
+
+Anschließend Element Web unter `http://localhost:8080` öffnen und mit dem lokalen Matrix-Nutzer anmelden.
+
+Wenn FEDEO selbst parallel lokal laufen soll, starte die FEDEO-Dienste separat wie gewohnt. Der lokale Matrix-Stack ist absichtlich über direkte Ports erreichbar, damit er unabhängig von DNS, TLS und Traefik getestet werden kann.

matrix/dev/element-config.json

@@ -0,0 +1,15 @@
+{
+  "default_server_config": {
+    "m.homeserver": {
+      "base_url": "http://localhost:8008",
+      "server_name": "localhost"
+    }
+  },
+  "disable_custom_urls": false,
+  "disable_guests": true,
+  "brand": "FEDEO Matrix Dev",
+  "default_theme": "light",
+  "features": {
+    "feature_video_rooms": true
+  }
+}