# Karar Günlüğü

Her karar: **ne**, **neden**, **bedeli**. Bir karar değişirse satır silinmez; altına yenisi eklenir.

## K1 — Taban: Laravel 13 resmi React starter kit (2026-11-10)

- **Ne:** `laravel/react-starter-kit` (main): Inertia 3, React 19, TypeScript, Tailwind 4, Vite+, Fortify, Wayfinder, shadcn/ui.
- **Neden:** Güncel ekosistemin doğru bağlanmış hâli; admin için giriş/2FA/düzen/UI kiti hazır geliyor.
- **Bedel:** Kullanılmayan parçalar ayıklandı (kayıt, e-posta doğrulama, passkey, karşılama sayfası).

## K2 — Tek uygulama, iki ön yüz (2026-11-10)

- **Ne:** Genel site ve yönetim ayrı JS/CSS girişleri ve ayrı kök Blade görünümleri kullanır.
- **Neden:** Genel sitenin paketi admin bağımlılıklarını taşımaz; SEO başlığı ve SSR yalnızca siteye uygulanır.
- **Bedel:** İki ön yüz arası geçiş tam sayfa yüklemesi; ortak kod bilinçli paylaşılmalı.

## K3 — SEO başlığı Blade'de, sunucuda (2026-11-10)

- **Ne:** `<title>`, meta, canonical, hreflang, Open Graph ve JSON-LD PHP'de üretilir (`SeoData` → `partials/seo.blade.php`). İstemci yalnızca SPA gezinmesinde eşitler.
- **Neden:** SSR süreci çalışmasa bile arama motoru eksiksiz başlık görür; PHP testleriyle doğrulanabilir; tek doğruluk kaynağı.
- **Bedel:** Site sayfalarında Inertia `<Head>` ile başlık/meta **yazılmaz** (çift etiket olur).

## K4 — Varsayılan dil öneksiz (2026-11-10) — **K20 ile değişti**

- **Ne:** `tr` → `/…`, `en` → `/en/…`; `x-default` Türkçe'ye işaret eder.
- **Neden:** Ana pazar Türkiye; anasayfa yönlendirme olmadan 200 döner; adresler kısa.
- **Bedel:** `en`, `admin` gibi ilk segmentler Türkçe slug olarak kullanılamaz (ayrılmış).

## K5 — Çeviriler JSON sütunlarında (2026-11-10)

- **Ne:** `{"tr": …, "en": …}` biçiminde JSON sütunları + küçük bir `HasTranslations` yardımcısı; paket yok.
- **Neden:** Tek tablo, basit admin formları, yeni dil için migration gerekmez, dizi değerleri destekler.
- **Bedel:** Slug araması JSON yolu üzerinden (yüzlerce satır için önemsiz; ayrıca önbellekli).

## K6 — İçerik veritabanında, ilk hâli JSON dosyalarında (2026-11-10)

- **Ne:** `database/content/**.json` → içe aktarma komutu → DB → admin panelden düzenleme.
- **Neden:** İlk içerik sürüm kontrolünde; müşteri sonradan panelden değiştirir; içe aktarma düzenlemeleri ezmez.
- **Bedel:** JSON ve DB zamanla ayrışır; doğruluk kaynağı canlıda DB'dir.

## K7 — Animasyon kütüphanesi yok (2026-11-10)

- **Ne:** Kaydırma efektleri CSS + küçük bir kaydırma motoru (IntersectionObserver + rAF + CSS değişkenleri) ile.
- **Neden:** GSAP/Motion ~25–60 KB ekler; ihtiyaç duyulan efektler `transform`/`opacity` ile yapılabiliyor; SSR ve JS'siz görünüm sorunsuz.
- **Bedel:** Çok karmaşık zaman çizelgeleri gerekirse ilgili sahne için kütüphane **tembel yüklenerek** eklenebilir.

## K8 — Yer tutucu medya: üretken SVG/CSS (2026-11-10)

- **Ne:** Fotoğraf/video yokken görseller kod ile üretilir (aurora zeminler, kontur çizimleri, yüz haritası). `MediaSlot` gerçek dosya gelince onu gösterir.
- **Neden:** Lisans/telif riski yok, çok hafif, markaya göre renklendirilebilir, sonradan değiştirmek tek alan.
- **Bedel:** Gerçek klinik görselleri gelene kadar "fotoğrafik" his sınırlı.

## K9 — Yerelde SQLite (2026-11-10)

- **Ne:** Geliştirme veritabanı `database/database.sqlite`.
- **Neden:** MariaDB'ye root erişimi oturumda yetkilendirilmedi; SQLite kimlik bilgisi gerektirmez. Kod veritabanından bağımsız yazılır.
- **Bedel:** Canlı MariaDB/MySQL olacağından yayın öncesi MariaDB ile tam test koşulmalı (`DEPLOYMENT.md`).

## K10 — URL kökü "tedaviler / treatments" (2026-11-10)

- **Ne:** İşlem sayfaları `/tedaviler/{kategori}/{islem}` altında.
- **Neden:** Hastanın aradığı sözcük; iki seviyeli hiyerarşi kırıntı yolu ve site bağlantıları için net.
- **Bedel:** Değişirse `lang/*/routes.php` tek satır + toplu 301 gerekir.

## K11 — Uydurma veri yok (2026-11-10)

- **Ne:** Sahte telefon, adres, hasta sayısı, puan, yorum, hekim adı **yazılmaz**. Bilgi yoksa alan gizlenir veya "yakında" gösterilir.
- **Neden:** Yanıltıcı bilgi hem mevzuata hem Google yapılandırılmış veri kurallarına aykırı; yanlışlıkla dizine girerse zarar verir.
- **Bedel:** Bazı bölümler gerçek bilgi gelene kadar sade görünür.

## K12 — Yönetim arayüzü Türkçe (2026-11-10)

- **Ne:** Admin panel tek dilli (Türkçe).
- **Neden:** Kullanıcıları klinik personeli; çift dil bakım yükü getirir.
- **Bedel:** İngilizce admin istenirse metinler sözlüğe taşınmalı.

## K13 — K3'ün uygulaması: `head` prop'u + Inertia `serverHead` (2026-11-10)

- **Ne:** `<head>` öğeleri ayrı bir Blade parçasında değil, `App\Seo\HeadBuilder` içinde hazır HTML dizgileri olarak üretilir ve sayfanın `head` prop'uyla gönderilir. SSR bunu ilk HTML'e yazar (`serverHead: true`), SSR yoksa `site.blade.php` aynı dizgileri basar, site içi gezinmede istemci eşitler.
- **Neden:** K3'teki ilke (başlık sunucuda, tek kaynak) korunurken Inertia 3'ün yerleşik mekanizması kullanılır; üç yolun da birebir aynı çıktıyı vermesi `data-inertia` anahtarlarıyla güvenceye alınır.
- **Bedel:** `head` her yanıtta (JSON gezinmeleri dahil) taşınır: sayfa başına ≈ 5–9 KB (sıkıştırılmış ≈ 1–2 KB).

## K14 — Genel site oturumsuz ve çerezsiz (2026-11-10)

- **Ne:** Genel rotalar `web` yerine kendi `site` ara katman grubundan geçer: oturum başlatılmaz, çerez yazılmaz, CSRF belirteci yoktur. İletişim formu JSON isteğiyle gönderilir; koruması aynı-köken denetimi (`SameOrigin`: `Origin` / `Sec-Fetch-Site`) + hız sınırı + honeypot + zorunlu KVKK onayıdır.
- **Neden:** Çerez yazmayan sayfalar herkese aynıdır → `ETag` ile yeniden doğrulanabilir, vekil/CDN arkasında önbelleklenebilir; çerez onayı gerektiren hiçbir şey yüklenmez.
- **Bedel:** Genel sitede oturuma dayalı özellik (flash mesaj, "beni hatırla") yoktur. Bu başlıkları göndermeyen istemciler (komut satırı, çok eski tarayıcılar) yalnızca hız sınırı ve honeypot ile sınırlanır — gönderimin tek etkisi bir talep kaydıdır.

## K15 — Dizinleme kapalıyken tarama açık (2026-11-10)

- **Ne:** `SEO_INDEXING` kapalıyken `robots.txt` `Disallow: /` yazmaz; bunun yerine her yanıt `X-Robots-Tag: noindex, nofollow` + `meta robots` taşır.
- **Neden:** Taraması yasaklanan sayfanın `noindex` kuralı okunamaz; adres başka yerden bağlantı alırsa içeriksiz olarak dizine girebilir.
- **Bedel:** Yayın öncesi ortam taranabilir (içerik sızıntısı istenmiyorsa ayrıca parola/IP kısıtı gerekir).

## K16 — Menüler ilk kullanımda kurulur (2026-11-10)

- **Ne:** Mega menü ve mobil menü (≈ 76 bağlantı) ilk HTML'de yoktur; üst bilgideki düğmeye ilk kez gelindiğinde/tıklandığında kurulur. Aynı bağlantılar alt bilgide ve `/tedaviler` sayfasında düz HTML olarak bulunur.
- **Neden:** Her sayfanın HTML'inden ≈ 33 KB ve ≈ 380 DOM öğesi düşer; tarayıcılar yine de tüm sayfalara düz bağlantılardan ulaşır.
- **Bedel:** JavaScript'siz ziyaretçi üst menüyü açamaz (alt bilgi ve dizin sayfası üzerinden gezinir).

## K17 — Medya kütüphanesi dosya adıyla (2026-11-10)

- **Ne:** Fotoğraf ve videolar veritabanına kaydedilmez; `storage/app/public/media/{home,categories,treatments}/<anahtar>.*` adına göre bulunur (`App\Content\MediaLibrary`) ve `MediaSlot` ile gösterilir.
- **Neden:** Görseller geldiğinde iş "dosyayı klasöre koymak"tan ibarettir: migration, form, eşleme yok; içe aktarma (`--fresh`) görsellere dokunamaz; aynı fotoğrafın AVIF/WebP/JPEG sürümleri yan yana durabilir.
- **Bedel:** Panelden yükleme ekranı yoktur (dosya sunucuya kopyalanır); alt metin kaydın adıdır; fotoğraflar önceden boyutlandırılmış gelmelidir (sunucuda dönüştürme yok).

## K18 — Bekleyen kelimeler %48 opaklıkta (2026-11-10)

- **Ne:** Kaydırdıkça aydınlanan metinlerde (`TextReveal`) sırası gelmemiş kelimeler %16 yerine %48 opaklıkla durur.
- **Neden:** Büyük metin için 3:1 kontrast eşiğinin üstünde kalır; kaydırmadan ileriyi okuyan ziyaretçi metni okuyabilir (Lighthouse erişilebilirlik denetimi de bunu arar).
- **Bedel:** Efekt biraz daha az kontrastlıdır.

## K19 — Seeder kullanıcı oluşturmaz (2026-11-10)

- **Ne:** `db:seed` yalnızca içeriği içe aktarır; starter kit'in "Test User" hesabı kaldırıldı. Yöneticiler `php artisan admin:create` ile açılır.
- **Neden:** Tohumlanan hesabın şifresi bilinir (`password`); canlıda yanlışlıkla çalıştırılırsa panel herkese açılır.
- **Bedel:** Yerelde ilk girişten önce bir kez `admin:create` çalıştırmak gerekir.

## K20 — Her dil kendi önekinde: `/tr/…`, `/en/…` (2026-11-11)

- **Ne:** K4'ün yerini alır. Türkçe de önek taşır (`/tr/tedaviler/botoks`). Kök adres `/` → `/tr`
  (301, sorgu dizgisi korunur). Öneksiz eski adresler (`/tedaviler/botoks`) 404 onarımında
  varsayılan dilin önekiyle tek adımda 301 olur (`App\Support\Redirects`). `x-default` yine Türkçe'dir.
- **Neden:** Proje sahibinin isteği: adresin kendisi sayfanın dilini söyler; iki dil simetriktir,
  yeni dil eklemek adres yapısını değiştirmez; hiçbir ilk segment "ayrılmış" kalmaz.
- **Bedel:** Kök adres bir yönlendirme döner (anasayfa `/tr`); Türkçe adresler üç karakter uzar.
  `WebSite` / klinik JSON-LD `url` değeri kök adres olarak kalır.

## K21 — Efektler için hazır paket yok; motor genişletildi (2026-11-11)

- **Ne:** Yeni kaydırma efektleri (zoom sahnesi, kinetik yazı, eğilen kartlar, renk değiştiren
  ışık, dönen çizimler) kendi motorumuzla yazıldı; motora isteğe bağlı **yumuşatma** (`smooth`)
  eklendi. GSAP ScrollTrigger, Lenis ve Motion değerlendirildi, eklenmedi.
- **Neden:** GSAP + ScrollTrigger ~45 KB, Motion ~35–60 KB (gzip) ek yük getirir ve aynı işi
  ikinci bir motorla yapar. Lenis yerel kaydırmayı ele geçirir (pasif olmayan `wheel` dinleyicisi):
  klavye/erişilebilirlik davranışını ve Lighthouse "en iyi uygulamalar" puanını bozar; istenen
  "akıcı" his, kaydırmaya dokunmadan ilerleme değerini yumuşatarak elde edildi.
- **Bedel:** Karmaşık zaman çizelgeleri elle (CSS `calc`/`pow`) yazılır; bkz. `ANIMATIONS.md` §8.

## K22 — Hero zemini: elle yazılmış WebGL gölgelendirici (2026-11-11)

- **Ne:** Anasayfa hero'sunun arkasında "canlı eş yükselti çizgileri" çizilir
  (`site/lib/hero-field.ts`): tek üçgen + tek parça gölgelendirici, WebGL 2, kütüphanesiz (~3,5 KB gzip,
  ayrı parça, sayfa boşta kalınca yüklenir). Altında CSS aurora durur.
- **Neden:** Sitenin üretken çizim motifiyle (kontur haritası) aynı dili konuşan, siteye özgü bir
  karşılama; three.js gibi bir kütüphane (150 KB+) tek bir tam ekran gölgelendirici için gereksizdir.
- **Bedel:** WebGL 2 yoksa, "hareketi azalt" ya da veri tasarrufu açıksa yalnızca aurora görünür.
  Gölgelendirici **arka planda** derlenir (`KHR_parallel_shader_compile`); eşzamanlı derleme
  Lighthouse'ta 700 ms ana iş parçacığı takılması yaratıyordu.

## K23 — Blog (2026-11-11)

- **Ne:** `posts` tablosu; `/tr/blog`, `/en/blog` (9'arlı sayfalama) ve yazı sayfaları; gövde
  Markdown; `BlogPosting` JSON-LD; panelde Blog modülü; başlangıç yazıları `database/content/posts/`.
  Yazar olarak **klinik** gösterilir; hekim incelemesi girilirse `reviewedBy` yazılır.
- **Neden:** Proje sahibinin isteği; bilgilendirici içerik uzun kuyruk aramalar için en verimli alan.
- **Bedel:** Yazılar da hekim incelemesi ister (`CONTENT_REVIEW.md`). Bir dilde başlığı ya da
  adresi olmayan yazı o dilde yayınlanmaz; menüde "Blog" yalnızca o dilde yazı varken görünür.
  Yazı tarihi kliniğin saat dilimindeki gündür (UTC'de saklanır).

## K24 — İletişim sayfasında Google Haritası çerçevesi (2026-11-11)

- **Ne:** Harita, adresle aranan standart Google Maps çerçevesidir (`output=embed`; API anahtarı yok).
  Çerçeve **görünüme girene kadar yüklenmez**; o zamana kadar ve JS'siz adres + "Haritada göster"
  bağlantısı durur. Arama metninden `/` işaretleri çıkarılır (Google "A / B"yi rota sayıyor).
- **Neden:** "Şimdilik" istenen çözüm; koordinat ya da anahtar gerektirmez.
- **Bedel:** Çerçeve üçüncü taraf içeriktir (Google çerez yazabilir) → K14'teki "çerezsiz site"
  ilkesinin tek istisnası; çerez onayı kurulurken (Faz 8) onaya bağlanmalıdır. Adres değişince
  iğnenin doğru yerde olduğu gözle kontrol edilmelidir.

## K25 — Bayraklı dil menüsü; tek yeni paket `country-flag-icons` (2026-11-11)

- **Ne:** Üst bilgideki dil değiştirici, bayraklı bir açılır menüdür (yerel `<details>`; JS'siz de açılır).
  Bayraklar `country-flag-icons` paketinden tek tek içe aktarılır (`site/lib/flags.ts`): pakete yalnızca
  kullanılan iki bayrak girer. İngilizce için Birleşik Krallık bayrağı (`config/site.php` → `flag`).
- **Neden:** Proje sahibinin isteği; SVG bayrak çizmek yerine bakımı yapılan bir kaynak.
- **Bedel:** Bayrak bir ülkeyi, dil ise bir dili temsil eder; bu yüzden her bayrağın yanında dilin
  kendi adı da yazılır.

## K26 — Vurgu metin rengi kartın kendi aksanını izler (2026-11-11)

- **Ne:** `--accent-fg`, sahne ya da aksan tanımlayan **her** öğede yeniden hesaplanır
  (`color-mix` + `--on-light` bayrağı). Kendi `data-accent` değeri olan kart, hangi sahnede durursa
  dursun kendi tonuyla boyanır.
- **Neden:** Önceden yalnızca sahnede hesaplanıyordu; kartların etiket ve ikonları her zaman altın
  rengindeydi, kategori renkleri yalnızca ışık olarak görünüyordu.
- **Bedel:** Yok (açık zeminde okunur "ink" tonları zaten tanımlıydı).

## K27 — Yazı tipi: Bricolage Grotesque + Onest; vurgu ağırlıkla (2026-11-12)

- **Ne:** Instrument Serif + Manrope yerine başlıkta **Bricolage Grotesque** (değişken, ince 320 ağırlıkta),
  metinde **Onest**. Başlıktaki `*vurgu*` artık italik değil: daha kalın (560) ve vurgu renginde.
- **Neden:** Proje sahibi önceki çifti "çok klasik, herkesin kullandığı gibi" buldu. Bricolage Grotesque
  ince ağırlıkta karakterli ama sakin; Onest okunaklı ve Türkçe karakterleri eksiksiz. İkisinde de italik
  yok, bu yüzden vurgu ağırlık karşıtlığıyla yapılır (tarayıcının yapay italiği çirkin olurdu).
- **Bedel:** İtalik yüz ve onun sayfa bazlı ön yüklemesi (`italic_headlines`) kaldırıldı. Yedek yazı
  tipi ölçüleri yeniden ölçüldü — bu kez dosya ortalaması yerine tarayıcıda gerçek metin genişliğiyle;
  kalın ağırlık için ayrı yedek yüz gerekti (yoksa vurgu yazı tipi gelince kayıyordu, CLS 0,11).

## K28 — Hero: kontur animasyonu + arkada soluk klinik fotoğrafları (2026-11-12)

- **Ne:** Anasayfa hero'sunda WebGL kontur alanı kalır; arkasında `media/home/backdrop-*` fotoğrafları
  soluk biçimde birbirine geçer ve yavaşça yaklaşır. Alanın çizgi aralarındaki zemin yarı saydamdır
  (`HeroField ground`). Altta üyelik/belge logoları, istatistiklerde (ayar girilince) yıllık deneyim.
- **Neden:** Proje sahibinin isteği: "arkaplanda hem şuanki animasyon hem de arkasına hafif klinik görseli".
- **Bedel:** İlk fotoğraf ilk ekranda yüklenir (mobil ~30 KB AVIF); diğerleri sayfa oturduktan sonra
  eklenir. `media/home/hero.*` konursa (video/fotoğraf) hepsinin yerini o alır.

## K29 — Klinik bilgileri kliniğin kendi sitesinden (2026-11-12)

- **Ne:** WhatsApp numarası, Instagram hesabı ve Google işletme bağlantısı kliniğin yayındaki sitesinden
  (cellavia.com) alındı ve `database/content/settings.json`'a yazıldı. Fotoğraflar ve logolar proje
  sahibinin paylaştığı klasörlerden geldi.
- **Neden:** Sabit WhatsApp düğmesi ve sosyal medya düğmeleri istendi; bilgiler kliniğin kendi
  yayımladığı, gerçek bilgiler (K11 uydurma veri yasağıyla çelişmez).
- **Bedel:** Doğrulama proje sahibindedir; panelden değiştirilebilir. Deneyim yılı ve platform puanları
  bulunamadığı için boş bırakıldı (gizli).

## K30 — Hasta yorumları: elle aktarılan gerçek yorumlar, yapılandırılmış veri yok (2026-11-12)

- **Ne:** Google/Trustpilot puanı ve sayısı ayarlardan, yorumlar Yorumlar modülünden gelir (özgün
  metin, özgün dil, özgün yoruma bağlantı). Yorum yokken yalnızca platform bağlantıları ince bir
  şeritte görünür. Platform pencere öğeleri (widget) **kullanılmaz**; `Review`/`AggregateRating`
  JSON-LD **yazılmaz**.
- **Neden:** Widget'lar üçüncü taraf betik + çerez demektir (K14, performans). Google kendi sitesindeki
  işletme yorumlarını zengin sonuç için kabul etmez ("self-serving reviews"). Türkiye'de sağlık
  tanıtımında hasta beyanı kullanımı kısıtlanabilir → yayın öncesi hukuk onayı.
- **Bedel:** Puan ve sayı elle güncellenir.

## K31 — Anasayfada adım adım randevu formu (2026-11-12)

- **Ne:** Anasayfanın sonunda (#randevu) üç adımlı form: alan → uygulama (ya da "hekimimle karar
  vermek istiyorum") → iletişim bilgileri. İletişim sayfası formuyla aynı uca (`contact.store`) gönderir;
  `category` alanı talebe "ilgilendiği alan" olarak kaydedilir. Hero'nun ana düğmesi buraya iner.
- **Neden:** Proje sahibinin isteği; kısa adımlar formu doldurmayı kolaylaştırır.
- **Bedel:** İletişim sayfasındaki tek sayfalık form da kalır (doğrudan gelenler için).

## K32 — Formlarda "robot değilim" doğrulaması: Cloudflare Turnstile (2026-11-13)

- **Ne:** İletişim sayfası formu ve anasayfadaki randevu sihirbazı (ikisi de `contact.store`) Cloudflare
  Turnstile ile korunur. Sunucu belirteci `siteverify` ile doğrular (`App\Support\Turnstile`); doğrulama
  yalnızca diğer alanlar geçerliyse en sonda yapılır (belirteç tek kullanımlıktır). Anahtarlar `.env`'de
  (`TURNSTILE_SITE_KEY`, `TURNSTILE_SECRET_KEY`); ikisinden biri boşsa doğrulama kapalıdır ve formlar
  önceki gibi çalışır. Betik, form görünüme yaklaşınca yüklenir (sihirbazda yalnızca son adımda);
  widget'ın 65 px yüksekliği önceden ayrılır (CLS yok).
- **Neden:** Proje sahibinin isteği. Mevcut korumalar (aynı-köken, hız sınırı, honeypot) basit botları
  durdurur; tarayıcı süren botlara karşı Turnstile ek katmandır. reCAPTCHA'ya göre daha hafif, çoğu
  ziyaretçiye görev göstermez.
- **Bedel:** Genel sitede ikinci üçüncü taraf içerik (K24'ten sonra): `challenges.cloudflare.com`'dan
  betik + çerçeve. Cloudflare erişilemezse (bağlantı hatası, 5xx) talep **kabul edilir** ve günlüğe
  yazılır — talep kaybı spam'den pahalıdır; yanlış gizli anahtar ise her talebi reddeder ve `error`
  düzeyinde günlüğe düşer. Cloudflare'i engelleyen ziyaretçi formu gönderemez (uyarı metni telefona
  yönlendirir). Ziyaretçinin IP'si ve tarayıcı sinyalleri Cloudflare'e (yurt dışı) gider → KVKK
  aydınlatma metninde anılmalıdır (hukuk onayı).

## K33 — Marka renkleri ve logo (2026-11-13)

- **Ne:** Marka renkleri lacivert `#1b1869`, mavi `#0782c6`, açık `#fafafa`. Lacivert koyu sahnenin
  (`ink`), `#fafafa` açık sahnenin (`bone`) zeminidir; mavi varsayılan vurgudur (`brand`, `:root` /
  `data-accent="brand"`). Mavi metin olarak 4,5:1'i geçemediği için iki tonu türetildi: koyu zeminde
  `brand-soft` `#5fb6ea`, açık zeminde `brand-deep` `#05659c`; ikincil metinler (`mute`, `haze`) ve
  yüzeyler de lacivertten türetildi (tümü ≥ 4,5:1). `gold*` belirteçleri kaldırıldı; `champagne`
  yalnızca Botoks kategorisinin vurgusu olarak kaldı. Logo kaynaktan (beyaz zeminli PNG) saydamlaştırıldı:
  açık zemin sürümü + koyu zemin sürümü (lacivert→mavi geçişi beyaz→`brand-soft`), `public/assets/brand/`,
  `config/site.php` → `defaults` üzerinden; panelden yüklenen logo kendi karşılığının yerine geçer.
  Favicon, apple-touch-icon ve `og-default.jpg` logodan üretildi; `favicon.svg` (eski monogram) kaldırıldı.
- **Neden:** Müşterinin marka renkleri ve logosu. Belirteç yapısı (koyu/açık sahne + vurgu) korunarak
  değerler değişti; bileşenlere dokunmak gerekmedi. Logo varsayılanı dosyada durduğu için her kurulumda
  veritabanı adımı olmadan görünür.
- **Bedel:** Logo PNG (SVG yok): 391×120, ~10 KB; üst bilgide bir görsel isteği. Logo artık sık sık
  LCP öğesi (önceden metindi) → `fetchPriority="high"` (React SSR `<head>`'e preload ekler); sıkıştırmalı
  ölçümle doğrulanacak. Koyu zemin sürümü türetildi; marka kılavuzunda negatif sürüm varsa o kullanılmalı.
  Lacivert, siyahtan açık olduğundan yarı saydam lacivert katmanlar açık zemin üstünde lavantaya kayar:
  kaydırılmış üst bilgi %75 → %90. Sıcak kategori vurguları (şampanya, gül, kehribar) lacivertle kaldı.

## K34 — Formlar CRM'e gider: CRM'in form sayfası çerçeve içinde (2026-11-13)

- **Ne:** Genel sitedeki formlar kliniğin CRM'inin kendi form sayfasını (`crm.empclinics.com/base/lp-form/iframe.html`)
  çerçeve içinde gösterir; talep doğrudan CRM'e yazılır, bu uygulamadan geçmez. İki biçim (`CrmForm`):
  `message` (ad, e-posta, telefon, not — iletişim sayfası ve anasayfadaki randevu formunun ilk adımı) ve
  `whatsapp` (ad + telefon; CRM yanıtında talebi alacak temsilcinin numarası gelir ve WhatsApp açılır).
  WhatsApp formu iki yerdedir: anasayfadaki bant (#whatsapp) ve her sayfadaki sabit düğmenin paneli;
  sitedeki diğer "WhatsApp ile yazın" düğmeleri de bu paneli açar (`WhatsAppButton`,
  `lib/whatsapp-form.ts`) — önce form, sonra sohbet. CRM'in gömme betiği (`lp-form.js`) yüklenmez; adresi
  aynı kuralla `lib/crm-form.ts` kurar: ayarlar sorgu parametresidir, form sitenin belirteçlerinden okunan
  renklerle giydirilir (`styles-json`). Anahtarlar `.env`'dedir (`CRM_FORM_API_KEY`, `CRM_FORM_SECRET_KEY` —
  CRM'deki partner şirket anahtarları); ikisi de doluyken açılır (`App\Support\CrmForms`, `site.crm`
  paylaşılan prop'u). Boşken sitenin kendi formları çalışır (randevu formunun ilk adımı ve iletişim
  sayfasında `ContactForm`; talepler panelde).
- **Randevu formunda sıra (proje sahibinin seçimi, 2026-11-13):** önce CRM'e kaydet. İlk adım CRM formudur;
  gönderilince talep CRM'dedir. Sonraki iki adımın yanıtı (alan, uygulama) CRM'e eklenemez — çerçeve
  yalnızca açılırken parametre alır, CRM'de de buna uygun bir uç yoktur (`quiz/store` puanlı değerlendirme
  içindir). Bu yanıtlar sitenin panelinde, CRM'in döndürdüğü müşteri numarasıyla saklanır
  (`leads.crm_customer_id`; ad/telefon/onay sütunları bu satırlarda boştur): `contact.interest` ucu,
  panelde "CRM müşterisi #…". CRM numara döndürmezse (spam saydığı talepler) sorular atlanır.
- **Neden:** Proje sahibinin isteği: talepler kliniğin öteki siteleriyle aynı CRM'de toplanır, WhatsApp'a
  geçmeden önce ad ve telefon alınır. Çerçeve CRM'in hazır çözümüdür; doğrulama (reCAPTCHA), telefon
  biçimi, mükerrer kayıt ve temsilci ataması CRM'de kalır.
- **Bedel:** Üçüncü taraf içerik (K24 ve K32'den sonra üçüncüsü): çerçevenin içinde Google reCAPTCHA, CDN'ler
  (Tailwind, axios, intl-tel-input), `ipinfo.io` ve — sitenin yazı yüzü için — Google Fonts yüklenir;
  ziyaretçinin IP'si bu hizmetlere gider → KVKK aydınlatma metninde anılmalı (hukuk onayı). Çerçeve
  görünüme yaklaşınca ya da panel açılınca istenir, ilk ekranda yoktur; yeri önceden ayrılır (CLS 0). Form
  sayfası kendi yüksekliğini bildiremez: yükseklik biçim başına sabittir (`FRAME`, stil sayfasıyla birlikte
  değişir); reCAPTCHA görsel soru açarsa çerçevenin içinde kaydırılır. Çerçevenin içindeki uyarı metinleri
  (`alert`) yalnızca Türkçedir. `hide_recaptcha` kullanılamaz (form sayfası belirteci her durumda ister).
  Anahtarlar tarayıcıda görünür (CRM'in gömme tasarımı; yalnızca talep eklemeye yarar). CRM açıkken
  Turnstile kullanılmaz; alan/uygulama bilgisi CRM kaydında değil paneldedir (iki sistem) — CRM'e
  "müşteri numarasına not ekle" ucu yazılırsa `contact.interest` oraya da iletebilir. `contact.interest`
  herkese açık bir uçtur: numara istemciden gelir, doğrulanamaz (aynı-köken denetimi ve hız sınırı var;
  yanıt, satır bulunup bulunmadığını söylemez). Tarayıcı yeni sekmeyi engellerse onay ekranındaki
  "WhatsApp’ı aç" bağlantısı kullanılır.
- **Güncelleme (K39, 2026-11-16):** Anahtarlar boşken WhatsApp düğmelerinin numaraya bağlantı olması
  kaldırıldı; o durumda sitenin kendi kısa formu açılır. "Önce form, sonra sohbet" artık her kurulumda geçerli.

## K35 — Anasayfa: her alana kendi sahnesi; randevu formunda önce bilgiler (2026-11-13)

- **Ne:** (1) Hero'nun hemen altında "Uzmanlık alanları": üstte tüm alanların dizini (hepsi aynı anda
  görünür), altında her alana **kendi paneli** — hepsi aynı boyda ve aynı parçalarla: sıra, uygulama
  sayısı, ad, slogan, üç uygulaması (öne çıkarılanlar önce), sayfasına bağlantı ve alanın işareti
  (`AreasShowcase`). Hareket açıkken paneller üst üste biner: her biri üst bilginin altında durur, sonraki
  üstüne kayar ve onu geriye iter (küçülür, gölgelenir). Panel yerine otururken adı anahat olarak
  kayar, metinleri sırayla yükselir; her panelin kendi çizim sahnesi vardır (K36). Tek sahne hepsini
  sürer (`.areas-deck`).
  (2) Belirli alanları öne çıkaran bölümler kaldırıldı: zoom sahnesi (yüz → doku → hücre;
  botoks/dolgu/mezoterapi/longevity anlatıyordu), yatay alan galerisi (diş 9. sıradaydı, galerinin sonunda
  görünüyordu), longevity bölümü ve "öne çıkanlar" ızgarası. Hero metni alan saymaz ("10 uzmanlık alanı,
  tek klinik"). (3) Randevu formunda (sayfa sonu, `#randevu`) sıra değişti: **Bilgiler → Alan → Uygulama**
  (K31'de alan → uygulama → bilgiler idi). Ziyaretçi önce formu görür; form ilk adımda gönderilir, sonraki
  iki adım isteğe bağlıdır ve kayıtlı talebe eklenir (`contact.interest`; sitenin kendi formunda talebin
  satırı tamamlanır, CRM formunda K34'teki gibi). Telefonda form, "doğrudan ulaşın" bilgilerinden önce
  gelir. Sıra: hero → alanlar → kinetik bant → WhatsApp bandı → yaklaşım → klinik → süreç → yorumlar →
  blog → SSS → randevu.
- **Neden:** Proje sahibinin isteği: diş ve saç geri planda kalıyordu, tüm bölümler eş değerde görünmeli;
  her alanın kendi kaydırma efekti olmalı; ziyaretçi formu ilk adımda görmeli. İlk adımda gönderim, yarıda
  bırakan ziyaretçinin talebini de kazandırır.
- **Bedel:** Alanlar bölümü uzundur (bkz. K36). Zoom sahnesi, alan galerisi ve yörünge çizimi
  koddan çıkarıldı (git geçmişinde durur). İşlemdeki "Öne çıkar" anahtarı artık ayrı bir bölüm doldurmaz;
  işlemi alanının panelinde öne alır. Üstü örtülmüş bir paneldeki bağlantıya klavyeyle gelinirse sayfa o
  panele kaydırılır. 576 pikselden alçak pencerelerde paneller üst üste binmez, düz bir sütundur.
  Sitenin kendi formunda talep ilk adımda saklandığı için alan/uygulama sonradan gelir: ziyaretçiye verilen
  şifreli belirteçle, en çok 6 saat içinde (`Lead::COMPLETION_HOURS`). **Saç:** içerikte saç bölümü yoktur
  (yalnızca Cihazlı İşlemler altında "Saç PRP"); kliniğin tabelasında "Saç ekimi, saç tedavileri" yazıyor.
  Uygulama listesi gelince 11. alan olarak eklenir — dizin ve paneller kendiliğinden çoğalır.

## K36 — Her alana kendi çizim sahnesi ve anlatımı (2026-11-13)

- **Ne:** Alanlar bölümündeki her panel yerine oturduktan sonra bir süre tutulur ve bu sırada o alana özel
  bir çizim sahnesi kaydırmayla ilerler (`area-scenes.tsx`): botoksta yüz çizimi nokta nokta yanar,
  dolguda profilde hacimler büyür, mezoterapide damlalar cilde düşer, cihazlı işlemlerde başlık cildi
  tarar, IV'de serum akar, erkek sağlığında bir rota çizilir, longevity'de yörüngeler döner, plastik
  cerrahide ölçüler alınır, dişte kavis taranır, güzellikte bir rozet açılır. Sahnenin vuruşları alanın
  uygulamalarıdır (öne çıkarılanlar önce, en çok dört): sıradaki uygulama listede öne çıkar, altında
  kısa açıklaması (`excerpt`) görünür. Botoks ve dolgu çizimleri uygulamanın bölgesini (`zone`) kullanır;
  yüz çizimi işlem sayfalarındaki haritayla ortaktır (`FaceDrawing`). Dizinin altına "Alanları geç"
  bağlantısı eklendi. Ayrıntı: `ANIMATIONS.md` §8.
- **Neden:** Proje sahibinin isteği: her hizmet, botoks sayfasındaki yüz haritası gibi, kendine özgü bir
  kaydırma anlatımıyla tanıtılsın; anasayfa kapsamlı olsun.
- **Bedel:** Bölüm çok uzundur: 10 panel × (panel + tutma) ≈ 900 piksellik ekranda 13.900 piksel
  (~15 ekran), telefonda ~11.800 piksel. Yeni metin yazılmadı (ad, slogan ve açıklamalar veritabanından);
  ama panelde hangi uygulamaların görüneceği "Öne çıkar" anahtarına ve sıraya bağlıdır. Sahneler şematik
  motiflerdir: iki yüz çizimi dışında vuruşla uygulama arasındaki bağ yalnızca sıradır. SVG parçaları
  bileşik katman olmaz: oynayan sahnenin SVG'si her karede yeniden boyanır (yalnızca bir sahne oynar).
  Akıcılık için her panelin saati ayrı yazılır (bkz. `PERFORMANCE.md` §5) — sahne eklerken tek bir
  değişkeni bütün desteye yazma. Çizimi olmayan yeni bir alan (ör. saç) genel sahneyle görünür; kendi
  çizimi ayrıca yazılmalıdır. Açıklamalar 736 pikselden alçak pencerelerde gösterilmez (yer yok).

## K37 — Ana branşlar: saç, diş, medikal estetik, erkek sağlığı; saç bölümü (2026-11-16)

- **Ne:** (1) Kliniğin **ana branşları** sırasıyla saç, diş, medikal estetik ve erkek sağlığıdır
  (`config/site.php` → `departments`; adlar ve medikal estetiğin sloganı `lang/{dil}/site.php` →
  `departments`). Medikal estetik beş alanı kapsar: botoks, dolgu, mezoterapi, cihazlı işlemler, güzellik.
  Hiçbir branşa girmeyen alanlar (IV, medical longevity, plastik cerrahi) "diğer alanlar"dır
  (`App\Content\Departments`). Kategori sırası buna göre: saç 1, diş 2, botoks…güzellik 3–7, erkek sağlığı 8,
  IV 9, longevity 10, plastik cerrahi 11. (2) **Anasayfa:** hero'nun üst satırı dört branşı sayar. Hero'nun
  altındaki bölümün başlığı sayı vermez ("Her alanda tek yaklaşım"); altındaki dizinde önce dört branş
  (belirgin), ardından "Diğer alanlar" (sade) listelenir — ayrı bir kart bölümü yoktur. Yalnızca dört branş panel
  ve sahne alır (K35/K36'daki on panel yerine). Tek alanlı branş o alandır (adı, uygulamaları); medikal estetik
  kendi adıyla görünür, vuruşları alanlarıdır, yüz çiziminde her alanın noktası yanar (`zones`) ve bağlantısı
  `/tr/tedaviler#aesthetics` bloğuna iner. Kinetik bant dört branşın adını kaydırır. (3) **Menüler:** "Ana
  branşlar" bölümünde saç, diş, medikal estetik ve erkek sağlığı aynı düzeyde birer giriştir; medikal estetiğin
  alanları kendi girişinin altında girintili durur (üzerine gelince sağ panelde sloganı ve alanları); "Diğer
  alanlar" çizgiyle ayrılmış ayrı bölümdür. **`/tedaviler`:** medikal estetik ve diğer alanlar renkli zeminli,
  başlıklı birer bloktur — bloğun bittiği yer görünür, erkek sağlığı medikal estetiğin parçası gibi okunmaz.
  (4) **Saç bölümü** (11. alan, `hair`, vurgu `copper`): saç ekimi (FUE),
  saç PRP (Cihazlı İşlemler'den taşındı; eski adresler panel mantığıyla 301), otolog eksozom, plazma, LED,
  topikal tedavi. Yeni sahne: saçlı deri kesitinde saç telden tele geri gelir, her vuruşta bir greft yerleşir.
- **Neden:** Proje sahibinin isteği (Baver Kaya üzerinden, 2026-11-16): "saçı da ekle", "saç, diş, medikal
  estetik, erkek sağlığı diye gidiyor sıralama; akışı, vurgulamaları buna göre ayarla", "tekrar eden
  animasyonlar vardı, bazılarını çıkar; öncelik ana branşlar olsun". On alanın her biri aynı kalıpta
  oynuyordu (~15 ekran); ana branşlar öne çıkmıyordu. Aynı gün Ersel'in iki düzeltmesi: menüde erkek sağlığı
  medikal estetiğin altındaymış gibi görünüyordu (grup adı küçük bir etiketti); "4 ana branş" diye yazılmasın,
  diğer alanlar da dört branşın ardından aynı yerde gösterilsin.
- **Bedel:** Dolgu, mezoterapi, cihazlı işlemler, IV, longevity, plastik cerrahi ve güzellik sahneleri koddan
  çıkarıldı (git geçmişinde durur); bu alanlar anasayfada artık kendi sahneleriyle tanıtılmaz. Branş üyeliği
  yapılandırmadadır, panelden değiştirilemez (kategori sırası panelden değişir; menüler yine branşa göre
  gruplar). Medikal estetiğin ayrı bir sayfası yoktur (bağlantı `/tedaviler` içindeki gruba iner; ileride
  "medikal estetik" aramaları için bir merkez sayfa düşünülebilir). Saç içeriği yapay zekâyla yazıldı,
  hekim onayı bekler; **"plazma tedavisi" soğuk plazma cihazı olarak yorumlandı** (klinik PRP'nin başka bir
  adı olarak kullanıyorsa sayfa birleştirilmeli), "tropikal tedavi" topikal tedavi olarak düzeltildi
  (`CONTENT_MAP.md` §11).

## K38 — Her sayfaya kendi çizimi ve hareketi (2026-11-16)

- **Karar:** Anasayfa dışındaki bütün sayfa türleri kendine ait bir vektör çizim ve hareket alır
  (döküm: `ANIMATIONS.md` §10). (1) **Hero'lar:** tedaviler (alanların atlası), iletişim (harita), SSS
  (soru–yanıt), blog (yazılan sayfa), yasal sayfalar (belge + işaret), hata sayfası (kontur halkalı sıfır),
  bölgesi yüzde olan işlemler (yüz + bölge), diğerleri canlı kontur. Çizimler sayfa açılırken kendini çizer
  (salt CSS), imlece tepki verir; hero metni kaydırınca geride kalır, sonraki bölüm üstüne kayar.
  (2) **Kategori sayfası:** uygulamalar alanın çizim sahnesiyle birlikte anlatılır — çizim sabit, liste
  ilerledikçe sahne ilerler. K37'de anasayfadan çıkarılan altı sahne (mezoterapi, cihazlı işlemler, güzellik,
  IV, longevity, plastik cerrahi) git geçmişinden geri alındı ve kendi sayfalarına yerleşti; saç, diş ve
  erkek sağlığı anasayfadaki sahnelerini kullanır; botoks ve dolgu yüz haritasında kalır. (3) **İşlem
  sayfası:** hızlı bilgi ikonları, okuru izleyen bölüm çubuğu, adım kadranı ve adım çizgisi. (4) **Küçük
  özellikler:** SSS'de arama, blog yazısında okunan başlığı işaretleyen içindekiler, hakkımızda'da ilke
  çizimleri, alt bilgide dev dış hat marka yazısı, koyu bölümlerde imleç ışığı.
- **Neden:** Proje sahibinin isteği (2026-11-16): "her sayfaya harika efektler, özellikler, vektörel çizimler,
  animasyonlu işler". İç sayfalar düz kalmıştı (hero'da aynı kontur, gövdede yalnızca belirme). K37 ile
  çelişmez: orada kesilen şey anasayfada **aynı kalıbın on kez yinelenmesiydi**; burada her sayfanın tek ve
  kendine ait bir çizimi vardır, anasayfa dört branşla kalır.
- **Kurallar aynı:** kütüphane yok (K21); yalnızca `transform` / `opacity` / `stroke-dashoffset`; içerik SSR
  HTML'inde ve JS'siz, "hareketi azalt" açıkken eksiksiz; çizimler süs (`aria-hidden`), bilgi metinde; çizimde
  yazı yok; şematik — sonuç/öncesi-sonrası göstermez; iletişimdeki harita çizimi gerçek bir harita değildir
  (adres ve gerçek harita sayfadadır, K11).
- **Bedel:** `site.css` 18,5 KB (sıkıştırılmış; bütçe 25 KB). Kategori sayfası ≈ 8 KB, işlem sayfası ≈ 6 KB
  ek JS (bütçe 15 KB). İşlem ve kategori sayfaları büyük ekranda uzadı (uygulama satırları `44vh`). Bölüm
  çubuğu bağlantıları yineler; yardımcı teknolojiden ve klavyeden gizlidir (gerçek gezinme yerindeki
  bağlantılardır). Lighthouse bu turda yeniden ölçülmedi; yerel kare süreleri `PERFORMANCE.md` §4'te.

## K39 — WhatsApp'a doğrudan bağlantı yok: önce kısa form (2026-11-16)

- **Karar:** Sitede hiçbir düğme ya da bağlantı bir WhatsApp numarasına gitmez. "WhatsApp ile yazın"
  düğmelerinin hepsi (her sayfadaki sabit düğme, anasayfadaki bant, çağrı bandı, randevu bölümü, iletişim
  sayfası) **kısa formu** açar: ziyaretçi ad soyad ve telefonunu yazar, formu gönderir; sohbet ancak talep
  kaydedildikten sonra açılır. CRM belgesindeki WhatsApp akışının kendisidir
  (`crm/public/base/lp-form/documentation.html` §2: düğme → form → kayıt → WhatsApp).
    - **CRM formları açıkken** (K34) form CRM'in çerçevesidir (`wp=true`); numarayı CRM'in yanıtı verir
      (talebi alan temsilcinin, gece ve atanmamış taleplerde CRM'in varsayılan numarası) ve sohbeti form
      sayfası açar. CRM numara vermezse talep yalnızca onaylanır — sitenin kendi numarasına düşülmez.
    - **CRM formları kapalıyken** (anahtarlar boş: yerel ortam, demo yayını) form sitenin kendi kısa formudur
      (`WhatsAppForm`): `contact.store`'a `channel: whatsapp` ile gider, talep panelde saklanır
      (`leads.channel`, Talepler'de "WhatsApp" işareti) ve yanıt sohbetin adresini taşır (kliniğin Site
      ayarları'ndaki WhatsApp numarası); sohbet o adresle açılır.
    - Sohbetin adresi **hiçbir sayfanın verisinde yoktur**: `site.contact.whatsappHref` kaldırıldı, yerine
      yalnızca formun ayarları gelir (`site.whatsapp`: gönderileceği uç, aydınlatma metni, Turnstile anahtarı;
      WhatsApp sunulmuyorsa `null`). Adres yalnızca kaydedilmiş bir kısa formun yanıtında döner. Onay ekranı
      (`FormDone`) sitede WhatsApp'a bağlanan tek yerdir ve ancak kayıttan sonra görünür.
- **Neden:** Proje sahibinin isteği (2026-11-16, ikinci kez): düğme numaraya yönlendirmemeli; ad, soyad ve
  telefon alınmadan sohbet başlamamalı. K34'te bu yalnızca CRM anahtarları girilince geçerliydi; anahtarlar
  boşken düğmeler `wa.me` bağlantısına düşüyordu — yerelde ve (anahtarsız kurulan) demo yayınında görünen
  de buydu. Kural artık kurulumdan bağımsızdır; adresin sayfa verisinden çıkarılması yanlışlıkla yeniden
  bağlantı verilmesini de önler (`WhatsAppFormTest`: hiçbir sayfada `wa.me` geçmez).
- **Bedel:** JS'siz ziyaretçi WhatsApp'a siteden ulaşamaz (düğmeler gizlenir, bantta "form için JavaScript
  gerekir" notu; telefon bağlantısı durur). Tarayıcı yeni sekmeyi engellerse sohbet kendiliğinden açılmaz;
  onay ekranındaki "WhatsApp'ı aç" düğmesi bunun içindir. CRM açıkken CRM numara döndürmezse sohbet açılmaz
  (K34'teki "kliniğin numarasına düş" yedeği kaldırıldı). WhatsApp sunulması için ya CRM anahtarları ya da
  Site ayarları'nda WhatsApp numarası gerekir; ikisi de yoksa düğmeler ve bant görünmez. Kısa formun
  talepleri de aynı korumalardan geçer (aynı-köken, hız sınırı, honeypot, onay, Turnstile).

## K40 — Süreç sahnesi: "dönüşen çizgiler"; ikinci tuval istisnası (2026-11-16)

- **Karar:** Anasayfadaki süreç bölümü (sabit başlık + değişen görsel, `StickySteps`) yerine sabitlenen bir
  sahne gelir: markanın kontur çizgilerinden oluşan **tek bir çizgi demeti** adım adım biçim değiştirir — akan
  konturlar → karşılıklı iki yüz profili (dinleme ve muayene) → rotalı kontur haritası (kişiye özel plan) →
  tek noktaya odaklanan halkalar (uygulama) → yörüngeler (takip) → çağrının arkasında ışınlar. Çizgiler üç
  boyutludur, imlece ve kaydırma hızına tepki verir. Bölüm manifestodan hemen sonraya, galeriden öne alındı
  ("yaklaşımımız" → "süreç"). Döküm: `ANIMATIONS.md` §11.
- **Neden:** Proje sahibinin isteği (2026-11-16): kardeş marka Cellavia'nın "Hücresel Yenilenme Yolculuğu"
  sayfasındaki (denizaltının rotayı izlediği dalış) çapta bir efekt — ama **onun kopyası değil**; site aynı
  firmadaki kişilere gösterilecek, yazılımcısı farklı. Bu yüzden düzenek de anlatı da başka seçildi: orada
  üçüncü şahıs bir araç bir rota boyunca yol alır ve çevre derinlikle değişir; burada yolculuk yoktur, sitenin
  kendi motifi olan çizgiler **dönüşür**. O sayfadan alınan tek şey ölçüttür (sürükleyicilik, kaydırmaya
  tepki, anlatı).
- **Tuval istisnası:** K21/K22'deki "tek tuval: hero zemini" kuralına ikinci bir istisna eklendi. Binlerce
  noktanın kare başına yeniden biçimlenmesi DOM/SVG ile `transform`/`opacity` sınırında yapılamaz (her çizgi
  bir yol, her karede `d` değişirdi). Kütüphane yine yok (K21): Canvas 2D, ~5,5 KB gzip, ayrı parça. Hero
  zemininin kuralları aynen geçerli: tembel yükleme, ana iş parçacığını bloklamayan kurulum, ekran dışında
  durma, çözünürlüğü düşürerek uyum, belirteç renkleri, tuvalsiz düşüş.
- **Kurallar aynı:** içerik (başlık, dört adım, çağrı) baştan DOM'da ve SSR HTML'inde; JS'siz, "hareketi
  azalt" açıkken ve alçak pencerelerde bölüm düz kartlardır; kaydırma ele geçirilmez; çizim şematiktir (yüz
  profilleri bir sonuç ya da öncesi/sonrası göstermez — "siz ve hekiminiz"); yeni metinler iki dildedir
  (`home.process.lead`, adım başına `motif`).
- **Bedel:** Sahne ≈ 4–4,6 ekran kaydırma ister (telefonda 5, geniş ekranda 5,6 ekran boyunda). Görünürken
  tuval sürekli çizer (ölçüm: `PERFORMANCE.md` §4; 4× yavaşlatılmış işlemcide ortanca 12 ms). `site.css`
  19,8 KB (bütçe 25 KB). Anasayfada `StickySteps` artık kullanılmıyor (işlem sayfalarında duruyor). Gerçek
  telefonlarda (iOS Safari, orta sınıf Android) elle denenmedi.

## K41 — Betikler ilk boyamadan sonra başlar; hero zemini yazılımsal çizicide çalışmaz (2026-11-17)

**Bağlam:** Proje sahibi demoyu (`demo.clvclinic.com`) PageSpeed ile ölçtü: mobil 84, masaüstü 64, SEO 69.
Aynı derleme yerelde (GPU'lu makine) mobil 96 / masaüstü 100 veriyordu. Fark PageSpeed sunucularının
ortamındaydı: **GPU yok**, WebGL yazılımsal çiziciyle (SwiftShader) çalışıyor. Hero'nun "canlı kontur"
gölgelendiricisi orada işlemcide çizildi; ana iş parçacığını ~3 sn meşgul etti (masaüstü TBT 360 ms, mobil
hız endeksi 29 sn). Ölçüm düzeni ve sayılar: `PERFORMANCE.md` §3–4.

- **Hero zemini yazılımsal çizicide hiç başlamaz** (`lib/hero-field.ts`): bağlam
  `failIfMajorPerformanceCaveat` ile istenir; tarayıcı yine de bağlam verirse çizicinin adı sorulur
  (SwiftShader, llvmpipe, softpipe, Basic Render Driver) ve bağlam bırakılır. CSS aurora (ve varsa klinik
  fotoğrafı) kalır — WebGL'siz ziyaretçinin zaten gördüğü hâl. GPU'suz gerçek ziyaretçiler (sanal makine,
  uzak masaüstü, engelli sürücü) de aynı kazancı alır; bu yalnızca bir ölçüm ayarı değildir.
- **Zayıf ama gerçek GPU:** çizim önce çözünürlüğü düşürür (%40'a kadar), yine yetişemiyorsa **kalıcı olarak
  durur** (önceden %40'ta sonsuza dek çizmeye devam ediyordu). 50 ms'yi aşan kare üç kat sayılır.
- **Kare sınırı:** zemin yavaş akar; 120–165 Hz ekranlarda her kareyi çizmek GPU'yu boşuna yorar. İki çizim
  arası en az 15 ms (≈ 60 kare/sn).
- **Betikler ilk boyamadan sonra** (`App\Support\DeferredScripts`, `site.blade.php`): sunucuda çizilmiş
  sayfanın ilk boyaması JavaScript istemez. `<head>`'de duran modül betikleri (düşük öncelikle de olsa) stil,
  yazı tipi ve logoyla aynı bağlantıyı paylaşıyor, hızlı bağlantıda ilk boyamadan **önce** çalışıyordu
  (hydration). Artık SSR'lı sayfa `<script src>` ve `modulepreload` basmaz; birkaç satırlık satır içi betik
  bunları ilk içerikli boyamadan (`first-contentful-paint`) sonra ekler. Arka planda açılan sekme (boyama yok)
  hemen, her durumda 3 sn sonra başlar. `ScriptPriority` (`fetchpriority="low"`) kaldırıldı.
- **SSR yoksa ertelenmez:** Node süreci çalışmıyorsa sayfayı JavaScript çizer; o zaman betik ilk boyamanın
  ta kendisidir, `@vite` etiketleri eskisi gibi `<head>`'de ve varsayılan öncelikte kalır (önceden bu yolda
  da düşük öncelikliydi — yanlıştı). Geliştirme sunucusunda (`npm run dev`) da erteleme yoktur.
- **Hero'nun arka fotoğrafı** süstür (LCP adayı bile değildir): hemen ama düşük öncelikle istenir
  (`Picture priority="low"`); stil, yazı tipi ve logonun önüne geçmez.
- **Google kuralları:** bot ve ziyaretçi aynı HTML'i alır (kullanıcı aracısına bakılmaz, gizleme yok); içerik,
  bağlantılar, `<head>` ve JSON-LD betik çalışmadan HTML'dedir. Yazılımsal çizici denetimi yalnızca süs
  tuvalini etkiler.
- **Bedel:** hızlı bağlantıda etkileşim (menü, formlar) bir kare kadar geç başlar. Ölçüm (yerel, PageSpeed
  koşulları benzetilerek): mobil 86 → 99–100, LCP 2,8 → 1,9 sn; masaüstü 77 → 100.

## K42 — Sırasını bekleyen metin de okunur kalır: en az 4,5:1 (2026-11-17)

**Bağlam:** Kaydırmayla ilerleyen listelerde sırası gelmemiş satırlar %30–45 opaklıktaydı (anasayfa alan
vuruşları %45, işlem adımları %30, kategori hikâyesi %40, yüz haritası listesi %45). Lacivert zeminde bu
1,8–4:1 kontrast demek; masaüstünde Lighthouse erişilebilirlik puanı 96–97'ye düşüyordu (K18'deki "bekleyen
kelimeler" bulgusunun aynısı).

- Bekleyen satır opaklığı: anasayfa vuruşları **%55** (kalın, açık metin: 5,2:1); `StickySteps`,
  `TreatmentStory`, `ZoneMap` **%80** (yumuşak metin ve bütün alan aksanları ≥ 4,5:1 — 11 kategori ve 11
  işlem sayfasında ölçüldü). Etkin satır yine %100; vurguyu ayrıca adım noktası, ilerleme çizgisi ve çizim taşır.
- **Kural:** bir metni soldurarak geri plana alırken sonuç kontrastı 4,5:1'in (büyük başlıkta 3:1) altına
  inmez. Yeni bir "bekleyen" durumu eklenirken ölçülür.

## K43 — İçerikteki iç bağlantılar kendiliğinden güncel; kurulum denetimi (2026-11-17)

**Bağlam:** 194 adreslik Google uyum taramasında (`SEO.md` §11) iki blog yazısı, Faz 13'te taşınan Saç PRP
sayfasının **eski** adresine bağlanıyordu (301). İçerik dosyası güncellenmişti ama `content:import` var olan
kayıtlara dokunmadığı için veritabanındaki metin (yerelde ve demoda) eski kalmıştı. Demo ayrıca geliştirici
makinesinin `.env`'iyle yayına alınmıştı: `APP_ENV=local`, `APP_URL=https://clvclinics.test` (canonical,
hreflang, OG ve JSON-LD yerel alan adını gösteriyordu), SSR süreci kapalı.

- **İç bağlantı onarımı** (`App\Support\Markdown`): Markdown gövdesi (blog, yasal sayfalar) HTML'e çevrilirken
  iç bağlantılar `redirects` tablosuna sorulur; taşınmış sayfanın bağlantısı güncel adresle yazılır (zincir
  5 adıma kadar izlenir). Slug değişince metinleri elle düzeltmek gerekmez; okur ve arama motoru 301'e uğramaz.
- **Kurulum denetimi** (`App\Support\DeploymentChecks`): ortam, hata ayıklama, site adresi (APP_URL ↔ açılan
  alan adı), SSR süreci, derleme, `storage` bağlantısı, önbellek, dizinleme. İki yerden okunur:
  `php artisan site:doctor [--host=alan-adi]` ve panelin Pano'su ("Kurulum uyarıları" — yalnızca panel yerel
  olmayan bir alan adında açıldığında; geliştirici makinesinde görünmez). Bu ayarların hiçbiri sayfada
  görünmez; yanlış kurulum ancak böyle fark edilir.
- **Canonical yine yalnızca `APP_URL`'den üretilir** (istek ana bilgisayarından değil; `config/site.php`):
  yanlış adres uyarılır, kendiliğinden "düzeltilmez" — hangi alan adının asıl olduğunu kod bilemez.
- SSR isteğine süre sınırı: `INERTIA_SSR_TIMEOUT` (varsayılan 3 sn). Takılan bir Node süreci artık her
  sayfayı 30 sn bekletmez; sayfa SSR'sız gönderilir.

## K44 — Çatı kavram: Medical Longevity; alan adları ve marka dili (2026-11-17)

**Bağlam:** Klinikten gelen konsept metni (2026-11-17): markanın en üst çatısı **Medical Longevity** (uzun ve
sağlıklı yaşam). Saç, ağız ve diş sağlığı, medikal estetik, erkek sağlığı ve öteki alanlar bu yaklaşımın
birbirini tamamlayan parçalarıdır. Temel cümle: _yalnızca hastalığı tedavi etmek değil; sağlığı korumak, yaşam
kalitesini desteklemek ve sağlıklı yaş almaya katkıda bulunmak._ Metnin 7. bölümü ("Teknik ve tasarımsal
sınırlar") yapıştırılırken yarıda kesildi; okunabilen kısmı: çalışan işlevleri bozma, tasarım sistemini ve
sayfa yapılarını gereksiz yere değiştirme.

**Hiyerarşi:** 1. Medical Longevity (yaklaşım) → 2. uzmanlık alanları → 3. tedaviler ve uygulamalar.

**Adlar** (anahtarlar ve — aşağıdaki iki istisna dışında — slug'lar değişmedi):

| Anahtar                            | Eski ad (TR)            | Yeni ad (TR)                           | EN                                   |
| ---------------------------------- | ----------------------- | -------------------------------------- | ------------------------------------ |
| `hair`                             | Saç Ekimi ve Tedavileri | **Saç Restorasyonu**                   | Hair Restoration                     |
| `dental`                           | Diş Sağlığı             | **Oral Sağlık ve Fonksiyon**           | Oral Health and Function             |
| branş `aesthetics`                 | Medikal Estetik         | **Medikal Longevity**                  | Longevity Aesthetics                 |
| `beauty` (medikal estetiğin alanı) | Güzellik                | **Cilt Bakımı ve Lazer**               | Skin Care and Laser                  |
| `mens-health`                      | Erkek Sağlığı           | **Erkek Sağlığı ve Vitalite**          | Men's Health and Vitality            |
| `longevity`                        | Medical Longevity       | **Koruyucu ve Kişiselleştirilmiş Tıp** | Preventive and Personalised Medicine |
| `iv-therapy`                       | IV Tedaviler            | **IV Destek Tedavileri**               | IV Therapy (aynı)                    |

- **Botoks, Dolgu, Mezoterapi, Cihazlı İşlemler, Plastik Cerrahi** ve 71 uygulamanın adı aynı kaldı: metin, somut
  tedavi adlarının alt düzeyde açıkça korunmasını istiyor; "Plastik Cerrahi" uzmanlığın kendi adıdır.
- **Eski "Medical Longevity" alanı** (damar, kalp, beyin, yumurtalık programları, sağlık koçluğu, akupunktur)
  çatıyla aynı adı taşıyamazdı; kapsamına en yakın örnek ad olan "Koruyucu ve Kişiselleştirilmiş Tıp"ı aldı ve
  metinde yaklaşımın "tıbbi çekirdeği" olarak anlatılır.
- **"Medikal Longevity" = medikal estetik uygulamaları.** Çatıyla karışmaması için: branşın sloganı neyi
  kapsadığını söyler ("Medikal estetik uygulamaları: …"), menüde alanları (botoks, dolgu…) hemen altındadır,
  SEO metinlerinde "medikal estetik" geçmeye devam eder. İngilizcede ad çatıyla **harfi harfine aynı** olacağı
  için "Longevity Aesthetics" yazıldı.
- **Uydurulmayanlar:** Kadın Sağlığı, Check-up, Beslenme (Metabolik Sağlık), Fizik Tedavi (Hareket ve
  Fonksiyonel Sağlık) için sitede hizmet yok; alan açılmadı (K11). Klinik bu hizmetleri verirse eklenir.
- **Slug'lar:** aranan sözcüğü taşıyan adresler korundu (`/tr/tedaviler/dis-sagligi`, `…/sac-ekimi-ve-tedavileri`,
  `…/erkek-sagligi`; görünen ad ve `<title>` yeni adı, başlığın ikinci yarısı aranan terimi taşır). İki alanın
  adresi yanıltıcı kalacağı için değişti (eskileri 301): `medical-longevity` → `koruyucu-ve-kisisellestirilmis-tip`
  / `preventive-personalised-medicine`; `guzellik` → `cilt-bakimi-ve-lazer`, `beauty` → `skin-care-and-laser`.
  `content:import --fresh` artık slug'ı değişen sayfalar için 301'i kendisi yazar (`ContentImporter` →
  `SlugRedirects::track()`; panelde olduğu gibi alanın sayfası ve altındaki uygulamalar).

**Marka dili:**

- Slogan: ~~"Sağlıklı yaşamın bilimi."~~ — klinik çok genel buldu; yerine K45'teki başlık ve site sloganı geldi.
  "Güzelliğin bilimi, iyi yaşamanın sanatı" kalktı.
- Anasayfa hero'sunun üst satırı artık branşları saymaz, çatıyı söyler ("Medical Longevity"); dört alan giriş
  cümlesinde ve hemen alttaki dizindedir (K37'nin "hero üst satırı dört branşı sayar" maddesinin yerine geçer;
  branş sırası ve yalnızca dört branşın panel alması aynen sürer).
- "Ana branşlar" → "Uzmanlık alanları"; "sağlıklı yaşlanma" → "sağlıklı yaş alma" (kliniğin kendi hizmet
  adları — "Damarların Sağlıklı Yaşlanması" vb. — olduğu gibi).
- Her alan kendi sağlık bağlantısıyla anlatılır (çiğneme ve beslenme; özgüven ve doğal görünüm; yaşam
  dönemleri ve yaşam kalitesi) ama **hiçbir uygulamanın yaşam süresini uzattığı ya da yaşlanmayı durdurduğu
  söylenmez**; "Longevity" her ada eklenmez. Yazım kuralları: `CONTENT_GUIDE.md` §5.
- Genel SSS'nin ilk sorusu çatıyı açıklar ("Medical Longevity ne demek?"); blogdaki "Medical Longevity Nedir?"
  yazısı yaklaşımın tek bir bölüm değil ortak çatı olduğunu anlatan bir bölüm aldı.
- 71 uygulama sayfası gözden geçirildi, değiştirilmedi: metinler zaten ölçülü, tıbbi ve vaat içermiyor; adı
  değişen alanlara atıf yok.

**Büyük harf:** "Medikal Longevity" Türkçe sayfada CSS `uppercase` ile "MEDİKAL LONGEVİTY" basılırdı. `Term`
(`components/ui/term.tsx`) metnin içindeki İngilizce terimi `lang="en"` ile işaretler → "MEDİKAL LONGEVITY";
`Eyebrow` düz metni kendiliğinden `Term`'den geçirir. (Bütünüyle İngilizce kalan adlar için `lang` ipucu sürüyor.)

**Açık kalanlar:** aşağıdakiler `TODO.md` Faz 19'da — özellikle koruyucu tıbbın ana alanlar arasına (anasayfa
paneli) alınıp alınmayacağı: metin onu çatıyla "en doğrudan ilişkili" alan sayıyor, sitede ise "Diğer alanlar"
arasında; bu bir sayfa yapısı değişikliği olduğu için sorulmadan yapılmadı.

## K45 — Anasayfa hero'su: Medical Longevity mesajı (2026-11-17)

**Bağlam:** Klinikten (Baver Kaya aracılığıyla) gelen geri bildirim: açılış Medical Longevity konseptini yeterince
güçlü yansıtmıyor; "Sağlıklı yaşamın bilimi" başlığı çok genel, açıklama metni strateji belgesini özetler ve
hizmetleri sayar gibi; "11 uzmanlık alanı, 71 uygulama, 2 dilde hizmet" marka algısını güçlendirmiyor; arka plan
yoğun, mobilde metnin önüne geçiyor. Randevu düğmesi kalsın, "Tedavileri keşfet" konsepte uygun bir ifadeye dönsün;
tasarım sistemi bozulmasın. Verilen örnek metin ("Sağlığın geleceği, yaşamın her döneminde.") bağlayıcı değildi.

**Karar:**

- **Mesaj:** üst satır "Medical Longevity" (aynı; `md` ve üstünde bir kademe büyük). Başlık
  **"Sağlıklı yaş almak, _bugünden_ planlanır."** (EN "Healthy ageing, planned _from today_."): kullanıcıya düşen
  değer (sağlıklı yaş alma) + yaklaşımın somut farkı (bugünden, planla — koruyucu ve kişiye özel). Açıklama
  hizmet saymaz: _"Bilimsel değerlendirme ve koruyucu tıp ilkeleriyle size özel bir sağlık planı kuruyoruz. Bu
  plan bugünkü ihtiyacınızı, uzun vadeli sağlığınızı ve yaşam kalitenizi birlikte gözetir."_ Yaşam süresi ya da
  yaşlanmayı durdurma iddiası yok (K44); "plan" ve "takip" sitede zaten söylenenler (süreç bölümü, hakkımızda).
- **Sayılar kalktı**, yerine yaklaşımın üç adımı: **Değerlendirme** (hekim muayenesi ve gerektiğinde tetkik) ·
  **Kişisel plan** (sağlık geçmişi, bulgular, hedef) · **Düzenli takip** (ihtiyaç değiştikçe plan güncellenir).
  Sayılar kataloğun büyüklüğünü söylüyordu, kliniğin ne tür bir kurum olduğunu değil. Masaüstünde sağ sütunda
  (eski sayıların yeri), tablette üç sütun, telefonda yalnızca adları. Sayılar hakkımızda sayfasında ve WhatsApp
  bandında duruyor; deneyim yılı da (ayar girilince) hakkımızda sayfasında.
- **İkinci düğme:** "Yaklaşımımızı tanıyın" / "Our approach" → aynı sayfadaki yaklaşım bölümü (`#yaklasim`:
  manifesto + süreç sahnesi). Tedaviler menüde ve hemen alttaki alan dizininde zaten var.
- **Zemin:** fotoğraflar, aurora ve kontur çizgileri metnin olduğu yerde lacivert sahneye soluyor (`.hero-backdrop`
  maskesi, `site.css`): telefonda üst kısım dışında %30, masaüstünde metnin solunda %40–50, sağa doğru %90.
  Çizgi efekti ve fotoğraflar duruyor (K41, Faz 11), yalnızca metnin arkası sakin.
- **Tipografi:** başlığın ilk satırı her genişlikte virgülde biter (masaüstünde iki satır, telefonda üç);
  başlıkların genel `text-wrap: balance`'ı burada kapalı — telefonda "almak,"ı satırından ayırıyordu. Açıklama
  masaüstünde üç satır.
- **Site sloganı** (alt bilgi, anasayfa `<title>`): "Medical Longevity ile sağlıklı yaş alma" / "Medical
  Longevity for healthy ageing" — "sağlıklı yaşamın bilimi" hiçbir yerde kalmadı.

**Kapsam dışı:** sayfa yapısı (hero'nun altındaki alan dizini, dört panel — K37) ve tasarım belirteçleri değişmedi.
