ZeasyAlexandClaude Opus 5
d07c18441b
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
75 lines
3.6 KiB
Markdown
75 lines
3.6 KiB
Markdown
# 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.
|
||
|
||
TypeScript auf Node 24, **ohne Laufzeitabhängigkeiten und ohne Build-Schritt** —
|
||
Node führt die `.ts`-Dateien direkt aus, SQLite und WebSocket sind eingebaut.
|
||
Betrieb über Docker Compose.
|
||
|
||
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` | IRC + Helix → DB, Einrichtungsseite | **läuft** |
|
||
|
||
## 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 config\config.example.yaml config\config.yaml
|
||
docker compose build
|
||
docker compose run --rm toolkit check-env
|
||
docker compose run --rm toolkit fetch-model
|
||
docker compose up -d
|
||
```
|
||
|
||
Dann **http://localhost:4792/setup** öffnen und die Twitch-Zugangsdaten
|
||
eintragen. Sie werden verschlüsselt im Docker-Volume abgelegt, nicht in einer
|
||
Datei im Projekt ([ADR-0005](docs/decisions/ADR-0005-zugangsdaten.md)).
|
||
|
||
## Aktueller Stand
|
||
|
||
Scheiben **S0 und S1** des MVP „Clip-Knopf" sind fertig: Container-Toolchain,
|
||
Einrichtung im Browser, Twitch-Auth, Datenbank und Chat-Aufnahme. Als Nächstes
|
||
S2 — OBS-Anbindung und der `!clip`-Trigger. Fahrplan:
|
||
[`docs/07-mvp-plan.md`](docs/07-mvp-plan.md).
|
||
|
||
## Tests
|
||
|
||
```powershell
|
||
docker run --rm -v "${PWD}:/app" -w /app node:24-bookworm-slim node --test "packages/**/*.test.ts" "apps/**/*.test.ts"
|
||
```
|