RbnAdmin — Yönetim paneli (dashboard, trafik, kullanıcı, ayar, cron, e-posta)

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/ — 49 *.php
(Controllers 11 · Views 28 · Models 3 · Providers 4 · Services 2 · Traits 1)
Envanter: 49 php dosyasının 49'u aşağıdaki tabloda anlatıldı; hiçbir dosya
"listedeyle kapatılmadı".
Alt dal belgeleri: Controllers.md · Models.md ·
Providers.md (Providers + Services + Traits) · Views.md

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

RbnAdmin, framework'ün her yönetim ekranının arkasındaki pakettir: giriş sonrası
dashboard, ziyaretçi trafiği analitiği, kullanıcı/rol yönetimi, sistem ayarları,
bot & API anahtarı yönetimi, cron logları, SEO raporu, iletişim mesajları, sistem
bildirimleri ve cPanel e-posta hesapları. Tüm rotaları Route::middleware('admin')
grubuna bağlıdır, yani oturum + rol denetimi olmadan hiçbiri erişilebilir değildir
(Core/Routes/Mappings/core.php:75).

Kullanıcı yönünden: URL'den gelen istek Dispatcher → Route → ilgili kontrolör.
Kontrolörler BaseController'dan türer; iş mantığı kontrolörde değil, servis /
provider / repository katmanındadır (kontrolörler yalnız istek doğrulama + render +
yönlendirme yapar). Tek istisna: RbnAdminService::saveColors() bir yetki kontrolü
içerir.

2. Klasör envanteri (49 dosya)

2.1 Controllers/ — 11 dosya

2.2 Models/ — 3 dosya

2.3 Providers/ — 4 dosya

2.4 Services/ — 2 dosya

2.5 Traits/ — 1 dosya

2.6 Views/ — 28 dosya (.rbn.php uzantısı zorunlu değil, ViewResolver ikisini de kabul eder)

Dashboard görünümü bu klasörde değildir. RbnAdminController::renderDashboard()
RbnAdmin/dashboard render eder (RbnAdminController.php:149); bu dosya
Resources/Views/RbnAdmin/dashboard.rbn.php yolunda, panelin ortak
Layouts/ ve Components/ dosyalarıyla birlikte oradadır (9 dosya).

3. Akış: bir istek panelden ekrana

3.1 Dashboard açılışı

GET /admin/  →  Core/Routes/Mappings/core.php:75  (middleware 'admin' → RbnAdmin modülü)
  → Route::module('suite','RbnAdmin')->load()  → Route.php:130
  → (new ModuleData)->registerRoutes()  → ModuleData.php:55  (Route::controller('RbnAdminController'))
  → Dispatcher → RbnAdminController::adminIndex()          RbnAdminController.php:27
  → renderDashboard('admin')                                RbnAdminController.php:58
      ├─ provider('dash.stats') → get<Proje>Stats() | getAdminStats()   :62-72
      ├─ service('analytics')->traffic()->summary()                    :75-80
      ├─ helper('Geo')->countryFlags()  → ülke adı/flag çözümü        :84-106
      ├─ group_projects() → aktif proje adı/alan adı                  :113-138
      ├─ service('shieldSettings')->getSetting('bot_activity',0)       :141
      │    └─ 1 ise manager('aiUsage')->getFilteredReport(['project'=>…])  :144
      └─ render('RbnAdmin/dashboard', …)                              :149

dashboard görünümü Resources/Views/RbnAdmin/dashboard.rbn.php; panel kasıtlı
olarak boş bırakılmıştır ('module' => null, RbnAdminController.php:151),
yani proje modülü zorunlu değildir.

3.2 Trafik raporu

GET /admin/webtraffic/report?start_date=&end_date=
  → WebtrafficController::report()                     WebtrafficController.php:191
  → service('analytics')->traffic()->query()->forRange($s,$e)->get()
      → TrafficAnalysisTrait::get()                   TrafficAnalysisTrait.php:79
        (her gün için Storage->traffic()->get('date_YYYY-MM-DD') ; satırlara 'date' eklenir)
  → PHP içinde cihaz/bot/sayfa/kaynak/trend sayımı    :207-262
  → render('Webtraffic/report', …)                     :296

Trafik bir SQL sorgusu değil, dosya tabanlı bir sayaçtır: TrafficAnalysisTrait
her şeyi $this->storage->traffic()->get('date_' . $date) ile okur
(TrafficAnalysisTrait.php:91,99,104). Ağır istatistikler (computeSummary())
aylık özet dosyalarından (getMonthlyData()) toplanır (:150,174).

3.3 Modal akışı (her alt modül için ortak)

GET /admin/modal/content?type=<modül>&id=<id> →
ModalController::content() (ModalController.php:19, rota core.php:77) →
discover()->controller($type) ile kontrolör bulunur → varsa modal($id,$view)
çağrılır. Bulunamazsa uyarı bloğu basılır, hata fırlatılmaz (:72-80).
Kontrolörün kendi getModalData($id) varsa veri oradan gelir; yoksa servis/provider
find($id) ile okunur (Core/Base/Web/Traits/Controller/ActionControllerTrait.php:251).

4. Yapılandırma / ayar anahtarları

5. Tuzaklar ve kurallar (kodda ölçülmüş)

1. ModuleData::registerMap() anahtar çakışması — düzeltilmiş ama izlenmeli.
   analytics hem servis (AnalyticsService) hem provider (AnalyticsProvider)
   adıdır (ModuleData.php:37,42). Farklı türler olduğu için çakışma yoktur; ama
   RbnAdminService iki ayrı anahtara birden yazılır (socialmedia, rbnAdmin,
   ModuleData.php:38) ve socialmedia ayrıca global kayıt defterinde vardır
   (Core/System/Registries/RegistryMap/SystemLogicMapTrait.php:78). Yani aynı sınıf
   üç yerden erişilebilir.

2. analytics servisinin AnalyticsProvider kullanımı ölü. AnalyticsProvider
getDashboardStats() metodu (AnalyticsProvider.php:25) hiçbir yerden çağrılmıyor
   (grep getDashboardStats → yalnız tanım + Internal/Syshub'ın kendi metodu).
   Dashboard'da kullanılan yol TrafficStatsChannel::computeSummary()'dir. Ayrıca
   AnalyticsProvider::getDashboardStats() içindeki $traffic->hits() çağrısı
   TrafficAnalysisTrait::hits()'e düşer ve bu tüm zamanların toplamını döndürür
   (TrafficAnalysisTrait.php:316 → count()), yani metot adı today_hits
   olmasına rağmen "bugün" değildir. Kullanılmadığı için etkisiz, yanıltıcıdır.

3. TrafficAnalysisTrait::count() tüm tarihleri tarar. $provider->listDates()
   döngüsüyle aylık dosyaların tümünü okur (TrafficAnalysisTrait.php:123).
   total_hits yıllar geçtikçe doğrusal yavaşlar. computeSummary() bunu ay
   özetleriyle telafi eder (:167-187), ama count() kendisi telafi etmez.

4. TrafficStatsChannel aynı trait'i iki kez kullanır → özyineleme mührü zorunlu.
   AnalyticsProvider ve TrafficStatsChannel aynı TrafficAnalysisTrait'i
   use eder (AnalyticsProvider.php:20, TrafficStatsChannel.php:16), bu yüzden
   aynı sınıftaki metotlar iki kez tanımlanmış olur ve use ile çakışmaz —
   trait tek yalnız derlenir. computeSummary()'nın static $isCalculating
   mührü (TrafficAnalysisTrait.php:139) bu yinelenmeyi kırmak içindir;
   finally bloğunda kaldırılır (:236-238). Mühre dokunulmazsa yol kilitlenir.

5. WebtrafficController bayrak çözümlemesini 4 kez tekrarlar.
   index() (:32-51), logs() (:143-165) ve RbnAdminController (:87-105) aynı
   "ISO kodu → ülke adı + fi fi-xx sınıfı" mantığını kopyalar. Yeni bir ülke
   kaynağı eklenirse üçü de güncellenmelidir.

6. Bot ayrımı string önekine dayanır. Bot/organik sınıflandırması
   str_starts_with($location, 'Bot') ile yapılır (WebtrafficController.php:125,129,249;
   TrafficAnalysisTrait.php:193,206). report() ayrıca '🤖' önekini de eler
   (WebtrafficController.php:270) — bu iki eleme tutarsızdır (computeSummary
🤖'ü eleyen yoktur, TrafficAnalysisTrait.php:193). Yeni bir bot etiketi
   biçimi bu üç noktada ayrı ayrı tanımlanmalıdır.

7. Hostmailhub/index.php uzantısı diğerlerinden farklı. 28 görünümün 27'si
   .rbn.php; bu biri düz .php. ViewResolver ikisini de kabul eder
   (Core/Render/Resolvers/ViewResolver.php:43), yani çalışır — ama konvansiyon
   dışıdır ve ViewProvider'ın .rbn.phpye özel davranışından
   (Core/Render/Providers/UI/ViewProvider.php:59) muaftır.

8. Cron log dosyası adı path traversal'a karşı elle süzülür, ama süzgeç dar.
   view()/deleteFile() .., /, \ reddi yapar
   (CronLogsController.php:136,195) — doğru. Ancak clear() tüm *.jsonl
   dosyalarını siler ve proje/oturum sınırı kontrolü yoktur (:211-224); bu bir yetki
   kararıdır, admin middleware'ine bağlıdır.

9. Route::post('users/store') rotası var, hedef metot yok. ModuleData.php:91
   → Route::post('store', 'store'); ancak UserManagementController ve tabanı
   CrudControllerTrait store() taşımaz (CRUD oluşturma ucu create()'dir,
   Core/Base/Web/Traits/Controller/Engine/CrudControllerTrait.php:24).
   Ölçüldü: ReflectionClass(UserManagementController::class)->hasMethod('store') →
   false. Bu uç çağrılırsa Dispatcher RuntimeException fırlatır
   (Core/Routes/Engine/Dispatcher.php:173). Detay: Models §7.4.

10. PanelMap içindeki SidebarController bu pakette değildir.
    PanelMap.php:63 navigation.sidebar.controller = 'SidebarController' der;
    bu sınıf Bundles/Internal/Backstage/Controllers/SidebarController.php:14'te
    yaşar. Panel ağacının başka bir pakete işaret etmesi kasıtalıdır
    (ModuleDataDriver controller eşlemesini buradan üretir,
    Core/System/Discovery/Engine/Drivers/ModuleDataDriver.php:180), ama
    RbnAdmin'ın kendi registerRoutes()'ında navigation rotası yoktur
    (ModuleData.php:52): yalnız harita tanımı vardır.

11. RbnAdminController::saveTheme() yetkiyi servis içinde denetler.
    RbnAdminService::saveColors() handler('access')->can('admin') çağırıp
    yetkisizse throw new \Exception(...) atar (RbnAdminService.php:27).
    Kontrolör bunu yakalamaz → yetkisiz istek 500'e düşer, kullanıcı dostu
    hata mesajı üretilmez.

12. handleResult() 4. parametresi fiil olarak "eylem" ayarı.
    Context diye adlandırılmış ama içerik create|store|update|status|delete|destroy| bulkOrder|bulkValueUpdate olmalı; başka bir metot adı geçirilirse mesaj
    sözlüğünde bulunamaz ve update varsayılanına düşer
    (ActionControllerTrait.php:156). Kullanıcı hatalı context verirse
    mesaj yanlış ama isabetli görünür.

13. Durum değiştirme değer normalizasyonu üç yerde kopyalanmış.
    '1' | true | 'true' | 'on' → 1 kuralı CategoriesController (RbnStudio),
    CronLogsController::toggleCron() (:233) ve CrudControllerTrait::status()
    (Core/Base/Web/Traits/Controller/Engine/CrudControllerTrait.php:178) içinde
    ayrı ayrı yazılıdır.

14. switchProject() Referer'a kör güvenir. Yönlendirme hedefi
    strtok($_SERVER['HTTP_REFERER'], '?')'dir (RbnAdminController.php:40);
    Referer yoksa panele düşer. Açık yönlendirme riski Referer'ı ayarlayan
    istemciye bağlıdır (tarayıcı Referer'ı yazılır, ham istemci yazmaz).

15. remember() önbelleği 600 sn; yazma yolları elle düşürüyor.
    create/delete/changePassword üçünde de aynı 12 satırlık "projeyi bul →
    api_cpanel_mail önbelleğini sil" bloğu tekrar edilir
    (HostmailhubController.php:123,156-163,189-197). Dördüncü bir yazma
    yolu eklenirse bu üç yer de güncellenmelidir, aksi halde 10 dakika eski liste görünür.

6. Örnek (gerçek koddan)

Tema kaydı — doğrulama, yetki ve yazma zinciri:

// Bundles/RbnSuite/RbnAdmin/Controllers/RbnAdminController.php:166-186
$data = $this->request->form([
    'theme_color_primary'   => 'required|regex:/^#[0-9A-Fa-f]{6}$/',
    'theme_color_secondary' => 'nullable|regex:/^#[0-9A-Fa-f]{6}$/',
    'project'               => 'nullable|string'
]);
$result = $this->service->saveColors(
    $data['theme_color_primary'],
    $data['theme_color_secondary'] ?? null,
    $data['project'] ?? null
);
return $this->Route->handleResult($result);

Akıcı trafik sorgusu:

// Bundles/RbnSuite/RbnAdmin/Controllers/WebtrafficController.php:203-204
$hits = $traffic->query()->forRange($startDate, $endDate)->get();
$allHits = array_values(array_filter($hits, fn($hit) => isset($hit['time'])));

7. İlgili belgeler

• RbnAuth — giriş, rol tablosu, oturum, CSRF (panelin kapısı)
• RbnStudio — içerik yönetimi (makale/haber/kategori/taslak)
• Core/Base/Web — BaseController, handleResult(), modal()
• Core/Http — Request::form(), Validator, rawAll()
• Core/Routes — Route::module(), middleware grupları
• Core/Database/Repositories — project.* depoları
• acik-sorular