Core/Base — framework'ün soyut tabanı (bileşen, servis, veri, web)

Doğrulanan kod tabanı: 1d89c431 (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: Core/Base/ — 65 *.php.
Envanter: 65 dosyanın 65'i aşağıda anlatıldı (alt dal belgelerinde dağınık).

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

Framework'ün tüm somut sınıflarının türediği kök: BaseComponent
(lazy keşif + bağlam), BaseService (tekil orkestratör), BaseModel /
BaseRepository / BaseConfig (veri), BaseController / BaseRender /
BaseManager (web), BaseChannel / BaseProxy (kalıp). Her şey
BaseComponent::__get() ile $this->service(...), $this->model(...),
$this->repository(...) gibi uydurma özelliklerini çözer.

Kimler çağırır: neredeyse her katman. Somut sınıflar (Core/Services,
Bundles/*, Packages/*) bu hiyerarşiyi kalıtır.

2. Klasör/dosya envanteri

Alt dal belge	Kapsam	Dosya
(bu belge)	kök (2), `Attributes/` (4), `Concerns/` (12), `Patterns/` (3)	21
Data.md	`Data/` ve `Data/Traits/**`	18
Services.md	`Services/` ve `Services/Traits/**`	18
Web.md	`Web/` ve `Web/Traits/**`	8
Toplam		65

2.1 Kök

Dosya	Görev	Önemli public yöntemler
`BaseComponent.php`	Kök soyut sınıf; `ArrayAccess`, `__get()` ile lazy keşif, `beforeBoot/afterBoot` kancaları, özyineleme koruması.	`__construct(?BaseService $rbn = null)`, `const B92_UYARI_ETIKETI`, `__debugInfo(): array`, `component(string $type,?string $target=null,bool $mandatory=true): ?object`, `__get(string $name)`
`BaseAttribute.php`	PHP attribute tabanı (alias/metadata/parent + `__get` ile metadata okuma).	`const __construct(array $metadata = [])`, `setParent(object $parent): void`, `__get(string $name)`, `config(string $key,$default=null)`

2.2 `Attributes/` (4)

Dosya	Görev	Yapıcı imzası / alanlar
`Bundle.php`	Paket kimliği attribute'u.	`__construct(public ?string $context = null, public array $map = [], public bool $register = true)`
`Component.php`	Bileşen (cache bayrağıyla) attribute'u.	`__construct(…, public bool $cache = false)`
`Module.php`	Modül kimliği: ikon/açıklama/başlık/SEO.	`__construct(…, ?string $icon = null, ?string $description = null, ?string $title = null, bool $seo = true)`
`SubModule.php`	Alt modül kimliği: veri sınıfı, entity adı, bulk girdi anahtarı, modal.	`__construct(…, ?string $data = null, ?string $entityName = null, ?string $bulkInputKey = null, ?string $modal = null)`

2.3 `Concerns/` (12)

Dosya	Görev	Önemli yöntemler
`BaseContextTrait.php`	Bağlamın kökü: `SovereignIdentity` + `IdentityExtractorTrait` + `ComponentHydratorTrait` + `ResolvesProjectConfigTrait`; `discover()`, `bootBaseContext()`, `map()`.	`discover(): DiscoveryEngine`, `bootBaseContext(): void`, `map(string $type, array $manual = []): array`
`ConcernsContextTrait.php`	Tüm alt bağlamları birleştirir ve boot sırasını yürütür.	`bootConcernsContext(): array`
`Contexts/ServicesContextTrait.php`	Servis/keşif/veritabanı/oturum kısayolları.	`resolveDiscovery(string $type,string $name)`, `initServicesContext(): array`, `config(string $key,$default=null)`, `db(): Database`, `session(): SessionManager`
`Contexts/StorageContextTrait.php`	Paylaşılan depolama motoru (cache/log/oturum).	`initStorageContext(): array`, `resolveStorage(): ?object`, `static forgetStorage(): void`, `cache()/logs()/sessions()`, `logWorkspace(?string $channel=null)`
`Contexts/HttpContextTrait.php`	İstek/yanıt motoru bağlamı.	`initHttpContext(): array`
`Contexts/ResourceResolverTrait.php`	Hedef repository/model/proje anahtarı çözümü ve standart 301.	`resolveTargetRepository(?string $fallbackKey=null): ?object`, `resolveTargetModel(?string=null): ?object`, `resolveCurrentProjectKey(?string $passedKey=null): string`, `perform301Redirect(string $pathOrUrl): void`
`Data/HybridAccessTrait.php`	Dizi erişimi + `toArray()`.	`offsetExists/offsetGet/offsetSet/offsetUnset(mixed)`, `toArray(): array`
`Data/InteractsWithProjectContextTrait.php`	Proje bağlamı değiştirme (CLI).	`activeProjectKey(): ?string`, `isValidProject(string): bool`, `switchProjectContext(string): bool`, `runInProjectContext(string,callable): mixed`, `restoreProjectContext(): bool`
`Data/ResolvesProjectConfigTrait.php`	Proje rota haritası/ayar/veri/yol/ad alanı çözümleme.	`static resetRouteMapCache()/resetAllRouteMapCaches()`, `getRouteConfig(string $projectKey,?string $key=null)`, `targetProjectUrl(string $projectKey,string $path=''): string`, `sanitizeCustomPath(mixed): string`, `resolveProjectConfig(string $configFile,?string $projectKey=null): array`, `resolveProjectData(string $key,?string $projectKey=null): mixed`, `resolveProjectSetting(string $key,?string $projectKey=null): mixed`, `resolveProjectPath(?string $projectKey=null,string $subPath=''): string`, `resolveProjectNamespace(?string $projectKey=null,string $subNamespace=''): string`
`Hydration/ComponentHydratorTrait.php`	Aktif controller'ın bileşenlerini somutlaştırır.	`hydrateComponents(): void`
`Identity/IdentityExtractorTrait.php`	Aktif controller'dan kimlik alanlarını (module/panel/sub_module/hub) kopyalar.	`extractIdentity(): void`
`Identity/SovereignIdentity.php`	Tüm bileşenlerin paylaştığı durum alanları (`$rbn`, `$discover`, `$module`, `$projectKey`, …) — metot içermez.	— (yalnız alanlar: `rbn`, `discover`, `shield`, `service`, `model`, `storage`, `http`, `request`, `response`, `module`, `sub_module`, `hub`, `panel`, `context`, `appName`, `projectKey`, `appVersion`, …)

2.4 `Patterns/` (3)

Dosya	Görev	Önemli public yöntemler
`BaseChannel.php`	Sorgu/kanal akıcı arayüzü (filtre, arama, önbellek, hidrasyon, sayfalama).	`__construct(string $cachePrefix)`, `status()/unread()/latest()/oldest()/active(): self`, `limit()/offset(int): self`, `where(string,$value,string $operator='='): self`, `search(string): self`, `cache(?int $ttl=null): self`, `asArray()/asObject()/asCollection(): self`, `hydrate(mixed): mixed`, `paginate(int $perPage,?string $url=null): object`, `toPackage(): array`, `getFromCache(string $key,callable $callback)`
`BaseProxy.php`	Keşif proxy'si: hafif kurulum, iki aşamalı `__get`.	`__construct(string $type)`, `__get(string $name)`, `resolveDiscovery(string $type,string $name)`
`Traits/Proxy/DiscoveryProxyTrait.php`	Proxy davranışını taşıyan trait.	`initializeProxy(string $type): void`, `__get(string $name)`, `__call(string $name, array $args)`

Kapsama (bu belge): 21/21 · Alt dallarla toplam: 65/65.

3. Akış — bir bileşenin doğuşu

new UsersModel()  (veya herhangi bir BaseComponent türevi)
 └─ BaseComponent::__construct(?BaseService $rbn)      BaseComponent.php:90
     ├─ DI verilmiş ama kullanılmıyorsa saatlik UYARI (LogThrottle::once)  :100-109
     ├─ beforeBoot()                                   :112
     ├─ bootConcernsContext()                          ConcernsContextTrait.php:41
     │    ├─ bootBaseContext()                          BaseContextTrait.php:53
     │    │    ├─ $this->rbn = BaseService::get()       :56
     │    │    ├─ controller ise setActiveController($this)  :59-61
     │    │    ├─ extractIdentity() + hydrateComponents()  :64-72
     │    │    ├─ $this->discover = $this->discover()  :82
     │    │    └─ Bootstrap::getAppContext('project_data') → appName/projectKey/appVersion  :91-99
     │    ├─ initServicesContext()  (discovery + db + session)  :48
     │    ├─ initStorageContext()   (paylaşılan StorageManager) :49
     │    └─ initHttpContext()      (request + response)        :50
     └─ afterBoot()                                    :118

Uydurma özellik erişimi:

$this->model('project.user')                 (service/repo vb. de aynı yol)
 └─ BaseComponent::__get('model')            BaseComponent.php:194
     ├─ önbellekte çözülmüşse doğrudan dön  :196-203
     ├─ ComponentTypes::typeMap() son eklerini dener  :206-218
     │    'user' → 'model' → component('model','user')
     └─ eşleşme yoksa null                  :220

4. Yapılandırma / ayarlar

Öğe	Yer	Not
`RESOLVED_SUFFIX_CACHE_LIMIT = 512`	`BaseComponent.php:48`	Son ek çözümleme önbelleği sınırı; aşınca tamamen boşaltılır
`component()` derinlik sınırı `> 20`	`BaseComponent.php:165`	Aşılırsa `rbn_panic` (yoksa `RuntimeException`)
`B92_UYARI_ETIKETI = 'b92-di-yok-sayildi'`	`BaseComponent.php:85`	Saatlik, sınıf başına tek DI uyarısı

5. Tuzaklar ve kurallar

__construct(?BaseService $rbn) imzası korunmuştur ama DI bağı kurmaz.
Parametre yalnız uyarı üretir (B-92). Gerçek erişim BaseService::get()
singleton'ıdır (BaseComponent.php:68).
Saatlik uyarı LogThrottle::once() kullanır. Süreç içi "bir kez"
koruması PHP-FPM'de işe yaramaz (her istek yeni süreç); ölçülen gürültü
162 isteklik koşuda 596 satırdı (BaseComponent.php:76).
Çerçeve kendi uyarısını tetiklememelidir. HttpContextTrait ve DiscoveryEngine, parametreyi gövdede kullanmayan RemoteRequest / ViewEngine nesnelerini argümansız açar (new RemoteRequest(), new ViewEngine()); B-92 uyarısı yalnız çağıranın bilerek verdiği DI nesnesi için yazılır. Yeni bir iç çağrıda $hub/$rbn geçirmeyin.
Özyineleme koruması 20 derinliktedir ve finally ile daima geri
alınır (BaseComponent.php:163).
Aktif controller DNA'sı önce gelir. Bileşenler kendi module/panel
değerlerini önce controller'dan alır, sonra servisten tamamlar
(BaseContextTrait.php:64).
Controller'a view bağlamı otomatik verilir: appName, projectKey,
projectGroup, appVersion (BaseContextTrait.php:102).
BaseProxy parent::__construct() çağırmaz; rbn ve discover
lazy kalır (BaseProxy.php:64).
Proxy birincil keşfi ölçümde çalışmıyor: DiscoveryProxyTrait yanlış
namespace'i (System\Registries\…) çağırıyor; hata yutuluyor ve
süreç başına bir kez security kanalına düşüyor
(BaseProxy.php:77). Düzeltme bilinçli olarak yapılmadı (Aşama 2).
perform301Redirect() guvenliHedef() süzgecinden geçmez — kendi
header()'ını yazar (ResourceResolverTrait.php:60). Bu yol
kullanılacaksa açık yönlendirme riski göz önünde bulundurulmalıdır.

6. Örnek (gerçek koddan)

Özellik çözümleme (son ek → tip → hedef), BaseComponent.php:206:

// $this->user  →  typeMap() içinde 'user' son eki 'model' tipine karşılık gelir
//              →  component('model', 'user')  →  UsersModel örneği
$rows = $this->user->where('is_active', 1)->get();

Proje bağlamı değiştirme (InteractsWithProjectContextTrait.php:71):

$sonuc = $this->runInProjectContext('ornek-proje', function () {
    return $this->user->count();
});
$this->restoreProjectContext();

7. İlgili belgeler

Data.md, Services.md, Web.md
../System/Discovery.md — ComponentResolver, ComponentTypes::typeMap()
../Database/README.md — BaseModel/BaseRepository tüketicileri
../../kavramlar/01-mimari-harita.md — Kernel aşamaları ve bileşen keşfi