Kontrat Özeti ve Kırmızı Bayrak Uyarısı

# Kontrat Özeti ve Kırmızı Bayrak Uyarısı

**Ne inşa ediyoruz:** PDF sözleşme yüklenince özet + 8 risk kategorisinde bayrak listesi üreten tool.

**Kullanıcının işi (JTBD):** Freelancer olarak yeni bir sözleşme imzalamadan önce, avukata ₺3000 vermeden, cayma/otomatik yenileme/IP hakkı gibi riskleri görmek istiyorum, böylece kötü maddeyi atlamayayım.

---

## Stack
- Next.js 15 + TS strict, Tailwind + shadcn/ui
- Supabase (magic link + Postgres + Storage)
- pdf-parse (server-side text extraction)
- Claude Sonnet 4.6 (200k context)
- Deploy: Vercel

## Veri modeli
```sql
create table contracts (
  id uuid primary key default gen_random_uuid(),
  user_id uuid references auth.users,
  file_path text, page_count int,
  summary_md text, flags_json jsonb,
  risk_score int, created_at timestamptz default now()
);
```

## Ana akışlar
1. Magic link giriş → upload PDF → Storage'a koy.
2. pdf-parse ile sayfa sayfa text çıkar, toplam 150k token'a sığacak şekilde chunkla.
3. Claude tek çağrıda: "3 paragraf özet + 8 kategoride bayraklar [{category, quote, severity, explanation, page}]".
4. Sonuç sayfası: özet kart + bayrak listesi (severity renkli), tıklayınca PDF'in ilgili sayfası sağda.
5. Her sayfanın sonunda büyük disclaimer: "bu hukuki tavsiye değildir".

## 6 saatlik inşa sırası
- 0:00–1:00 — Scaffold + auth + storage + upload UI
- 1:00–2:00 — PDF parse + chunk stratejisi
- 2:00–4:00 — Claude prompt + JSON çıktı + render
- 4:00–5:00 — react-pdf preview + highlight overlay (MVP'de sadece sayfa atlama)
- 5:00–6:00 — Mobil, boş durum, deploy

## Başarı kriteri
- [ ] 30 sayfalık sözleşme çalışıyor
- [ ] 8 kategorinin hepsinde en az bir örnek üretiliyor
- [ ] Tıklanan bayrak ilgili sayfaya götürüyor
- [ ] Disclaimer her sayfada var
- [ ] Canlı URL

## Dikkat
- **Hukuki sorumluluk**: "öneri" dili, "garanti" yok.
- Büyük PDF'leri RAG değil tek prompt + 200k context ile vur, basit tut.
- Sözleşme metnini Claude'a göndermeden önce kullanıcıya onay ekranı göster.