mirror of
https://github.com/Govor-team/Govor.git
synced 2026-11-21 14:28:20 +00:00
Add forwarding, friend controls, and benefits
Add message forwarding and reply lookup, friend removal and blocking endpoints, and database-backed Govor+ privileges with customizable profile tags. Include migrations, integration tests, and updated API and operations documentation.
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
# ChatsHub — сообщения
|
||||
|
||||
Подключение: `/hubs/chats`, Bearer access token и активная сессия. Команды возвращают `HubResult<T>` (status, result, errorMessage); события приходят независимо от ответа команды. Этот раздел описывает рабочую копию с исправлениями от 04.10.2026.
|
||||
Подключение: `/hubs/chats`, Bearer access token и активная сессия. Команды возвращают `HubResult<T>` (status, result, errorMessage); события приходят независимо от ответа команды. Контракт сверяется с серверной ревизией, указанной в обзоре.
|
||||
|
||||
## Команды
|
||||
|
||||
@@ -24,7 +24,7 @@
|
||||
}
|
||||
```
|
||||
|
||||
RecipientType.User=0 означает личный чат: recipientId — PrivateChat.Id. Group=1 означает ChatGroup.Id. Вложение: `{ mediaId, encryptedKey }`. Содержимое или вложение обязательно; Send ограничивает текст 50 000 символами. SignalR не выполняет MVC DataAnnotations автоматически. DTO проверки дополняются сервисами доступа.
|
||||
RecipientType.User=0 означает личный чат: recipientId — PrivateChat.Id. Group=1 означает ChatGroup.Id. Вложение: `{ mediaId, encryptedKey }`; для E2EE encryptedKey пустой, секрет находится внутри ciphertext. encryptedContent — подписанный конверт с префиксом govor.e2ee.v1:, максимум 1 000 000 символов; до 100 уникальных вложений. Даже сообщение только с файлом содержит E2EE-конверт. Транспортный лимит входящего SignalR-сообщения — 1 100 000 байт, поэтому учитывайте JSON-overhead. SignalR не выполняет MVC DataAnnotations автоматически. DTO проверки дополняются сервисами доступа.
|
||||
|
||||
Send/Read/React и чтение истории проверяют участие в конкретном чате. В группах заблокированный участник не имеет доступа. Reply и вложения не позволяют ссылаться на чужие закрытые чаты. Edit проверяет автора, доступ и временной лимит редактирования. Remove проверяет автора/права администратора группы; HideForMe пока не реализован и возвращает ошибку, ForceRemove удаляет сообщение.
|
||||
|
||||
@@ -45,7 +45,7 @@ Send/Read/React и чтение истории проверяют участие
|
||||
| GroupProfileChanged | GroupProfileChangedResponse: `{ groupId }` |
|
||||
| GroupMemberChanged | GroupMemberChangedResponse: `{ groupId, userId, status, role }` |
|
||||
|
||||
Опечатка MessageReaded сохранена для совместимости. При подключении сервер автоматически добавляет соединение в группу его сессии. События чата направляются активным сессиям участников; заблокированные участники групп исключаются. Не требуется вручную подписываться на SignalR-группу чата. Отзыв сессии прекращает её участие в маршрутизации и проверяется для команд; истечение токена закрывает соединение.
|
||||
Опечатка MessageReaded сохранена для совместимости. При подключении сервер автоматически добавляет соединение в группу его сессии. События чата направляются активным сессиям участников; заблокированные участники групп исключаются. Не требуется вручную подписываться на SignalR-группу чата. Отзыв сессии прекращает её участие в маршрутизации и проверяется для команд; срок сессии повторно проверяется перед командой. Мгновенное закрытие соединения только по истечению access JWT не гарантируется конфигурацией; не полагайтесь на него как на механизм logout.
|
||||
|
||||
UserMessageResponse: messageId, senderId, recipientId, recipientType, encryptedContent, replyToMessageId, sentAt, isEdited, mediaAttachments. История через HTTP также содержит реакции и reactionsVersion. После получения сообщения загрузите снимок реакций при необходимости.
|
||||
|
||||
@@ -59,4 +59,4 @@ GroupProfileChanged сообщает об изменении имени, опи
|
||||
|
||||
Сохранение в БД и доставка события — разные этапы. После reconnect загрузите историю через HTTP; объединяйте ответ Send и ReceiveMessage по messageId. Для реакций принимайте более новую version и заменяйте counts целиком, затем восстанавливайте состояние видимых сообщений через GET.
|
||||
|
||||
SignalR-события не имеют долговременной очереди. Push сообщений использует серверную очередь и повторные попытки; для реакций, политик каналов и изменений сообществ push не отправляется. Реальный push требует корректной конфигурации Firebase и зарегистрированного FCM-токена активной сессии. Повтор Send после неоднозначного сетевого сбоя всё ещё может создать дубликат: clientMessageId/idempotency-key для сообщений не реализован.
|
||||
SignalR-события не имеют долговременной очереди. Push сообщений использует серверную очередь и повторные попытки; для реакций, политик каналов и изменений сообществ push не отправляется. Реальный push требует корректной конфигурации Firebase и зарегистрированного FCM-токена активной сессии. Для E2EE messageId берётся из подписанного конверта. Повтор того же конверта с тем же автором, чатом, reply и набором вложений возвращает сохранённое сообщение; конфликт содержимого с тем же ID отклоняется. Повтор может повторить уведомления. Создание нового конверта/ID при каждой сетевой попытке всё ещё может породить дубликаты.
|
||||
|
||||
Reference in New Issue
Block a user