e-Fatura GİB Asistanı

# e-Fatura GİB Asistanı

**Ne inşa ediyoruz:** "Bugün ABC Ltd'ye 3 saat danışmanlık, 4500 TL+KDV" diye yazınca AI'ın kalem/oran/kod çıkarıp UBL-TR XML + PDF üreten araç.

**Kullanıcının işi (JTBD):** Faturayı 10 saniyede yazıp basacak şekilde tarif etmek istiyorum, sistem KDV oranını ve GTIP/GİB kodunu kendi tahmin etsin, ben sadece doğrula deyim.

---

## Stack
- Next.js 15 App Router
- Tailwind + shadcn/ui
- Supabase Postgres + Auth
- Claude Sonnet 4.6
- UBL-TR XML üreten kütüphane (npm 'ublxml' veya elle)
- react-pdf
- Deploy: Vercel

## Veri modeli
```sql
create table customers (
  id uuid primary key default gen_random_uuid(),
  user_id uuid references auth.users not null,
  title text, vkn_tckn text, address text, tax_office text
);

create table invoices (
  id uuid primary key default gen_random_uuid(),
  user_id uuid references auth.users not null,
  customer_id uuid references customers,
  invoice_no text, invoice_date date, due_date date,
  raw_input text, items jsonb,
  vat_total numeric, total numeric,
  ubl_xml text, pdf_url text,
  status text default 'draft',
  created_at timestamptz default now()
);
```

## Ana akışlar
1. Müşteri kütüğüne ekle (VKN, vergi dairesi, unvan).
2. "Yeni fatura" → metin alanına yaz: "X firmasına 5 saat web tasarım, 8500 TL net".
3. Claude items[] çıkarır (ad, miktar, birim, fiyat, KDV oranı, GTIP kodu).
4. Kullanıcı düzenler, "fatura kes" der.
5. UBL-TR XML + PDF üretilir, indirir veya GİB'e gönderir (v2).

## 6 saatlik inşa sırası
- 0:00–1:00 — Scaffold + auth + müşteri CRUD
- 1:00–2:00 — Doğal dil → kalem extraction Claude prompt
- 2:00–3:30 — KDV oran sözlüğü + AI doğrulama (hizmet/ürün ayırımı)
- 3:30–4:30 — UBL-TR XML üretimi (sade şema, e-arşiv)
- 4:30–5:30 — PDF (TR fatura görünümü)
- 5:30–6:00 — Vercel deploy + örnek 5 fatura test

## Başarı kriteri
- [ ] Doğal dilden kalem çıkarma %90+ doğru (10 örnekte)
- [ ] KDV %1/8/20 doğru tahmin (gıda/hizmet/ürün ayırma)
- [ ] UBL-TR XML şeması GİB doğrulayıcısından geçiyor
- [ ] PDF Türk fatura format normuna uygun
- [ ] Müşteri seçimi VKN tamamlama ile çalışıyor

## Dikkat
- e-Fatura sistemi için resmi başvuru (mali mühür) zorunlu — MVP'de e-arşiv (B2C) ile sınırla.
- KDV oranı yanlış seçmek vergi cezası demek; AI'a "emin değilsen sor" promptu.
- VKN doğrulama (10 hane + checksum) MUST.
- TR sayı format (₺), virgül/nokta dikkatli.