Özellik Envanteri
Bu belge, WebBlocks CMS ürün özelliklerini keşfedilebilir kılmak için kullanılan kaynak envanteridir. Bir çalışma zamanı sözleşmesi değil, ürün ve operasyonel görünürlük envanteridir. Ayrıntılı teknik sözleşmeler bağlantılı dokümanlarda yer alır.
Envanter, yeni kullanıcıların ve AI/operatör iş akışlarının hangi CMS yeteneklerinin var olduğunu, yönetici/herkese açık/API yüzeylerinde nerede göründüklerini ve hangi kullanıcıya yönelik dokümantasyon sayfalarının hâlâ eksik olduğunu anlamasına yardımcı olur. Ayrıca gelecekte kaynağa bağlı bir CMS dokümantasyon sayfası için Markdown kaynak sayfası olarak da uygundur.
Envanter Sütunları
- Özellik: ürün yeteneği veya belgelenmiş yön.
- Alan: özelliğin sahibi olan ürün alanı.
- Durum: uygulandı, belgelenmiş yön, yalnızca planlandı veya daha net doküman gerekli.
- Yönetim yolu: varsa tarayıcı yönetim yüzeyi.
- Herkese açık davranış: herkese açık ziyaretçilerin veya render edilen sitelerin deneyimlediği şey.
- API desteği: Internal Content API veya keşif yüzeylerinin bunu sunup sunmadığı.
- Kaynak / uygulama notları: kısa kaynak veya uygulama bağlamı.
- Mevcut dokümanlar: depoya göreli güncel dokümantasyon bağlantıları.
- Doküman eksiği / sonraki doküman sayfası: bir sonraki dokümantasyon ihtiyacı.
Temel İçerik Modeli ve Page Builder
| Özellik | Alan | Durum | Yönetim yolu | Herkese açık davranış | API desteği | Kaynak / uygulama notları | Mevcut dokümanlar | Doküman eksiği / sonraki doküman sayfası |
|---|---|---|---|---|---|---|---|---|
| Siteler | Temel içerik | Uygulandı | /webadmin/sites | Site kapsamlı herkese açık yönlendirme, marka öğeleri, diller (locale), değişkenler ve içerik | Internal Content API üzerinden keşfedilebilir | Sayfalar, alan adları, diller (locale), medya ve gezinme için kök içerik kapsamı | docs/multisite.md, docs/core-concepts.md | kapsandı |
| Diller (Locale) / Yerelleştirme | Temel içerik | Uygulandı | /webadmin/locales, site düzenlemede diller (locale) | Dile (locale) duyarlı sayfalar ve herkese açık URL'ler | Internal Content API üzerinden keşfedilebilir | Yerelleştirilmiş sayfa çevirileri ve dil (locale) yönlendirmesi | docs/localization.md, docs/multisite.md | kapsandı |
| Sayfalar | Page Builder | Uygulandı | /webadmin/pages | Yayında olan sayfalar CMS herkese açık yönlendirmesi üzerinden render edilir | Sayfa okuma ve içerik planı desteği | İlişkisel sayfalar, çeviriler, slotlar ve bloklar | docs/core-concepts.md, docs/internal-content-api.md | kullanıcı kılavuzu gerekli |
| Sayfa Yerleşimleri | Page Builder | Uygulandı | /webadmin/page-layouts, Edit Page ayarları | Herkese açık kabuk ve slot sarmalayıcı davranışı | İçerik planlaması için keşfedilebilir | Yerleşim slotları ve body sınıflarıyla yönetilen yerleşimler | docs/page-layouts.md | kapsandı |
| Slotlar | Page Builder | Uygulandı | Edit Page slot editörü | Slot bölgeleri sayfaya ait veya ortak içeriği render eder | İçerik planları sayfaya ait slotları hedefler | Slotlar sayfa bölgelerini blok içeriğinden ayırır | docs/core-concepts.md, docs/page-layouts.md | Page Builder genel bakışı gerekli |
| Ortak Slotlar | Page Builder | Uygulandı | /webadmin/shared-slots, Edit Page slot kaynağı | Yeniden kullanılabilir site kapsamlı slot blok ağaçları sayfalarda render edilir | Ortak slot API temelleri ve atama desteği | Kopyalanan şablonlar değil, ortak içerik referansları | docs/core-concepts.md, docs/internal-content-api.md | kullanıcı kılavuzu gerekli |
| Bloklar | Page Builder | Uygulandı | Edit Page slot blok editörü | Bloklar herkese açık sayfa içeriğini render eder | Blok/içerik keşfi ve içerik planları | Çeviriler ve ayarlarla ilişkisel blok ağaçları | docs/core-concepts.md, docs/public-block-render-markup.md | Page Builder genel bakışı gerekli |
| Blok Tipi Sözleşmeleri | Page Builder | Uygulandı | /webadmin/block-types sözleşme modalı | Güvenli renderer ve editör davranışını yönlendirir | İçerik sözleşmesi ve keşif yüzeyleri blok sözleşmelerini sunar | Sözleşme kayıt defteri alanları, ayarları ve yetenekleri tanımlar | docs/block-type-contracts.md, docs/api-discovery.md | kapsandı |
| Page Builder | Page Builder | Uygulandı | Edit Page | Yerleşimler, slotlar ve bloklardan herkese açık sayfalar oluşturur | Taslak güvenli içerik doğrulama/uygulama | Sayfaya ait içerik için temel düzenleme modeli | docs/core-concepts.md, docs/ai-page-building-guide.md | Page Builder genel bakışı gerekli |
| Sayfa Varlıkları | Page Builder | Uygulandı | Edit Page -> Page Management -> Assets | Sayfa kapsamlı CSS ve JS yalnızca sahibi olan sayfada render edilir | Birincil içerik planı yüzeyi değildir | Site kapsamlı herkese açık yollar altında ilişkisel sayfa varlıkları | docs/public-assets.md, README.md | kullanıcı kılavuzu gerekli |
| Medya Kitaplığı | İçerik varlıkları | Uygulandı | /webadmin/media | Herkese açık medya dosyalarına bloklar ve varlıklar tarafından başvurulabilir | Mevcut medya referanslarının daha sonra API kullanımına açılması planlanıyor | Site kapsamlı medya yönetimi ve kullanım denetimleri | docs/core-concepts.md, docs/public-assets.md | medya kılavuzu gerekli |
| Gezinme | Herkese açık yapı | Uygulandı | /webadmin/navigation | Gezinme blokları ve menüler herkese açık gezinmeyi render eder | Gezinme API temelleri | Gruplar ve simgelerle site kapsamlı menüler ve öğeler | docs/internal-content-api.md, README.md | kullanıcı kılavuzu gerekli |
| Navbar / Üstbilgi kompozisyonu | Herkese açık yapı | Uygulandı | Page Builder blok seçici | Navbar, marka, gezinme ve üstbilgi eylemleri herkese açık üstbilgileri oluşturur | Blok sözleşmelerinde keşfedildiğinde oluşturulabilir | Sisteme ait navbar temel öğeleri ve birleştirilebilir alt öğeler | docs/public-block-render-markup.md, README.md | Page Builder genel bakışı gerekli |
| Sayfa Önizleme | Editoryal | Uygulandı | Edit Page -> Preview | Taslak, incelemede ve yayında olan sayfalar için kimlik doğrulamalı önizleme | Önizleme URL'leri operatör iş akışları tarafından raporlanabilir | noindex önizleme şeridiyle herkese açık render kullanır | docs/editorial-workflow.md, docs/internal-content-api.md | kapsandı |
| Sayfa Revizyonları | Editoryal | Uygulandı | Edit Page revizyonları | Önceki sayfa içeriğini editörler için güvenle geri yükler | Birincil API yazma yüzeyi değildir | Aktör/kaynak meta verileriyle sayfa revizyonu anlık görüntüleri | docs/revisions.md | kapsandı |
| Ortak Slot Revizyonları | Editoryal | Uygulandı | Ortak slot revizyonları | Yeniden kullanılabilir ortak içeriği geri yükler | Birincil API yazma yüzeyi değildir | Ortak slot revizyon geçmişi ve geri yükleme | docs/revisions.md | kapsandı |
| Sayfa Dönüştürücü | Page Builder | Uygulandı | /webadmin/pages, İçe Aktarma/Dönüştürme akışları | İncelenmiş statik HTML analizinden taslak CMS sayfaları oluşturur | Herkese açık bir API değil, iç içerik planlama kavramlarını kullanır | Kapsamı sınırlandırılmış HTML analizi ve imzalı dönüştürme planları | docs/page-converter-roadmap.md, README.md | kullanıcı kılavuzu gerekli |
| Tek Sayfa İçe Aktarma | Page Builder | Uygulandı | /webadmin/pages -> Import Page | Belgelenmiş bir JSON yükünden tek bir taslak sayfa oluşturur | Internal Content API'den ayrıdır | İncelenmiş tek sayfalık JSON içe aktarımı için yönetici modal iş akışı | README.md | kullanıcı kılavuzu gerekli |
Editoryal İş Akışı ve İzinler
| Özellik | Alan | Durum | Yönetim yolu | Herkese açık davranış | API desteği | Kaynak / uygulama notları | Mevcut dokümanlar | Doküman eksiği / sonraki doküman sayfası |
|---|---|---|---|---|---|---|---|---|
| Taslak / İncelemede / Yayında / Arşivlendi iş akışı | Editoryal | Uygulandı | Edit Page -> Overview | Herkese açık rotalar yalnızca yayında olan sayfaları render eder | API, içerik yazmaları için taslak öncelikli kalır | Sayfa durumları yazma, inceleme, yayınlama ve arşivlemeyi ayırır | docs/editorial-workflow.md | kapsandı |
| Editör rolü | İzinler | Uygulandı | /webadmin/users, rol yönetimi | Editörler izinleri dahilinde atanan içeriği yönetebilir | Yetkilendirme, yönetici/API erişimini etkiler | Ana ürün yönetici durumundan ayrı CMS rolü | docs/users-and-permissions.md | kapsandı |
| Site Yöneticisi rolü | İzinler | Uygulandı | /webadmin/users, rol yönetimi | Site yöneticileri atanan site içeriğini yönetir | Yetkilendirme, yönetici/API erişimini etkiler | Site kapsamlı yönetim rolü | docs/users-and-permissions.md | kapsandı |
| Süper Yönetici rolü | İzinler | Uygulandı | /webadmin/users, rol yönetimi | Kurulum düzeyinde CMS yönetimi | Token ve sistem işlemleri için gereklidir | CMS süper yöneticisi, ana uygulama yönetici durumu değil bir CMS rolüdür | docs/users-and-permissions.md, ARCHITECTURE_DECISIONS.md | kapsandı |
| Atanmış site erişimi | İzinler | Uygulandı | Kullanıcı yönetimi | Yönetim çalışmasını atanmış sitelerle sınırlar | API yetkilendirmesi için geçerlidir | Site üyelikleri CMS erişimini kısıtlar | docs/users-and-permissions.md, docs/multisite.md | kapsandı |
| İş akışı geçişleri | Editoryal | Uygulandı | Edit Page -> Overview | Sayfaların ne zaman herkese açık hale gelebileceğini veya yayından çıkabileceğini denetler | Yayınlama iş akışı normal içerik planlarından ayrı kalır | Geçiş izinleri editoryal durum değişikliklerini korur | docs/editorial-workflow.md | kapsandı |
| Yayınlama izinleri | İzinler | Uygulandı | Rol/kullanıcı izinleri | Herkese açık sayfaları kimin yayınlayabileceğini belirler | Yayınlama API yeteneği gelişmiş bir özelliktir ve ayrıdır | AI/operatör yazmaları için yayınlama kasıtlı olarak varsayılan değildir | docs/editorial-workflow.md, docs/internal-content-api.md | AI/operatör örneği gerekli |
| Arşivleme izinleri | İzinler | Uygulandı | Rol/kullanıcı izinleri | Herkese açık yayından kaldırmayı denetler | Normal bir içerik planı davranışı değildir | Arşivleme yıkıcı silme değil, editoryal iş akışıdır | docs/editorial-workflow.md | kapsandı |
| Revizyon geri yükleme izinleri | İzinler | Uygulandı | Sayfa ve ortak slot revizyon ekranları | Geri yüklenen içerik, yayınlandıktan sonra gelecekteki herkese açık render'ı etkiler | Normal bir içerik planı davranışı değildir | Geri yükleme akışları CMS yetkilendirmesi gerektirir | docs/revisions.md | kapsandı |
| CMS profil sayfası | Yönetici UX | Uygulandı | /webadmin/profile | Doğrudan herkese açık davranışı yoktur | API odaklı değildir | Oturum açmış yöneticiler kendi profillerini yönetir | README.md | kullanıcı kılavuzu gerekli |
| Kurulum düzeyi kullanıcılar | İzinler | Uygulandı | /webadmin/users | Doğrudan herkese açık davranışı yoktur | Yetkilendirme, API token'larını ve erişimi etkiler | CMS kullanıcı yönetimi, CMS rollerini ana uygulama kullanıcılarına bağlar | docs/users-and-permissions.md | kapsandı |
Herkese Açık Site Özellikleri
| Özellik | Alan | Durum | Yönetim yolu | Herkese açık davranış | API desteği | Kaynak / uygulama notları | Mevcut dokümanlar | Doküman eksiği / sonraki doküman sayfası |
|---|---|---|---|---|---|---|---|---|
| Herkese açık sayfa render'ı | Herkese açık site | Uygulandı | Page Builder ve herkese açık ayarlar | Yayında olan CMS sayfalarını yerleşimler, slotlar ve bloklardan render eder | İçerik planları render edilebilir taslak sayfalar oluşturabilir | Herkese açık presenter; siteleri, sayfaları, slotları, ortak slotları ve blokları çözümler | docs/core-concepts.md, docs/public-block-render-markup.md | Page Builder genel bakışı gerekli |
| Herkese açık arama | Herkese açık site | Uygulandı | Maintenance -> Search Rebuild, herkese açık arama ayarları | Site/dil (locale) kapsamlı herkese açık arama sonuçları | Bir teslim API'si değildir | Veritabanı destekli arama dizini | docs/search.md | kapsandı |
| Arama modalı | Herkese açık site | Uygulandı | Header Actions bloğu ve herkese açık varlıklar | Üstbilgiden tetiklenen arama modalı | API odaklı değildir | CMS'ye ait herkese açık arama modalı çalışma zamanını kullanır | docs/search.md, README.md | kapsandı |
| Search Form bloğu | Herkese açık bloklar | Uygulandı | Page Builder blok seçici | Herkese açık arama formunu render eder | Blok sözleşmelerinde keşfedildiğinde oluşturulabilir | Blok tabanlı arama giriş noktası | docs/search.md, docs/public-block-render-markup.md | kapsandı |
| Ziyaretçi Raporları | Analitik | Uygulandı | /webadmin/visitor-reports | Gizlilik açısından güvenli herkese açık trafik raporlaması | Herkese açık bir teslim API'si değildir | Ziyaretçi olayı toplamları ve raporlama | README.md | kullanıcı kılavuzu gerekli |
| Site Marka Öğeleri / SEO varsayılanları | Herkese açık site | Uygulandı | Edit Site -> Branding, SEO Defaults | Herkese açık meta veri geri dönüşü (fallback) ve marka varlıkları | Site keşif yüzeyleri bağlamı sunar | Siteye ait görünen ad, slogan, SEO varsayılanları, favicon, sosyal görsel | docs/core-concepts.md, README.md | kullanıcı kılavuzu gerekli |
| Sayfa düzeyinde SEO geçersiz kılmaları | Herkese açık site | Uygulandı | Sayfa çevirisi ayarları | Dile (locale) duyarlı sayfa meta verisi geçersiz kılmaları | Sayfa okuma yüzeyleri sayfa meta verisi bağlamını içerir | SEO değerleri sayfa çevirilerinde tutulur | README.md, docs/localization.md | kullanıcı kılavuzu gerekli |
| Favicon / sosyal görsel | Herkese açık site | Uygulandı | Edit Site -> Branding | Herkese açık favicon ve sosyal önizleme geri dönüşleri | Birincil API yazma yüzeyi değildir | Site düzeyinde marka medyası desteği | README.md | kullanıcı kılavuzu gerekli |
| Site değişkenleri | Herkese açık site | Uygulandı | Edit Site -> Variables | Desteklenen herkese açık render'da {{ site.variable_key }} belirteçlerini değiştirir | Birincil API yazma yüzeyi değildir | İlişkisel, yeniden kullanılabilir, site kapsamlı metin belirteçleri | README.md | kullanıcı kılavuzu gerekli |
| Çoklu site yönlendirmesi | Herkese açık site | Uygulandı | /webadmin/sites, alan adı yönetimi | İstekleri eşleşen siteye/alan adına yönlendirir | Site keşfi operatör bağlamını destekler | Site başına birincil ve takma ad alan adları | docs/multisite.md, docs/coexistence.md | kapsandı |
| Yerelleştirilmiş herkese açık URL'ler | Herkese açık site | Uygulandı | Diller (locale) ve sayfa çevirileri | Dile (locale) duyarlı sayfa yolları ve geri dönüşler | Dil (locale) keşfi operatör bağlamını destekler | Sayfa çevirileri ve dil (locale) yönlendirmesi | docs/localization.md | kapsandı |
Formlar ve Mesajlar
Contact Form (İletişim Formu) ve Contact Messages (İletişim Mesajları), WebBlocks CMS'nin birinci sınıf özellikleridir. Kullanıcıya yönelik kurulum, gönderim, spam işleme, e-posta geri dönüşü ve sorun giderme kılavuzu artık docs/contact-forms-and-messages.md içinde yer alıyor.
| Özellik | Alan | Durum | Yönetim yolu | Herkese açık davranış | API desteği | Kaynak / uygulama notları | Mevcut dokümanlar | Doküman eksiği / sonraki doküman sayfası |
|---|---|---|---|---|---|---|---|---|
| Contact Form bloğu | Formlar | Uygulandı | Page Builder blok seçici | Herkese açık bir form render eder ve gönderimleri saklar | contact_form keşfedildiğinde içerik planları aracılığıyla oluşturulabilir | Alıcı geri dönüş desteğine sahip birinci sınıf blok | docs/contact-forms-and-messages.md, docs/block-type-contracts.md, docs/public-block-render-markup.md | kapsandı |
| Contact Messages yönetim ekranı | Formlar | Uygulandı | /webadmin/contact-messages | Herkese açık liste yoktur; gönderimleri yöneticiler inceler | Herkese açık bir teslim API'si değildir | Yönetici tablosu teslim ve spam durumunu içerir | docs/contact-forms-and-messages.md, README.md | kapsandı |
| İletişim formu gönderim depolama | Formlar | Uygulandı | Contact Messages | Gerçek herkese açık gönderimleri inceleme için saklar | API odaklı değildir | Gönderimler, e-posta bildirimi denemelerinden önce saklanır | docs/contact-forms-and-messages.md | kapsandı |
| Spam önleme denetimiyle eleme | Formlar | Uygulandı | Contact Form renderer ve gönderim işleme | Oluşturulan denetim alanı doldurulmuş gönderimler normal başarı yönlendirmesi alır ve elenir | API odaklı değildir | Yerel renderer tarafından oluşturulan, CMS'ye ait gizli .wb-form-check | docs/contact-forms-and-messages.md | kapsandı |
| Spam puanlama / karantina | Formlar | Uygulandı | Contact Messages | Şüpheli gönderimler yönetici incelemesi için karantinaya alınabilir | API odaklı değildir | Bağlantılar, ticari kalıplar ve tekrarlanan IP'ler için temkinli spam sinyalleri | docs/contact-forms-and-messages.md | kapsandı |
| E-posta bildirimi geri dönüş zinciri | Formlar | Uygulandı | Contact Form bloğu, Edit Site -> Contact, ortam e-postası | Alıcı çözümlemesini blok, site ve güvenli e-posta geri dönüşünden dener | API odaklı değildir | Teslim denemeleri kalıcı depolamadan sonra gerçekleşir; kurulum rehberi .env dosyasını, site alıcılarını ve önbellek temizlemeyi kapsar | docs/contact-forms-and-messages.md, docs/installation.md, docs/getting-started.md | kapsandı |
| İletişim e-postası tanılama komutu | Operasyonlar | Uygulandı | Operatör tarafı tanılama | Herkese açık davranışı yoktur | API odaklı değildir | Gizli bilgileri koruyan e-posta yapılandırma tanılaması ve kontrollü SMTP gönderim denetimleri | docs/contact-forms-and-messages.md, docs/operations.md, README.md | kapsandı |
| Teslim durumu / hata ayrıntıları | Formlar | Uygulandı | Contact Messages | Herkese açık hata ifşası yoktur | API odaklı değildir | Kaydedilen mesajlar, yöneticinin görebildiği bildirim durumunu içerir | docs/contact-forms-and-messages.md | kapsandı |
Internal Content API ve AI Operasyonları
Internal Content API, güvenilir AI/operatör araçları içindir. Herkese açık bir teslim API'si, bir AI sağlayıcı entegrasyonu veya bir içe/dışa aktarma alternatifi değildir. AI/operatör araçları canlı keşif kullanmalı ve blok tanıtıcılarını (handle) tahmin etmemelidir.
Önerilen ek dokümanlar:
docs/ai-page-building-overview.md- docs/contact-forms-and-messages.md artık mevcut.
- docs/markdown-docs-to-cms-sync.md zaten mevcut.
| Özellik | Alan | Durum | Yönetim yolu | Herkese açık davranış | API desteği | Kaynak / uygulama notları | Mevcut dokümanlar | Dokümantasyon eksiği / sonraki doküman sayfası |
|---|---|---|---|---|---|---|---|---|
| API Token'ları | AI operasyonları | Uygulandı | /webadmin/system/api-tokens | Herkese açık davranış yok | Bearer token ile kimlik doğrulama | Token'lar hash'lenir ve yalnızca bir kez gösterilir | docs/internal-content-api.md, docs/api-discovery.md | kapsandı |
| Token yetenekleri | AI operasyonları | Uygulandı | API token oluşturma/düzenleme | Herkese açık davranış yok | Yetenek kapsamlı API yetkilendirmesi | Yayınlama/silme yetenekleri gelişmiş, isteğe bağlı seçeneklerdir | docs/internal-content-api.md | AI/operatör örneği gerekiyor |
| API keşif uç noktası | AI operasyonları | Uygulandı | Tarayıcı yönetim yolu yok | Herkese açık davranış yok | Güvenilir araçlar için keşif kökü | API temel URL'si ve token ile başlar | docs/api-discovery.md | kapsandı |
| OpenAPI uç noktası | AI operasyonları | Uygulandı | Tarayıcı yönetim yolu yok | Herkese açık davranış yok | Makine tarafından okunabilir API sözleşmesi | Keşiften bağlantılıdır | docs/api-discovery.md, docs/internal-content-api.md | kapsandı |
| AI kılavuz uç noktası | AI operasyonları | Uygulandı | Tarayıcı yönetim yolu yok | Herkese açık davranış yok | Keşiften kılavuz bağlantısı | Operatörlerin güvenle içerik oluşturmasına yardımcı olur | docs/ai-page-building-guide.md | genel bakış gerekiyor |
| İçerik sözleşmesi uç noktası | AI operasyonları | Uygulandı | Tarayıcı yönetim yolu yok | Herkese açık davranış yok | Blok/içerik sözleşmesi keşfi | İçerik planlamasından önce gereklidir | docs/api-discovery.md, docs/block-type-contracts.md | kapsandı |
| Örnekler uç noktası | AI operasyonları | Uygulandı | Tarayıcı yönetim yolu yok | Herkese açık davranış yok | Örnek içerik planı keşfi | Keşiften bağlantılıdır | docs/api-discovery.md | AI/operatör örneği gerekiyor |
| Sayfa okuma API'si | AI operasyonları | Uygulandı | Tarayıcı yönetim yolu yok | Herkese açık davranış yok | Salt okunur sayfa inceleme | Dahili API altında kaynak tarzı uç nokta | docs/internal-content-api.md | kapsandı |
| Blok/içerik keşfi | AI operasyonları | Uygulandı | Tarayıcı yönetim yolu yok | Herkese açık davranış yok | Blok sözleşmesi ve içerik inceleme | Tahmine dayalı blok handle'larını önler | docs/block-type-contracts.md, docs/api-discovery.md | kapsandı |
| İçerik doğrulama (validate) | AI operasyonları | Uygulandı | Tarayıcı yönetim yolu yok | Herkese açık davranış yok | İçerik planlarını uygulamadan (apply) önce doğrular | Operatör iş akışları için zorunlu güvenlik adımı | docs/internal-content-api.md, docs/ai-page-building-guide.md | kapsandı |
| İçerik uygulama (apply) | AI operasyonları | Uygulandı | Tarayıcı yönetim yolu yok | Taslak CMS içeriği oluşturur, varsayılan olarak herkese açık değildir | Onaylanan içerik planlarını uygular | Varsayılan olarak önce taslak ve yıkıcı olmayan davranış | docs/internal-content-api.md, docs/ai-page-building-guide.md | kapsandı |
| Taslak güvenli sayfa oluşturma | AI operasyonları | Uygulandı | Oluşturulan sayfa Pages ekranında görünür | Taslak sayfalar yayından önce önizlenebilir | İçerik planları aracılığıyla desteklenir | Sayfalar, slotlar, çeviriler ve blok ağaçları oluşturur | docs/internal-content-api.md | AI/operatör örneği gerekiyor |
| replace_existing_draft_page / taslak güvenli değiştirme modeli | AI operasyonları | Uygulandı | Pages içindeki mevcut taslak sayfa | Yalnızca taslak sayfaya ait yönetilen slotları değiştirir | Desteklenen validate/apply modu | Beklenen yol veya updated-at güvenlik korumalarını kullanır | docs/internal-content-api.md, docs/markdown-docs-to-cms-sync.md | AI/operatör örneği gerekiyor |
| Gezinme API temelleri | AI operasyonları | Uygulandı | Yönetim panelindeki gezinme kaynakları | Planlanan içerik, onaydan sonra herkese açık gezinmeyi etkileyebilir | Gezinme menüsü/öğesi temelleri | Geniş yıkıcı davranış içermeyen güvenli temeller | docs/internal-content-api.md | AI/operatör örneği gerekiyor |
| Ortak slot API temelleri | AI operasyonları | Uygulandı | Ortak slot yönetimi | Ortak içerik onaydan sonra sayfalar arasında görüntülenebilir | Ortak slot ve atama temelleri | Uyumlu, aynı site içi atama desteği | docs/internal-content-api.md | AI/operatör örneği gerekiyor |
| Yalnızca JSON hatalar | AI operasyonları | Uygulandı | Tarayıcı yönetim yolu yok | Herkese açık davranış yok | API hataları JSON döndürür | Operatör API'sini tarayıcı yönetim yanıtlarından ayırır | docs/internal-content-api.md | kapsandı |
| CSRF gerektirmeyen Bearer API yazma davranışı | AI operasyonları | Uygulandı | Tarayıcı yönetim yolu yok | Herkese açık davranış yok | Bearer yazma işlemleri tarayıcı CSRF'sine bağlı değildir | Operatör araçları için güvenilir token sözleşmesi | docs/internal-content-api.md | kapsandı |
| Önizleme URL raporlama | AI operasyonları | Uygulandı | Edit Page önizlemesi | Operatörler taslak önizlemelerini inceleyebilir | Apply yanıtları önizleme bağlamını raporlayabilir | Önizleme kimliği doğrulanmış ve taslak güvenli kalır | docs/ai-page-building-guide.md, docs/editorial-workflow.md | kapsandı |
| Önce-taslak AI sayfa oluşturma iş akışı | AI operasyonları | Uygulandı | Sayfalar ve önizleme ekranları | AI tarafından oluşturulan sayfalar onaylanana kadar taslaktır | Keşif, doğrulama (validate), uygulama (apply) iş akışı | Canlı keşif ve birebir sözleşmeler gerektirir | docs/ai-page-building-guide.md | docs/ai-page-building-overview.md gerekiyor |
| Markdown dokümanlarından CMS'ye senkronizasyon runbook'u | Dokümantasyon | Belgelenmiş yön | Çalışma zamanı yönetim yolu yok | Gelecekteki kaynağa bağlı doküman sayfaları Markdown'dan türetilen içeriği yayınlayabilir | Keşif, doğrulama ve onaylı taslak güvenli uygulama iş akışlarını kullanır | Markdown kaynağı otoriter kalır ve değişen docs/ dosyaları AI/operatör planlamasını yönlendirir | docs/markdown-docs-to-cms-sync.md | kapsandı |
Operasyonlar
| Özellik | Alan | Durum | Yönetim yolu | Herkese açık davranış | API desteği | Kaynak / uygulama notları | Mevcut dokümanlar | Dokümantasyon eksiği / sonraki doküman sayfası |
|---|---|---|---|---|---|---|---|---|
| Sistem Güncellemeleri | Operasyonlar | Uygulandı | /webadmin/system/updates | Kurulu CMS kodunu ve paket varlıklarını günceller | Herkese açık bir dağıtım API'si değil | Paket yerlisi güncelleme akışı | docs/updates.md, docs/operations.md | operatör kılavuzu gerekiyor |
| Sürüm paketi güncellemeleri | Operasyonlar | Uygulandı | Sistem Güncellemeleri | Onaylanan güncellemeden sonra herkese açık site davranışı değişir | API odaklı değil | Paket sürüm artefaktlarını kullanır | docs/updates.md, docs/package-architecture.md | operatör kılavuzu gerekiyor |
| Paket yerlisi güncelleme kökü | Operasyonlar | Uygulandı | Sistem Güncellemeleri | Doğrudan herkese açık davranış yok | API odaklı değil | Kanonik paket kökü vendor/fklavyenet/webblocks-cms | docs/package-architecture.md, ARCHITECTURE_DECISIONS.md | kapsandı |
| Güncelleme migration'ları | Operasyonlar | Uygulandı | Sistem Güncellemeleri | Çalışma zamanının gerektirdiği şemayı hizalı tutar | API odaklı değil | Paket güncelleme migration'ları mevcut kurulumları destekler | docs/updates.md, ARCHITECTURE_DECISIONS.md | kapsandı |
| Güncelleme hazırlığı | Operasyonlar | Uygulandı | Sistem Güncellemeleri | Herkese açık davranış yok | API odaklı değil | Güncellemeden önce hazırlık ve sürüm ayrıntısı kontrolleri | docs/updates.md | operatör kılavuzu gerekiyor |
| Son güncelleme çalıştırması | Operasyonlar | Uygulandı | Sistem Güncellemeleri | Herkese açık davranış yok | API odaklı değil | Operatörler için son çalıştırma raporlaması | docs/updates.md, README.md | operatör kılavuzu gerekiyor |
| Destek raporu | Operasyonlar | Uygulandı | Sistem Güncellemeleri | Herkese açık davranış yok | API odaklı değil | Güncelleme sorunları için indirilebilir destek tanılamaları | docs/updates.md | operatör kılavuzu gerekiyor |
| Yedeklemeler | Operasyonlar | Uygulandı | /webadmin/backups | Site içeriğini ve kurulum durumunu korur | API odaklı değil | Yedekleme kayıtları ve depolama diski | docs/operations.md | kapsandı |
| Geri yükleme | Operasyonlar | Uygulandı | /webadmin/backups geri yükleme akışı | Geri yüklenen içerik herkese açık siteyi etkileyebilir | API odaklı değil | Kontrollü yedek geri yükleme iş akışı | docs/operations.md | kapsandı |
| Site Dışa/İçe Aktarma | Operasyonlar | Uygulandı | /webadmin/site-transfers/exports, /webadmin/site-transfers/imports | Site içeriğini kurulumlar arasında taşır | Internal Content API'den ayrıdır | İçeriği, medyayı, gezinmeyi ve ilgili site verilerini paketler | docs/operations.md, README.md | kullanıcı kılavuzu gerekiyor |
| Site Klonlama / Terfi | Operasyonlar | Uygulandı / belgelendi | Site ve terfi iş akışları | Klonlanan/terfi ettirilen site içeriği herkese açık hale gelebilir | Herkese açık bir dağıtım API'si değil | Paket tabanlı site aktarımı ve terfi kavramları | docs/operations.md, README.md | operatör kılavuzu gerekiyor |
| Arama Yeniden Oluşturma | Operasyonlar | Uygulandı | Maintenance -> Search Rebuild | Herkese açık arama dizinini yeniler | API odaklı değil | Veritabanı destekli herkese açık aramayı yeniden oluşturur | docs/search.md, docs/operations.md | kapsandı |
| Katalog onarım komutları | Operasyonlar | Uygulandı | Operatör tarafı bakım | Yönetim/görüntüleme tarafından kullanılan CMS kataloglarını onarır | API odaklı değil | Katalog tutarlılığı için bakım komutları | docs/operations.md, README.md | operatör kılavuzu gerekiyor |
| Kurulum sihirbazı | Kurulum | Uygulandı | İlk çalıştırma kurulum ekranları | İlk CMS kurulum durumunu oluşturur | API odaklı değil | Tarayıcı rehberliğinde ilk kurulum | docs/installation.md | kapsandı |
| Paket tüketicisi kurulumu | Kurulum | Uygulandı | Paket kurulum iş akışı | Bir host uygulamada CMS herkese açık/yönetim rotalarını etkinleştirir | API odaklı değil | Paket kurucusu şemayı, varlıkları ve ilk kullanıcıyı hazırlar | docs/installation.md, README.md | kapsandı |
| Native yerel geliştirme | Geliştirme | Dokümanlar hazırlandı | Yalnızca yerel geliştirme | Yerel .test geliştirme ortamı | API odaklı değil | Yalnızca HTTPS yerel geliştirme rehberliği | docs/native-local-development.md | kapsandı |
| Test stratejisi | Geliştirme | Dokümanlar hazırlandı | Geliştirme iş akışı | Doğrudan herkese açık davranış yok | API odaklı değil | Risk temelli test betikleri ve doğrulama rehberliği | docs/testing-strategy.md | kapsandı |
Eklenti Sistemi
| Özellik | Alan | Durum | Yönetim yolu | Herkese açık davranış | API desteği | Kaynak / uygulama notları | Mevcut dokümanlar | Dokümantasyon eksiği / sonraki doküman sayfası |
|---|---|---|---|---|---|---|---|---|
| Eklenti barındırma mimarisi | Eklentiler | Temelleri uygulandı | /webadmin/system/plugins | Eklentiler etkinleştirildiğinde herkese açık davranış ekleyebilir | Genel amaçlı herkese açık bir API değil | CMS çekirdeği bir eklenti barındırıcısıdır | docs/plugin-system.md, ARCHITECTURE_DECISIONS.md | kapsandı |
| Elle ZIP eklenti kurulumu | Eklentiler | Uygulandı | System -> Plugins -> Upload | Kurulan eklentiler varsayılan olarak devre dışıdır | API odaklı değil | Depolamaya ait kurulum yolu ve paket doğrulaması | docs/plugin-system.md | eklenti yaşam döngüsü kılavuzu gerekiyor |
| Varsayılan olarak devre dışı eklenti yaşam döngüsü | Eklentiler | Uygulandı | System -> Plugins | Devre dışı eklentiler etkisizdir | API odaklı değil | Kurulan paketler açıkça etkinleştirilmelidir | docs/plugin-system.md | kapsandı |
| Etkinleştir / devre dışı bırak | Eklentiler | Uygulandı | System -> Plugins | Etkin eklenti davranışını devreye alır veya kaldırır | API odaklı değil | Uyumluluk ve kurulum kontrolleri etkinleştirmeyi korur | docs/plugin-system.md | eklenti yaşam döngüsü kılavuzu gerekiyor |
| Eklenti kurulumu / migration'lar | Eklentiler | Temelleri uygulandı | Eklenti ayrıntı/kurulum ekranları | Rotalar çalışmadan önce eklenti davranışı kurulum gerektirebilir | API odaklı değil | Eksik eklentiye ait tablolar kontrollü kurulum rehberliği gösterir | docs/plugin-system.md | eklenti yaşam döngüsü kılavuzu gerekiyor |
| Eklenti izinleri | Eklentiler | Uygulandı | Rol/kullanıcı izin yönetimi | Eklenti yönetim rotalarına erişimi denetler | API odaklı değil | İzinler handle önekiyle tanımlanır | docs/plugin-system.md | kapsandı |
| Eklenti yönetim rotaları | Eklentiler | Uygulandı | /webadmin/plugins/{plugin-handle} | Etkinleştirildiğinde eklentinin tarayıcı yönetim davranışı | API odaklı değil | Rotalar yalnızca etkin durumda çalışır ve ad alanıyla korunur | docs/plugin-system.md | kapsandı |
| Eklenti sağlık/durum bilgisi | Eklentiler | Uygulandı | System -> Plugins | Doğrudan herkese açık davranış yok | API odaklı değil | Sağlık kontrolleri ve uyumluluk durumu | docs/plugin-system.md | kapsandı |
| Eklentiye ait bloklar/blok paketleri | Eklentiler | Temelleri uygulandı | Eklenti etkinken blok seçici | Eklenti blokları herkese açık içerik görüntüleyebilir | Blok sözleşmeleri açığa çıkardığında keşfedilebilir | Eklenti blok handle'ları eklentiye aittir | docs/plugin-system.md, docs/block-type-contracts.md | eklenti yaşam döngüsü kılavuzu gerekiyor |
| Herkese açık varlık kancaları | Eklentiler | Temelleri uygulandı | Eklenti kaydı | Eklentiler güvenli herkese açık varlıklar ekleyebilir | API odaklı değil | Güvenli head ve body sonu katkı kancaları | docs/plugin-system.md | kapsandı |
| Eklenti Kataloğu tarayıcısı | Eklentiler | Uygulandı | System -> Plugins -> Browse Plugin Catalog | Doğrudan herkese açık site davranışı yok | Katalog meta verilerini okur, herkese açık bir dağıtım API'si değildir | Herkese açık katalog meta verisi tarama | docs/plugin-system.md, docs/plugin-ecosystem-and-catalog.md | eklenti yaşam döngüsü kılavuzu gerekiyor |
| Katalogdan kurulum | Eklentiler | Uygulandı | Eklenti Kataloğu ayrıntısı | Kurulan eklenti etkinleştirilene kadar devre dışı kalır | API odaklı değil | Sağlama toplamı doğrulanmış katalog artefaktı kurulumu | docs/plugin-system.md | eklenti yaşam döngüsü kılavuzu gerekiyor |
| Katalog destekli eklenti güncellemeleri | Eklentiler | Uygulandı | System -> Plugins | Onaylanan güncellemeden sonra güncellenmiş eklenti davranışı | API odaklı değil | Sağlama toplamı ve paket doğrulama yolunu yeniden kullanır | docs/plugin-system.md | eklenti yaşam döngüsü kılavuzu gerekiyor |
| Elle kaldırma | Eklentiler | Uygulandı | System -> Plugins | Devre dışı olan yüklenmiş eklenti paketini kaldırır | API odaklı değil | Eklentiye ait veritabanı tablolarını korur | docs/plugin-system.md | kapsandı |
| Paketle gelen bir CMS çekirdek özelliği değil, operatör eklentisi olarak WebBlocks UI Manager | Eklentiler | Mimari uygulandı | Yalnızca elle yüklenip etkinleştirildiğinde kurulur | Olağan CMS çalışma zamanı davranışı yok | API odaklı değil | Birinci taraf operatör eklentisi paketlenmiş çekirdeğin dışında kalır | docs/plugin-system.md, ARCHITECTURE_DECISIONS.md | kapsandı |
Dokümantasyon ve Ürün Sitesi Hazırlığı
Mevcut dokümanlar teknik açıdan zengin olsa da özellik keşfedilebilirliği eksiktir. Bu envanter, hangi kullanıcıya dönük doküman sayfalarının eksik olduğuna ve hangi kaynak sayfaların daha sonra hedef bir dokümantasyon sitesinde kaynağa bağlı dokümantasyon sayfaları olarak yayınlanabileceğine karar vermeye yardımcı olmalıdır.
Öncelikli dokümantasyon sayfaları:
- AI Sayfa Oluşturma Genel Bakışı
- Sayfa Oluşturucu Genel Bakışı
- Özellik Envanteri
- Formlar / Mesajlar sorun giderme
- Eklenti yaşam döngüsü kılavuzu
- Sistem Güncellemeleri operatör kılavuzu
webblocksui.com pazarlama içeriği teknik dokümantasyondan ayrı kalmalıdır. Pazarlama sayfaları ürün değerini özetleyebilir; teknik ve operatör rehberliği için ise kaynak, Markdown dokümantasyonu olmaya devam etmelidir.