AI Sözleşme Karşı-Teklif Yazarı

# AI Sözleşme Karşı-Teklif Yazarı

**Ne inşa ediyoruz:** PDF sözleşmeyi yükleyince riskli maddeleri tespit eden, her birine karşı-teklif metni öneren ve track-changes Word dosyası üreten araç.

**Kullanıcının işi (JTBD):** SaaS müşterimden gelen MSA'yı 20 dakikada okuyup, kabul edemeyeceğim 4-5 maddeyi profesyonel dilde counter-propose etmek istiyorum, böylece avukat masrafı çıkmadan sağlam müzakere edeyim.

---

## Stack
- Next.js 15 App Router + TypeScript
- Tailwind + shadcn/ui
- Supabase Postgres + storage (PDF saklama)
- Claude Sonnet 4.6 (200K context, uzun sözleşmelere)
- pdf-parse (server-side PDF → text)
- Deploy: Vercel

## Veri modeli
```sql
create table contracts (
  id uuid primary key default gen_random_uuid(),
  user_id uuid references auth.users not null,
  filename text, raw_text text, party_role text,
  created_at timestamptz default now()
);

create table clauses (
  id uuid primary key default gen_random_uuid(),
  contract_id uuid references contracts on delete cascade,
  ordinal int, original_text text, clause_type text,
  risk_level text check (risk_level in ('low','medium','high')),
  risk_explanation text, counter_proposal text,
  status text default 'pending'
);
```

## Ana akışlar
1. PDF upload + tarafımı seç (alıcı/satıcı/işveren).
2. pdf-parse → ham metin → Claude clause segmentation (numaralı liste).
3. Her clause için: tip (limitation, IP, indemnity...), risk skoru, açıklama, counter-text.
4. Side-by-side görünüm: orijinal | risk | karşı-teklif. Kullanıcı kabul/red/edit.
5. Sonuçları docx olarak track-changes formatında export.

## 6 saatlik inşa sırası
- 0:00–1:00 — Scaffold + auth + upload UI
- 1:00–2:00 — pdf-parse + Claude clause segmentation prompt
- 2:00–3:30 — Risk analizi + counter-proposal üretimi (per clause batch)
- 3:30–5:00 — Side-by-side review UI + accept/edit
- 5:00–5:30 — docx export (docx kütüphanesi, basit)
- 5:30–6:00 — Vercel deploy + 1 gerçek sözleşmeyle test

## Başarı kriteri (akşam demo)
- [ ] 5 sayfalık örnek sözleşme yükleniyor, parse ediliyor
- [ ] En az 8 clause segment, en az 2 yüksek-risk işaretli
- [ ] Her yüksek-riskli için counter-text Türkçe ve hukuk diliyle yazılmış
- [ ] Side-by-side ekran düzgün görünüyor
- [ ] docx export açılıyor (Word'de track changes değişiklik olarak)

## Dikkat
- **Disclaimer büyük yazılmalı**: "Hukuki tavsiye değildir, avukat onayı gerekir."
- 200K context Sonnet 4.6'da yeterli, ama 50+ sayfa için chunking gerekebilir.
- Türkçe sözleşmeler için sistem prompt'unda Türk hukuku terminolojisi örneği ver.
- Track-changes docx oluşturmak `docx` kütüphanesinde insert/delete revision kullanmayı gerektirir.