Bundles/Internal/Webhub — Frontend kimlik, SEO, navigasyon, entegrasyon ve SSS

Doğrulanan kod tabanı: d49b4413 (dal feat/fw-license-master) · Tarih: 2026-10-05 · Yayın: 0.9.7 = bu commit + sonrası; belge yalnız doğrulama anındaki kodu anlatır
Kaynak klasör: Bundles/Internal/Webhub/ — 43 *.php + 19 *.rbn.php görünüm.
Envanter: 43 php dosyasının 43'ü bu belgelerde anlatıldı.

1. Ne işe yarar, kimler kullanır

Webhub, ziyaretçinin gördüğü siteyi yöneten modüldür: marka kimliği
(firma adı, slogan, iletişim), SEO ayarları ve SEO puanlama motoru, frontend
menüleri (navbar/footer), SSS ve
harici entegrasyonlar (Analytics, AdSense, head/body/footer script).

Kimler çağrır: geliştirici paneli (WebhubController üzerinde
#[Module(panel:'developer', context:'panel')], WebhubController.php:8).
Modülün verisi proje kapsamlıdır: z_settings (project.settings) ve
z_frontend_menus, z_pages, z_faqs tabloları.

2. Alt dallar ve belgeleri

2.1 Controllers/ (7)

2.2 Models/ (3)

2.3 Services/ (6)

2.4 Providers/ (3)

2.5 Views/ (19)

Kapsama: 43/43.

3. Akış — SEO taraması (modülün en ağır yolu)

POST webhub/seo/scan
  → SeoController::scan()                              SeoController.php:72
      → $this->service('seoScanner')                   :75
          → SeoScannerService::scan()                  :18
              ├─ base_url = https? + $_SERVER['HTTP_HOST']       :20-22
              ├─ executePipeline(['seo.settings','seo.core','seo.dom'], $params)  :30-34
              │    → her handler execute() → [score, report]; skorlar TOPLANIR  :105-111
              │      · SettingsScannerHandler  : execute()   (25 puan)
              │      · CoreScannerHandler      : execute()   (30 puan)
              │      · DomScannerHandler       : execute()   (45 puan)
              │    → score = min(100, Σ)                            :114
              └─ handler('seo.advice')->execute([score, report])   :37-41
                   → [advice (kural tabanlı), gemini (AI)]         AdviceHandler.php:18
      → provider('webhub')->actionScan('save_seo_scan', $result)  :78
          → dört ayara yazılır: seo-score, seo-report, seo-advice,
            seo-gemini-advice                                      WebhubProvider.php:111
          → purgeCache() (settings_group_*)                       :117
      → handleResult(true, …, 'seo/report')                       :82

Ayar kayıt akışı (Kimlik/SEO/Entegrasyon ortak):

POST webhub/seo/save
  → SeoController::update()                          SeoController.php:123
      → request->form([id, label_tr, setting_key])    :125-130
      → $this->service->action()->withId($id)->save($data)   :131
          ├─ criteria['setting_key'] = …              WebhubService.php:56
          ├─ provider->save(array_merge($data,$criteria))      :68
          │    ├─ anahtar yoksa: label_en → label_tr → setting_name slug'ı  :36-39
          │    ├─ 'value' → 'setting_value' eşlemesi  :45-49
          │    ├─ field_options boşsa '[]'            :52-56
          │    ├─ var mı? update(id) : create()       :65-83
          │    └─ purgeCache()                        :86
          └─ criteria = []  (akıcı döngü sıfırlama)  :69

4. Yapılandırma / ayar anahtarları

5. Tuzaklar ve kurallar (kodda görülen, ölçülmüş)

1. group_id sabitleri kırılgandır. create() çağrıları group_id => 1/2/10 yazar
   (IdentityController.php:66, SeoController.php:113, IntegrationsController.php:82).
   Grup id'leri veritabanında yeniden üretilirse yeni alan yanlış gruba düşer.
2. request->rawAll() denetleyicide. NavigationController::save() kural dizisi tanımlamak yerine
   ham girdi kullanır ve bunu bilinçli yapar (yorum: FW-ALTYAPI-2 / B, NavigationController.php:54).
   Beyaz liste CrudControllerTrait::crudInput() yolunda çalışır, bu yol trait'i kullanmıyor.
   Denetleyici unset($data['project']) ile proje anahtarını düşürür — yazma kapsamı modelin beyanına bırakılır.
3. IntegrationsController::save() WebhubProvider::save()'ı hiç çağırmaz. Servis
   IntegrationsService extends SettingsService → CrudServiceTrait; create()/update()
   ikisi de save()'a düşer (CrudServiceTrait.php:128,140) ve save() önce
   component('model') dener (:399-405) — SettingsModel çözüldüğü için
   provider->save() dalına (:420-426) hiç girilmez. Sonuç: WebhubProvider'ın üç
   koruması — slug türetme (:36-39), field_options JSON koruması (:52-56) ve
   settings_group_ önbellek düşürme (:95-101) — bu yolda çalışmaz. Aynı desen
   IdentityController::create/update ve SeoController::create/update için de geçerlidir
   (withId()->save() → WebhubService::save() → provider->save(), orada çalışır);
   fark, WebhubService'in $this->provider'ı boot()'ta bağladığı için (:30)
   provider dalına düşmesidir.
4. getTree() iki kip, iki çağrı. getNested() iç içe ($nested=true),
   getTree() düz+girinti (indent_level). getParents() yalnız düz kipi okur (:118) —
   iç içe ağaçta indent_level olmadığı için seçenekler girintisiz görünürdü.
5. Menü silme guard'ı sessiz başarısızlık. destroy() alt menü varsa false döner
   (FrontendMenuProvider.php:105); delete/{id} rotası bu false'u kullanıcıya
   "silinemedi" diye ayırt etmeden gösterir. Backstage'deki karşılığı da aynı desende
   (SidebarHandler::deleteCategory).
6. Ölçüt sıfırlama akıcı döngüyü kısa ömürlü kılar. WebhubService::save() ve action()
   çalıştıktan sonra $this->criteria = [] yapar (:69,:81). Aynı servis örneği üzerinde
   ikinci bir save() önceki withKey/withGroup filtresini kaybetmiş olur.
7. FaqController::index() dönüş tipi tutarsız. Diğerleri void/render çağırırken
   bu bir return $this->render(...) yapar (:32-34) ve $this->paginate($faqs)->to('faqs')
   zincirlemesi kullanır — to() çağrısının dönüş değeri atanır ama faqs olarak da geçirilir.
8. SEO taraması kendi sunucusunu HTTP ile yoklar. CoreScannerHandler ve DomScannerHandler
base_url'e remote->get() atar (CoreScannerHandler.php:46, DomScannerHandler.php:23).
   $_SERVER['HTTP_HOST'] doğrudan kullanıldığı için tarama panelin erişildiği host'u
   tarar; Host başlığı değiştirilmiş bir istek yanlış siteyi ölçebilir.
   SSL doğrulaması kapalıdır (CURLOPT_SSL_VERIFYPEER => false, :50-51 / :23).
9. scan() puanı zaman içinde kaydedilen bir sayıdır. getReport() veritabanındaki
   seo-report JSON'unu sayar; tarama yapılmamışsa seo-score 0 gelir ve
   SeoConfig::getScoreDisplay(0) "Taranmadı" döner (SeoConfig.php:19) —
   yani score=0 "kritik" değil "ölçülmedi" anlamına gelir.
10. AdSense tohumlama project_key'i elle yazar. setupAdsense() save() çağrısında
    'project_key' => $projectKey alanını açıkça koyar (IntegrationsService.php:51);
    diğer yollarda bu alan bilinçli olarak yazılmıyor (kapsam modelde).
11. FaqService boş bir sınıftır. 22 satır, yalnız iki protected beyan; herhangi bir
    metot yoktur (FaqService.php:17). Tüm davranış BaseService + project.faq
    repository'sinden gelir.

6. Örnek (gerçek koddan)

// Bundles/Internal/Webhub/Providers/FrontendMenuProvider.php:116-140 (özetlenmiş)
public function getParents($excludeId = null): array
{
    $tree    = $this->getTree();
    $options = [];

    // Düzenleme yapılıyorsa: kendisi + tüm alt dalı listeden çıkar (döngüsel koruması)
    $forbiddenIds = [];
    if ($excludeId) {
        $forbiddenIds[] = (int) $excludeId;
        $this->findDescendants((int) $excludeId, $tree, $forbiddenIds);
    }

    foreach ($tree as $item) {
        if (in_array((int) $item['id'], $forbiddenIds)) {
            continue;
        }
        $prefix = $item['indent_level'] > 0 ? str_repeat(' ', $item['indent_level'] * 2) . '↳ ' : '';
        $options[] = ['id' => $item['id'], 'title' => $prefix . $item['title']];
    }

    return $options;
}

7. İlgili belgeler

• Seo.md — tarama pipeline'ının dört handler'ı ve puanlama kuralları
• Core/Base/README.md — BaseService akıcı sözleşmesi
• Core/Base/Data.md — BaseModel kapsam (scoped) davranışı
• kavramlar/02-yapilandirma.md — z_settings şeması
• kavramlar/05-asset-sistemi.md
• acik-sorular.md