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

README.md

@@ -0,0 +1,57 @@
+# abdulive-toolkit
+
+Werkzeugkasten für den Twitch-Kanal **abdulive_**. Ein Monorepo mit mehreren
+kleinen Diensten, die sich einen gemeinsamen Kern teilen: Twitch-Auth,
+Helix-Client, EventSub/IRC-Ingest und eine SQLite-Datenbank.
+
+Zielgröße des Kanals: ~5–30 gleichzeitige Zuschauer. Alles hier ist auf diese
+Phase optimiert — nicht auf Skalierung, sondern auf **Wachstum und Bindung**.
+
+## Die neun Tools
+
+| # | Tool | Ordner | Zweck | Status |
+|---|------|--------|-------|--------|
+| 1 | Clip-to-Shorts | `apps/clipper` | Clips → 9:16 mit Untertiteln, Upload-fertig | geplant |
+| 2 | Go-Live-Broadcaster | `apps/broadcaster` | Stream-Start → Discord/Bluesky/Instagram | geplant |
+| 3 | Raid- & Netzwerk-Tool | `apps/raid-scout` | Raid-Ziele finden, Raid-Historie führen | geplant |
+| 4 | Analytics-Dashboard | `apps/dashboard` | Viewer vs. Chat, Titel-Performance, Retention | geplant |
+| 5 | VOD-Kapitel | `apps/vod-chapters` | Szenen-/Kategoriewechsel → Timestamps | geplant |
+| 6 | Community-Gedächtnis | `apps/community` | Chatter-Profile, Begrüßungen, Overlay-Hinweise | geplant |
+| 7 | Chat steuert Dinge | `apps/overlay-server` + `apps/overlay-web` | Overlay, Soundboard, Minigames, Umfragen | geplant |
+| 8 | Punktesystem + Shop | `apps/loyalty` | Punkte mit echten Konsequenzen | geplant |
+| 9 | Stream-Recap | `apps/recap` | Zusammenfassung nach Streamende in Discord | geplant |
+
+Dazu der Dienst, der unter allen anderen liegt:
+
+| — | **Ingest-Daemon** | `apps/ingest` | EventSub + IRC → Event-Bus + DB | **zuerst** |
+
+## Doku
+
+- [`docs/00-overview.md`](docs/00-overview.md) — Was hier gebaut wird und warum
+- [`docs/01-architecture.md`](docs/01-architecture.md) — Aufbau, Datenfluss, Prozesse
+- [`docs/02-twitch-integration.md`](docs/02-twitch-integration.md) — Auth, Scopes, EventSub, Rate Limits
+- [`docs/03-data-model.md`](docs/03-data-model.md) — Datenbankschema
+- [`docs/04-roadmap.md`](docs/04-roadmap.md) — Reihenfolge und Meilensteine
+- [`docs/05-setup.md`](docs/05-setup.md) — Lokal einrichten
+- [`docs/06-hebel-analyse.md`](docs/06-hebel-analyse.md) — **Womit anfangen und warum**
+- [`docs/07-mvp-plan.md`](docs/07-mvp-plan.md) — **MVP „Clip-Knopf": Umfang, Scheiben, Zeitplan**
+- [`docs/projects/`](docs/projects/) — je ein Spec-Dokument pro Tool
+- [`docs/decisions/`](docs/decisions/) — Architekturentscheidungen (ADRs)
+
+## Schnellstart
+
+Alles läuft in Docker — auf dem Rechner werden nur Docker Desktop und OBS
+gebraucht, ffmpeg und whisper.cpp stecken im Image.
+Siehe [`docs/05-setup.md`](docs/05-setup.md).
+
+```powershell
+Copy-Item .env.example .env
+Copy-Item config\config.example.yaml config\config.yaml
+docker compose build
+docker compose run --rm toolkit check-env
+```
+
+## Aktueller Stand
+
+Struktur und Dokumentation stehen, Code noch nicht. Als Nächstes:
+**MVP „Clip-Knopf"** nach [`docs/07-mvp-plan.md`](docs/07-mvp-plan.md).