Packages/RbnFactory — içerik fabrikası ayarı ve VPS sözleşmesi

Kapsam: Bu sayfa yalnız fabrika ayar dosyasındaki direction bloğunun VPS'e giden alanlarını anlatır. Paketin tam dosya envanteri henüz yazılmadı.
Kaynak klasör: Packages/RbnFactory/ · ayar örneği: Packages/RbnFactory/factory-settings.example.php

direction.site_domain — sitenin kendi alan adı

• Biçim: yalnız alan adı, ör. site.com (şemasız, www öneksiz).
• Ne işe yarar: VPS, yazının CTA ve bağlantılarında yalnız bu alan adını bilir; başka bir alan adı içeren yazıyı reddeder. Böylece model alan adı uyduramaz.
• Boş bırakılırsa: site_alan_adi boş gider; VPS tarafında alan adı kuralı uygulanmaz (eski davranış). Canlı sitede doldurmanız önerilir.
• Örnek:

'direction' => [
    'site_note'   => 'Sitenin konusu ve bölgesi hakkında kısa not',
    'location'    => '',
    'site_domain' => 'site.com',
],

Yazı tarihleri — published_at ve modified_at (ZORUNLU sütunlar)

İçerik/yazı tablolarında published_at (yayın tarihi) ve modified_at (değişiklik tarihi) zorunlu sütunlardır. Çalışma zamanında "sütun var mı" diye bakan dal, created_at/updated_at yedeği ve "sütunsuz sitede eski davranış" YOKTUR: sütunları olmayan site blog sayfalarını çalıştıramaz (kurulum: aşağıda factory:published-at --apply). Yayındaki (is_active = 1) yazıda iki sütun HER ZAMAN dolu; pasif yazıda ikisi de NULL (public yüzeyde gösterilmez).

Kurallar (tek yol)

İçerik alanları: title, slug, summary, content, image, images, seo_title, seo_description, seo_keywords, cta, faqs, pros_cons, author_comment (JSON alanlar biçimden bağımsız karşılaştırılır). Panel (RbnStudio) düzenlemesi ve fabrika yenilemesi (FactoryAuditService::applyRenewal) aynı savePost yolundan geçer; yenileme published_at'i ileri taşımaz.

Okuma (FormatHelper, yedeksiz)

• FormatHelper::publishedAt($post) yalnız published_at okur. Görünen yayın tarihi (enrichPost), JSON-LD datePublished, RSS pubDate, kategori sırası ve liste/sitemap sıralaması buradan gelir.
• FormatHelper::modifiedAt($post) yalnız modified_at okur. JSON-LD dateModified, sitemap lastmod ve enrichPost içindeki modified_date/time/relative (eski updated_* adları aynı değerle) buradan gelir.
• created_at ve updated_at HİÇBİR içerik tarihi çıktısında okunmaz (updated_at sayfa görüntüleme sayacı gibi teknik yazmalarla da yenilenir: ON UPDATE CURRENT_TIMESTAMP).
• Liste sorgusu (ContentQueryTrait::getPosts()) published_at, modified_at seçer; varsayılan sıra ORDER BY published_at DESC.
• Yazı detayında "Güncelleme: …" metnini yalnız modified_date yayın gününden farklıysa gösterin; liste kartlarında göstermeyin.

Sitemap, feed, crawler

CrawlerMap içerik kaynağı örneği:

'blog' => [
    'model' => \Rbn\Project\App\Models\BlogPostModel::class,
    'entries_method' => 'getSitemapEntries',
    'order_by' => 'published_at',
    // ...
],

Sütunları kurma ve eski yazıları doldurma

php rbn factory:published-at --project=<anahtar> [--type=blog]          # plan (salt okunur)
php rbn factory:published-at --project=<anahtar> [--type=blog] --apply  # sütunlar + indeks + doldurma

• --apply sütunları ekleyen TEK yerdir (FactorySchemaHandler): published_at DATETIME NULL (+ indeks) ve modified_at DATETIME NULL; sütun sırası kuralı için aşağıya bakın.
• Doldurma yalnız yayındaki yazılara dokunur: published_at boşsa fabrika yazısında app_factory_jobs.published_at, yoksa scheduled_at, o da yoksa created_at ile doldurulur ve modified_at aynı değere eşitlenir; published_at dolu, modified_at boşsa modified_at = published_at olur. updated_at DEĞİŞMEZ (keepUnchanged). Pasif yazılara dokunulmaz. İkinci koşu 0 satır yazar.
• Eski sitelerde bu komut çalıştırılmadan blog çalışmaz (geriye dönük uyum yok). Yüklemeden sonra rbn cache:clear gerekir (sayfa, liste ve sitemap önbelleği).

Sütun sırası

Tablo kolon sırası kuralı (docs/kavramlar/03-veritabani-ve-kiracilik.md §8): son iki sütun sırayla updated_at, created_at. published_at ve modified_at updated_at'ten ÖNCE eklenir (FactorySchemaHandler::ensurePostPublishedAt() / ensurePostModifiedAt(), AFTER koddan hesaplanır). Sütun yanlış yerdeyse (örneğin sonda) factory:published-at --apply MODIFY … AFTER ile taşır ve created_at'i tablonun sonuna alır (ensurePostTimestampTail(); veri, tip ve ON UPDATE CURRENT_TIMESTAMP korunur); plan çıktısındaki "sütun sırası" sütunu doğru/YANLIŞ gösterir.

Kapı testi

fw-regresyon\birim\fw_icerik_tarihi_tek_kaynak.php: K1-K2 tarih çıktısında updated_at kırmızı; K3 publishedAt() / modifiedAt() yalnız kendi sütununu okur; K4 modified_at ham okuması yalnız izinli dosyalarda; K5 framework (Core/Packages/Bundles) ve proje kodunda tarih bağlamında çalışma zamanı sütun denetimi (hasColumn, hasPublishedAt…), published_at/modified_at için ?? yedeği, aynı satırda created_at/updated_at yedeği ve COALESCE(published_at|modified_at|created_at) YASAK (baseline yok; tek istisna sütunu ekleyen FactorySchemaHandler).

Sürüm notu: .github/UPGRADING.md ve .github/CHANGELOG.md [Unreleased].