RbnAdmin/Models — kayıt merkezi, panel haritası ve kimlik

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/Models/ — 3 *.php
Envanter: 3 dosyanın 3'ü anlatıldı.
Üst belge: README.md

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

Bu klasörde hiçbir veritabanı modeli yoktur (RbnAuth ve RbnStudio'da ModuleData
adında bir sınıf vardır, burada öyle bir sınıf da yoktur — bu paketteki üç sınıfın
üçü de yapılandırma sınıfıdır). Üç görev üstlenirler:

1. ModuleData — paketin servis/provider kayıtlarını ve tüm HTTP
   rotalarını tanımlar. Paket yüklenirken Route::module('suite','RbnAdmin')->load()
   tarafından bulunur ve registerRoutes() çağrılır (Core/Routes/Route.php:143).
2. PanelMap — panel menüsünün ağacı: hangi modül, hangi başlık, hangi ikon,
   hangi kontrolör. Menü ve breadcrumb bu sabitten üretilir.
3. PanelIdentity — panelin SEO/OG/meta verisi ve varsayılan bilgilendirme
   metinleri.

2. Dosya envanteri

3. ModuleData::registerMap() — kayıt defteri (:33-46)

'services'  => ['analytics' => AnalyticsService, 'socialmedia' => RbnAdminService, 'rbnAdmin' => RbnAdminService],
'providers' => ['analytics' => AnalyticsProvider, 'social'    => SocialMediaProvider],

• analytics hem servis hem provider → farklı türler, çakışma yok.
• RbnAdminService iki anahtara birden yazılıyor (socialmedia, rbnAdmin).
• socialmedia ayrıca global kayıt defterinde de var
  (Core/System/Registries/RegistryMap/SystemLogicMapTrait.php:78).

4. ModuleData::registerRoutes() — paketin 9 rota grubu

Toplam: 60 uç (ölçüldü: Select-String "Route::(get|post)\(" → 60 eşleşme).
Bunların tamamı Route::middleware('admin') → Route::panel('admin') grubunun
içine yüklenir (Core/Routes/Mappings/core.php:75).

Rota adlandırma tutarsızdır: yalnız 7. ve 8. gruplar (bot-settings, cron)
->name('admin.…') kullanır — 16 uç (ölçüldü: 16 name('admin eşleşmesi);
diğer 8 gruptaki 44 uç adsızdır. Adı olmayan rotalar returnPath()'in
adlandırılmış rota keşfini kullanamaz
(Core/Base/Web/Traits/Controller/ActionControllerTrait.php:69-…).

5. PanelMap::MAP — panel ağacı

Kök: identity ('Yönetim Paneli', ikon ri-dashboard-line), sub_modules altında
11 üst düğüm:

controller ipucu yoksa ModuleDataDriver anahtardan türetir:
PascalCase(slug) . 'Controller' (Core/System/Discovery/Engine/Drivers/ModuleDataDriver.php:185).
Yani contact → ContactController, notification → NotificationController
otomatik eşleşir; yazmamak bir hataya yol açmıyor, sadece örtük.

6. PanelIdentity — kimlik ve metinler

• THEME_COLOR = '#c56a3c' (Terracotta) ve FAVICON = '@fw/images/favicon-rbnadmin.svg' (:17-18).
• PANEL_IDENTITY['seo'] robots = 'noindex, nofollow' (:29) — yönetim paneli
  dizinlenmemeli, kasıtlı.
• Başlıklar FrameworkIdentity::ADMIN_TITLE . ' | ' . FrameworkIdentity::ADMIN_NAME
  sabitlerinden gelir (:25,33) — marka adları tek kaynaktan.
• DEFAULT_INFO yalnız dashboard ve settings için metin taşır (:47-66);
  diğer 9 panel modülü için karşılığı yoktur → görünümler kendi metinlerini yazar.
• VIEW_MAP yalnız iki anahtar içerir (:71-74) ve hiçbir kod tarafından okunmaz
  (ölçüldü: VIEW_MAP araması yalnız bu tanımı bulur). RbnAuth'ın VIEW_MAP'i de
  benzer biçimde tanımlıdır (RbnAuth/Models/AuthIdentity.php:109).

Karşılaştırma: PanelIdentity bir #[Bundle] özniteliği taşıyan ModuleData
tarafından config['identity'] olarak okunur (ModuleDataDriver.php:171), ama
RbnAdmin/Models/ModuleData.php içinde CONFIG sabiti yoktur — kimlik
#[Bundle(map: PanelMap::MAP)] üzerinden MAP['identity'] alanından gelir
(ModuleDataDriver.php:162).

7. Tuzaklar

1. PanelMap içindeki SidebarController bu pakette değildir.
   PanelMap.php:63 navigation.sidebar.controller = 'SidebarController' der;
   sınıf Bundles/Internal/Backstage/Controllers/SidebarController.php:14'te yaşar.
   ModuleDataDriver bu ipucuyla controller_map üretir
   (ModuleDataDriver.php:182), yani panel haritası kasıtlı olarak
   komşu pakete işaret eder. Ama RbnAdmin'ın registerRoutes()'ında navigation
   rotası yoktur (:52-158) → menüde görünen bir düğüm için RbnAdmin tarafında
   uç yoktur.

2. identity düğümü yalnız PanelMap'te vardır, ModuleData tarafından
   türetilmez. ModuleDataDriver identity alanını $map['identity'] üzerinden
   okur (:162) ve yoksa ucfirst($bundle->name) = 'Rbnadmin' yazar (:165).
   PanelMap::MAP['identity']['title'] = 'Yönetim Paneli' doğru değer; yalnız
   ModuleData registerMap()'i döndürmediği için bu yol harita dosyasına
   bağımlıdır.

3. Rota adlandırma tutarsızlığı (§4). Adlandırılmamış rotalarda
   returnPath('users/profile') gibi dize yollar kullanılmak zorundadır;
   handleResult()'ın returnPath() çağrısı (ActionControllerTrait.php:227)
   ad çözemediğinde dizeyi olduğu gibi döndürür (:143-147).

4. users/store rotası var, store() metodu yok — bu bir ölü uçtur. ⚠️
   ModuleData.php:91 → Route::post('store', 'store'), ancak
   UserManagementController (ve tabanı CrudControllerTrait) store() metodunu
   taşımaz; CRUD oluşturma ucu create()'dir (CrudControllerTrait.php:24).
   Ölçüldü: ReflectionClass(UserManagementController::class)->hasMethod('store')
   → false; hasMethod('create') → true. Dispatcher bu durumda metot yok
   yoluna düşer ve RuntimeException fırlatır
   (Core/Routes/Engine/Dispatcher.php:173); üretimde mesaj
   'Controller not found or method missing.' olur.
   Bu uç muhtemelen hiç kullanılmıyor (ekranlar update/{id} veya servis
   tarafından oluşturma yapıyor), ama rota tablosunda "var" göründüğü için
   geliştirici yanlış yönlendirilir. Aynı grupta update/([0-9]+) → update
   var (CrudControllerTrait.php:40), yani güncelleme çalışır, ekleme çalışmaz.
   Aynı desen RbnStudio'da yoktur (orada tek save ucu hem ekler hem günceller).

5. users grubu store ve update/{id} uçlarını ayırır — bu ayrımın
   niyeti "oluştur" / "güncelle" idi, ama yalnız yarısı bağlı (tuzak 4).
   RbnStudio'da tek save ucu id yoksa ekleme, varsa güncelleme yapar
   (RbnStudio/Controllers/PostsController.php:112).

6. Route::get('modal/?([0-9]*)', 'modal') kalıpları users (:90) ve
   contact (:143) gruplarında seçenekli parametre kullanır — diğer tüm
   modal uçları modal/{id?} biçimindedir. İki yazım da çalışır ama birleştirilse
   daha tutarlı olur.

7. delete uçlarının tamamı POST'tur — ölçüldü: users/delete (:94),
   contact/delete (:144), contact/restore (:145), contact/destroy (:146),
   notification/delete (:155), hostmailhub/delete (:76) — hiçbiri GET
   değil. CSRF yüzeyi yoktur; bu RbnStudio'nın aksine güvenli taraftadır
   (RbnStudio'da Route::get('delete/{id}') da kayıtlıdır, bkz.
   RbnStudio §5).

8. PanelIdentity::VIEW_MAP ölü — RbnAuth'ınki değil. §6'da ölçüldü:
   grep VIEW_MAP → yalnız bu tanım. Karşılaştırma: RbnAuth'ın VIEW_MAP'i
   Core/Render/Handlers/UI/AuthHandler.php:30 tarafından okunur; panelin
   karşılığı olan PanelHandler yalnız communication servisini sorgular
   (Core/Render/Handlers/UI/PanelHandler.php:40) ve kimlik sabitlerini
   kullanmaz (:30: "kaynak, aktif kontrolörden DNA mirasıyla otomatik gelir").

9. registerMap() providers altında analytics var ama
   AnalyticsProvider'ın $targetModel = 'Users' (AnalyticsProvider.php:18) —
   yani bu provider trafikle değil kullanıcı tablosuyla çalışır. Adı yanıltıcıdır.

8. Örnek (gerçek koddan)

Paketin rotaları nasıl yüklenir (çağıran taraf Core/Routes/Route.php:139):

// Bundles/RbnSuite/RbnAdmin/Models/ModuleData.php:72-79
Route::prefix('hostmailhub')->controller('HostmailhubController')->group(function () {
    Route::get('/', 'index');
    Route::get('modal/{id?}', 'modal');
    Route::post('create', 'create');
    Route::post('delete/{email?:[a-zA-Z0-9_\.-]+}', 'delete');
    Route::post('change-password', 'changePassword');
    Route::get('eternalLink', 'eternalLink');
});

9. İlgili belgeler

• RbnAdmin README · Controllers.md · Providers.md
• Core/Routes — Route::module(), Route::prefix()
• Core/Support/Definitions — FrameworkIdentity
• RbnStudio — aynı kalıbın (#[Bundle] + registerRoutes) ikinci örneği