Ana içeriğe atla

Nasıl çalışır

Gerçek zamanlı senkronizasyona sahip uygulamalar cihazda yerel bir veritabanı tutar. Okumalar anlık (yerel), yazımlar yerel olarak sıraya alınır ve her şey arka planda sunucuya senkronize edilir.
Kullanıcı yazması -> Yerel veritabanı -> Yükleme sırası -> Sunucu -> Postgres
                                                                      |
Kullanıcı okuması <- Yerel veritabanı <- Senkronizasyon çoğaltması <-+
Sonuç: anlık okumalar, yükleme göstergeleri yok ve kötü bağlantılarda veya çevrimdışı çalışan bir uygulama.

AI’ın kurduğu şeyler

AI’dan gerçek zamanlı bir uygulama oluşturmasını isteyin. Uygun bir aktif veritabanı varsa onu yeniden kullanır; aksi takdirde bir veritabanı oluşturur, senkronizasyon hizmetini açar ve iki bölümlü bir uygulama oluşturur:
  • UI - yerel veritabanı, canlı sorgular ve senkronizasyon bağlayıcısı ile istemci uygulaması
  • Process - token uç noktası, senkronizasyon yükleme rotası ve geçiş çalıştırıcısı
Kimlik bilgileri vault içinde depolanır. AI, veritabanı ortam değişkenlerini db aracı ile process bileşenine bağlar. Uygulama hazır olarak kabul edilmeden önce, veritabanı sync: ready göstermelidir. Senkronizasyon hazır değilse, uygulama render edilebilir ancak cihazlar arası gerçek zamanlı veriler çalışmaz.

Temel kurallar

  • Önce yerel olarak yazın. Senkronizasyonun arka planda yüklemesine izin verin.
  • Yerel veriler varsa, yükleme göstergeleri değil boş durumları gösterin.
  • Kullanıcı tarafından görülen durumu senkronize edilen tablolarda tutun, böylece yenilemeler ve çevrimdışı kullanımda kalır.
  • İlgili yerel yazımları birlikte gruplandırın, böylece UI bir adımda güncellenir.
  • Gerçek zamanlı bir uygulamayı tamamlanmış olarak işaretlemeden önce senkronizasyon durumunu doğrulayın.

Çevrimdışı uygulama kabuğu

UI şablonları, uygulamanın ilk ziyaretten sonra ağ olmadan yeniden açılabilmesi için bir çevrimdışı uygulama kabuğu içerebilir. Uygulama kabuğu statik HTML, JS, CSS ve simgelerdir.
  • Çevrimdışı kabuk uygulamanın ağ olmadan açılmasını sağlar
  • Senkronizasyon uygulama verilerini çevrimdışı kullanılabilir tutar
Birlikte: uygulama ağ olmadan açılır, en son senkronize edilen verileri gösterir, yeni yazımları sıraya alır ve bağlantı geri geldiğinde senkronize olur.

Gerçek zamanlı senkronizasyon ne zaman kullanılır

İyi uyumGereksiz
Görev yöneticileri ve not uygulamalarıStatik pazarlama sayfaları
İşbirliğine dayalı araçlarTek seferlik form gönderimleri
Zayıf bağlantılı alan uygulamalarıSalt okunur broşür siteleri
Anlık hissettirilmesi gereken her şeyÇevrimdışı değeri olmayan uygulamalar

Platform değişkenleri

Kazzle, her uygulama procesine otomatik olarak küçük bir ortam değişkenleri seti enjekte eder. Bunlar kendi vault sırlarınızdan ayrıdır.
DeğişkenNe olduğu
PORTProcessinizin dinlemesi gereken port
HOSTBağlanılacak hostname (genellikle 0.0.0.0)
KAZZLE_API_URLKazzle çalışma zamanı yardımcıları tarafından kullanılan temel URL
KAZZLE_APP_COMPONENT_<NAME>_URLKardeş bileşenin çalışma zamanı URL’si

Kardeş URL’leri

Bir uygulamanın birden fazla bileşeni olduğunda (örneğin bir web UI ve bir server processi), Kazzle kardeş bileşenlerin URL’lerini enjekte edebilir:
# "web" bölümünde:
KAZZLE_APP_COMPONENT_SERVER_URL=http://localhost:3001

# "server" bölümünde:
KAZZLE_APP_COMPONENT_WEB_URL=http://localhost:3000
Bir kardeş zaten dağıtıldığında, enjekte edilen değer o dağıtılan bileşeni gösterir. Aksi takdirde o kardeş için geçerli geliştirme adresini gösterir.