kolaytercih/docs/gece-vardiyasi/2026-09-21/06-cto-plani.md

# 06 — CTO planı — 2026-09-21 gece vardiyası (Tur 3)

Hazırlayan: CTO ajanı · Girdi: `05-ceo-kararlari.md` §3 + `01`/`02`/`03`/`04` · Kod **değiştirilmedi**; yalnızca bu dosya yazıldı. Tüm dosya:satır atıfları main HEAD `56925e1` üzerinde okunarak doğrulandı. (Tek yan etki: `p4-eposta` worktree'sinde doğrulama için `next typegen` + `tsc` + `lint` koşuldu; yalnızca gitignore'lu `.next/` ve `next-env.d.ts` oluştu, `git status` temiz.)

## 1. Özet (5 madde)

1. **Dört paket de uygulanabilir; dosya kümeleri ayrık.** CEO'nun listesindeki üç gizli çakışma çözüldü: (a) P3'ün "tek sabit"i `seo.tsx`'e (P1'in) giremez → yeni dosya; (b) P2'nin `paket_goruntulendi` olayı `/paket` sayfasına (P3'ün) dokunmadan yeni `src/app/paket/layout.tsx` ile bağlanır; (c) P2 `src/app/layout.tsx`'e dokunmaz, erken olay kaybı `analitik.ts` içinde kuyrukla çözülür.
2. **P2 kök nedeni doğrulandı ve bir tane daha bulundu.** Hook `useRef` + `[ad, anahtarEki]` deps'li effect kullanıyor; eleman ilk commit'te yoksa (banner) ya da sökülüp yeniden takılıyorsa (tadımlık) gözlem hiç kurulmuyor → callback ref. Ek bulgu: Rybbit script'i `afterInteractive`; `olay()` script yokken sessizce düşürüyor → mount anında atılacak yeni olaylar (`sonuc_/paket_goruntulendi`) sert yüklemede kaybolur → küçük kuyruk şart.
3. **P3'te CEO'nun kapsamı eksik (CTO itirazı #1).** "İhtimal dili" yalnız `riskNotuUret`'te değil: tadımlık havuzunun `riskNotu`'su **LLM üretimi ve DB'de kayıtlı**, prompt'u açıkça "yüksek/orta/düşük ihtimal dili kullan" diyor (`scripts/tadimlik-uret.ts:70-71`); danışman sohbetinin sistem prompt'u da aynı (`src/app/api/soru/route.ts:48`). Girişsiz ziyaretçinin /sonuc'ta gördüğü tek yapay zekâ satırı eski dille kalırdı. Çözüm: risk cümlesi tek saf fonksiyona (`riskNotuMetni`) alınır, tadımlıkta **okuma anında** deterministik üretilir — prod'da LLM yeniden koşusu gerekmez.
4. **P4'te soğuma kaynağı değiştirildi (CTO itirazı #2).** better-auth 1.6.23'te `verification.identifier` = **token** (e-posta değil); e-posta yalnız `value` JSON'unda ve satır `sendMagicLink` çağrılmadan **önce** yazılıyor → tablo tabanlı soğuma kendi satırına takılır ve kayan pencere üretir. Yerine süreç içi `Map` (tek konteyner; şema/DB yazımı yok). Ayrıca prod guard **modül yüklenirken değil gönderim anında** atmalı; aksi hâlde `next build` (NODE_ENV=production, env'siz) kırılır.
5. **Doğrulama tuzağı:** taze worktree'de `pnpm exec tsc --noEmit` **baseline'da kırık** (`PageProps` global tipi `.next/types`'tan geliyor). Önce `pnpm exec next typegen` koşulmalı — denendi: typegen → tsc 0 hata, `pnpm lint` temiz. Tam `pnpm build`'i yalnız P1 koşar (HTML kabul kriteri); dört paralel build ~8 GB RAM ister, diğerleri tsc+lint ile kapanır, build'i Tur 4'te orkestratör sırayla alır.

### Dosya sahipliği (ayrık; listede olmayan dosyaya dokunulmaz)

| Paket | Dosyalar (**Y** = yeni) |
|---|---|
| **P1** `gece/p1-rehber-altyapi` | `src/features/rehber/components/el-cizimi-sema.tsx` · `src/features/rehber/components/rehber-makale.tsx` · `src/lib/rehber.ts` · `src/lib/tarih.ts` **Y** · `src/app/sitemap.ts` · `src/lib/seo.tsx` (yalnız `articleJsonLd`) |
| **P2** `gece/p2-olcum` | `src/components/use-gorunum-olayi.ts` · `src/lib/analitik.ts` · `src/features/sihirbaz/components/{hero-form,cta-sira-form,sihirbaz-cagri-karti}.tsx` · `src/features/liste/components/tercih-profili-kapisi.tsx` · `src/features/kullanici/components/giris-form.tsx` · `src/features/rapor/components/{liste-uretici,listem-govde}.tsx` · `src/app/paket/layout.tsx` **Y** · `src/features/odeme/components/paket-gorunum-olayi.tsx` **Y** · `src/components/rybbit-identify.tsx` · `src/features/kullanici/components/user-nav.tsx` · (salt-okunur doğrulama, değişiklik beklenmiyor: `kaydet-banner.tsx`, `tadimlik-satiri.tsx`) |
| **P3** `gece/p3-vaat-dili` | `src/app/page.tsx` · `src/app/paket/page.tsx` · `src/features/odeme/components/paket-satinal.tsx` · `src/lib/ai/rapor.ts` (yalnız `riskNotuUret`) · `src/app/layout.tsx` (yalnız `description`) · `src/lib/veri-kapsami.ts` **Y** · **CTO eki:** `src/lib/risk.ts` · `src/lib/tadimlik-havuzu.ts` · `scripts/tadimlik-uret.ts` · `src/app/api/soru/route.ts` (yalnız 48. satır) · `src/components/arama-funnel-karti.tsx` (yalnız 38. satır) · `src/features/katalog/components/veri-kaynagi.tsx` (yalnız `export`) |
| **P4** `gece/p4-eposta` | `src/lib/eposta-gonder.ts` · `src/lib/eposta.ts` · `src/lib/auth.ts` · `src/lib/analitik-sunucu.ts` · isteğe bağlı ayrı commit: `.gitea/workflows/ci.yaml` |

Çakışma kararları: `seo.tsx` → P1 (P3 oraya sabit eklemez). `src/app/paket/page.tsx` + `paket-satinal.tsx` → P3 (P2 yeni layout dosyası kullanır). `src/app/layout.tsx` → P3 (P2 script'e dokunmaz). `tadimlik-satiri.tsx` → P2, `tadimlik-havuzu.ts` → P3. `analitik.ts` → P2, `analitik-sunucu.ts` → P4. `giris-form.tsx` → P2, `auth.ts` → P4.

### Tüm yazılımcılar için ortak kurallar

- Yalnız kendi worktree + dalında lokal commit; **push/merge yok**. `git add -A` / `git add .` **yasak** — yalnız sahip olunan dosyalar yol vererek eklenir (build `data/*.db-shm` gibi izlenen dosyaları kirletebilir; `data/app.db`, `docker-compose.yml`, `docs/geo/geo-raporu.md` asla).
- Doğrulama sırası (worktree kökünde): `pnpm exec next typegen && pnpm exec tsc --noEmit && pnpm lint`. Dev sunucusu/tarayıcı yok (AGENTS.md).
- Next'e özgü API'den önce `node_modules/next/dist/docs/` (P1: `01-app/03-api-reference/03-file-conventions/01-metadata/sitemap.md`, `04-functions/generate-metadata.md`; P2: `03-file-conventions/layout.md`). Doğrulananlar: `openGraph.modifiedTime` tipte var (`opengraph-types.d.ts:28`); sitemap `lastModified: string | Date`; `next typegen` (`06-cli/next.md:175`).
- Commit mesajı sonu: `Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>`. Rapor: `07-yazilimci-raporlari.md`'ye kendi başlığı.

---

## 2. P1 · Rehber altyapısı

**Amaç:** Şema metni JS'siz botlara görünsün; mermaid hatasında sonsuz iskelet bitsin; `guncelleme` tarihi uçtan uca aksın; frontmatter tırnağı ve tablo taşması düzelsin.

**Kök neden (kanıt):**
- `el-cizimi-sema.tsx:85-97`: `aria-label` yalnız `svg` state'i dolunca render ediliyor; SSR çıktısı = `aria-hidden` iskelet + figcaption. Bileşen client ama SSR edilir → içine konan `<details>` sunucu HTML'ine girer.
- `el-cizimi-sema.tsx:55-74`: `import("mermaid").then(async …)` zincirinde `catch` yok; `mermaid.render` atarsa (`getBBox is not a function`, 2 oturum — tarayıcıya özgü, kaynağı saptanamadı) `svg` hiç dolmaz, iskelet kalır, promise yakalanmaz. Mermaid ayrıca `#d<id>` geçici div'ini `body`'de bırakabilir (`mermaid.core.mjs:1248`).
- `rehber.ts:71-74`: `.replace(/^["']|["']$/g, "")` iki ucu bağımsız siliyor. Etkilenen yalnız 2 dosya (`merkezi-yerlestirme…md:3`, `taban-siralamalar…md:3`); 24 dosyanın hiçbirinde tam tırnaklı değer yok.
- `rehber.ts:20-26` `RehberOzet`'te `guncelleme` yok; `sitemap.ts:22` `/rehber` girdisinde `lastModified` yok, `:47` `y.tarih`; `seo.tsx:149-169` `dateModified` yok; `rehber-makale.tsx:32` yalnız `publishedTime`, gövdede tarih yok.
- `rehber-makale.tsx:79`: `[&_table]:w-full`, sarmalayıcı yok.

**Değişiklikler:**
1. `src/lib/tarih.ts` **(yeni, saf, `server-only` yok):** `export function trTarih(iso: string): string` — `/^(\d{4})-(\d{2})-(\d{2})$/` ile ayrıştır, sabit `AYLAR = ["Ocak",…,"Aralık"]` dizisinden `"21 Eylül 2026"` üret; biçim uymazsa `throw`. `Date`/`toLocale*`/saat dilimi **kullanma**.
2. `src/lib/rehber.ts`:
   - Tırnak: değer uzunluğu ≥ 2, ilk ve son karakter **aynı** tırnak (`"` ya da `'`) **ve** aradaki metin o tırnağı içermiyorsa soy; aksi hâlde olduğu gibi bırak.
   - `RehberOzet`'e `guncelleme?: string`. `metaDogrula`: `tarih` ve (varsa) `guncelleme` `YYYY-MM-DD` değilse ya da `guncelleme < tarih` ise build'i kıran `Error` (mevcut hata mesajı kalıbıyla). `oku()` ve `ozetOku()` (cache'ten kırpma dalı dahil, `:169-170`) alanı taşır. Sıralama `tarih`'e göre **kalır**. `RehberAramaKaydi` değişmez.
   - Tablolar: `parcala()` içindeki iki `marked.parse` çıktısını tek yardımcıdan geçir: `<table>` → `<div class="rehber-tablo" role="region" aria-label="Tablo" tabindex="0"><table>`, `</table>` → `</table></div>` (marked 18 `<table>`'ı özniteliksiz basar; global `marked.use` **kullanma**). `:12` yorumundaki "10 makale"yi düzelt.
3. `src/lib/seo.tsx` — yalnız `articleJsonLd`: `dateModified?: string` parametresi; çıktıda `dateModified: opts.dateModified ?? opts.datePublished`.
4. `src/features/rehber/components/rehber-makale.tsx`: metadata'da `openGraph: { type: "article", publishedTime: yazi.tarih, modifiedTime: yazi.guncelleme ?? yazi.tarih }`; `articleJsonLd`'ye `dateModified`; `aciklama` paragrafının altına `<p className="mt-3 text-xs text-slate-500">Yayın: <time dateTime={yazi.tarih}>{trTarih(yazi.tarih)}</time>` + (yalnız `guncelleme` varsa) ` · Güncelleme: <time …>` — düz metin satırı, **badge değil** (SectionEyebrow kuralı tetiklenmez). Sınıf listesinde `[&_table]:mt-4` → `[&_.rehber-tablo]:mt-4 [&_.rehber-tablo]:overflow-x-auto`.
5. `src/app/sitemap.ts`: rehber girdilerinde `lastModified: y.guncelleme ?? y.tarih`; `/rehber` girdisini `staticEntries`'ten fonksiyon içine al, `lastModified` = tüm yazıların `guncelleme ?? tarih` değerlerinin en büyüğü (ISO string karşılaştırması yeter).
6. `src/features/rehber/components/el-cizimi-sema.tsx`:
   - `const [hata, setHata] = useState(false)`. `cizdir()` → `import("mermaid").then(async …).catch(() => { document.getElementById("d" + semaId)?.remove(); if (!iptal) setHata(true); })`; `mermaid.initialize`'a `suppressErrorRendering: true` (11.16'da var, `config.type.d.ts:237`).
   - Render: `svg` varsa mevcut `role="img" aria-label` div'i (korunur); yoksa ve `hata` değilse iskelet; `hata` ise iskelet **çizilmez**. figcaption'dan sonra, `<figure>` içinde: `<details open={hata || undefined} className="mt-2 text-xs text-slate-500"><summary className="cursor-pointer font-medium text-slate-600">Şemayı metin olarak oku</summary><p className="mt-2 text-sm leading-6 text-slate-600">{ariaLabel}</p></details>`. Gizli metin (`sr-only`, `display:none`) **yok**.

**Commit bölünmesi:** (1) `fix(rehber): frontmatter tırnak + tablo sarmalayıcı` · (2) `feat(rehber): guncelleme alanı → sitemap/JSON-LD/OG/görünür tarih` · (3) `fix(rehber): şema metni SSR'da + mermaid hata toparlama`. Hepsi [KARAR].

**Kabul kriterleri / doğrulama:** typegen+tsc+lint; ardından **yalnız bu pakette** `pnpm build`, sonra (ana repodaki mevcut build'de baseline ölçüldü: ilk iki grep **0**, description `Üst sıraya…` diye tırnaksız başlıyor — yani kriterler ayırt edici):
- `grep -c "Şemayı metin olarak oku" .next/server/app/rehber/tercih-listesi-nasil-yapilir.html` ≥ 1 ve aynı dosyada `grep -c "Tercih listesi dilim şeması"` ≥ 1; `.next/server/app/meraklisina.html`'de `grep -c "Sihirbaz akış şeması"` ≥ 1.
- `grep -o 'name="description" content="[^"]\{0,30\}' .next/server/app/rehber/merkezi-yerlestirme-nasil-calisir.html` → `&quot;Üst sıraya` ile başlar (aynısı `taban-siralamalar-nasil-degisir`).
- Aynı HTML'de `rehber-tablo` sınıfı ve `Yayın:` + `<time dateTime="2026-` bulunur; `.next/server/app/sitemap.xml.body`'de `/rehber</loc>` girdisinin `<lastmod>`'u var. Geçici olarak bir yazıya `guncelleme: 2026-09-22` ekleyip `dateModified`/`modifiedTime`/`Güncelleme:` çıktısını gör, **commit'lemeden geri al** (`content/` yazar dalının).
- Kod incelemesi: `.catch` var, hata dalında iskelet yok, `details` açık.

**Kapsam dışı:** `kume`/`ilgili` (T4), FAQPage, llms.txt, IndexNow, flowchart dışı mermaid, font, yazar alanı, `content/rehber/*` (yazar dalı), `rehber-listesi.tsx`.

**Riskler / AGENTS.md:** `ElCizimiSema` `/meraklisina` hunisiyle ortak → `<details>` orada da çıkar; metin kaynağı yine tek `ariaLabel` prop'u olduğundan **şema senkron kuralına yeni yük binmez**, `huni-semasi.tsx`'e dokunulmaz; Bilal görsel bakmalı. Ekran okuyucuda metin iki kez okunabilir (CEO kabul etti). `metaDogrula` sıkılaşması: 24 dosyanın hepsi `YYYY-MM-DD` (doğrulandı), yazar dalındaki yeni dosyalar bozuk tarihle gelirse build kırılır — istenen davranış.

---

## 3. P2 · Ölçüm onarımı

**Amaç:** Görünüm hook'u sonradan mount olan elemanda da çalışsın; 6 yeni olay; 429 mesajı; PII ayrı commit.

**Kök neden (kanıt):**
- `use-gorunum-olayi.ts:20,28-30,51`: `useRef` + deps `[ad, anahtarEki]`. `ref.current` effect anında `null` ise erken dönüyor ve deps değişmediği için bir daha çalışmıyor.
  - `kaydet-banner.tsx:33,47,57`: `kapali` başlangıçta `true` → ilk render `null`; üstelik içerik `ViewportPortal` içinde (`viewport-portal.tsx` — ilk client render'da da `null`). Eleman hiçbir zaman ilk commit'te yok → olay **0**.
  - `tadimlik-satiri.tsx:75-77,87,104`: tip uymuyorsa `setSatir(null)` → `<section>` sökülür, fetch sonrası **yeni** DOM düğümü takılır; gözlemci eski (kopuk) düğümde kalır.
  - Çalışanlar (`listem-govde.tsx:139-148`, `sihirbaz-cagri-karti.tsx:232`) eleman ilk commit'te var olduğu için etkilenmiyor.
- **İkinci neden (raporlarda yok):** `layout.tsx:129-136` script'i `afterInteractive`; `analitik.ts:52-58` `window.rybbit` yoksa sessiz no-op. Sert sayfa yüklemesinde mount effect'i script'ten önce koşar → olay kaybolur. Mevcut olaylar kullanıcı etkileşimiyle atıldığı için görünmedi; yeni "sayfa görüntülendi" olaylarını doğrudan vurur.
- **Uyarı:** `tadimlik_goruntulendi` = 0'ın tek nedeni hook olmayabilir — prod `tadimlik_havuzu` boşsa bileşen hiç render edilmez (`tadimlik-bolumu.tsx:20`, bellek notu "deploy sonrası prod'da `pnpm tadimlik`") ve bölüm uzun tablonun altında. Düzeltmeden sonra hâlâ 0 ise önce havuz kontrol edilir (Bilal).

**Değişiklikler:**
1. `src/lib/analitik.ts`: `OlayAdi`'na **tam bu adlarla** ekle: `cta_form_goruntulendi`, `sira_form_hata`, `sonuc_goruntulendi`, `paket_goruntulendi`, `liste_uretim_hata`, `giris_hata`. `olay()`: `window.rybbit` yoksa olayı modül içi kuyruğa (en çok 20) koy; 500 ms aralıkla en çok 20 deneme (10 sn) — script gelince sırayla boşalt, gelmezse kuyruğu at (reklam engelleyici). Yeni `export function olayBirKez(ad, ozellikler?, anahtarEki?)`: hook'taki `sessionStorage` anahtar mantığının (`kolaytercih.olay.<ad>[.<ek>]`) aynısı — anahtar varsa çık, yoksa yaz + `olay()`; storage hatasında yine gönder.
2. `src/components/use-gorunum-olayi.ts`: dönüş tipi `RefCallback<T>`; `useCallback((el: T | null) => { … }, [ad, anahtarEki])`. `el` yoksa / `IntersectionObserver` yoksa / anahtar zaten yazılıysa çık; yoksa gözlemci kur, kesişimde `io.disconnect()` + `olayBirKez`. React 19 ref temizleme fonksiyonu döndür (`return () => io.disconnect()`). `ozelliklerRef` deseni korunur. Çağıranların hepsi yalnız `ref={…}` veriyor (`.current` okuyan yok — doğrulandı) → 5 kullanım yerinde değişiklik gerekmez.
3. `cta-sira-form.tsx`: **yalnız profilsiz daldaki** `<section>`'a (`:162`) `ref={useGorunumOlayi<HTMLElement>("cta_form_goruntulendi")}` (hook çağrısı koşulsuz, üstte). Özellik yok — Rybbit pathname'i zaten yazar. `catch` dalına (`:110`) `olay("sira_form_hata", { kaynak: "cta" })`.
4. `hero-form.tsx:87` catch → `{ kaynak: "hero" }`; `tercih-profili-kapisi.tsx` `facetYukle` catch → `{ kaynak: duzenle ? "duzenle" : "kapi" }`. Doğrulama hatası (geçersiz sayı) **sayılmaz**, yalnız istek hatası.
5. `sihirbaz-cagri-karti.tsx` `SihirbazBolumu`: mount effect'inde `olayBirKez("sonuc_goruntulendi", { girisli: girisliMi ? "evet" : "hayir", sira_kovasi: siraKovasi(sira) }, girisliMi ? "girisli" : "anonim")`.
6. `/paket`: `src/features/odeme/components/paket-gorunum-olayi.tsx` **(yeni, client, `null` döner)** — effect'te `new URLSearchParams(window.location.search).get("kaynak")`, allowlist `kilit | kredi_bitti | nav`, değilse `"diger"`; `olayBirKez("paket_goruntulendi", { kaynak }, kaynak)`. `useSearchParams` **kullanma** (`cacheComponents: true` → Suspense/CSR bailout derdi). `src/app/paket/layout.tsx` **(yeni)**: `{children}` + `<PaketGorunumOlayi />`. Linkler: `listem-govde.tsx:288,369` → `/paket?kaynak=kilit`; `liste-uretici.tsx:134` → `?kaynak=kredi_bitti`; `user-nav.tsx:51` → `?kaynak=nav`.
7. `liste-uretici.tsx`: `else` dalı (`:87`) `olay("liste_uretim_hata", { kod: sonuc.code })`; `catch` (`:89`) `{ kod: "ISTISNA" }`. `AUTH`/`KREDI`/`PAKET` dalları bu olayı **atmaz**.
8. `giris-form.tsx`: `linkGonder` hata dalı → `olay("giris_hata", { yontem: "eposta", status: error.status ?? 0 })`; `status === 429` ise toast "Çok sık denedin, bir dakika sonra tekrar dene", değilse mevcut mesaj. Google hata dalı → `{ yontem: "google", status }`. `geriSayimBaslat` 30 → **60** sn (P4'ün sunucu soğumasıyla hizalı; P4 merge edilmese de zararsız).
9. **Ayrı, son commit [BİLAL]:** `rybbit-identify.tsx` `eposta`/`isim` prop'ları ve trait'ler kalkar, `kullaniciTanit(kullaniciId)`; `user-nav.tsx:47` çağrısı sadeleşir. `analitik.ts`'e dokunmaz.

**Commit bölünmesi:** (1) `fix(analitik): görünüm hook'u callback ref + erken olay kuyruğu` · (2) `feat(analitik): huni olayları` (3–7 + 8'in olay kısmı) · (3) `fix(giris): 429 mesajı + 60 sn geri sayım` · (4) **[BİLAL]** `chore(gizlilik): rybbit identify yalnız kullanıcı ID`. (4) en sonda durmalı: `user-nav.tsx`'te 47. ve 51. satırlar yakın; Bilal reddederse `git merge gece/p2-olcum~1`.

**Kabul kriterleri:** typegen+tsc+lint temiz. `grep -rn "useGorunumOlayi" src` → mevcut 5 + `cta-sira-form`. `grep -rnE "olay(BirKez)?\(" src | grep -iE "email|eposta:|sira:"` → boş (ham sıra/e-posta yok; sıra yalnız `siraKovasi()`). Olay adları yukarıdaki listeyle birebir (kalıcı sözleşme). Kod incelemesi: hook eleman `null→düğüm` geçişinde gözlem kuruyor, düğüm sökülünce `disconnect` ediyor.

**Kapsam dışı:** `giris_basarili` (P4), `odeme_hata`, `sihirbaz_kapatildi`, `rapor_yazdirildi`, /sonuc pageview şişmesi, iç trafik filtresi, `src/app/layout.tsx`, `page.tsx`/`sohbet-client.tsx`/`tercih-degisti-modali.tsx` içindeki `/paket` linkleri (kaynak = `diger` düşer), `rapor-actions.ts` (hata alt nedeni).

**Riskler / AGENTS.md:** Yeni CTA butonu eklenmiyor; var olan `ArrowRight` desenine dokunma. `?kaynak=` `/paket` canonical'ını etkilemez (`sayfaMetadata path: "/paket"`). `/giris?callback=/paket` dönüşünde kaynak kaybolur (kabul). Kuyruk sayesinde dev'de (script yok) 10 sn sonra sessizce boşalır — hata yok.

---

## 4. P3 · Vaat dili ve güven temizliği

**Amaç:** Olmayan özelliği ("yerleşme olasılığı") satan dili kaldırmak; 4↔5 yıl tutarsızlığını bitirmek; iki [BİLAL] değişikliğini bağımsız commit olarak hazırlamak.

**Kök neden (kanıt):** `page.tsx:180`, `paket-satinal.tsx:31` "yerleşme olasılığı"; `rapor.ts:166,168,170,172` dört cümlenin dördü de "ihtimal". "4 yıl": `page.tsx:107,122,148,180,365` + `paket-satinal.tsx:31`; DB `sira2021…sira2025` = 5 (`rapor.ts` `programBilgisi`, tablolar "Son 5 yıl"). **CEO listesinde olmayanlar:** `scripts/tadimlik-uret.ts:70-71` (prompt "ihtimal dili kullan"), `:72` ("son 4 yılın"), `:84-87` (mock); `src/app/api/soru/route.ts:48`; `src/components/arama-funnel-karti.tsx:38` "Yerleşme ihtimalini görerek seç." Tadımlık `riskNotu` DB'de (`schema.ts:187`) ve `tadimlik-havuzu.ts:83`'ten olduğu gibi servis ediliyor; oysa rozet aynı satırda canlı hesaplanıyor (`tadimlik-satiri.tsx:107`) → metinle rozet çelişebiliyor. CEO'nun grep'i (`olasılı|ihtimalle yerleş`) "ihtimalini/ihtimal dili/ihtimali düşük" kalıplarını yakalamıyor.

**Commit 1 — [KARAR] `fix(metin): olasılık dili + 5 yıl`:**
- `src/lib/veri-kapsami.ts` **(yeni):** `export const VERI_YIL_SAYISI = 5;` (+ yorum: DB `sira2021–sira2025`; veri yılı eklenince güncelle). **`seo.tsx`'e koyma (P1'in).**
- `src/lib/risk.ts`: `export function riskNotuMetni(risk: RiskSeviyesi | null): string` — güvenli: "Son taban sıralaması senin sıranın belirgin altında; geçmiş veriye göre güvenli aralıkta." · az-riskli: "Son taban sıralaması sırana yakın; küçük bir kayma sonucu değiştirebilir." · riskli: "Son taban sıralaması senin sıranın üstünde kapandı; hayal tercihi olarak düşün." · `null`: "Güncel taban verisi yok; bu satırı temkinli değerlendir." ("Geçen yıl" **deme**: kod `sira2025 ?? sira2024`'e düşüyor.)
- `src/lib/ai/rapor.ts` `riskNotuUret`: gövde → `return riskNotuMetni(riskHesapla(p.sira2025 ?? p.sira2024, adaySira));`. Başka hiçbir şeye dokunma (5/13/6 şeması, risk eşiği, prompt aynı).
- `page.tsx:180` ve `paket-satinal.tsx:31` → `` `Her tercih için yerleşme riski ve trend analizi (son ${VERI_YIL_SAYISI} yıl)` ``; `page.tsx:107,122,148,365` sabitten. `page.tsx`'te import'u **32. satırın (`@/lib/credits`) hemen altına** koy (commit 3'ün dokunacağı 15. ve 55-59. satırlardan uzak).
- `arama-funnel-karti.tsx:38` → "Yerleşme riskini görerek seç."

**Commit 1b — [KARAR · CTO eki] `fix(ai): tadımlık risk notu deterministik + prompt dili`:**
- `tadimlik-havuzu.ts:83`: `riskNotu: riskNotuMetni(riskHesapla(program.efektifSira, sira) ?? dilimdenRisk(satir.dilim))` (`program` = satırın snapshot'ı; üç fonksiyon `@/lib/risk`). Böylece `/api/tadimlik` de kapsanır; DB satırları ve şema değişmez.
- `scripts/tadimlik-uret.ts:70-72` prompt: "riskNotu: geçmiş taban verisine dayalı risk değerlendirmesi (TEK kısa cümle). ASLA garanti/kesin/yüzde/olasılık/ihtimal deme; 'güvenli / az riskli / riskli' etiketleriyle konuş." + "son 5 yılın"; mock metinleri aynı dile. Script **koşulmaz**.
- `api/soru/route.ts:48` → "ASLA yerleşme garantisi verme; olasılık, yüzde ya da 'ihtimal' dili kullanma — güvenli / az riskli / riskli etiketleri ve taban sıralarıyla konuş."

**Commit 2 — [BİLAL] `chore(metin): danışman fiyat kıyası`:** "2.000–10.000 TL" → "1.000–5.000 TL" (`page.tsx:90,168,484`, `paket/page.tsx:52`); "onda bir fiyatına" → "çok daha düşük fiyata" (`paket/page.tsx:49`, `layout.tsx:55`; `page.tsx:228` yorum satırı içinde ölü kod — yorum bloğunu sil). Fiyat bölümü paragrafının (`page.tsx:484-487`) altına `text-xs text-slate-500` kaynak satırı: "Danışman fiyat aralığı: Armut, 2026." Sabit **kullanma**, düz metin (commit 1'den bağımsız kalsın). Rakamı ajanlar doğrulamadı → Bilal Armut sayfasını açmadan almasın.

**Commit 3 — [BİLAL] `chore(guven): hero'da YÖK logosu yerine tarihli veri satırı`:** `veri-kaynagi.tsx:4` `const TARIH_METNI` → `export const KATALOG_TARIH_METNI` (dosya içi kullanım güncellenir; tek biçim kaynağı). `page.tsx:236-251`: `<Image>` + dikey ayraç kalkar; aynı kutu (`inline-flex … rounded-lg border …` sınıfları **aynen**) içinde `<strong>Veri: YÖK Atlas</strong> · son güncelleme <time dateTime={KATALOG_VERI_TARIHI}>{KATALOG_TARIH_METNI}</time>`. `import Image` (15) silinir; `KATALOG_VERI_TARIHI` 55-59'daki seo import'una eklenir. `public/yok-logo.svg` **silinmez**.

**Kabul kriterleri:** typegen+tsc+lint. Commit 1+1b sonrası: `grep -rniE "olasılı|ihtimal" src scripts/tadimlik-uret.ts` → yalnız `page.tsx:76` ("binlerce ihtimal" — kombinasyon anlamı, vaat değil), `page.tsx:132` ("boşta kalma ihtimalini" — SSS, kapsam dışı), `program-tablosu.tsx:176` (kod yorumu) ve prompt'lardaki **yasaklayıcı** cümleler. `grep -rn "4 yıl" src/app/page.tsx src/features/odeme` → boş. Commit 2 sonrası `grep -rn "onda bir\|2\.000–10\.000" src` → boş. Bağımsızlık testi: `main`'den geçici dal açıp commit 2'yi ve 3'ü **tek başlarına** `git cherry-pick` et → çakışmasız + tsc geçer; geçici dalı sil.

**Kapsam dışı:** Garanti→Güvenli (H2) — `cta-sira-form.tsx`'teki "garanti dilimleri / nereye yerleşirsin" dahil (dosya P2'nin); `/hakkinda`, "Sınırlarımız", hero/kapanış tonu, SSS metinleri, `vizyon.md`.

**Riskler / AGENTS.md:** Davranış değişmiyor (eşikler, 5/13/6, havuz kuralları aynı) → **`huni-semasi.tsx` `SEMA` güncellenmez**; şemadaki "risk notu gerçek sıralama geçmişinden hesaplanır, yapay zekâ yorumu değildir" iddiası 1b ile tadımlık için de doğru hâle gelir. Kayıtlı raporlardaki eski cümleler kalır (göç yok). Commit 3 yeni badge tasarlamaz (SectionEyebrow kuralı: mevcut bilgi kutusu, pill değil). CTA butonlarına dokunulmuyor.

---

## 5. P4 · Giriş e-postası sağlamlaştırma

**Amaç:** Reply-To, prod'da sessiz fallback'in bitmesi, adres başına soğuma, şablon temizliği, `giris_basarili`.

**Kök neden (kanıt):** `eposta-gonder.ts:13-18` ve `auth.ts:33-37` `NODE_ENV`'e bakmadan konsola yazıp başarı dönüyor (token'lı link loga düşer); `eposta-gonder.ts:22` sessiz `onboarding@resend.dev`; `:21-29` `replyTo` yok; `eposta.ts:79-80` Google Fonts `<link>`, `:96-101` footer'da iletişim yok; `auth.ts`'te adres bazlı sınır yok (yalnız eklentinin IP limiti 5/60 sn, `magic-link/index.mjs:157-163`); `analitik-sunucu.ts:17` tek olay.

**Değişiklikler:**
1. `eposta-gonder.ts`: `export function epostaKonsolModu(): boolean` = `!process.env.RESEND_API_KEY && (process.env.NODE_ENV !== "production" || process.env.EPOSTA_KONSOL_FALLBACK === "1")`. `epostaGonder` başında, **çağrı anında** (modül seviyesinde **asla** — `next build` NODE_ENV=production + env'siz koşar, modül yüklenirken atmak build'i kırar): konsol modu → mevcut `console.log`; anahtar yok ve konsol modu değil → `throw new Error("[eposta] RESEND_API_KEY tanımlı değil")`; `EMAIL_FROM` yok → prod'da (kaçış bayrağı yoksa) `throw`, aksi hâlde mevcut `resend.dev`. `send`'e `replyTo: process.env.EMAIL_REPLY_TO ?? "destek@kolaytercih.com"` (Resend 6 alan adı `replyTo`).
2. `auth.ts` `sendMagicLinkEmail`: `:33-37` bloğu → `if (epostaKonsolModu()) { console.log(link); return; }`; aksi hâlde `epostaGonder` (yanlış yapılandırmada atar → better-auth 500 → formda hata toast'ı; P2 `giris_hata{status:500}` yazar). `__sonMagicLink` satırı yerinde kalır.
3. Soğuma — `auth.ts`, **yalnız `NODE_ENV === "production"`** (dev paneli "anında giriş" art arda istek atıyor): `globalThis.__girisEpostaSon: Map<string, number>`; anahtar `email.trim().toLowerCase()`; her çağrıda 60 sn'den eski kayıtları buda; kayıt varsa **sessizce `return`** (mail yok, istek 200); yoksa zamanı yaz → gönder; gönderim atarsa kaydı **sil** (kullanıcı hemen yeniden deneyebilsin) ve hatayı yeniden fırlat. Konsol modunda da çalışır (lokal docker testi görsün).
4. `eposta.ts`: `:79-80` iki `<link>` satırı silinir; footer'a (`:98-99`) üçüncü satır: `<a href="https://kolaytercih.com" style="color:#94a3b8;">kolaytercih.com</a> &middot; <a href="mailto:destek@kolaytercih.com" style="color:#94a3b8;">destek@kolaytercih.com</a>`; düz metin (`text`) gövdelerinin sonuna aynı iki bilgi. Satış dili ekleme.
5. `analitik-sunucu.ts:17`: `"odeme_tamamlandi" | "giris_basarili"`. `auth.ts` `databaseHooks`'a `session: { create: { after: async (session, ctx) => { void sunucuOlayi("giris_basarili", { kullaniciId: session.userId, pathname: "/giris", ozellikler: { yontem: ctx?.path?.startsWith("/magic-link") ? "eposta" : ctx?.path?.startsWith("/callback") ? "google" : "diger" } }); } } }` — **`await` yok**; imza `(session, context | null)` 1.6.23 tiplerinde doğrulandı (`@better-auth/core … init-options.d.mts`). E-posta özelliğe girmez.
6. **İsteğe bağlı commit [BİLAL]** `.gitea/workflows/ci.yaml`: `.env.production` bloğuna `RYBBIT_HOST`, `RYBBIT_SITE_ID`, `RYBBIT_API_KEY`, `EMAIL_REPLY_TO` satırları (secret yoksa boş gelir → kod no-op/varsayılan; zararsız). Gerekçe aşağıda, itiraz #4.

**Commit bölünmesi:** (1) `chore(eposta): şablondan harici font + footer iletişim` · (2) `fix(eposta): Reply-To + prod'da sessiz fallback yok` · (3) `feat(giris): adres başına 60 sn soğuma` · (4) `feat(analitik): giris_basarili sunucu olayı` · (5) [BİLAL] ci.yaml. Tamamı "Bilal görmeden merge edilmez"; (2) ve (3) canlı giriş yolunu değiştirir, tek tek atılabilir.

**Kabul kriterleri:** typegen+tsc+lint. `grep -n "fonts.googleapis\|fonts.gstatic" src/lib/eposta.ts` → boş. `grep -n "process.env" src/lib/eposta-gonder.ts` → tüm okumalar fonksiyon gövdesinde. `grep -n "await sunucuOlayi" src/lib/auth.ts` → boş. Kod incelemesi: prod + anahtarsız + bayraksız yolda hiçbir `console.log` URL basmıyor. Bilal'in merge öncesi lokal docker testi: `EPOSTA_KONSOL_FALLBACK=1` ile link konsola düşer, 60 sn içinde ikinci istek link **üretmez**; bayraksız/anahtarsız → formda hata.

**Kapsam dışı:** disposable filtre, vazgeçme linki/`List-Unsubscribe`, eski token iptali, Resend webhook, Traefik IP başlığı / better-auth `rateLimit` ayarı, DNS, `kredi-hatirlatma.ts`.

**Riskler:** Hata = kimse giriş yapamaz → (2)-(3) için lokal docker testi şart (bellek notu "testler lokal docker'la"). Süreç içi `Map` yeniden başlatmada sıfırlanır ve çoklu kopyada paylaşılmaz — bugün tek konteyner (`docker-compose.yml`), ikinci katman IP limiti duruyor. Soğumada düşen isteğin `verification` satırı yetim kalır (15 dk'da ölür, hiç postalanmadı — zararsız). `session.create` Google girişinde ve dev panelde de tetiklenir (dev'de env yok → no-op).

---

## 6. CTO itirazları (CEO kararına)

1. **P3 kabul kriteri eksik ve grep'i yetersiz.** Yalnız `riskNotuUret` düzeltilirse girişsiz /sonuc tadımlığı (LLM üretimi, DB'de kayıtlı) ve danışman sohbeti "ihtimal" diliyle kalır; prompt'lar bu dili **emrediyor**. Alternatif: commit 1b (okuma anında deterministik risk notu + iki prompt satırı). Prod'da `pnpm tadimlik --force` gerekmez.
2. **P4-3 "kaynak: `verification` tablosu" kırılgan.** `identifier` = token (`magic-link/index.mjs:61-68`), e-posta yalnız `value` JSON'unda (indeks yok, `name` ile biçim değişir), satır `sendMagicLink`'ten **önce** yazılıyor (kendine takılır), düşürülen her istek yeni satır bırakıp pencereyi kaydırır; düzeltmesi tabloya `DELETE` gerektirir. Alternatif: süreç içi `Map` — şema yok, DB yazımı yok, better-auth iç yapısına bağımlılık yok.
3. **P4-2 "net hata" modül seviyesinde atılamaz** — `next build` kırılır; yalnız gönderim anında.
4. **P4-5 `giris_basarili` prod'da büyük olasılıkla hiç düşmeyecek:** `sunucuOlayi` `RYBBIT_HOST/SITE_ID/API_KEY` ister (`analitik-sunucu.ts:13-15,31`); CI'ın yazdığı `.env.production`'da bu üçü **yok** (`.gitea/workflows/ci.yaml:17-34`). Rybbit'teki 3 `odeme_tamamlandi` kaydının kaynağı bu yüzden şüpheli (lokal docker testi olabilir). Bilal: Gitea secret'larını ekle + P4 commit 5'i al; yoksa huninin `giris_basarili` adımı boş kalır.
5. **P2 `paket_goruntulendi {kaynak}` CEO'nun dosya listesiyle yapılamaz** (`/paket` sayfası ve `paket-satinal.tsx` P3'ün; `SatinAlForm` yalnız girişliye render oluyor). Alternatif: yeni `paket/layout.tsx`. Ana sayfadaki iki `/paket` linki (`page.tsx:535,565`, P3'ün) kaynak taşıyamaz → `diger`.
6. **P2'ye erken-olay kuyruğu eklenmezse** yeni görüntülenme olayları sert yüklemede (OAuth dönüşü, e-postadan gelen, yer imi) sistematik eksik sayar; CEO listesinde yoktu, eklendi.
7. **İstemci 30 sn ↔ sunucu 60 sn:** kullanıcı 30. sn'de "Yeniden gönder"e basınca sunucu sessizce yutar, kullanıcı mail bekler. P2 geri sayımı 60'a çeker.
8. **"Her paket `pnpm build`"**: dört paralel build ≈ 8 GB (bellek notu: build ~2 GB). Yalnız P1 build eder; diğerleri typegen+tsc+lint; build Tur 4'te sırayla.

## 7. Backlog (bu gece yapılmayan teknik maddeler, öncelik sırasıyla)

1. **Prod tadımlık havuzu kontrolü** (`pnpm tadimlik`) — P2 yayına girip `tadimlik_goruntulendi` hâlâ 0 ise ilk şüpheli. [Bilal]
2. **Gitea secret'ları:** `RYBBIT_*`, `EMAIL_REPLY_TO` (itiraz #4). [Bilal]
3. Garanti→Güvenli (H2) tek paket: ~10 dosya + `SEMA` + aria + figcaption aynı commit; `cta-sira-form.tsx` "garanti dilimleri / nereye yerleşirsin" ve `page.tsx:132` dahil. Karar bekliyor.
4. Rehber T4 (`kume`/`ilgili` + `/rehber` küme başlıkları, `SectionEyebrow` ile) — P1 merge'inden sonra, aynı dosyalar.
5. `liste_uretim_hata` alt nedeni: `rapor-actions.ts` sonuç tipine `neden: "ai" | "dogrulama" | "tekrar"`; ardından `odeme_hata`, `sihirbaz_kapatildi`, `rapor_yazdirildi`; kalan `/paket` linklerine `kaynak` (`page.tsx`, `sohbet-client.tsx`, `tercih-degisti-modali.tsx`).
6. Tarih biçimi tekilleştirme: `veri-kaynagi.tsx`'in `toLocaleDateString`'i P1'in `trTarih`'ine geçsin (P1+P3 merge sonrası); hydration #418 şüphesini de kapatır.
7. better-auth `rateLimit` + `advanced.ipAddress.ipAddressHeaders` Traefik'e göre sabitlenmesi (IP başlığı yanlışsa limit ya herkese ortak ya hiç işlemiyor) — canlı ayar, lokal docker + Bilal.
8. `error.tsx`'e ChunkLoadError için tek seferlik reload; `/sonuc` pageview şişmesi (`replaceState`).
9. `el-cizimi-sema.tsx:14-15` font lisansı — alınmadıysa font değişimi işi.
10. Eski token iptali, Resend webhook/alarm, hatırlatma retry, disposable filtre (ürün/hukuk kararı sonrası).