S1: Einrichtungs-Assistent, Twitch-Auth, Datenbank und Chat-Aufnahme

Zugangsdaten kommen jetzt aus der App statt aus einer .env: ein
Einrichtungs-Assistent auf http://localhost:4792/setup nimmt Client-ID,
Secret und OBS-Passwort entgegen, der OAuth-Rueckruf laeuft auf denselben
Server. Gespeichert wird verschlueselt (AES-256-GCM) in einem Volume,
bewusst nicht in der Datenbank - die wird auf die Windows-Seite gesichert.
Siehe ADR-0005.

Technikbasis vereinfacht: Node 24 bringt node:sqlite, WebSocket, fetch und
die Ausfuehrung von TypeScript mit. Das Projekt hat damit null
Laufzeitabhaengigkeiten und keinen Build-Schritt; pnpm-Workspaces und die
Paketmanifeste sind entfallen, Importe laufen ueber die imports-Map der
Wurzel-package.json. erasableSyntaxOnly verhindert Syntax, die das Type
Stripping stillschweigend entfernen wuerde. Siehe Nachtrag 2 in ADR-0001.

Enthalten:
- packages/core: Config, Layout, Logger mit Secret-Maskierung, Retry, YAML
- packages/db: Migrationen, Repositories, alle SQL-Anweisungen an einem Ort
- packages/twitch: Secret-Speicher, OAuth, Helix mit Token-Bucket, IRC
- apps/ingest: Daemon, Einrichtungsseite, Spike-Erkennung
- 20 Tests (IRC-Parser, Spike-Detektor, Datenbankschicht)

Der Chat verbindet sich anonym, solange nichts hinterlegt ist - damit laesst
sich die Datenaufnahme pruefen, bevor die Twitch-Apps existieren.

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

docs/projects/clip-shorts.md

@@ -122,8 +122,26 @@ Bei Quelle = getrennte Vertical-Szene aus OBS entfällt der ganze Filtergraph.
 ## Untertitel
 
 `whisper.cpp` (`whisper-cli`), Modell `ggml-small` (deutsch, reicht; `medium`
-bei Bedarf), auf der extrahierten Audiospur (16 kHz Mono WAV). Kein Python,
-keine GPU nötig — auf CPU braucht ein 30-Sekunden-Clip unter einer Minute.
+bei Bedarf). Kein Python, keine GPU nötig — auf CPU braucht ein
+30-Sekunden-Clip unter einer Minute.
+
+**Transkribiert wird ausschließlich die Mikrofonspur.** OBS nimmt getrennte
+Audiospuren auf (Mikro auf Spur 2, Spielton auf Spur 3, Mischung auf Spur 1).
+Whisper bekommt nur Spur 2 — bei GTA-Motoren, Schüssen und Spielmusik ist das
+der Unterschied zwischen einem brauchbaren und einem unbrauchbaren Transkript.
+Ins fertige Short kommt weiterhin die Mischung von Spur 1.
+
+```bash
+# Mikrofonspur herausziehen, 16 kHz Mono, so wie whisper.cpp es erwartet
+ffmpeg -i raw.mp4 -map 0:a:1 -ac 1 -ar 16000 -c:a pcm_s16le mic.wav
+whisper-cli -m /models/ggml-small.bin -l de -oj -osrt -f mic.wav
+```
+
+`-map 0:a:1` ist der zweite Audiostrom der Datei — welcher das ist, hängt davon
+ab, wie OBS die Spuren schreibt. Die Zuordnung steht in
+`config/config.yaml` unter `clipper.audio` und wird beim ersten Clip mit
+`ffprobe` gegengeprüft.
+
 Ausgabe als SRT, Umwandlung in ASS mit Karaoke-Timing
 (wortweises Highlight — der Stil, der auf Shorts funktioniert), dann einbrennen: