RbnAdmin/Controllers — 11 kontrolör

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/RbnSuite/RbnAdmin/Controllers/ — 11 *.php
Envanter: 11 dosyanın 11'i anlatıldı.
Üst belge: README.md

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

On bir kontrolör, RbnAdmin paketinin tüm HTTP giriş noktasıdır. Hiçbiri veri
katmanına doğrudan SQL yazmaz; isteği doğrular, alt servise/repozitoryoya devreder,
sonucu handleResult() ile kullanıcıya döner veya render() ile görünüm basar.

Tümü BaseController → BaseComponent soyundan gelir; #[Module] (kök) veya
#[SubModule] (alt) özniteliğiyle kimliklerini bildirirler. #[SubModule]'ın
service/repository/manager/model alanları, kuruluşta (hydration) hangi
bileşenin " aktif servis" olacağını belirler
(Core/Base/Concerns/Hydration/ComponentHydratorTrait.php:56).

2. Dosya envanteri

Gözlem: CronLogsController özniteliğinde service: 'cron' yazmasına rağmen
metotların hiçbirinde $this->service kullanılmaz; hepsi
$this->repository('master.cronJob') / $this->repository('project.cronLog') çağırır
(:22,52,104,186,235,250). service('cron') yalnız BotSettingsController::save()
tarafından dolaylı kullanılır (BotSettingsController.php:153).

3. Akışlar (dosya:satır kanıtlı)

3.1 Ortak kalıp: form → servis → handleResult()

POST /admin/users/store
  → ControllerResolver (Route.php:143 ile kayıt edilen route)
  → UserManagementController (CrudControllerTrait::create)   CrudControllerTrait.php:24
      ├─ request->rawAll()                                   CrudControllerTrait.php:30
      ├─ crudInput() → hedef modelin $fillable beyaz listesi CrudControllerTrait.php:71
      └─ activeService->create($data) → handleResult(…, 'create')  CrudControllerTrait.php:31

Rota tablosu ModuleData::registerRoutes() içindedir
(Models/ModuleData.php:52); users grubu 11 uç tanımlar (:87-105).

3.2 Durum değiştirme (AJAX)

CategoriesController (RbnStudio) ve CronLogsController::toggleCron() (:229-239)
aynı normalizasyonu kullanır: '1' | true | 'true' | 'on' → 1, aksi hâlde 0.
handleResult($result, null, false, 'status') çağrısında 3. parametre false
olduğu için returnPath(false) → yönlendirme yapılmaz; tarayıcıda kalan sayfa
korunur (ActionControllerTrait.php:227).

3.3 Modal görünümü üç farklı yolla üretiliyor

3.4 Dosya sistemiyle çalışan tek kontrolör: CronLogsController

GET /admin/cron/cronlogs?tab=files
  → CronLogsController::index()                            :44
      ├─ repository('project.cronLog')->getLogs(300, $pk)  :55   (DB sekmesi)
      └─ glob(Paths::project()->root('Storage/logs/cron') . '/*.jsonl')  :60-79
          └─ yalnız dosya adı '_<proje anahtarı>.jsonl' ile BİTENLER alınır  :70

Dosya adı süzgeci str_contains($filename, '_' . $pk . '.jsonl') ile yapılır
(:70) — bu sona eki değil, içinde geçme testidir; x_abc.jsonl.bak
benzeri bir ad teorik olarak eşleşir, ama glob yalnız *.jsonl döndürdüğü için
pratikte kapalıdır.

4. Ayar anahtarları ve varsayılanlar

5. Tuzaklar

1. BotSettingsController::status() parent::status() çağırır, sonra yanlış
   nesneye yazar. CrudControllerTrait::status() çalışır, ama
   clearProjectCache() doğrudan sınıf adıyla çağrılır
   (BotSettingsController.php:222) — bu yol service('settingsApi') değil,
   BootCacheProvider'ın statik metodudur. Aynı statik çağrı save() (:163) ve
   create() (:213) içinde de üç kez tekrarlanmıştır.

2. AdminSettingsController nesne/dizi karışımı okuyor — ve bu güvenli,
   ama okuyucu için yanıltıcıdır. Aynı grup kümesi üç farklı stille okunur:
   $group->group_key (:35), $group['group_key'] (:52) ve
   is_object($group) ? $group['id'] : $group['id'] (:62, :71).
   Ölçüldü: SettingsRepository::fetchGroups() → ->get()->all() model
   nesneleri döndürür (Core/Database/Engine/Traits/Query/ExecutionTrait.php:38),
   ama BaseModel implements \ArrayAccess + HybridAccessTrait::offsetGet()
   (Core/Base/Data/BaseModel.php:47,50 · Core/Base/Concerns/Data/HybridAccessTrait.php:34)
   sayesinde dizi erişimi de çalışır. Yani :52 ölü bir hata değildir —
   kırılganlıktır: fetchGroups() bir gün düz dizi döndürmeye başlarsa
   :52 sessizce '' döner ve $activeGroup hiç bulunamaz (ayarlar ekranı
   grupsuz açılır). Üç stilin tek stile (:35'teki gibi) indirgenmesi güvenli olur.
   Aynı "nesne mi dizi mi" belirsizliği badgeCounts hesabında da var (:60-76).

3. HostmailhubController alan adı beyaz listesi. create/delete/
   changePassword üçünde de istenen alan adı getActiveDomains() içinde
   değilse işlem önce reddedilir (:114-117, :147-150, :181-184).
   getActiveDomains() boş grup dönerse tek elemanlı liste üretir (:215-219).

4. HostmailhubController::delete() rota imzası tuzaklı. Rota
   POST hostmailhub/delete/{email?:[a-zA-Z0-9_\.-]+}'dir
   (ModuleData.php:76); metot ise $this->request->input('email') ?? $id
   okur (:141). @ karakteri alan adına ait olduğu için URL'de gönderilemez;
   pratikte email gövde alanından gelmelidir.

5. UserManagementController::delete() kendini silmeyi engeller.
   Oturumdaki user_id ile hedef karşılaştırılır (:114-117); eşitse işlem
   yapılmaz ve hata mesajı gösterilir. Bu denetim yalnız bu yolda vardır;
   CrudControllerTrait::delete() benzeri koruma taşımaz.

6. UserManagementController::updateRole() korumalı alanı yetkili yoldan yazar.
   Genel update() yolu role alanını yazamaz (UsersModel::$guarded); rol
   değişimi yalnız UserManager::setRole() üzerinden olur ve her çağrı
   security kanalına MASS_ASSIGNMENT_AUTHORIZED_WRITE olarak düşer (:95-99).

7. ModalController çözülemeyen type için istisna atmaz, uyarı bloğu basar
   (:72-80). Buna karşılık content() AJAX değilse 403 döner (:21-24) —
   korumanın yalnız yarısı burada.

8. SeoReportController "thin controller" standardı. 27 satır, tek ekran,
   doğrudan service('seoScanner')->getReport(). Öznitelikte service yok,
   bu yüzden aktif servis türetilmiş ada (seo-report) göre çözülür (:13-15).

9. WebtrafficController::googleAnalytics*() tarih varsayılanı 30 gün
   (:321-324, :351-354); report() ise 7 gün (:194-195). İki ekran
   farklı pencere kullanır ve bu bir hata değil, bilinçli seçimdir.

6. Örnek (gerçek koddan)

Kendi parolasını değiştirmek isteyen kullanıcının kendi profil şifresi — hedef kimlik
istemekten değil oturumdan gelir:

// Bundles/RbnSuite/RbnAdmin/Controllers/UserManagementController.php:173-186
$data = $this->request->form([
    'new_password'    => 'required|min:8',
    'repeat_password' => 'required|same:new_password'
]);

$targetId = (int) $this->session()->get('user_id');
$user     = $this->manager->getUser($targetId);
$role     = $user['role'] ?? 'user';
$result   = $this->manager->updatePassword($targetId, $data['new_password'], $role);

$this->handleResult($result, 'Şifreniz başarıyla güncellendi.', 'users/profile');

7. İlgili belgeler

• RbnAdmin README — paket geneli, ayar anahtarları, 15 tuzak
• RbnAuth — AuthRole::ROLES, handler('access')->can()
• Core/Base/Web — BaseController + CrudControllerTrait
• Core/Routes — rota kaydı ve middleware grupları