Core/Database/Models — tablo sınıfları (Master / Common / Project)

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/Database/Models/ — 34 *.php.
Envanter: 35 dosyanın 35'i aşağıda anlatıldı.

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

Her model bir tabloyu temsil eder; BaseModel'dan gelen kapsam, beyaz liste,
zaman damgası ve ilişki davranışlarını konkrete bağlar ($table,
$connection, $scoped, $timestamps, $fillable, $guarded). Model
SQL yazmaz; yalnız BaseModel/trait API'sini kullanır (Anayasa §8).

Kimler çağırır: Core/Database/Repositories/*, doğrudan
$this->model('project.user') çağıran controller'lar.

2. Dosya envanteri

2.1 Kök

2.2 Common/ (6) — database_common

2.3 Master/ (9) — database_master

2.4 Project/ (18) — database_project

Kapsama: 35/35.

3. Akış — modelin kuruluşu ve kapsam

$this->model('project.user')  → keşif → RegistryMap: 'project.user' => Models\Project\UsersModel  SystemPhysicalMapTrait.php:58
 └─ new UsersModel()
     └─ BaseModel::__construct()                       BaseModel.php:210
         ├─ $connection = 'database_project'
         └─ parent::__construct() → BaseComponent → bootConcernsContext()/bootBaseContext()
 └─ ->where(...)
     └─ QueryModelTrait::query()                       QueryModelTrait.php:44
         ├─ logModelScopeVisibility() (kapsam dışıysa saatlik ölçüm satırı)  :49
         ├─ new QueryBuilder($this->db, $this->table)  :67
         ├─ $builder->connection($this->connection)    :71-73
         └─ $scoped ise: where(project_key, aktif) ya da whereIn(project_key, [aktif, …projectScopeIncludes])  :88-108

Kapsam anahtarı çözümü BaseModel::resolveScopeProjectKey() →
getActiveProjectKey(); withProjectScope()/withoutProjectScope() klon
üretir (BaseModel.php:155).

4. Yapılandırma

5. Tuzaklar ve kurallar

1. Varsayılan kapsam KAPALI. BaseModel::$scoped = false
   (Base/Data/BaseModel.php:57); her model kararını kendi dosyasında yazar.
2. Tipli alan yeniden bildirilemez. BaseModel::$primaryKey tipsiz
   bildirilmiştir; alt sınıf string tipiyle yeniden bildirirse PHP fatal
   verir ve sınıf hiç yüklenmez (MasterRbnHeartbeatsModel.php:37).
3. $guarded alanları doğrudan yazılamaz. Yetki gerekiyorsa
   authorizeFields([...]) klonu kullanılır ve her çağrı
   MASS_ASSIGNMENT_AUTHORIZED_WRITE olarak loglanır
   (MassAssignmentTrait.php:105).
4. $fillable tanımlı değilse süzme uygulanmaz (geriye uyum kilidi).
5. Boş proje bağlamında kapsam uygulanmaz (bkz. Engine.md).
6. Heartbeat modeli şema oluşturmaz. Tablo yoksa tüm veri yolları güvenli
   varsayılana döner (RbnHeartbeatsModel.php:15, 227-236).
7. SchemaDoctorModel tablosuzdur; getTable(): string yerine
   getTableOrNull().

5.1 İçerik değişiklik tarihi: $contentFields ve modified_at

Sitemap lastmod ve JSON-LD dateModified yalnız satırın modified_at sütunundan gelir (FormatHelper::modifiedAt()). Sitemap'e giren her
içerik modeli (çekirdekte ContentCategoryModel; projede ürün gibi modeller) içerik sayılan alanları $contentFields ile bildirir:

protected array $contentFields = ['title', 'slug', 'content'];

• ContentDateModelTrait (Core/Base/Data/Traits/Model/Engine/) create() ve update() yolunda modified_at değerini MERKEZİ yazar: yeni kayıt = şimdi;
  güncellemede listedeki alanlardan biri eski satırdan GERÇEKTEN farklıysa şimdi. Aynı içerikle kayıt (boşluk, 199 = 199.00, JSON biçimi) tarihi oynatmaz
  (FormatHelper::contentChanged(); yazı tablosu ContentServiceTrait::savePost() aynı karşılaştırmayı kullanır).
• Sayaç, sıralama, görünürlük ve entegrasyon alanlarını listeye KOYMAYIN; bunları query()->update() ile yazın (model update() yolundan geçmez, modified_at oynamaz).
• $contentFields bildiren modelin tablosunda modified_at ZORUNLUDUR (çalışma zamanında hasColumn dalı yoktur). Sütunu php rbn content:modified-at --project=<anahtar> --apply
  ekler: updated_at'ten ÖNCE, son iki sütun updated_at, created_at; mevcut satırlar modified_at = updated_at (boşsa created_at) ile dolar, updated_at değişmez.
  --apply olmadan komut yalnız plan gösterir. Tablo listesi, sitemap kaynağı olan modellerin $contentFields bildirenleridir (CrawlerResolver::resolveSitemapModels()).
• Panel/servis kayıtları modelin save()/update()/create() yolundan geçmelidir; $model->where(...)->update($data) (builder) yolu modified_at yazmaz.

6. Örnek (gerçek koddan)

// Kapsamlı (scoped = true) model: proje süzgeci builder'a otomatik eklenir
$faqs = $this->model('project.faq')->where('is_active', 1)->get();

// Kapsam dışı (scoped = false) modelde süzgeç KENDİN yazılır
$all = $this->model('master.projects')->where('is_active', 1)->get();

// Korumalı alana yetkili yazma (klon döner, loglar)
$this->model('project.user')->authorizeFields(['role'])->update($id, ['role' => 'admin']);

7. İlgili belgeler

• ../README.md, ../Engine.md, Repositories.md
• ../Base/Data.md — BaseModel ve model trait'leri
• ../../kavramlar/03-veritabani-ve-kiracilik.md
• ../../acik-sorular.md §1.2 — MasterRbnHeartbeatsModel tablo adı