RBN Framework — Belgeler Dizini (kaynak ağacı haritası)
Bu belge hangi commit'e göre yazıldı:
d49b4413(dalfeat/fw-license-master)
Son doğrulama tarihi: 2026-10-05
Yayın tabanı: 0.9.7 = bu commit + sonrası; belge yalnız doğrulama anındaki kodu anlatır
Kapsam:rbnframework/deposunun tamamı (okuma yönü: framework'ü hiç bilmeyen biri)
Bu dizi, framework'ün kendi kodunu okuyarak yazılmış rehberidir. Her iddia
dosya:satır ya da sınıf::metot ile kaynağa bağlıdır. Kodda
doğrulanamayan hiçbir şey burada yazılmamıştır; doğrulanamayanlar
acik-sorular.md dosyasındadır.
Dizin kaynak ağacını aynalar: kaynak yolu = belge yolu
(Core/Http/… → Core/Http/README.md), böylece okuyucu kodda nerede ise
belgede de orada.
1. Kavram rehberleri (kavramlar/)
| Belge | Konu | Kim okumalı? |
|---|---|---|
| kavramlar/01-mimari-harita.md | Açılış zinciri, Kernel aşamaları, yönlendirme, render, project_key / site / modül kavramları, Paths, ortam algısı |
Framework'e ilk kez dokunan herkes |
| kavramlar/02-yapilandirma.md | Hangi ayar hangi dosyada, kim okuyor, öncelik sırası, ortam değişkenleri, "bir ayar nereden okunur?" karar tablosu | Ayar ekleyen/değiştiren |
| kavramlar/03-veritabani-ve-kiracilik.md | Bağlantı aileleri, BaseModel kapsam/yazma koruması, migration, master tabloları, lisans kapısı |
Veritabanı ve model yazan |
| kavramlar/04-surumleme-ve-yayin.md | Sürüm kuralı, tek kaynak, rbn version:*, CHANGELOG/UPGRADING biçimi, yükseltme |
Sürüm/yayın yapan |
| kavramlar/05-asset-sistemi.md | ASSET/CSS/JS/FONT/İKON sistemi, konvansiyon, önbellek | Asset/view yazan |
| kavramlar/06-riza-kapisi.md | Çerez bandı / analitik / reklam kodu / rıza kaydı kapısı: tek karar kuralı (ayar dolu VE noindex değil), tüketiciler | Çerez, analitik, reklam, yasal sayfa işi yapan |
| acik-sorular.md | Kodda doğrulanamayan ya da çelişen noktalar (her maddede: ne soruldu · nereye bakıldı · neden belirsiz · nasıl çözülür) | Herkes (okuma sonrası mutlaka) |
2. Kaynak ağacı haritası (klasör → belge)
Tek tablo: kaynak klasörü, dosya sayısı ve o klasörü anlatan belge.
2.1 Core/
| Kaynak klasör | *.php |
Belge | Durum |
|---|---|---|---|
Core/Base/ |
65 | Core/Base/README.md · Data.md · Services.md · Web.md | ✅ |
Core/Database/ |
74 | Core/Database/README.md · Engine.md · Models.md · Repositories.md · Migrations.md | ✅ |
Core/Http/ |
36 | Core/Http/README.md (5 kök) · Engine.md (17) · Security.md (14) | ✅ |
Core/Render/ |
51 | Core/Render/README.md (2 kök) · Builders.md (7) · Configs.md (5) · Controllers.md (5) · Handlers.md (6) · Providers.md (11) · Resolvers.md (10) | ✅ |
Core/Routes/ |
13 | Core/Routes/README.md | ✅ |
Core/Services/ |
81 | Core/Services/README.md (+ kayıt haritası) · Console/README.md (30) · Exception.md (13) · Gatekeepers.md (13) · Hosting.md (6) · Master.md (7) · System.md (11) | ✅ |
Core/Support/ |
— | Core/Support/README.md (+ alt dallar) |
⏳ ayrı görev |
Core/System/ |
— | Core/System/README.md (+ Config.md, Discovery.md, Paths.md, …) |
⏳ ayrı görev |
2.2 Bundles/, Packages/, Resources/
| Kaynak klasör | *.php |
Belge | Durum |
|---|---|---|---|
Bundles/Internal/Syshub/ |
47 | Bundles/Internal/Syshub/README.md · Security.md (5 controller) · DbConsole.md (3 controller) | ✅ |
Bundles/Internal/Webhub/ |
43 | Bundles/Internal/Webhub/README.md · Seo.md (5 handler) | ✅ |
Bundles/Internal/Backstage/ |
24 | Bundles/Internal/Backstage/README.md | ✅ |
Bundles/RbnSuite/ |
80 | Bundles/RbnSuite/README.md — paketler arası ilişkiler, ortak kayıt kalıbı | ✅ |
Bundles/RbnSuite/RbnAdmin/ |
49 | Bundles/RbnSuite/RbnAdmin/README.md · Controllers.md (11) · Models.md (3) · Providers.md (7: Providers+Services+Traits) · Views.md (28) | ✅ |
Bundles/RbnSuite/RbnAuth/ |
15 | Bundles/RbnSuite/RbnAuth/README.md | ✅ |
Bundles/RbnSuite/RbnStudio/ |
16 | Bundles/RbnSuite/RbnStudio/README.md | ✅ |
Packages/RbnApi/ |
27 | Packages/RbnApi.md | ✅ |
Packages/RbnEmail/ |
10 | Packages/RbnEmail.md | ✅ |
Packages/RbnFile/ |
8 | Packages/RbnFile.md | ✅ |
Packages/RbnFactory/ (yalnız ayar ve VPS sözleşmesi) |
- | Packages/RbnFactory.md | kısmi |
Packages/RbnPipeline/ |
31 | Packages/RbnPipeline.md + RbnPipeline/Rules.md (11) | ✅ |
Packages/RbnUtility/ |
2 | Packages/RbnUtility.md | ✅ |
Packages/PackageData.php |
1 | Packages/PackageData.md | ✅ |
Resources/ (Assets, Data, images, Views) |
29 php + 53 diğer | Resources/README.md | ✅ |
Bundles/RbnSuite/*satırları 05.10.2026'da DOC-REHBER-AGAC-5 görevinde
dolduruldu: RbnAdmin 49 + RbnAuth 15 + RbnStudio 16 = 80 php, tamamı
alt belgelere yazıldı. Bu görevde ölçülen iki ölü rota hedefi bulundu;
bkz.acik-sorular.md§2.⏳ satırı, o kaynak ağacı için önceden ayrılmış belge yolunu gösterir;
belge o görevde üretilecektir. Kapsam dışı bırakılan kaynak ağaçları
(projects/,domains/) bu dizinin konusu değildir.
3. Okuma sırası
- Yeni başlayan (framework'ü bilmiyor):
kavramlar/01-mimari-harita.md→kavramlar/02-yapilandirma.md→acik-sorular.md - Ayar/ayar dosyası ile uğraşan:
kavramlar/02-yapilandirma.md→acik-sorular.md - Model/Repository/migration yazan:
kavramlar/03-veritabani-ve-kiracilik.md→Core/Database/README.md→Core/Base/Data.md - Controller/view yazan:
Core/Base/Web.md→Core/Routes/README.md→Core/Http/README.md→Core/Http/Engine.md - Panel ekranı yazan:
Bundles/RbnSuite/RbnAdmin/README.md→ Controllers.md → Views.md →Bundles/RbnSuite/RbnAdmin/Models.md(rota kaydı) - Giriş/oturum/rol değiştiren:
Bundles/RbnSuite/RbnAuth/README.md→Core/Routes/README.md(middleware grupları) - İçerik (makale/haber/kategori) yazan:
Bundles/RbnSuite/RbnStudio/README.md→Core/Database/README.md - Dosya/görsel yükleyen:
Packages/RbnFile.md→Core/Http/Engine.md(UploadedFile) - Dış servis (sosyal medya, arama motoru, ödeme) bağlayan:
Packages/RbnApi.md→Packages/PackageData.md - Sürüm/yayın yapan:
kavramlar/04-surumleme-ve-yayin.md(kökREADME.md+.github/UPGRADING.mdile birlikte) - Şablon/görünüm yazan:
Core/Render/README.md→Core/Render/Resolvers.md→Core/Render/Handlers.md(TemplateExpressionGuard,RawHtmlGate) →Core/Render/Builders.md+ kavramlar/05-asset-sistemi.md - Güvenlik/erişim kuralı yazan:
Core/Services/Gatekeepers.md→Core/Services/Master.md(lisans) →Core/Services/Exception.md - CLI/cron/migration yazan:
Core/Services/Console/README.md→ kavramlar/04-surumleme-ve-yayin.md - Ajan (kod okuyup değiştiren):
kavramlar/altındaki beş belgeyi de oku;
ardından.agents/rules/core-architecture.md,database-and-cli.md,
versioning.mdkurallarını oku.
Kök
README.mdkurulum içindir (Gereksinimler, Kurulum, sır yönetimi,
klasör haritası, CLI listesi, güvenlik, sürüm). Mimari soruları o belgede
değil, bu dizide aranır.
4. Nasıl katkı / güncelleme kuralı
Kural (bağlayıcı): Framework kodunda yapılan her değişiklik, o
değişikliğin ilgili olduğu belgeyi aynı ya da takip eden yayın
güncellemesinde güncellemek zorundadır. Belge güncellenmeden commit
edilmiş bir davranış değişikliği eksik sayılır.
Belge–konu eşlemesi:
| Kod değişikliği | Güncellenmesi gereken belge |
|---|---|
Giriş noktası, PreBoot, KernelFactory, bir Stage, Route::run(), RedirectManager, Paths, is_local() / ProjectDbProfileResolver |
kavramlar/01-mimari-harita.md |
Yeni ayar anahtarı, Config önceliği, project-routemap.php / project-settings.php şeması, secrets.php app bölümü |
kavramlar/02-yapilandirma.md |
Bağlantı ailesi, BaseModel kapsam, $fillable, migration, master tablosu, lisans kapısı |
kavramlar/03-veritabani-ve-kiracilik.md + Core/Database/ altındaki belge |
Version, FrameworkIdentity, APP_VERSION, CLI sürüm komutları, CHANGELOG/UPGRADING biçimi |
kavramlar/04-surumleme-ve-yayin.md |
BaseComponent/BaseService/BaseModel tabanları, Concerns/*, Patterns/* |
Core/Base/README.md + ilgili alt dal |
Bundles/Internal/Syshub/** (sistem panosu, bakım modu, veri temizliği, DB konsolu, güvenlik) |
Bundles/Internal/Syshub/README.md + Security.md / DbConsole.md |
Bundles/Internal/Webhub/** (kimlik, SEO + tarama pipeline'ı, menü, yasal sayfa, SSS, entegrasyon) |
Bundles/Internal/Webhub/README.md + Seo.md |
Bundles/Internal/Backstage/** (panel sidebar'ı, e-posta ayarları, ayar mimarisi) |
Bundles/Internal/Backstage/README.md |
Request/Response/Validator |
Core/Http/README.md |
Core/Http/Engine/* (trait'ler, UploadedFile, FormRequest) |
Core/Http/Engine.md |
Core/Http/Security/* (form kalkanı, ApiGuard) |
Core/Http/Security.md |
Packages/RbnApi/* (dış servis kapısı) |
Packages/RbnApi.md + Packages/PackageData.md |
Packages/RbnEmail/* (SMTP, şablon, IMAP) |
Packages/RbnEmail.md |
Packages/RbnFile/* (yükleme, GD, dışa/içe aktarma) |
Packages/RbnFile.md |
Packages/RbnPipeline/* (AI içerik hattı) |
Packages/RbnPipeline.md (+ Rules.md) |
Packages/RbnUtility/* (RSS, Trends) |
Packages/RbnUtility.md |
Resources/Views/*, Resources/Assets/*, Resources/Data/* |
Resources/README.md |
Route, Collector, Matcher, Dispatcher, RedirectManager, Mappings/* |
Core/Routes/README.md |
| Asset/CSS/JS/FONT/İKON | kavramlar/05-asset-sistemi.md + Core/Render/Builders.md + Core/Render/Configs.md |
Şablon yönergesi (@if/@yield/@import/@csrf), layout, view yolu güvenliği |
Core/Render/README.md + Core/Render/Resolvers.md + Core/Render/Handlers.md (TemplateExpressionGuard) |
SEO/meta/schema/robots.txt/sitemap/llms.txt |
Core/Render/Resolvers.md + Core/Render/Providers.md + Core/Render/Controllers.md |
Varlık vekili (/framework-assets, /project-assets), font/medya yönlendirme |
Core/Render/Controllers.md + Core/Render/Configs.md |
| Hata sayfası, RbnShield, panic ekranı | Core/Services/Exception.md + Core/Services/Gatekeepers.md (BootSentinel) |
| IP koruması, WAF, hız sınırı, bakım modu, VIP | Core/Services/Gatekeepers.md |
| Lisans doğrulama, proje/uygulama sürümü | Core/Services/Master.md |
| CLI komutu, cron, migration, temizlik işi | Core/Services/Console/README.md |
| Ayar servisi, oturum, kullanıcı, CDN, modül keşfi | Core/Services/System.md |
| Yasal sayfa (gizlilik, KVKK, çerez, mesafeli satış), şirket/yasal ayar anahtarları, çerez envanteri | Core/Services/Yasal-Sayfa-Motoru.md |
Telefon biçimi (format_phone, phone_e164, whatsapp_url), iletişim bilgisi tek kaynağı (contact_info() / $contact), Google işletme senkronu (google:sync), ayar tablosunda boş satır yok (settings:set / settings:unset) |
Core/Services/Iletisim-Bilgisi.md |
Blog yazar künyesi (blog-author, blog-author-title), yazı verisinde author, blog_author parçası, BlogPosting yazarı |
Core/Services/Blog-Yazar-Kunyesi.md |
Çalışma saatleri (contact-hours haftalık program), açık/kapalı durumu (open_status), etiket şablonları ({time}, {next_open}), opening_status bileşeni, Google saat senkronu |
Core/Services/Calisma-Saatleri.md |
| cPanel (e-posta/alan adı/SSO) | Core/Services/Hosting.md |
Ek kurallar:
- Her belgenin başındaki "Doğrulanan kod tabanı" satırı, belgeyi yazan kişi
tarafından güncellenir; "son doğrulama tarihi" de aynı anda yazılır. - "Yayın tabanı" satırı sürümü anlatır:
A.B.C = bu commit + sonrası, yani belge
yalnız doğrulama anındaki kodu anlatır. Belgeyi yazan kişi o commit'ten sonra
değişen bir şeyi anlatıyorsa commit'i kendisi günceller — başkası güncellemez. - Bir iddia artık kodda doğrulanamıyorsa silinmez,
acik-sorular.md'ye taşınır. - Belgelerde proje/müşteri/kişi adı yazılmaz (bkz.
.agents/rules/core-architecture.md§9). Örnekler jeneriktir:
<proje>,site.example,ornek-proje-1. - Yeni metot/fonksiyon adları İngilizce, açıklama metinleri Türkçedir
(aynı kural §10).