Add design documentation for CTA drawer and UX improvements

- Introduced a new document detailing the design principles behind the funnel CTA drawer, emphasizing user flow and context retention.
- Added a UX/CRO corrections document outlining critical findings from a recent audit, including payment flow adjustments, button transparency, and pricing clarity.
- Created a gamification document to outline user engagement strategies and the program evaluation model for the Kolay Tercih feature.
- Developed a vision document for TercihAI, detailing the product's positioning, revenue model, and MVP scope, aimed at providing AI-assisted preference guidance for students.

docs/urun/vizyon.md

@@ -0,0 +1,94 @@
+# TercihAI (çalışma adı) — Cebindeki Tercih Danışmanı
+
+> Durum: Fikir doğrulandı, MVP geliştirme aşamasında. Son güncelleme: 20 Temmuz 2026.
+
+## Tek cümlelik tanım
+
+YKS öğrencisine, insan tercih danışmanının 2.000–10.000 TL'ye yaptığı işi
+299–499 TL'ye yapan AI destekli tercih asistanı.
+
+## Neden bu niş? (Pazar araştırması özeti — Temmuz 2026)
+
+- Türkiye B2C'de tüketicinin istisnai para harcadığı alanlar: oyun, fal/astroloji,
+  dating, **eğitim**. Eğitim, ailelerin en son kıstığı harcama.
+- Fal nişi kanıtlanmış gelire sahip (Faladdin: 15M+ kullanıcı, ~$5M/yıl) ama
+  kurucusu Temmuz 2025'te gözaltına alındı, gelirler "yasa dışı kazanç" sayıldı
+  → hukuki risk nedeniyle elendi.
+- Mevcut "tercih robotları" (tercihrobotu.com.tr, Kariyer.net, YÖK Atlas sihirbazı)
+  tamamen ücretsiz **liste filtreleme** araçları — bu katman metalaşmış.
+- Para, akıl verme katmanında: insan danışmanlar tercih döneminde 2.000–10.000 TL
+  alıyor. Bu katmanı AI ile ciddi yapan kimse yok. **Boşluk burası.**
+
+## Konumlandırma
+
+"Puanına göre bölüm listeleyen robot" DEĞİL — "listeni birlikte kuran,
+riskini açıklayan, sorularına cevap veren danışman."
+
+- Sıralamana göre 24 tercihlik dengeli liste (hayal / dengeli / garanti dilimleri)
+- Her tercih için gerekçe: son 4 yıl taban sıralaması trendi, kontenjan değişimi, doluluk
+- Serbest soru-cevap: "X bölümü mü Y mi?", "Bu sıralamayla riskli mi?", iş imkanları
+- Veli modu: sürece para veren kişi çoğu zaman veli — çıktılar veliye anlatılabilir olmalı
+
+## Gelir modeli (kararlaştırıldı — 21 Temmuz 2026)
+
+Tek seferlik ödeme + tükenen kredi modeli (abonelik yok, bilinçli):
+
+- **Ücretsiz:** temel program arama + sıralama sorgusu (trafik mıknatısı + SEO)
+- **Kayıt (Google login + e-posta magic link):** 3–5 deneme kredisi
+  + rapor önizlemesi (ilk 5 tercih satırı açık, gerisi blur)
+- **Tek paket — 299 TL / 60 kredi:**
+  - Pakete DAHİL (kredi düşmez): kişisel 24'lük liste + risk raporu
+    + PDF çıktı + 2 liste revizyonu hakkı
+  - Krediler sadece AI sohbet için: her mesaj = 1 kredi (60 soru hakkı)
+- **Top-up:** krediler bitince 99–149 TL'ye +30 kredi (sezon sonu panik-alımı)
+- **Ödeme:** iyzico, tek çekim (başvuru hemen yapılmalı — onboarding 2–7 gün)
+- Satış mesajı: "Listen + risk raporun + 60 soru hakkın — danışmanın 1/10 fiyatına"
+- Sezon dışı genişleme (v2): KPSS/DGS/ALES tercihleri, yıl boyu AI sınav koçu
+
+### Funnel
+
+/sonuc (ücretsiz dilimler) → "Risk analizini gör" CTA → kayıt (deneme kredisi
++ blur önizleme) → 299 TL paywall → liste + rapor + sohbet → kredi bitince top-up.
+
+## Veri kaynakları
+
+- [yokatlas-py](https://github.com/saidsurucu/yokatlas-py) — YÖK Atlas'ın yeni
+  JSON API'sine karşı güncel (v0.6.0+); taban puan, başarı sırası, kontenjan, son 4 yıl.
+  YÖK Atlas Nisan 2026'da React SPA'ya geçti, eski HTML scraping öldü — bunu kullan.
+- [yokatlas-dataset-2025](https://github.com/MorphaxTheDeveloper/yokatlas-dataset-2025) —
+  hazır CSV dump (bootstrap için)
+- Strateji: veriyi kendi Postgres'imize alıp oradan servis etmek (API'ye bağımlı kalma)
+
+## Stack ve mimari kararlar
+
+- Next.js (App Router) + TypeScript + Tailwind + shadcn/ui (radix, nova preset)
+- Postgres (program/puan verisi + kullanıcılar)
+- AI katmanı: Claude API — sohbet + liste üretimi, YÖK Atlas verisiyle grounded
+- Ödeme: iyzico veya PayTR (TL, tek seferlik ödeme)
+- Deploy: Vercel. SEO için taban puan sayfaları SSR (organik trafik kanalı)
+
+## MVP kapsamı (sezon hedefi: tercih dönemi bitmeden yayında)
+
+1. ✅ Veri pipeline: YÖK Atlas CSV → SQLite (`npm run ingest`, 2021–2024 arşivi)
+   + canlı API tazeleme (`npm run refresh`: POST /api/tercih-kilavuz/search,
+   2025 sıralama/puan/kontenjan, 23.610 program, 17.994'ünde 2025 sırası).
+   Az yerleşenli programlarda API sıralama vermez → NULL; sorgular
+   COALESCE(sira2025, sira2024) kullanır. Deploy'da Postgres/Turso'ya taşınacak.
+2. ✅ Ücretsiz: sıralama gir → hayal/dengeli/garanti dilimleri (`/sonuc`,
+   puan türü seçimi, 2024→2025 trend göstergesi). SEO sayfaları yapılacak.
+3. Ücretli: AI danışman sohbeti + 24'lük dengeli liste üretimi + PDF çıktı
+4. Ödeme entegrasyonu (tek seferlik)
+
+## Riskler
+
+- **Sezonluk gelir:** yılın ~6 haftası pik. Kabul edildi (yan proje hedefi $1–5K MRR eşdeğeri).
+- **ÖSYM takvimi:** tercih dönemi kısa; bu sezona yetişemezsek KPSS tercihleri (Ağustos–Eylül)
+  ve gelecek YKS sezonu hedeflenir.
+- **AI yanlış yönlendirme:** tercih hayati karar — her öneri gerçek YÖK Atlas verisine
+  dayanmalı, "garanti" dili yasak, sorumluluk reddi şart.
+- **Rakiplerin AI eklemesi:** Kariyer.net vb. ekleyebilir; hız ve odak bizim avantajımız.
+
+## Kurucular
+
+- Bilal (geliştirme + ürün) — yazılımcı, yan proje kapasitesi günde 1–2 saat
+- Claude (araştırma + geliştirme co-founder'ı)