# 00 — Genel Bakış: Flovy Nedir, Ne Yapar?

## Tek Cümle

*"Web sitenize bir satır kod yapıştırın; Flovy ziyaretçinizi tanısın, ürününüzü anlatsın, sepet kursun, ödeme alsın, fatura kessin — ve bir dahaki ziyarette sizi hatırlasın."*

---

## Rakiplerden Farkı

| Özellik | Tidio / Crisp | Shopify Inbox | Flovy |
|---|---|---|---|
| Ürün arama + öneri | ❌ | ✅ (sadece Shopify) | ✅ |
| Sepet + ödeme | ❌ | ✅ (sadece Shopify) | ✅ |
| e-Fatura (Türkiye) | ❌ | ❌ | ✅ |
| Ziyaretçiyi tanıma | ❌ | ❌ | ✅ **Moat** |
| Geçmiş bazlı öneri | ❌ | ❌ | ✅ **Moat** |
| Platform bağımsız | ✅ | ❌ | ✅ |
| Türkçe AI kalitesi | ⭐⭐ | ⭐ | ⭐⭐⭐⭐⭐ |

**Asıl moat:** Ziyaretçi hafızası. Rakip scripti kaldırıp başka ürüne geçince o ziyaretçi verisi gider. Merchant bunu yapmak istemez.

---

## Sistem Mimarisi

```
┌──────────────────────────────────────────────────────┐
│                   Tenant (İşletme)                   │
│  Flovy Panel → Ürün girer, widget ayarlar, analitik │
└──────────────────────────┬───────────────────────────┘
                           │ embed snippet (1 satır JS)
                           ▼
┌──────────────────────────────────────────────────────┐
│              İşletmenin Web Sitesi                   │
│         <script src="flovy.tekyerden.co/w.js">       │
│         Widget açılır — ziyaretçi yazmaya başlar     │
└──────────────────────────┬───────────────────────────┘
                           │ HTTP / WebSocket
                           ▼
┌──────────────────────────────────────────────────────┐
│           FastAPI Backend (port 8000)                │
│                                                      │
│  1. Visitor tanıma (fingerprint + email + IP)        │
│  2. Session aç                                       │
│  3. Intent Router (Regex → Semantic → LLM)          │
│  4. RAG: tenant ürünleri + KB                        │
│  5. Tool execute (search, cart, pay, lead)           │
│  6. stream_token üret → Node.js'e delege            │
└────────┬─────────────────┬────────────────────────────┘
         │                 │
         ▼                 ▼
┌─────────────┐   ┌──────────────────┐
│ Node.js WS  │   │  Celery Workers  │
│ flovy-stream│   │  - Embedding     │
│ port 8090   │   │  - Scraping      │
│ Gemini SSE  │   │  - PII silme     │
└─────┬───────┘   └──────────────────┘
      │
      ▼ token-token
┌─────────────┐
│   Widget    │◄── ziyaretçi görür
│  (browser)  │
└─────────────┘

Ödeme tamamlanınca:
PayTR Callback → FastAPI → e-Fatura (Turkcell) → "Ödemeniz alındı" chat mesajı
```

---

## Faz Planı

### Faz 1 — MVP (Şu An İnşaa Ediyoruz)

- [x] Proje iskelet + CLAUDE.md + dokümantasyon
- [ ] Auth + tenant sistemi
- [ ] Ürün yönetimi API
- [ ] Chat session + mesaj API
- [ ] Visitor hafızası (fingerprint + profil)
- [ ] RAG sistemi (ürün embedding + cosine)
- [ ] 3 katmanlı intent router
- [ ] Tool sistemi (search, cart, pay, lead, escalate)
- [ ] PayTR entegrasyonu
- [ ] e-Fatura otomasyonu
- [ ] Widget JS embed snippet
- [ ] Streaming aktif (Node.js bridge reuse)

**Hedef:** 5 pilot tenant, gerçek ödeme + e-Fatura + ziyaretçi tanıma canlıda.

### Faz 2 — SaaS Lansmanı

- Panel frontend (Next.js)
- Free / Pro / Business planları + Stripe billing
- Çok dil (TR, EN, AR)
- WhatsApp kanal entegrasyonu
- Tenant analitik dashboard
- "Powered by Flovy" badge (viral büyüme)

### Faz 3 — Ekosistem

- İkas / WooCommerce / Shopify connector (ürün sync)
- Kendi fine-tune modeli (birikmiş conversation data)
- Sesli mod (Web Speech API)
- BDDK ödeme kuruluşu lisansı araştırması

---

## Tenant Planları (Faz 2)

| Plan | Aylık | Sohbet | AI mesaj | Kanal | Beyaz etiket |
|---|---|---|---|---|---|
| Free | ₺0 | 100 | 500 | Web | ❌ |
| Starter | ₺299 | 1000 | 5000 | Web | ❌ |
| Pro | ₺799 | 5000 | 25000 | Web+WA | ✅ |
| Business | ₺1999 | Sınırsız | Sınırsız | Tümü | ✅ |

---

## Başarı Metrikleri

| Metrik | Hedef |
|---|---|
| İlk token süresi (streaming) | < 500ms |
| Rule fast-path latency | < 10ms |
| Semantic routing latency | < 600ms |
| LLM full response | < 3s |
| Ziyaretçi tanıma doğruluğu | > %85 (fingerprint match) |
| Halüsinasyon oranı | < %1 (tool sonuçlarına bağlı) |
| Aylık AI maliyeti / 1000 sohbet | < $5 |