dm: прямой обмен сообщениями (DM) + soundtouch + архитектура звонков

- src/dm/: dm_core/dm_crypto/dm_mailbox — прямой обмен сообщениями (DM) - lib/soundtouch-master/: vendored SoundTouch (изменение темпа/высоты аудио) - doc/dm_arch.md, doc/chat_call_arch.md: архитектура DM и звонков - tests: test_dm.c, test_dm_e2e.c - chat: рефакторинг chat_* модулей, member_sync, invite_build - chatgui/chatgui-android: синхронизация с новым API чата - lib/u_async, debug_config, utun_instance: сопутствующие изменения
2026-09-15 21:09:17 +03:00
1 parent 761f64cf76
commit 73fe99b33f
@@ -0,0 +1,93 @@
+# DM — прямой p2p чат между двумя пользователями группы
+
+## 1. Цель
+
+Возможность начать личный чат с любым пользователем доступных групп.
+Пока target offline сообщения временно хранятся на storage-узлах.
+
+## 2. Ключевые решения
+
+- Отдельная DM-подсистема (НЕ канал: без TOPO_GROUP/member_sync/merkle).
+- Идентичность детерминированная: одна ветка на пару, согласование без handshake.
+- E2E-шифрование содержимого сразу.
+- Offline-хранение: dm_mailbox на storage-узлах с флагом dm_storage.
+- Доставка: fallback — сперва проверка наличия узла в BGP-группе; доступен →
+  прямой send; нет связи → storage.
+
+## 3. Идентичность и ключи (детерминированные)
+
+    conv_id     = SHA256("utun_dm_v1" || min(node_a,node_b) || max(node_a,node_b))[..63]
+    shared      = X25519(my_x25519_priv, peer_x25519_pub)
+    content_key = SHA256(shared || "utun_dm_content")
+
+Обе стороны выводят одинаковые значения из своего privkey и pubkey пира
+(известен из общей группы). Смена x25519 у пира = новая ветка.
+
+## 4. Модель данных (SQLite, общий chats.db)
+
+    dm_conversations(conv_id TEXT PK, peer_node_id, peer_x25519 BLOB, peer_ed25519 BLOB,
+                     peer_name TEXT, last_out_seq INT, last_in_seq INT, created_at INT, last_ts INT)
+    dm_messages(conv_id TEXT, dir INT, seq INT, ts INT, author INT, ct TEXT,
+                data BLOB, sig BLOB, PRIMARY KEY(conv_id,dir,seq))
+    dm_mail(recipient INT, sender INT, conv_id TEXT, seq INT, ts INT, data BLOB, sig BLOB,
+            ttl INT, PRIMARY KEY(recipient,sender,seq))
+
+Два независимых направленных потока (A→B, B→A) с монотонным seq.
+Без chain-хеша: для 2 пиров достаточно seq + catch-up по диапазону.
+
+## 5. Доставка
+
+1. Проверка доступности: peer присутствует в BGP-группе (общая группа).
+2. Доступен → прямой send (сервис ETCP_RT_ID_DM = 0x34), ждём DM_ACK{conv_id,seq}.
+   Нет ACK за таймаут → fallback в mailbox.
+3. Нет связи → MAIL_PUT на 1..N storage-узлов.
+4. Catch-up при connect: DM_HELLO{conv_id,last_out_seq,last_in_seq} → пир досылает
+   (in_seq+1 .. out_seq).
+5. Dedup: вставка только при seq > last_in_seq.
+
+## 6. E2E-шифрование
+
+    data_enc = nonce(13B, счётчик по seq) || AES-CCM_ct || tag
+
+secure_channel уже умеет AES-CCM. Storage/relay видят только шифротекст.
+
+## 7. Storage-узлы (dm_storage)
+
+- Новый флаг dm_storage=yes в adm_tags (блок B владельца), распространяется
+  существующим member_sync без нового синка.
+- DM читает adm_tags мемберов общих групп (peers_<ch>) и кэширует storage-узлы.
+- Протокол mailbox (сервис ETCP_RT_ID_DM_MAILBOX = 0x35):
+
+      MAIL_PUT {recipient,sender,conv_id,seq,ts,data,sig}
+      MAIL_PULL {recipient, per-sender cursor}
+      MAIL_ACK {up_to_seq}
+
+  TTL 7 дней + лимит объёма, dedup по (recipient,sender,seq).
+
+## 8. Старт и anti-spam
+
+- dm_start(peer): создать беседу (вывести conv_id/ключи), обеспечить прямое
+  соединение (переиспользовать chat_sync_connect_node/node_conn_direct).
+- Пир автопринимает на первом DM_HELLO/сообщении, только если отправитель в
+  общей группе.
+
+## 9. Файлы и интеграция
+
+| Файл | Назначение |
+|------|-----------|
+| src/dm/dm_core.c/h    | беседы, send/recv, таблицы, bind 0x34, conn-события, fallback |
+| src/dm/dm_crypto.c/h  | derive + AES-CCM |
+| src/dm/dm_mailbox.c/h | storage-узел, push/pull/ack, bind 0x35 |
+
+Плюс:
+
+- src/chat/chat_member.c — бит CHAT_MEMBER_FLAG_DM_STORAGE + парсинг dm_storage.
+- utun_instance.c — dm_core_init/destroy.
+- chat_core — API dm_start/send/list + события CHAT_EVT_DM_*.
+- headless CLI — dm list/send/messages.
+- src/Makefile.am — новые источники.
+
+## 10. Сервисы ETCP
+
+    ETCP_RT_ID_DM         = 0x34
+    ETCP_RT_ID_DM_MAILBOX = 0x35