Twitch / Kick Stream Highlight Kesici

# Twitch / Kick Stream Highlight Kesici

**Ne inşa ediyoruz:** VOD URL'sini verince chat patlamalarını + sesli tepkileri analiz edip 10 viral 30sn klibi 9:16 dikey formatta üreten araç.

**Kullanıcının işi (JTBD):** Dün 6 saat yayın yaptım, en iyi 5 anı bugün TikTok ve Shorts'a koyup retention istiyorum, manuel clip aramaya zaman yok.

---

## Stack
- Next.js 15 App Router (frontend)
- Tailwind + shadcn/ui
- Supabase Postgres + Auth + storage
- Claude Sonnet 4.6
- Render.com worker (FFmpeg + Whisper)
- Twitch API
- Deploy: Vercel + Render

## Veri modeli
```sql
create table vods (
  id uuid primary key default gen_random_uuid(),
  user_id uuid references auth.users not null,
  source text, source_id text, url text,
  duration_seconds int, status text default 'queued',
  created_at timestamptz default now()
);

create table clips (
  id uuid primary key default gen_random_uuid(),
  vod_id uuid references vods on delete cascade,
  start_seconds int, end_seconds int,
  signal_score numeric, ai_caption text,
  output_url text
);
```

## Ana akışlar
1. Twitch VOD URL'si → metadata + chat transkripti.
2. Worker FFmpeg ile audio peak + Whisper segments.
3. Sinyal füzyonu: chat msg/dk + audio peak + spike noktaları.
4. Claude top 10 anı seç + caption yaz.
5. FFmpeg cut + 9:16 crop (face-track basit) + upload.

## 6 saatlik inşa sırası
- 0:00–1:00 — Scaffold + auth + VOD URL form
- 1:00–2:00 — Twitch chat fetch + audio extract
- 2:00–3:30 — Sinyal füzyonu (chat + audio)
- 3:30–4:30 — Claude clip seçimi + caption
- 4:30–5:30 — FFmpeg cut + 9:16 (crop center)
- 5:30–6:00 — Render worker deploy

## Başarı kriteri
- [ ] 1 VOD işlenip 10 clip üretildi
- [ ] Her clip 30sn ± 5sn
- [ ] 9:16 dikey crop (center crop yeterli MVP)
- [ ] Clip MP4 indirilebiliyor
- [ ] Thumbnail otomatik (ortadaki frame)

## Dikkat
- FFmpeg cold start ağır — Render worker kalıcı tutmak gerekebilir.
- Storage maliyeti: 1 saat VOD ~5GB; aggressive cleanup şart.
- 9:16 face-tracking v2 (MediaPipe veya OpenCV).
- Twitch ToS — kendi VOD'unu indirmek serbest, başkasının clip'i değil.