# Üst Manşet Haber Portalı — Teknik Mimari

Bu doküman, **Üst Manşet** portalının teknik mimarisini, veri akışını, entegrasyon kararlarını ve performans planlamasını detaylandırır.

---

## 1. Teknoloji Yığını (Technology Stack)

Proje, güncel, güvenli ve performanslı olması adına aşağıdaki teknolojiler üzerine kurulmuştur:

- **Çekirdek Çerçeve (Core Framework)**: [Laravel 12](https://laravel.com)
- **Programlama Dili**: PHP 8.2 (Mevcut sürüm: `8.2.29`)
- **Veritabanı (Database)**: MySQL (WampServer entegre)
- **Frontend Katmanı (UI/Reaktivite)**: 
  - **Blade**: Sunucu tarafı şablonlama (SSR).
  - **Livewire 3**: Sayfa yenilemeden dinamik ve reaktif bileşenler.
  - **Alpine.js**: İstemci tarafı hafif etkileşimler.
  - **Vite**: Modern frontend derleyici ve asset yöneticisi.
- **Güvenlik ve Bildirim**: SweetAlert2 (Kullanıcı bildirimleri için).
- **Editör**: Güvenli bir WYSIWYG editör (Aşama 2'de eklenecektir).

---

## 2. Altyapı ve Veritabanı Sürücü Tercihleri

Yerel geliştirme kolaylığı sağlaması ve kaynak tüketimini minimumda tutması adına ilk aşamada `.env` yapılandırmasında aşağıdaki sürücüler **database** olarak ayarlanmıştır:

- **Oturum Yönetimi (Session)**: `SESSION_DRIVER=database`
  - *Gerekçe*: Yerel WampServer ortamında oturumların güvenle takip edilebilmesi ve çakışma yaşanmaması.
- **Önbellek (Cache)**: `CACHE_STORE=database`
  - *Gerekçe*: Haber portalının yüksek yük altında veritabanına doğrudan gitmesini engellemek için yerel geliştirme aşamasında önbellekleme mekanizmasının test edilmesi.
- **Arka Plan İşleri (Queue)**: `QUEUE_CONNECTION=database`
  - *Gerekçe*: E-posta gönderimi, görsel sıkıştırma, loglama ve dış servis entegrasyonu gibi zaman alan işlerin kuyruğa atılması ve `php artisan queue:work` ile yerel ortamda asenkron işlenebilmesi.

---

## 3. SEO ve Performans Mimarisi

Haber portalı başarısında SEO ve yüklenme hızı en kritik faktörlerdendir:

1. **Cumulative Layout Shift (CLS) Yönetimi**:
   - Google Ads ve reklam alanları için şablonlarda önceden sabit yükseklikler (`min-height` ve `aspect-ratio` tanımları) atanacaktır. Reklam yüklenirken sayfa içeriğinin aşağı/yukarı kayması kesinlikle engellenecektir.
2. **Önbellek Katmanı (Caching Strategy)**:
   - Çok okunan haberler, kategori listeleri ve menü elemanları veritabanı önbelleğinde (Cache) saklanacak, haber güncellendiğinde ilgili önbellek anahtarları otomatik temizlenecektir.
3. **Resim Optimizasyonu**:
   - Yüklenen tüm haber resimleri sunucu tarafında optimize edilecek ve modern formatlar (WebP/AVIF) kullanılacaktır.
4. **Google News & RSS**:
   - Google News standartlarına uyumlu XML site haritaları ve anlık güncellenen RSS besleme kanalları (feeds) kurulacaktır.

---

## 4. Güvenlik Politikaları

- **APP_DEBUG**: Yerel ortamda `true` olarak yapılandırılmıştır. Canlı sunucuda (production) bu değer kesinlikle `false` olmalıdır.
- **Validation**: Tüm kullanıcı verileri ve form istekleri `Form Request` sınıfları veya Livewire bileşenlerindeki sıkı kurallar ile doğrulanacaktır.
- **Audit Log (Denetim Günlüğü)**: Kritik işlemler (haber silme, kullanıcı yetkilendirme vb.) için arka planda log tutulması mimari olarak planlanmıştır.
