Mimari
Yönetim paneli, API ve sitelerin birbiriyle nasıl konuştuğunu ve bir değişikliğin canlıya nasıl ulaştığını öğrenin.
Bu sayfada Journey AI'ın üç parçasını, kurulum modelini ve bir değişikliğin editörden canlı siteye uzanan yolculuğunu öğreneceksiniz.
Üç parça
| Parça | Görevi |
|---|---|
| Yönetim paneli | Editörlerin, onaylama izni olan kullanıcıların ve yöneticilerin çalıştığı web uygulaması. İçeriği API üzerinden okur ve yazar. |
| API | İçeriği veritabanında saklar, iş kurallarını ve yetkileri uygular, sitelere JSON sunar. Dosyalar bulut depolamada tutulur ve CDN üzerinden sunulur. |
| Site şablonu | Next.js tabanlı web sitesi. Sayfaları API'den çeker, bileşen ağacını React bileşenlerine çevirir. |
Yönetim paneli ──► API ──► Önizleme sitesi (önizleme kopyalarını gösterir)
└───► Canlı site (yalnızca yayındakini gösterir)Kurulum başına bir örnek
Her kurulumun kendi API'si, veritabanı, dosya deposu ve iki sitesi vardır. Ortak kod tüm kurulumlara dağıtılır, ancak kurulumlar arasında veri paylaşılmaz.
İki site modeli
Her kurulumda aynı site kodu iki kez dağıtılır:
- Önizleme sitesi: API'den önizleme kopyalarını ister ve önbellek kullanmaz. Yönetim panelinin bileşen düzenleyicisinde iframe içinde gösterilen site budur. Denetleyici yalnızca burada açıktır.
- Canlı site: Yalnızca yayındaki içeriği çeker ve sayfaları önbellekte tutar. Sayfalar en geç 5 dakikada bir arka planda tazelenir; kayıt anında da panelin isteğiyle hemen yenilenir.
Önizleme bir taklit değil, aynı sitenin ayrı bir kopyasıdır. Editör değişikliğin canlıda nasıl görüneceğini önceden görür.
Bir değişikliğin yolculuğu
Editör kaydeder
Editör yayındaki bir sayfanın başlığını değiştirir ve Kaydet'e tıklar.
API önizleme kopyasına yazar
Değişiklik sayfanın önizleme kopyasına yazılır, canlı kayda dokunulmaz. Önizleme kopyası yoksa o anda oluşturulur.
Siteler yenilenir
Panel iki siteye de önbellek yenileme isteği gönderir. Önizleme sitesi değişikliği hemen gösterir.
Sayfa onaya düşer
Yayındaki bir sayfada ayrı bir gönderme adımı yoktur: kayıtla birlikte durum Onay Bekliyor olur. Onaylama izni olan kullanıcı işi "Seni bekleyenler" listesinde ve bildirimlerde görür.
Onaylama izni olan kullanıcı onaylar
API önizleme kopyası ile yayındaki kaydın yerini değiştirir. Yayın başlangıç tarihi geldiyse sayfa Yayında olur, gelmediyse zamanlanır.
Canlı site güncellenir
Panel yeniden önbellek yenileme ister ve ziyaretçi yeni içeriği görür.
Durumların ayrıntısı için Yayın akışı sayfasına bakın.
Düzenleme ve onay modeli
Journey AI, editöre anında güven veren ama canlı yayın için ayrı bir kontrol katmanı sunan bir akış kullanır:
- Kaydet yalnızca önizleme kopyasını günceller; canlı kayıt dokunulmaz. Yayındaki bir sayfada kayıt, değişikliği aynı anda onaya da gönderir.
- Onaya Gönder yalnızca hiç yayınlanmamış sayfalarda kullanılır; durum Onay Bekliyor olur.
- Onayla ve Yayınla önizleme kopyası ile yayındaki kaydın yerini değiştirir. Reddet sayfayı Düzenleme Bekliyor durumuna döndürür; reddetme penceresinde gerekçe alanı yoktur. Editör düzeltip Tekrar Onaya Gönder ile yeniden gönderir.
- Önbellek yenileme hem canlı hem de önizleme siteyi ilgili sayfa için günceller; böylece arayüz ve site aynı anda senkron kalır.
Bu model, editörün "sorunsuz göründüğü" bir aracıyla, üretim güvenliği arasında denge kurar.
İçerik nasıl saklanır?
Sayfa içeriği HTML olarak saklanmaz; her sayfa bir bileşen ağacıdır. Site bu ağacı dolaşır ve her düğümü bir React bileşenine çevirir. Bu sayede panelde "ne yazıldığı", sitede ise "nasıl göründüğü" belirlenir. Aynı içerik farklı sitelerde farklı tasarımla görünebilir.