# Yönetim Paneli

Adres: `/admin` · Teknoloji: Inertia + React + shadcn/ui · Dil: Türkçe · Dizinleme: kapalı (her ortamda `noindex`).

## 1. Erişim

- Giriş: `/admin/login` (Fortify). **Herkese açık kayıt yoktur.**
- Kullanıcılar yalnızca komut satırından açılır — panelde kullanıcı yönetimi ekranı (henüz) yoktur:

    ```bash
    php artisan admin:create                                   # ad, e-posta, şifre sorar
    php artisan admin:create --name="Ad Soyad" --email=ad@ornek.com --password="…"
    ```

    Seeder kullanıcı oluşturmaz ([`DECISIONS.md`](DECISIONS.md) K19).

- İsteğe bağlı iki adımlı doğrulama (2FA): Hesabım → Güvenlik. Yönetici hesaplarında açılması önerilir.
- Şifre sıfırlama e-posta ile (canlıda SMTP ayarı gerekir).

## 2. Modüller

| Modül             | Yol                           | İş                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ----------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Pano              | `/admin`                      | Yayındaki kategori/işlem sayısı, yeni talepler, son talepler; **eksikler**: çevirisi eksik ve hekim onayı girilmemiş işlemler (ilgili listeye bağlanır)                                                                                                                                                                                                                                                                                                                                                              |
| Talepler          | `/admin/leads`                | İletişim/randevu talepleri: arama, durum süzgeci, ayrıntı (ilgilendiği alan ve işlem), durum (Yeni → Arandı → Kapandı), not, silme. WhatsApp'ın önündeki kısa formdan gelen talepler (CRM formları kapalıyken; K39) listede **WhatsApp** işaretiyle, ayrıntıda "Geldiği form: WhatsApp formu" diye görünür — ziyaretçi sohbet bekliyordur. CRM formları açıkken (K34) talebin kendisi CRM'dedir; burada yalnızca ziyaretçinin sonradan seçtiği alan/işlem "CRM müşterisi #…" adıyla durur (telefon sütunu "CRM’de"). |
| Kategoriler       | `/admin/categories`           | 11 kategori (branşlara dağılımı `config/site.php` → `departments`, K37): ad, adres uzantısı, slogan, özet, giriş, öne çıkanlar, SSS, SEO, vurgu rengi, sıra, yayın. Eklenip silinmez (anahtarları ikon ve çizimlere bağlıdır)                                                                                                                                                                                                                                                                                        |
| İşlemler          | `/admin/treatments`           | İşlem sayfaları: ekleme, düzenleme, silme; içerik bölümleri, hızlı bilgiler, SSS, SEO, yüz haritası bölgesi, öne çıkarma, yayın, hekim onayı. Süzgeçler: ad, kategori, yayın, hekim onayı, eksik çeviri                                                                                                                                                                                                                                                                                                              |
| Blog              | `/admin/posts`                | Blog yazıları: ekleme, düzenleme, silme; başlık, adres uzantısı, kısa açıklama, Markdown gövde, kategori, SEO, yayın tarihi (ileri tarih = "Zamanlandı"), hekim incelemesi. Süzgeçler: başlık, kategori, durum, eksik çeviri                                                                                                                                                                                                                                                                                         |
| SSS               | `/admin/faqs`                 | Genel sorular: ekleme, düzenleme, silme, sıra, anasayfada gösterme                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Yorumlar          | `/admin/reviews`              | Hasta yorumları (Google, Trustpilot, diğer): ekleme, düzenleme, silme, sıra, yayın. Metin özgün dilinde ve aynen; özgün yorumun bağlantısıyla (aşağıda §9)                                                                                                                                                                                                                                                                                                                                                           |
| Sayfalar          | `/admin/pages`                | Yasal sayfalar (KVKK, gizlilik, çerez): başlık, Markdown gövde, SEO, yayın                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Site ayarları     | `/admin/site-settings`        | Genel · İletişim · Sosyal medya · SEO · Yasal · Yorumlar (aşağıda §5)                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Yönlendirmeler    | `/admin/redirects`            | 301 listesi: ekleme, silme, kullanım sayısı (adres uzantısı değişince kendiliğinden eklenir)                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Hesabım           | `/admin/settings/profile` vb. | Profil, şifre, 2FA, görünüm (açık/koyu)                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Sistem günlükleri | `/admin/log-viewer`           | opcodesio/log-viewer — yalnızca giriş yapmış kullanıcı                                                                                                                                                                                                                                                                                                                                                                                                                                                               |

**Planlanan, henüz yok:** Kullanıcılar ekranı · Site ayarlarında Analitik grubu (GA4/GTM, çerez onayıyla
birlikte) · favicon yükleme · medya yükleme ekranı · Hekimler modülü ([`TODO.md`](../TODO.md) Faz 8).

## 3. Çevrilebilir alanların düzenlenmesi

- Formun üstündeki **yapışkan kaydet çubuğunda tek bir dil anahtarı** (TR | EN) vardır; dil etiketi
  taşıyan bütün alanlar seçilen dili gösterir. Kaydet düğmesi de oradadır.
- Anahtardaki **sarı nokta**: o dilde zorunlu çeviri (ad ya da adres uzantısı) eksik.
  **Kırmızı nokta**: o dilde doğrulama hatası var; form hatalı dile ve alana kendiliğinden gider.
- Bir dilde adı ya da adres uzantısı olmayan kayıt o dilde **yayınlanmaz** (başka dile düşmez);
  menülere, site haritasına ve `hreflang` listesine girmez.
- **Adres uzantısı (slug)** addan önerilir ve ilk kayda kadar adı izler; sonrasında yalnızca elle değişir.
  Yayındaki bir adres değişirse eski adres için **301 kendiliğinden** eklenir — işlem başka kategoriye
  taşındığında ve kategori uzantısı değiştiğinde (işlemleriyle birlikte) de. Var olan yönlendirmeler yeni
  adrese çevrilir; zincir oluşmaz, kendine yönlenen kayıt açılmaz.
- Yeni işlem **taslak** olarak başlar; boş bir sayfa yanlışlıkla yayına girmez.
- Kayıttan sonra form saklanan hâliyle yeniden açılır (boş satırlar düşer, metinler kırpılır).

## 4. SEO alanları

Her içerikte `SEO başlığı` ve `SEO açıklaması` — karakter sayacı ve Google önizlemesiyle.
Sayaçlar **öneridir** (başlık, " | site adı" eki dahil ≈ 60; açıklama ≈ 120–165 karakter); sunucu
yalnızca üst sınırı uygular (başlık 80, açıklama 200). Boş bırakılırsa şablon kullanılır
([`SEO.md`](SEO.md) §3).

**Hekim onayı** (işlem formunun son bölümü): "Onaylayan hekim" ve "Onay tarihi" doldurulduğunda sayfada
"… tarafından incelendi" notu görünür ve arama motorlarına `reviewedBy` / `lastReviewed` gönderilir.
Gerçek bir inceleme olmadan doldurulmaz. Sayfa sayfa kontrol listesi: [`CONTENT_REVIEW.md`](CONTENT_REVIEW.md).

## 5. Site ayarları — alanlar

| Grup         | Alanlar                                                                                                                                                                                                                                                                     |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Genel        | Site adı, slogan (TR/EN), deneyimin başladığı yıl, logo (açık zemin), koyu zemin logosu                                                                                                                                                                                     |
| İletişim     | Telefon, WhatsApp (sitede bağlantı olarak gösterilmez: kısa form gönderilince sohbet bu numarayla açılır; CRM formları açıkken numarayı CRM verir — K39), e-posta, harita bağlantısı, adres (TR/EN), şehir, posta kodu, ülke kodu, enlem + boylam, çalışma saatleri (TR/EN) |
| Sosyal medya | Instagram, Facebook, YouTube, LinkedIn, TikTok, X                                                                                                                                                                                                                           |
| SEO          | Varsayılan açıklama (TR/EN), paylaşım görseli (1200×630), Google Search Console ve Bing doğrulama kodları                                                                                                                                                                   |
| Yasal        | Tüzel kişi adı, ruhsat / yetki belgesi numarası                                                                                                                                                                                                                             |
| Yorumlar     | Google ve Trustpilot için ayrı ayrı: yorum sayfasının adresi, puan (1.0–5.0, tek ondalık), yorum sayısı                                                                                                                                                                     |

- **Boş bırakılan alan temizlenir**; sitede ve JSON-LD'de hiç görünmez — yer tutucu basılmaz.
- **Deneyimin başladığı yıl** (`general.founded_year`, 1900 … bu yıl) anasayfada "… yıllık deneyim"
  olarak gösterilir; boşsa o bilgi gizlenir.
- **Yorumlar grubu:** puan ve yorum sayısı platformdan **aynen kopyalanır ve elle güncellenir**
  (otomatik çekilmez). Adres doluysa anasayfada o platformun yorum sayfasına
  bağlantı çıkar; puan ve sayı yalnızca ikisi birlikte doluysa gösterilir. Anahtarlar: `reviews.{google,trustpilot}_url` / `_rating` / `_count`.
- Sayısal ayarlar sayı olarak saklanır: yıl ve yorum sayısı tam sayı, puan, enlem ve boylam ondalık.
  JSON tam sayıya denk gelen ondalığı (5.0) `5` olarak geri verir; puanı okuyan kod `(float)` ile çevirir.
  Site adı, slogan ve açıklama boşken `config/site.php` içindeki varsayılanlar kullanılır.
- Görseller: SVG, PNG, WebP ya da JPG, en çok 1 MB; `storage/app/public/brand/` altına karma adla
  kaydedilir (`/storage/brand/…`). Betik ya da olay işleyici içeren SVG reddedilir.
- Logo yüklenmemişse `config/site.php` → `defaults.logo` / `defaults.logo_dark` (marka dosyaları,
  `public/assets/brand/`) kullanılır ve alanda soluk gösterilir. Her alan kendi karşılığının yerine geçer;
  yüklenen logo kaldırılınca marka dosyasına dönülür.
- Enlem ve boylam birlikte girilir.
- **Renkler ve yazı tipleri panelde değildir**: `resources/css/site.css` → `@theme`
  ([`DESIGN_SYSTEM.md`](DESIGN_SYSTEM.md) §2).

## 6. Sayfa görselleri

Kategori, işlem ve blog görselleri **panelden yüklenmez**; dosya adına göre bulunur
([`PLACEHOLDERS.md`](PLACEHOLDERS.md) → Medya). Kategori, işlem ve yazı düzenleme ekranlarının sonundaki
**"Sayfa görseli"** kutusu, o sayfa için beklenen dosya adını ve şu an bir dosyanın bulunup bulunmadığını gösterir.

## 7. Geliştirici notları

- Sayfalar `resources/js/pages/admin/**`, denetleyiciler `App\Http\Controllers\Admin` (hepsi `AdminController`dan),
  doğrulama `App\Http\Requests\Admin`. Rotalar `routes/web.php` içinde, `admin.*` adlarıyla.
- Ortak parçalar `resources/js/components/admin/`: `SaveBar` (dil anahtarı + kaydet), `TranslatedField`,
  `SlugField`, `SeoFields`, liste düzenleyiciler (`StringListEditor`, `PairListEditor`), `FormSection`,
  `ConfirmDialog`, `MediaNote`, `ImageField`, `MarkdownField`, `ReviewSection` (hekim incelemesi),
  `PostForm`, `PatientReviewForm` (hasta yorumu), süzgeç ve sayfalama parçaları.
- **Form deseni:** çevrilebilir alanı olan formlar `useForm` + Wayfinder rota nesnesiyle gönderilir
  (`form.submit(TreatmentController.update(id))`) — dil anahtarı, liste düzenleyiciler ve önizleme
  denetimli durum ister. Basit formlar (talep durumu, yönlendirme ekleme) ve bütün silme onayları
  `<Form {...Controller.action.form()}>` kullanır; silmeler `ConfirmDialog` üzerinden geçer.
- Sunucu tarafı yardımcılar: `App\Content\BodySchema` (`content.{dil}` gövdesinin biçimi: doğrulama,
  form durumu, kayıt öncesi temizlik), `App\Support\Translations`, `App\Support\RecordKey` (yeni kaydın
  değişmez anahtarı), `App\Support\SlugRedirects` (adres değişiminde 301), `ValidatesTranslations`.
- Paylaşılan prop'lar (`HandleInertiaRequests`): `locales` (düzenleme dilleri), `site` (ad, adres),
  `newLeads` (menüdeki rozet), `auth.user`.
- Bildirim metinleri `lang/tr.json`, alan adları ve özel doğrulama iletileri `lang/tr/validation.php`.
- Tür güvenli rota yardımcıları (`@/actions/**`, `@/routes/**`) Wayfinder ile üretilir ve sürüm
  kontrolünde değildir; `npm run dev` / `npm run build` sırasında kendiliğinden oluşur. Derleme
  yapmadan yalnızca `tsc` çalıştırılacaksa önce `php artisan wayfinder:generate --with-form`.
- Kayıtta ilgili önbellekler model olaylarıyla temizlenir; panelde gezinme önbelleği (Inertia prefetch)
  GET dışı her istekten sonra boşaltılır.
- Admin'den genel siteye bağlantılar `<a target="_blank">` (ayrı ön yüz; `<Link>` değil).
- Log viewer: sayfa ve API'si panelin oturumunu kullanır (`config/log-viewer.php` → `middleware`,
  `api_middleware`); erişim `AppServiceProvider` içindeki `viewLogViewer` kapısıyla sınırlıdır.
- Panel marka işareti `resources/js/components/app-logo-icon.tsx` (geçici "C" monogramı; `fill-current`
  ile boyanan bir SVG'dir, işaretin vektörü gelince değiştirilir). Favicon logodan üretildi (2026-11-13).

## 8. Blog yazıları

- **Durum:** "Yayında" = yayın kutusu işaretli **ve** yayın tarihi geçmiş. Tarih ilerideyse yazı
  "Zamanlandı" görünür ve o an gelince kendiliğinden yayına girer; kutu işaretsizse "Taslak"tır.
  Yayın tarihi kliniğin saat dilimiyle (`config/site.php` → `timezone`) girilir.
- Bir dilde başlığı ya da adres uzantısı boş olan yazı o dilde yayınlanmaz (site 404 döner);
  listedeki "çevirisi eksik" süzgeci bunları gösterir.
- Adres uzantısı değişince eski adresten 301 kendiliğinden eklenir (`SlugRedirects`).
- Gövde Markdown'dır: `##` başlıkları yazı sayfasında "İçindekiler" listesini oluşturur; ham HTML ayıklanır.
  Site içi bağlantılar dil önekiyle yazılır (`/tr/tedaviler/botoks`).
- Kapak görseli panelden yüklenmez: `storage/app/public/media/blog/<anahtar>.*`.

## 9. Yorumlar (hasta yorumları)

- Yalnızca **gerçek** yorumlar, Google, Trustpilot ya da başka bir platformdan **kelimesi kelimesine**
  kopyalanır; her birine özgün yorumun bağlantısı girilir. Yorum uydurulmaz, kısaltılmaz, düzeltilmez,
  çevrilmez ([`DECISIONS.md`](DECISIONS.md) K11).
- Metin yazıldığı dilde tek bir sütunda durur (`body`, çeviri yok); yanında dilinin iki harfli kodu
  (`language`: `tr`, `en`, `de` …) tutulur. Puan (1–5) ve tarih isteğe bağlıdır; tarih ileri olamaz.
- Sıra: küçük sıra numarası önce, aynı sıradakiler yeniden eskiye (`Review::published()` aynı sırayı verir).
  "Yayında" kapalıyken yorum sitede görünmez.
- **Hukuki uyarı:** Türkiye'de sağlık hizmetlerinin tanıtımına ilişkin kurallar hasta yorumlarının ve
  tavsiyelerinin kullanımını sınırlar. Yorumlar sitede yayına alınmadan önce kliniğin **hukuk
  danışmanının onayı** alınmalıdır; liste ekranının üstünde bu not durur.
