# CLV Clinics — Ana Plan

> Son güncelleme: 2026-11-10 · Durum takibi: [`TODO.md`](../TODO.md)

## 1. Amaç

CLV Clinics için **çok dilli (TR/EN), SEO'su güçlü, görsel olarak üst seviye** bir kurumsal
web sitesi ve bunu yöneten bir **admin paneli**.

- Kaynak: `docs/subjects/MEDİKAL İŞLEMLER TOTAL.xlsx` → **10 kategori, 66 işlem**
  (eşleme: [`CONTENT_MAP.md`](CONTENT_MAP.md)).
- Her işlem **kendi sayfasında**, düzgün ve tutarlı bir yapıyla anlatılır.
- Apple tarzı **kaydırmaya bağlı anlatım** (scrollytelling): sabitlenen sahneler, kaydırdıkça
  açılan metinler, yatay akışlar, hareketli küçük görseller.
- Logo, iletişim bilgileri, hekimler, fotoğraf ve videolar **sonradan gelecek** → şimdilik
  yer tutucu; hepsi tek yerden değiştirilebilir olacak ([`PLACEHOLDERS.md`](PLACEHOLDERS.md)).

## 2. Başarı ölçütleri

| Alan            | Hedef                                                                                              |
| --------------- | -------------------------------------------------------------------------------------------------- |
| SEO             | Her sayfa sunucuda üretilmiş HTML + eksiksiz meta/hreflang/JSON-LD; Lighthouse SEO 100             |
| Performans      | Core Web Vitals "İyi": LCP < 2,5 sn · INP < 200 ms · CLS < 0,1; Lighthouse Performans ≥ 90 (mobil) |
| Erişilebilirlik | Lighthouse A11y ≥ 95; klavye ile tam gezinme; `prefers-reduced-motion` desteği                     |
| Bakım           | Marka rengi/yazı tipi/logo/iletişim değişikliği **tek dosya veya admin panelden**                  |
| Çok dillilik    | Yeni dil eklemek kod değişikliği gerektirmeden yapılandırma + çeviri ile mümkün                    |
| Uyum            | Google Search Essentials, yapılandırılmış veri kuralları; KVKK ve sağlık tanıtım mevzuatına dikkat |

## 3. Teknoloji yığını

| Katman     | Seçim                                        | Not                                         |
| ---------- | -------------------------------------------- | ------------------------------------------- |
| Backend    | Laravel 13 (PHP 8.3)                         | Resmi React starter kit tabanı              |
| Köprü      | Inertia.js 3                                 | Hem site hem admin                          |
| Arayüz     | React 19 + TypeScript                        | React Compiler açık                         |
| Stil       | Tailwind CSS 4                               | Tasarım belirteçleri `@theme` ile           |
| Derleme    | Vite+ (`vp`)                                 | Starter kit varsayılanı                     |
| SSR        | Inertia SSR (Node)                           | Yalnızca genel site için                    |
| Kimlik     | Laravel Fortify                              | Giriş + 2FA + şifre sıfırlama; kayıt kapalı |
| Admin UI   | shadcn/ui (Radix)                            | Yalnızca admin paketinde                    |
| Log        | opcodesio/log-viewer                         | `/admin/log-viewer`, yalnızca yönetici      |
| Veritabanı | SQLite (yerel) → MariaDB/MySQL (canlı)       | `.env` ile değişir                          |
| Test       | PHPUnit + Larastan + Pint, `vp check`, `tsc` |                                             |

Kararların gerekçeleri: [`DECISIONS.md`](DECISIONS.md).

## 4. Mimari özet

Tek Laravel uygulaması içinde **iki ayrı ön yüz**:

|               | Genel site (`site`)                                | Yönetim (`admin`)                                |
| ------------- | -------------------------------------------------- | ------------------------------------------------ |
| Giriş dosyası | `resources/js/site.tsx` + `resources/css/site.css` | `resources/js/app.tsx` + `resources/css/app.css` |
| Kök görünüm   | `resources/views/site.blade.php`                   | `resources/views/app.blade.php`                  |
| Sayfalar      | `resources/js/pages/site/**`                       | `resources/js/pages/{admin,auth,settings}/**`    |
| SSR           | Açık                                               | Kapalı                                           |
| Dizinleme     | index (canlıda)                                    | `noindex`                                        |

Neden ayrı: genel sitenin JS/CSS paketi admin bağımlılıklarını (Radix, shadcn) taşımasın;
SEO başlığı ve performans ayarları siteye özel olsun.

Ayrıntı: [`ARCHITECTURE.md`](ARCHITECTURE.md).

## 5. Sayfa haritası

| Sayfa              | TR                                                                             | EN                                      |
| ------------------ | ------------------------------------------------------------------------------ | --------------------------------------- |
| Anasayfa           | `/tr` (`/` → 301)                                                              | `/en`                                   |
| Tüm tedaviler      | `/tr/tedaviler`                                                                | `/en/treatments`                        |
| Kategori (10)      | `/tr/tedaviler/{kategori}`                                                     | `/en/treatments/{category}`             |
| İşlem (66)         | `/tr/tedaviler/{kategori}/{islem}`                                             | `/en/treatments/{category}/{treatment}` |
| Blog               | `/tr/blog`, `/tr/blog/{yazi}`                                                  | `/en/blog`, `/en/blog/{post}`           |
| Hakkımızda         | `/tr/hakkimizda`                                                               | `/en/about`                             |
| İletişim / Randevu | `/tr/iletisim`                                                                 | `/en/contact`                           |
| SSS                | `/tr/sss`                                                                      | `/en/faq`                               |
| Yasal metinler     | `/tr/kvkk-aydinlatma-metni`, `/tr/gizlilik-politikasi`, `/tr/cerez-politikasi` | `/en/...`                               |
| Teknik             | `/sitemap.xml`, `/robots.txt`                                                  |                                         |
| Yönetim            | `/admin/**`                                                                    |                                         |

Her dil kendi önekindedir (K20, 2026-11-11). Sonraki faz: Hekimler (`/hekimlerimiz`).

Toplam dizinlenebilir sayfa: (1 + 1 + 10 + 66 + 3 + 3) × 2 dil = **168 URL**.

## 6. Sayfa tasarım omurgası

**Anasayfa** — tanıtım filmi gibi akar:

1. Hero: büyük başlık, canlı "aurora" arka plan (video ya da fotoğraf eklenince yerine geçer),
   gerçek rakamlar (alan / işlem / dil sayısı) ve akan işlem adları şeridi
2. Manifesto: kaydırdıkça kelime kelime aydınlanan metin
3. Uzmanlık alanları: sabitlenen sahnede yatay akan 10 kategori kartı
4. Süreç: sabit başlık + adım adım ilerleyen anlatım (muayene → plan → uygulama → takip)
5. Medical Longevity vitrini (koyu, sinematik bölüm; yörünge görseli)
6. Öne çıkan işlemler
7. SSS özeti, randevu çağrısı

**Kategori sayfası** — başlık + giriş anlatımı, öne çıkan noktalar, (botoks ve dolguda)
**etkileşimli yüz haritası**, işlem listesi, kategori SSS, çağrı.

**İşlem sayfası** — hero + hızlı bilgiler (süre, anestezi, iyileşme, etki, kalıcılık) →
"Nedir?" → "Kimler için?" → "Nasıl uygulanır?" (adım adım sahne) → "İşlem sonrası" →
"Olası yan etkiler" → "Sonuçlar" → SSS → ilgili işlemler → çağrı + tıbbi bilgilendirme notu.

Tasarım dili ve hareket kuralları: [`DESIGN_SYSTEM.md`](DESIGN_SYSTEM.md),
[`ANIMATIONS.md`](ANIMATIONS.md).

## 7. Fazlar

| Faz | Kapsam                               | Çıktı                                                                       |
| --- | ------------------------------------ | --------------------------------------------------------------------------- |
| 0   | Keşif ve planlama                    | Bu belgeler, `TODO.md`, `CLAUDE.md`                                         |
| 1   | Kurulum ve altyapı                   | Laravel + starter kit, log-viewer, iki ön yüz, i18n yönlendirme             |
| 2   | Veri modeli ve içerik                | Tablolar, 10 kategori / 66 işlem TR+EN içerik, seeder                       |
| 3   | Tasarım sistemi ve hareket altyapısı | Belirteçler, yazı tipleri, bileşenler, kaydırma motoru, üst/alt bilgi       |
| 4   | Sayfalar                             | Anasayfa, tedaviler, kategori, işlem, hakkımızda, iletişim, SSS, yasal, 404 |
| 5   | SEO                                  | Meta, hreflang, JSON-LD, site haritası, robots, yönlendirmeler              |
| 6   | Admin panel                          | Giriş, pano, ayarlar, içerik yönetimi, talepler, kullanıcılar               |
| 7   | Performans ve kalite                 | Önbellek, başlıklar, Lighthouse, erişilebilirlik, testler                   |
| 8   | Müşteri içerikleri ve yayın          | Logo/iletişim/hekim/medya, blog, analitik + çerez onayı, canlıya alma       |

Ayrıntılı iş listesi ve güncel durum: [`TODO.md`](../TODO.md).

## 8. Riskler ve önlemler

| Risk                                                                           | Önlem                                                                                          |
| ------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |
| **Tıbbi içerik (YMYL)**: metinler yapay zekâ destekli yazıldı                  | Yayından önce hekim onayı zorunlu; işlem sayfasında "tıbbi inceleme" alanı; abartılı vaat yok  |
| **Mevzuat**: sağlık tanıtım yönetmeliği, reçeteli ürün marka adı (ör. "Botox") | Bilgilendirici dil; `SEO.md` içinde uyum notları; hukuki onay müşteride                        |
| **Yer tutucu bilgiler** dizine girerse                                         | Canlı dışı ortamlarda `noindex`; sahte adres/telefon **hiçbir yerde** yazılmaz, boşsa gizlenir |
| **SSR barındırma**: Node süreci gerekir                                        | `<head>` PHP'de üretilir → SSR erişilemezken bile meta/JSON-LD tam (`DECISIONS.md` K13)        |
| **Ağır animasyon** performansı düşürür                                         | Yalnızca `transform`/`opacity`; kütüphanesiz hafif motor; hareket azaltma desteği              |
| **İnce/tekrarlı içerik** (66 benzer sayfa)                                     | Her sayfa özgün ve yapılandırılmış içerik; benzer başlıklar farklılaştırıldı                   |

## 9. Kapsam dışı (şimdilik)

Online ödeme, hasta portalı, canlı sohbet, randevu takvimi entegrasyonu, çoklu şube.
İhtiyaç olursa Faz 8 sonrasına eklenir.
