Struktur, Doku und S0-Toolchain fuer das abdulive-Toolkit

Monorepo-Geruest fuer neun Streamer-Tools plus den Ingest-Daemon, der
unter sechs davon liegt. Enthaelt:

- docs/: Ueberblick, Architektur, Twitch-Integration, Datenmodell,
  Roadmap, Setup, Hebel-Analyse und den MVP-Plan "Clip-Knopf"
- docs/projects/: je eine Spezifikation pro Tool
- docs/decisions/: vier ADRs (TS-Monorepo, SQLite, EventSub/IRC, Docker)
- docker/: Image mit ffmpeg und whisper.cpp, abhaengigkeitsfreier
  Entrypoint mit check-env, fetch-model und calibrate
- config/layout.yaml: aus einem VOD-Screenshot eingemessener
  Facecam-Ausschnitt (440x330 oben links, Chat-Overlay ab x=1270)

Noch kein Anwendungscode - Scheibe S0 aus docs/07-mvp-plan.md.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013VTGjd92LsDDWF3frd9FTB

docker-compose.yml

@@ -0,0 +1,49 @@
+# Stand: Scheibe S0 aus docs/07-mvp-plan.md.
+# Es gibt noch keinen Daemon - der Container fuehrt einzelne Befehle aus
+# (check-env, fetch-model, calibrate). Ab S1 wird daraus ein Langlaeufer.
+#
+# OBS_REPLAY_DIR in .env auf den Wiedergabepuffer-Ordner setzen, z. B.
+# OBS_REPLAY_DIR=C:/Users/abdu/Videos/replay
+
+services:
+  toolkit:
+    build:
+      context: .
+      dockerfile: docker/Dockerfile
+    image: abdulive/toolkit:dev
+    container_name: abdulive-toolkit
+    env_file:
+      - path: .env
+        required: false
+    command: ["help"]
+
+    # OBS laeuft auf dem Host, nicht im Container
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+
+    ports:
+      - "127.0.0.1:4780:4780"   # OAuth-Rueckruf, nur waehrend `auth` (ab S1)
+      - "127.0.0.1:4791:4791"   # Overlay-Server (ab M3)
+      - "127.0.0.1:4792:4792"   # Sichtungsseite (ab S5)
+
+    volumes:
+      # Konfiguration: nur lesend
+      - ./config:/app/config:ro
+      # OBS-Wiedergabepuffer: nur lesend, wird zum Verarbeiten einmal kopiert
+      - ${OBS_REPLAY_DIR:-./data/replay}:/replay:ro
+      # Fertige Clips landen wieder auf der Windows-Seite
+      - ./data/clips:/app/data/clips
+      # DB, Modelle und Arbeitsdateien in benannten Volumes - NICHT als
+      # Bind-Mount, siehe docs/decisions/ADR-0004-docker.md
+      - abdulive-db:/db
+      - abdulive-models:/models
+      - abdulive-work:/work
+
+    # Damit das Encoding dem Stream nicht die CPU wegnimmt
+    cpus: "3.0"
+    mem_limit: 3g
+
+volumes:
+  abdulive-db:
+  abdulive-models:
+  abdulive-work: