Bundles/Internal/Syshub — Sistem, güvenlik, veri temizliği ve veritabanı konsolu

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/Syshub/ — 47 *.php + 20 *.rbn.php görünüm.
Envanter: 47 php dosyasının 47'si bu belgelerde anlatıldı (aşağıdaki alt dal tabloları).

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

Syshub, framework'ün kendi kendini gözetleyen panosudur: sistem sağlığı
istatistikleri, bakım modu, IP engelleme / güvenilir liste / hız sınırı, depolama
temizliği ve ham SQL terminali. Diğer modüllerin (RbnAdmin, RbnAuth, projeler)
kullandığı hiçbir işlevi yoktur; tek işi işletim katmanını yönetmektir.

Kimler çağırır: yalnız geliştirici paneli (panel: 'developer', Module
attribute'i SyshubController'da). context: 'developer' olduğu için bu
modülün rotaları diğer rollere açılmaz (ModuleData.php:17).

2. Alt dallar ve belgeleri

2.1 Controllers/ kök (3)

2.2 Handlers/ (4)

2.3 Models/ (3)

2.4 Providers/ (7)

2.5 Services/ (2)

2.6 Views/ (20)

Kapsama: 47/47.

3. Akış — bir istek syshub'a geldiğinde

GET /<panel>/syshub
  → Route::prefix('syshub')->controller('SyshubController')        ModuleData.php:58
  → SyshubController::index()                                     SyshubController.php:23
      → $this->service  ⇒  SyshubService (alias 'syshub')          ModuleData.php:30
          → handler('syshub')  ⇒  SyshubHandler                     SyshubService.php:82
              → repository('common.shieldSetting')                  SyshubHandler.php:28
              → getFolderStats(Paths::project()->storage('framework/views'))  :30,35
              → getFolderStats(Paths::project()->storage('logs'))            :31,36
              → getFolderStats(Paths::project()->sessions())                 :32,37
              → model('master.ipBlock')?->count()                            :49
              → model('common.rateLimit')?->count()                          :50
      → render('Dashboard/index', [...])                           SyshubController.php:27

Depolama temizliği zinciri:

POST syshub/datapurge/clearAll
  → PurgeController::clearAll()                                    PurgeController.php:151
      → SyshubMap::MAP['sub_modules']['datapurge']['sub_modules']  :155
        (7 anahtar: cache, logs, sessions, backups, exports, uploads, view)
      → her anahtar için purge()->clear($type,null,$projectKey)     :159
          → service('storage')->{$type}()->withProject($key)->clearAll()  DataPurgeHandler.php:93

Ham SQL zinciri:

POST syshub/dbconsole/console/execute
  → SqlConsoleController::executeQuery()                           SqlConsoleController.php:40
      → request->form(['query'=>'required|string'], ['action'=>'sql_console_execute'])
      → SyshubDbConsoleService::executeQuery()                      SyshubDbConsoleService.php:46
          → SyshubDbConsoleHandler::executeQuery()                 SyshubDbConsoleHandler.php:23
              ├─ session: is_logged_in / is_master_developer / user_role      :29-35
              ├─ isRawSqlRole(...)  → reddi hâlinde SQL_CONSOLE_DENIED_ROLE   :31,37
              ├─ hasMultipleStatements(...) → SQL_CONSOLE_DENIED_MULTI         :42
              ├─ auditSql('SQL_CONSOLE_EXECUTE', $sql) → logs()->channel('security')  :47,200-216
              └─ model('schemaDoctor')->executeRaw($sql)                        :50

4. Yapılandırma / ayar anahtarları

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

1. BulkControllerTrait imza tuzağı. PurgeController::bulkDelete($target=null, string $method='bulkDestroy', $redirect=null)
   imzası bilerek yorum bozucudur: yönlendirici {type}'ı 1. argüman, {path}'i 2. argüman geçirir
   (ModuleData.php:78,81), controller bunu $path = ($method !== 'bulkDestroy') ? $method : null
   ile ayrıştırır (PurgeController.php:176). $method bir yöntem adı değil, dosya yoludur.
2. logs ve view ayrıcalıklı tip. DataPurgeHandler::getProviderStats() yedi tip döndürür ama
   logs için getCategorizedLogs()/getConfigs() ve view için farklı anahtar kullanılır
   (DataPurgeHandler.php:60). PurgeController::module() yalnız logs'ta özel dallanır (:69).
3. PurgeConfig::TYPES ile SyshubMap uyuşmuyor. PurgeConfig framework türünü tanımlar
   (PurgeConfig.php:51) ama SyshubMap alt modülleri arasında framework yoktur; view var
   (SyshubMap.php:59). Ters yönde de fark var: view PurgeConfig'te yok. Bu yüzden view kartı
   bg_color alamaz ve PurgeController::index #6366f1 varsayılanına düşer (PurgeController.php:39).
4. Ham SQL üç kapıdan geçer ve her durumda denetlenir. Rol (:31), tek ifade (:42) ve denetim
   (:47) sırayla; reddedilen durumlar da auditSql ile kayda girer (:38,43). Denetim yazımı
   try/catch içindedir — denetim kaydı yazılamazsa sorgu yine de çalışır (:213-215).
5. isMaintenance() yorum uyumu (G-03). Panel eskiden === 'on' ile okuyordu; zorlayıcı katman
   normalizeSwitch() kullanıyordu. maintenance_mode='1' yazan operatör siteyi AÇIK görüyor,
   site ENGELLİ görünüyordu. İkisi de tek kaynağa bağlandı; anahtar yoksa KAPALI sayılır
   (SyshubMaintenanceProvider.php:29,42-45).
6. Önbellek düşürme yazma sonrası zorunlu. getSetting() settings_shield önbelleğini kullanır;
   yazma sonrası düşürülmezse panel eski değeri okumaya devam eder
   (SyshubMaintenanceProvider.php:88, SyshubFirewallProvider.php:71).
   Her iki yerde de try/catch ile yutulur — güvenlik açığı değil, gecikmedir.
7. SyshubCronProvider::find() ölü kod. getJobs() kayıtlı alias master.cronJob kullanırken
   (SyshubCronProvider.php:25) find() kayıtsız model('cronJobs') çağırır (:69). Bu ada karşılık
   gelen CronJobsModel yoktur (dosya adı MasterCronJobsModel.php; kayıt alias'ı
   SystemPhysicalMapTrait.php:29). ?->toArray() sayesinde hata fırlatmaz, daima [] döner.
8. Statistiklerde sert kodlanmış değerler. active_threats => 0, health_score => 98
   (SyshubHandler.php:53), getHealthStatus()['score'] => 98 (SyshubFirewallProvider.php:92),
   traffic bloğu tamamen sıfır (SyshubHandler.php:64). Panel bunları gerçek ölçüm gibi gösterir.
9. Paths::frameworkRoot() ile modül sayımı. getModuleCount() Bundles/Internal ve
   Bundles/RbnSuite altındaki dizin sayısını sayar (SyshubHandler.php:122); paket içi
   *.php sayısıyla ilgisi yoktur.
10. SqlConsoleController::getTableData() tablo adını interpolasyonla gömüyor —
    "SELECT * FROM `{$form['table']}` LIMIT 100" (SqlConsoleController.php:78).
    Değer required|string ile gelir; backtick kaçışı yapılmadığı için backtick içeren bir tablo adı
    sorguyu bozabilir. executeQuery() bu yüzden tek ifade kuralını uygular ama tablo adını doğrulamaz.
11. Rol kapısı yalnız SQL'de var. executeQuery() user_role ∈ {developer, superadmin} ya da
    is_master_developer arar (SyshubDbConsoleHandler.php:68). dropTable, deleteRows,
    optimize, cleanInstall gibi daha yıkıcı işlemlerin hiçbirinde bu kapı yoktur; güvenlik
    yalnız URI'nin context: 'developer' korumasına dayanır.

6. Örnek (gerçek koddan)

// Bundles/Internal/Syshub/Handlers/SyshubDbConsoleHandler.php:23-47 (özetlenmiş)
public function executeQuery(string $sql): array
{
    if (empty(trim($sql))) {
        return ['success' => false, 'message' => 'Sorgu boş olamaz.'];
    }

    $session  = $this->session();
    $role     = (string) $session->get('user_role', '');
    $allowed  = self::isRawSqlRole(
        (bool) $session->get('is_logged_in', false),
        (bool) $session->get('is_master_developer', false),
        $role
    );
    if (!$allowed) {
        $this->auditSql('SQL_CONSOLE_DENIED_ROLE', $sql);
        return ['success' => false, 'message' => 'Bu işlem için yetkiniz yok.'];
    }
    if (self::hasMultipleStatements($sql)) {
        $this->auditSql('SQL_CONSOLE_DENIED_MULTI', $sql);
        return ['success' => false, 'message' => 'Aynı anda yalnızca tek bir SQL ifadesi çalıştırılabilir.'];
    }
    $this->auditSql('SQL_CONSOLE_EXECUTE', $sql);
    // …
}

7. İlgili belgeler

• Security.md · DbConsole.md
• Core/Base/README.md — BaseComponent, BaseController, keşif zinciri
• Core/Base/Services.md — BaseService / BaseProvider sözleşmeleri
• Core/System/Config.md — Definition::get('database_project', …)
• Core/Database/README.md — schemaDoctor, master/common katmanları
• kavramlar/03-veritabani-ve-kiracilik.md
• acik-sorular.md