Müşteri Yorumu Asistanı

# Müşteri Yorumu Asistanı

**Ne inşa ediyoruz:** E-ticaret satıcılarının gelen yorumlarını sentiment analiziyle önceliklendirip, negatif yorumlara empatik cevap taslağı öneren bir panel.

**Kullanıcının işi (JTBD):** Trendyol/Shopify'da haftada 200+ yorum aldığımda, kritik negatifleri hızla görüp 2 dakikada cevaplamak istiyorum, böylece hem müşteriyi kaybetmeyeyim hem de günümü kaybetmeyeyim.

---

## Stack
- Next.js 15 App Router + TypeScript strict
- Tailwind + shadcn/ui
- Supabase Postgres + magic link auth
- Anthropic Claude Sonnet 4.6
- Entegrasyon: Trendyol API veya Shopify webhook (MVP için mock JSON seed yeterli)
- Deploy: Vercel

## Veri modeli
```sql
create table stores (
  id uuid primary key default gen_random_uuid(),
  user_id uuid references auth.users not null,
  platform text check (platform in ('trendyol','shopify')),
  store_name text, api_key_encrypted text,
  created_at timestamptz default now()
);

create table reviews (
  id uuid primary key default gen_random_uuid(),
  store_id uuid references stores on delete cascade,
  external_id text unique, rating int, author text, body text,
  received_at timestamptz,
  sentiment text check (sentiment in ('neg','neu','pos')),
  priority int default 0, reply_draft text,
  status text default 'pending' check (status in ('pending','sent','dismissed'))
);
```

## Ana akışlar
1. Magic link girişi, mağaza bağla (platform + API key formu).
2. "Senkronla" butonu veya saatlik cron son 50 yorumu çeker.
3. Dashboard: kritik negatif → nötr → pozitif sırasıyla kart listesi.
4. Karta tıkla → Claude empatik cevap önersin → düzenle → "gönderildi" işaretle.

## 6 saatlik inşa sırası
- 0:00–1:00 — Scaffold, Supabase schema, magic link, boş dashboard
- 1:00–2:30 — Mağaza formu, mock yorum seed, sentiment batch çağrısı
- 2:30–4:30 — Dashboard liste + detay modal + Claude draft üretimi
- 4:30–5:30 — Mobil kart UI, boş durum, hata mesajları
- 5:30–6:00 — Vercel deploy + 10 gerçek yorumla smoke test

## Başarı kriteri (akşam demo)
- [ ] En az 1 mock mağaza bağlanabiliyor ve yorumlar çekiliyor
- [ ] Negatifler listede en üstte, kırmızı bir ipucu ile
- [ ] Claude cevap draft'ı doğru dilde (TR) ve empatik
- [ ] "Gönderildi" işaretleme state'i kalıcı
- [ ] Mobilde bozulma yok, canlı URL var

## Dikkat
- Trendyol API onay süreci uzun — MVP'de mock JSON ile başla, API'yi v2'ye bırak.
- Sentiment'i tek çağrıda 20'lik batch ile al, maliyet kontrolü için Haiku da olur.
- Cevabı **asla otomatik gönderme**; sadece draft öner.