Server-side DM dialogs state

2026-08-22 18:31:32 +04:00
parent c70f18fcf4
commit 781157299f
13 changed files with 666 additions and 9 deletions
@@ -334,6 +334,25 @@

 ### 8.2. Новые методы, которые нужны

+### 8.3. Серверный слой диалогов
+
+Помимо хранения самих DM-сообщений сервер поддерживает материализованный слой состояния диалогов:
+
+- отдельная запись на пару `owner_login` + `peer_login`;
+- `relation_flag` со значениями `close_friend`, `contact`, `none`;
+- `last_message_blob_b64` как последний контентный signed DM block в base64;
+- `last_message_time_ms`;
+- `unread_count`;
+- `last_read_receipt_time_ms` как watermark последнего подтверждения прочтения.
+
+Ключевые правила:
+
+- `close_friend` всегда имеет приоритет над `contact`;
+- если `read receipt` приходит не по порядку, сервер хранит наибольший watermark и не откатывает состояние назад;
+- `unread_count` пересчитывается сервером по сообщениям диалога с учётом watermark и `read_at_ms`;
+- старые исторические данные восстанавливаются из `signed_messages` при инициализации/миграции;
+- UI не должен собирать inbox только из локального кеша, когда ему доступен серверный список диалогов.
+
 ## 9. Правила валидации и применения

 ### 9.1. Общее правило по ревизиям