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/gamification.md

@@ -0,0 +1,239 @@
+# Kolay Tercih — Gamification ve Listeye Ekleme Kurgusu
+
+> Durum: Ürün kararı  
+> Son güncelleme: 1 Ağustos 2026
+
+## Ana fikir
+
+Kolay Tercih'te bütün deneyim kullanıcının başarı sıralaması üzerine inşa
+edilir. Amaç kullanıcıya yalnızca erişebileceği programları göstermek değil;
+seçtiği programların sıralamasına, ilgi alanlarına ve önceliklerine ne kadar
+uyduğunu açıklayarak tercihine ışık tutmaktır.
+
+Gamification; puan, rozet veya yapay rekabet üzerinden değil, kullanıcının
+belirsiz bir fikirden gerekçeli ve dengeli bir tercih listesine ilerlemesi
+üzerinden çalışır.
+
+## Değişmez ürün kuralları
+
+1. Başarı sıralaması bütün hesaplamaların başlangıç noktasıdır.
+2. Listeye yalnızca tekil bir program eklenir. Üniversitenin veya bölümün tamamı
+   listeye eklenmez.
+3. Program satırlarında erişilebilir bir `+` düğmesi bulunur.
+4. Kullanıcı sihirbazı doldurmadan ilk programı listesine ekleyemez.
+5. Sihirbaz tamamlandıktan sonra `+` ile seçilen program doğrudan listeye
+   eklenir; uyumsuz programlar engellenmez.
+6. Sistem kullanıcının yerine karar vermez. Çelişkileri görünür kılar, nedenini
+   açıklar ve son kararı kullanıcıya bırakır.
+7. “Garanti kazanırsın” gibi kesinlik bildiren ifadeler kullanılmaz. Risk ve
+   uyum değerlendirmeleri geçmiş YÖK Atlas verilerine dayalı rehberliktir.
+
+## Kullanıcı yolculuğu
+
+### 1. Sıralamayı öğren
+
+Kullanıcı başarı sıralamasını ve puan türünü girer. Sistem buna göre program
+havuzunu, hayal/dengeli/güvenli aralıklarını ve kullanılabilir sihirbaz
+seçeneklerini oluşturur.
+
+### 2. Niyetini öğren
+
+Kullanıcı ilk kez bir programdaki `+` düğmesine bastığında sihirbaz seçimleri
+yoksa program hemen eklenmez. Tıklanan program “bekleyen program” olarak
+korunur ve kısa sihirbaz açılır.
+
+Sihirbaz en az şu bilgileri toplar:
+
+- İlgi alanları
+- Tercih edilen şehirler
+- Devlet/vakıf tercihi
+- Kariyer ve yaşam öncelikleri
+
+Sihirbaz giriş mesajı:
+
+> Önce seni biraz tanıyalım
+>
+> Sadece sıralamana uyan bir liste değil, ne istediğine de uyan bir tercih
+> listesi kurmak istiyoruz. Birkaç kısa seçim yap; eklediğin programların sana
+> ne kadar uyduğunu birlikte değerlendirelim.
+
+Kısa alternatif:
+
+> Tercihine ışık tutabilmemiz için önce ne istediğini öğrenelim.
+
+Birincil eylem:
+
+> Tercihlerimi belirle
+
+İkincil eylem:
+
+> Vazgeç
+
+Sihirbaz zorunludur; “şimdilik atla ve ekle” seçeneği bulunmaz.
+
+### 3. İlk programı ekle
+
+Sihirbaz başarıyla tamamlandığında kullanıcının daha önce `+` ile seçtiği
+bekleyen program otomatik olarak listeye eklenir. Kullanıcı aynı programı
+yeniden bulmak veya tekrar `+` düğmesine basmak zorunda kalmaz.
+
+Başarı bildirimi:
+
+> Program listene eklendi. Sıralamana ve tercihlerine göre değerlendirdik.
+
+### 4. Listeyi bilinçli biçimde geliştir
+
+Sihirbaz tamamlandıktan sonraki `+` tıklamaları programı doğrudan ekler.
+Sistem ekleme öncesinde onay modalı göstermez ve uyumsuz seçimleri engellemez.
+Her programın değerlendirmesi listede görünür.
+
+## Program değerlendirme modeli
+
+Her eklenen program iki ayrı eksende değerlendirilir:
+
+### Yerleşme riski
+
+Kullanıcının başarı sıralaması ile programın güncel ve geçmiş taban
+sıralamaları karşılaştırılır.
+
+Örnek durumlar:
+
+- Hayal
+- Dengeli
+- Daha güvenli
+- Veri yetersiz
+
+“Garanti” yerine mümkün olduğunda “daha güvenli” ifadesi tercih edilir.
+
+### Tercih uyumu
+
+Program, sihirbaz seçimleriyle karşılaştırılır. Uyum tek bir kapalı puan olarak
+verilmek yerine anlaşılır gerekçelerle açıklanır.
+
+Örnek olumlu sinyaller:
+
+- İlgi alanlarınla uyumlu
+- Tercih ettiğin şehirlerden birinde
+- Devlet/vakıf tercihine uyuyor
+- Kariyer önceliklerinle örtüşüyor
+
+Örnek çelişki sinyalleri:
+
+- Seçtiğin ilgi alanlarının dışında görünüyor
+- Tercih ettiğin şehirlerin dışında
+- Üniversite türü tercihinle uyuşmuyor
+- Belirttiğin önceliklerle zayıf eşleşiyor
+
+Dil yargılayıcı olmamalıdır. “Sana uygun değil” yerine “seçimlerinle
+karşılaştırdığımızda şu noktada ayrışıyor” denir.
+
+## Liste ekranı
+
+Liste yalnızca seçilen programları depolayan bir favoriler alanı değildir.
+Kullanıcının tercih stratejisini görünür kılan karar merkezidir.
+
+Her satırda en az şu bilgiler bulunur:
+
+- Program ve üniversite
+- Güncel taban sıralaması
+- Kullanıcının sıralamasına göre risk durumu
+- Tercihlerle uyumlu noktalar
+- Varsa çelişki veya dikkat notu
+- Listeden çıkarma eylemi
+
+Örnek uyumlu satır mesajı:
+
+> İlgi alanın ve devlet üniversitesi tercihinle uyumlu. Sıralama açısından
+> dengeli aralıkta.
+
+Örnek çelişkili satır mesajı:
+
+> Bu program listende kalabilir; ancak seçtiğin ilgi alanlarının ve tercih
+> ettiğin şehirlerin dışında görünüyor.
+
+Örnek risk mesajı:
+
+> Geçen yılın taban sıralaması senin sıralamandan daha yukarıda. Hayal
+> tercihlerinden biri olarak değerlendirebilirsin.
+
+Birden fazla çelişki varsa sistem hepsini aynı anda bağırmaz. En önemli bir veya
+iki gerekçe satırda gösterilir; ayrıntılar açılır alanda sunulur.
+
+## İlerleme hissi
+
+Deneyimin oyunlaştırma döngüsü şöyledir:
+
+1. **Keşfet:** Sıralamana göre programları incele.
+2. **Seç:** `+` ile ilgini çeken programı listene al.
+3. **Anla:** Sistem risk ve tercih uyumunu açıklar.
+4. **Dengele:** Hayal, dengeli ve daha güvenli dağılımını geliştir.
+5. **Tamamla:** Gerekçeli 24 tercihlik listeye ulaş.
+
+İlerleme göstergeleri:
+
+- `3 / 24 tercih`
+- Hayal / dengeli / daha güvenli dağılımı
+- Tercihlerle güçlü uyum gösteren program sayısı
+- Dikkat edilmesi gereken seçim sayısı
+- Listenin eksik kalan tarafına yönelik tek ve uygulanabilir öneri
+
+Örnek yönlendirmeler:
+
+> Listen dengeli tercihlerde güçleniyor. Birkaç daha güvenli seçenek eklemek
+> riski dağıtabilir.
+
+> Seçtiklerinin çoğu aynı şehirde. Şehir konusunda esneksen alternatiflerini
+> genişletebilirsin.
+
+> 24 tercihe ulaştın. Şimdi dağılımı ve dikkat notlarını birlikte gözden geçir.
+
+## `+` düğmesinin durumları
+
+- **Varsayılan:** “Listeme ekle”
+- **Sihirbaz gerekli:** Tıklama sihirbaz ön bilgilendirmesini açar
+- **Ekleniyor:** Düğme geçici olarak devre dışı kalır
+- **Eklendi:** `+` yerine onay işareti gösterilir, erişilebilir etiketi
+  “Listende” olur
+- **Liste dolu:** Düğme devre dışıdır ve “Listen 24 tercihe ulaştı” açıklaması
+  sunulur
+- **Hata:** Seçim kaybolmaz; kullanıcıya yeniden deneme eylemi verilir
+
+İkon düğmesinin dokunma alanı en az 44×44 piksel olmalı ve yalnızca ikona bağlı
+anlam bırakılmamalıdır. Görsel etiket veya erişilebilir ad bulunmalıdır.
+
+## Sihirbaz seçimlerini değiştirme
+
+Kullanıcı sihirbaz yanıtlarını daha sonra değiştirebilir. Değişiklik mevcut
+programları listeden otomatik olarak çıkarmaz. Bütün satırların uyum
+değerlendirmesi yeni yanıtlara göre yeniden hesaplanır ve değişen yorumlar
+görünür biçimde güncellenir.
+
+Örnek bildirim:
+
+> Tercihlerin güncellendi. Listendeki programları yeni seçimlerine göre yeniden
+> değerlendirdik; hiçbir programı silmedik.
+
+## Kaçınılacak kalıplar
+
+- Kullanıcıyı sihirbazı doldurmadığı için suçlayan dil
+- Uyumsuz bir programın eklenmesini engellemek
+- Sadece renk ile uyum veya risk anlatmak
+- Kesin yerleşme vaadi vermek
+- Her `+` tıklamasında modal veya onay adımı göstermek
+- Rozet, puan ve seri gibi kararın ciddiyetini oyunlaştıran ödüller
+- Kullanıcının sihirbazdan önce tıkladığı programı unutmak
+- İlgi alanı uyumunu yerleşme ihtimaliyle aynı şeymiş gibi sunmak
+
+## Başarı ölçütleri
+
+- Sıralama sonucundan ilk `+` tıklamasına geçiş
+- İlk `+` sonrasında sihirbaz tamamlama oranı
+- Sihirbazdan sonra bekleyen programın başarıyla eklenme oranı
+- Kullanıcı başına eklenen program sayısı
+- 24 tercihe ulaşan kullanıcı oranı
+- Uyarı görüldükten sonra programı koruma/çıkarma davranışı
+- Sihirbaz tercihlerini güncelleme oranı
+- Liste dağılımının zaman içinde daha dengeli hâle gelmesi
+
+Bu metrikler kullanıcıyı daha çok tıklamaya zorlamak için değil, daha bilinçli
+bir tercih listesi kurup kuramadığını anlamak için kullanılmalıdır.

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'ı)