Kullanıcı arayüz durumu

Bir kullanıcının web uygulamasındaki düzeni tek bir tarayıcıya değil, kullanıcı hesabına aittir. İstemci modülü webapp/js/ui-state.js, adlandırılmış değerleri auth modülünün iki rotası üzerinden okur ve yazar; sunucu bunları kullanıcı başına auth_user_ui_state tablosunda saklar. Bu sayfa veri modelini, rotaları, yazma birleştirmesini, ana ekran düzeni için çakışma kuralını ve hangi tercihlerin sunucuda saklanmadığını açıklar.

Kısaca¶

• Bir satır bir kullanıcı için bir anahtar ve bir JSON değeri tutar; anahtar o kullanıcının canlı satırları arasında benzersizdir (src/cluster_erp/modules/auth/ui_state/models.py:13-35).
• GET /api/v1/auth/ui-state oturum açmış kullanıcının her anahtarını döndürür; PUT /api/v1/auth/ui-state/{key} bir değer saklar (src/cluster_erp/modules/auth/ui_state/routes.py:21-39).
• İki rota da kullanıcı kimliğini istekten değil oturumdan alır ve yalnız kimlik doğrulama ister (src/cluster_erp/modules/auth/ui_state/routes.py:15-18).
• Saklanan bir değer JSON olarak en çok 262.144 bayt olabilir (src/cluster_erp/modules/auth/ui_state/schemas.py:8-29).
• İstemci yazmaları 600 ms boyunca toplar ve sayfa gizlendiğinde veya kapandığında bekleyen yazmaları gönderir (webapp/js/ui-state.js:41-73).

Nasıl çalışır¶

Sunucu tarafı¶

Temel sütunlar ve yumuşak silme ortak temel modelden gelir; bkz. temel model ve kimlikler. Bir değerin güncellenmesi, eşlenmiş diğer her varlık gibi otomatik değişiklik geçmişine kaydedilir; bkz. değişiklik geçmişi.

İstemci tarafı¶

loadUiState() tüm anahtarları oturum başına bir kez okur ve erken çağıranlar arasında tek bir isteği paylaştırır. Başarısız bir okuma null döndürür ve yerel kopyayı kullanımda bırakır (webapp/js/ui-state.js:18-39). saveUiState(key, value) bellekteki kopyayı günceller, değeri kuyruğa alır ve 600 ms'lik bir zamanlayıcıyı yeniden başlatır; gönderim anahtar başına bir PUT ile ve bir yazma sayfa yenilemesinden sağ çıksın diye keepalive ile yapılır (webapp/js/ui-state.js:41-73). Gizliye geçen visibilitychange ve pagehide kuyruğu hemen gönderir (webapp/js/ui-state.js:58-65). Çıkış önbelleği ve kuyruğu düşürür (webapp/js/ui-state.js:75-85).

Web uygulamasının yazdığı anahtarlar¶

Benim veya Tümü kapsamı gibi bileşen ayarları düzen değerinin içinde, bileşen öğesinin cfg alanında saklanır (webapp/js/widget-scope.js:4-8).

Ana ekran düzeni çakışma kuralı¶

Ana ekran düzeni yerel depoda önbelleğe alınır ve sunucuda saklanır. Hangi kopyanın kazanacağına hydrateFromServer() karar verir (webapp/js/home.js:4565-4631):

1. Dock sabitlemeleri, son aramalar, yoğunluk ve dock'taki tuş sunucudan olduğu gibi alınır (webapp/js/home.js:4579-4589).
2. Sunucuda bu cihaz sınıfı için düzen yoksa, ilk kez görülen bir sınıf PC düzeninden başlar; aksi hâlde yerel kopya sunucuya yayımlanır (webapp/js/home.js:4590-4615).
3. İkisi de varsa her biri bir updatedAt damgası taşır. Sunucu kopyası yerel kopyanın yerini yalnız kesinlikle daha yeniyse alır; daha yeni bir yerel kopya sunucuya gönderilir (webapp/js/home.js:4616-4631).

Başarısız bir istek hiçbir şeyi değiştirmez; yerel düzen sunucuya ulaşılamadı diye hiçbir zaman atılmaz (webapp/js/home.js:4565-4570).

Yalnız tarayıcıda tutulan tercihler¶

Neden böyle kurulu¶

• webapp/js/ui-state.js:1-9 içindeki yorum, yalnız yerel depoda tutulan bir düzenin tarayıcıya, cihaza ve ana makine adına göre farklılaştığını ve temizlenen bir önbelleğin sıfırlanma gibi göründüğünü belirtir.
• Model belge dizesi, bir satırı yalnız sahibi olan kullanıcının veya onun adına hareket eden bir yöneticinin değiştirebileceğini belirtir (src/cluster_erp/modules/auth/ui_state/models.py:14-21).
• Şema yorumu, boyut tavanının bir kullanıcının kullanıcı başına ayrılan alanda keyfi miktarda veri saklamasını durdurduğunu belirtir (src/cluster_erp/modules/auth/ui_state/schemas.py:8-9).

Kurallar ve sınırlar¶

• Projenin yazılı mühendislik kuralları tarayıcı test süitlerinin web-client/_ui_state_guard.mjs kullanmasını ister. Koruma, bir süitin gerçek bir kişinin düzenini hiç değiştirmemesi için süitleri ayrılmış bir test hesabıyla çalıştırır (web-client/_ui_state_guard.mjs:1-4). Bkz. e2e bataryası.
• Tarayıcı testleri: web-client/_e2e_dock_pins.mjs, web-client/_e2e_app_wheel.mjs, web-client/_e2e_density.mjs, web-client/_e2e_mobile_home.mjs, web-client/_e2e_command_palette.mjs.

Diğer parçalarla etkileşim¶

• Karar kaydı sunucu tarafı arayüz durumu sayfasıdır.
• İki rotanın kimlik doğrulaması kimlik doğrulama ve oturumlar sayfasında anlatılır.

Sınırlar ve açık noktalar¶

• Anahtarlar istemcinin seçtiği 1 ile 60 karakter arası serbest dizelerdir; daha uzun bir anahtar işleyici çalışmadan HTTP 422 ile reddedilir (src/cluster_erp/modules/auth/ui_state/models.py:34, src/cluster_erp/modules/auth/ui_state/routes.py:33).
• Hiçbir rota bir anahtarı silmez. Koddan belirlenemedi: kullanımdan kalkan özelliklerin anahtarlarının hiç kaldırılıp kaldırılmadığı.

Tanıtılan terimler¶

İlgili sayfalar¶

• Web uygulaması platformu
• Ana ekran, dock ve başlatıcı
• Cihaz sınıfları
• Auth modülü
• Sunucu tarafı arayüz durumu

92f8051 numaralı commit ile 2026-11-13 tarihinde doğrulandı.