Fatura Okuyucu ve Muhasebe Asistanı

# Fatura Okuyucu ve Muhasebe Asistanı

**Ne inşa ediyoruz:** Fatura fotoğrafını Claude vision ile okuyup yapılandırılmış veri + kategori tahmini üreten ve Google Sheets'e gönderen mobil-öncelikli PWA.

**Kullanıcının işi (JTBD):** KOBİ sahibi olarak her fatura geldiğinde 10 saniyede fotoğrafını çekmek ve ayın sonunda muhasebeciye tek tıkla göndermek istiyorum, böylece ayda 3 saat geri kazanayım.

---

## Stack
- Next.js 15 (PWA) + TS strict, Tailwind + shadcn/ui
- Supabase (magic link + Postgres + Storage)
- Claude Sonnet 4.6 (vision)
- Google Sheets API (opsiyonel export)
- Deploy: Vercel

## Veri modeli
```sql
create table invoices (
  id uuid primary key default gen_random_uuid(),
  user_id uuid references auth.users,
  file_path text, captured_at timestamptz default now(),
  supplier_vkn text, supplier_name text, invoice_no text,
  invoice_date date, total_amount numeric, vat_amount numeric,
  category text, items_json jsonb, status text default 'new'
);
```

## Ana akışlar
1. Mobil öncelikli: büyük kamera butonu → fotoğraf çek → Storage'a yükle.
2. Sunucu tarafı Claude vision'a: "supplier, invoice_no, date, total, vat, items[]. Başlık ve maddelere bak, kategori tahmin et: ofis/yakıt/hizmet/yazilim/pazarlama/diger".
3. Liste ekranı: ay bazlı gruplama + toplam tutar + kategori rozetleri.
4. "Google Sheets'e aktar" → seçili ay CSV olarak Sheets'e append.

## 6 saatlik inşa sırası
- 0:00–1:00 — PWA scaffold + manifest + magic link
- 1:00–2:30 — Kamera akışı + Storage upload + Claude vision prompt
- 2:30–4:00 — Liste UI + ay gruplama + düzenleme modal
- 4:00–5:00 — Google Sheets API bağlama + CSV export
- 5:00–6:00 — iPhone/Android'de test + deploy

## Başarı kriteri
- [ ] Fotoğraf çekilip 5 saniyede yapılandırılmış veri dönüyor
- [ ] Kategoriler otomatik, kullanıcı değiştirebiliyor
- [ ] Ay bazlı toplamlar doğru
- [ ] Google Sheets export çalışıyor
- [ ] iOS Safari'de kamera hatası yok

## Dikkat
- El yazısı faturalarda vision doğruluğu düşer — her alanı kullanıcı düzeltilebilir tut.
- KVKK: fatura görselini talep üzerine silme butonu olsun.