Sesli CRM Asistanı

# Sesli CRM Asistanı

**Ne inşa ediyoruz:** Saha satışçısının arabada sesli not bıraktığı, AI'ın yapılandırılmış görüşme kaydı + sonraki adım çıkardığı ve HubSpot/Pipedrive'a otomatik yazdığı PWA.

**Kullanıcının işi (JTBD):** Müşteri ziyaretinden çıkar çıkmaz arabada 90 saniye konuşmak istiyorum ve akşama CRM'e açıp tek tek yazmak zorunda kalmamalıyım.

---

## Stack
- Next.js 15 App Router + PWA manifest + offline-first
- Tailwind + shadcn/ui (mobile-first)
- Supabase Postgres + storage (ses dosyası)
- OpenAI Whisper API (TR'de iyi) + Claude Sonnet 4.6
- MediaRecorder API
- Deploy: Vercel

## Veri modeli
```sql
create table visits (
  id uuid primary key default gen_random_uuid(),
  user_id uuid references auth.users not null,
  audio_url text, duration_seconds int,
  transcript text,
  account_name text, contact_name text,
  stage text, sentiment text,
  notes text, next_step text, next_step_due date,
  crm_record_id text, crm_pushed_at timestamptz,
  created_at timestamptz default now()
);
```

## Ana akışlar
1. PWA aç → büyük "kaydet" butonu → 30-180sn ses → yükle.
2. Whisper transkript → Claude extraction prompt: account, contact, stage (cold/warm/hot), notes, next_step, due_date.
3. Kullanıcı extraction'ı düzenler → "CRM'e yolla" → HubSpot/Pipedrive create/update.
4. Liste: bugünün görüşmeleri, "next_step due olanlar" hatırlatma.

## 6 saatlik inşa sırası
- 0:00–1:00 — Scaffold, auth, PWA kurulum, Supabase storage bucket
- 1:00–2:00 — Mobil kayıt UI + ses upload
- 2:00–3:30 — Whisper transkript + Claude extraction prompt
- 3:30–4:30 — Extraction düzenleme ekranı + güncelleme
- 4:30–5:30 — HubSpot OAuth + contact/deal upsert
- 5:30–6:00 — Bugün listesi + Vercel deploy

## Başarı kriteri
- [ ] Telefondan ses kaydedip yükleme çalışıyor
- [ ] Whisper transkript Türkçe makul (aksiyon kelimeleri yakalıyor)
- [ ] Account/contact/stage/next_step alanları çıkarılıyor
- [ ] HubSpot test hesabına en az 1 kayıt yazıldı
- [ ] PWA telefonda "Ana ekrana ekle" çalışıyor

## Dikkat
- Whisper ücreti = 0.006/dk, MVP'de düşük ama batch izle.
- HubSpot OAuth onay süreci 1-2 hafta — MVP'de API key flow kullan.
- Offline ses kayıt + sonra senkron PWA'nın kazanan tarafı; service worker'ı atla(ma).
- Aksanlı TR için Whisper-large-v3 veya AssemblyAI Universal-2 alternatif.