Senkronizasyon ve çakışma çözümü politikası

1. WebSocket kanal modeli

Authenticated her operatör tenant:<user_id>:* kanal namespace'ine subscribe olabilir. Cross-user subscribe (örn. tenant:B:tasks:* A kullanıcısı tarafından) handshake düzeyinde reddedilir; bağlantı KURAL 22 fail-closed kapanır. Kanıt:

• core/routes/web_terminal.py — _ws_authenticate ?token=JWT + Bearer + lydos_sid cookie 3 yol; failure → 1008 close (sonradan nginx 4401).
• P5/P6/P7 sayfaları app.user_id GUC ile PG RLS'i beslerken WS kanalı aynı kimliğe bağlanır.

2. Çakışma çözümü — son-yazan-kazanır (LWW)

LYDOS tek-region federation DB üzerinde çalışır. İki cihaz aynı satıra (örn. chat_files.content veya user_workspace_prefs.streaming_enabled) eş zamanlı yazarsa, PostgreSQL'in serializable transaction kuyruğu doğal LWW sıralamasını uygular: updated_at sütunu her UPDATE'te now() ile yeniden yazılır, son commit sonuncu değeri sabitler.

Detay: user_workspace_prefs PUT UPSERT'i COALESCE(EXCLUDED.col, table.col) kullanır — partial PUT, dokunulmamış toggle'ları korur, yalnızca açıkça gönderilen alanlar yazılır. Bu davranış P7 wiring test'iyle pinli (test_p7_prefs_wiring.py).

3. Optimistic UI + rollback

Dashboard yüzeylerinde toggle/edit aksiyonları:

1. UI optimistically anında yeni değeri gösterir.
2. PUT/PATCH istek backend'e gider. Cevap 2xx → state korunur.
3. Cevap 4xx/5xx → UI değişikliği rollback edilir (kullanıcı önceki değeri yeniden görür) ve bir AlertTriangle banner'ı response detail alanını açıkça gösterir (P7 prefs sayfası bu disiplini örnekler).

Operatörün verbose_errors tercihi açıksa ham backend detail alanı gösterilir; kapalıysa jenerik mesaj. Toggle prefs'te canlı.

4. Reconnect + state recovery

WebSocket disconnect olduğunda client:

• Exponential backoff ile yeniden bağlanır (1s → 30s, max 10 attempt). M179 Fleet Bus WS hook'u (use-fleet-bus-ws.ts) bu modeli örnekler.
• Reconnect başarılı olunca son event_seq kümülatif sıralayıcı ile sunucudan kayıp event replay edilir.
• 20s heartbeat ile bağlantı sağlığı izlenir; üst üste 2 heartbeat kaybedilirse forced reconnect.

5. Dürüst sınırlar

Bu politika LYDOS'un BUGÜN — controlled-beta tek-region — uyguladığı kuraldır:

• Multi-region active-active replication ROADMAP (Q229). Bugün cross-region geçici disconnect olursa client backoff ile yerel region'a yeniden bağlanır.
• CRDT (conflict-free replicated data type) tabanlı offline- first sync ROADMAP — bugün offline-first deneyim PWA shell + opportunistic write queue (SW v28+) düzeyinde.
• Sub-saniye cross-device sync hedeflenir; ölçülen pencere tipik 1–5s arasıdır. p95 ölçümü sürekli load test sırasında şikayet doğurursa burada güncellenir.