Files
Artemy 632ac04b56 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.
2026-10-31 18:29:40 +07:00

14 KiB
Raw Permalink Blame History

Реакции, паки и настройки каналов

Контракт текущей серверной ревизии из обзора. Все маршруты требуют Bearer access token и активную сессию. JSON использует camelCase, перечисления передаются числами. HTTP и SignalR вызывают один сервис с одинаковыми проверками доступа.

Реакции сообщения

На одном сообщении пользователь может иметь одну реакцию: новая заменяет предыдущую. Изменять чужую реакцию нельзя; userId берётся из токена. Доступ имеют участники личного чата и незаблокированные участники группы/канала.

Метод Маршрут Тело / результат
GET /api/messages/{messageId}/reactions Снимок реакций
PUT /api/messages/{messageId}/reactions/me { "reactionId": "<GUID>" }; снимок
DELETE /api/messages/{messageId}/reactions/me Без тела; снимок

Успех — HTTP 200. Повтор PUT той же реакции и DELETE отсутствующей реакции идемпотентны: не повышают version и не отправляют событие. PUT требует активную реакцию активного пака. Ошибки: 400 — некорректный ID; 401 — нет активной access-сессии; 403 — нет доступа или запрещено настройками канала; 404 — сообщение/реакция недоступны.

Снимок и событие MessageReactionsChanged имеют одинаковый формат:

{
  "messageId": "11111111-1111-1111-1111-111111111111",
  "recipientId": "22222222-2222-2222-2222-222222222222",
  "recipientType": 0,
  "version": 3,
  "actorId": "33333333-3333-3333-3333-333333333333",
  "actorReaction": null,
  "counts": [
    { "reactionId": "b3000000-0000-0000-0001-000000000001", "reactionCode": "👍", "count": 2 }
  ]
}

В GET actorId — текущий пользователь. В событии — пользователь, который изменил реакцию. actorReaction — его текущая MessageReactionResponse либо null после удаления. Не принимайте чужую actorReaction за свою. В counts передаётся полный снимок счётчиков, а не приращения. recipientType: 0 — личный чат (recipientId = PrivateChat.Id), 1 — группа/канал.

История сообщений содержит reactionsVersion и reactions с reactionId, reactionCode, userId и reactedAt. Старая неизвестная reactionCode может иметь reactionId=null; отображайте её как сохранённый код. Миграция связывает известные старые эмодзи с базовым паком.

SignalR и синхронизация клиента

Подключение: /hubs/chats, обычный access token. Методы возвращают существующий HubResult<T> с status, result, errorMessage:

var result = await connection.InvokeAsync<HubResult<MessageReactionsChangedResponse>>(
    "React", messageId, new SetReactionRequest { ReactionId = reactionId });
var removed = await connection.InvokeAsync<HubResult<MessageReactionsChangedResponse>>(
    "RemoveReaction", messageId);

connection.On<MessageReactionsChangedResponse>("MessageReactionsChanged", state =>
{
    // На UI-потоке: принять более новую версию и заменить counts целиком.
    // actorReaction обновляет собственный выбор только при actorId == currentUserId.
});
connection.On<ChannelReactionPolicyResponse>("ChannelReactionPolicyChanged", policy =>
{
    // Обновить разрешённые реакции канала по более новой version.
});

Событие после сохранения получают активные сессии обоих участников личного чата или незаблокированных участников группы, включая устройства автора изменения. Для этих событий push не отправляется. События SignalR не имеют долговременной очереди: после reconnect загрузите HTTP-снимки видимых сообщений и политику канала. Подпишитесь на события до загрузки истории и сравнивайте version отдельно для каждого сообщения, чтобы запоздавший ответ не затёр новое состояние. Ответ команды и событие могут дублировать одну версию.

Каталог, установка и обмен

Базовый пак Emoji доступен каждому автоматически, не требует установки и не отключается. Его ID — b3000000-0000-0000-0000-000000000001; содержит 👍 👎 ❤️ 🔥 🥰 👏 😁 🤔 😢 🎉 🤯 🙏. Пользовательские паки публичны среди авторизованных пользователей. Установка добавляет пак в личный выбор; применять публичную реакцию можно и без установки.

Метод Маршрут Назначение
GET /api/reaction-packs?skip=0&take=50 Активный каталог
GET /api/reaction-packs/mine?skip=0&take=50 Базовый и установленные паки
GET /api/reaction-packs/{packId} Активный пак с активными реакциями
GET /api/reaction-packs/shared/{shareCode} Открыть пак по коду обмена
PUT /api/reaction-packs/{packId}/subscription Установить; HTTP 204
DELETE /api/reaction-packs/{packId}/subscription Удалить из выбора; HTTP 204
GET /api/reactions/{reactionId} Определение реакции, включая отключённую
GET /api/reaction-packs/limits Лимиты файлов и пака

skip >= 0, take от 1 до 100. Возвращается список паков. Каждый пак: id, name, description, shareCode, sharePath, isDefault, isEnabled, createdByUserId, createdAt, reactions. sharePath — относительный API-маршрут; клиент может передавать shareCode в своей deep link. Отдельного механизма отправки приглашения/сообщения сервер не добавляет.

Элемент reactions: id, packId, code, name, kind, emoji, mediaFileId, mediaUrl, width, height, sizeBytes, durationMilliseconds, isEnabled, createdAt. kind: Emoji=0, Image=1, Gif=2. Для файлов используйте mediaUrl (/api/media/download/{id}) с Bearer token. Файлы реакций доступны всем авторизованным пользователям, включая исторические файлы отключённых реакций. ID файла не даёт доступ к обычным закрытым вложениям чата.

При отображении незнакомого reactionId получите /api/reactions/{reactionId} и кешируйте определение/изображение. Идентичность и файл реакции неизменяемы; для замены изображения администратор создаёт новый элемент.

Администрирование паков

Требуется роль Admin; операции изменения дополнительно проверяют административное приглашение пользователя в БД, согласно существующей модели прав проекта. Будущий бот может использовать эти маршруты с access-сессией административного пользователя. Выдача отдельной bot-учётной записи/токена пока не реализована.

Метод Маршрут Тело
GET /api/admin/reaction-packs?skip=0&take=50 Каталог, включая отключённые паки и элементы
GET /api/admin/reaction-packs/{packId} Пак, включая отключённые элементы
POST /api/admin/reaction-packs { "name": "Cats", "description": "..." }
PUT /api/admin/reaction-packs/{packId} { "name": "Cats", "description": "...", "isEnabled": true }
DELETE /api/admin/reaction-packs/{packId} Мягкое отключение пака; 204
POST /api/admin/reaction-packs/{packId}/reactions/emoji { "name": "Cool", "emoji": "😎" }
POST /api/admin/reaction-packs/{packId}/reactions/media multipart/form-data: name и file
DELETE /api/admin/reaction-packs/{packId}/reactions/{reactionId} Мягкое отключение элемента; 204

Создание/обновление возвращает HTTP 200 с DTO. name — 1–100 символов, description — до 500. До 100 элементов в паке, включая отключённые. Базовый пак и его элементы неизменяемы. Отключение исключает пак/элемент из выбора и запрещает новые реакции, но сохраняет ранее поставленные реакции и файлы; пользователь может снять свою старую реакцию. Отдельного события изменения каталога нет: обновляйте каталог при открытии выбора и после отказа установки реакции.

Файлы

Формат определяется по содержимому: PNG, JPEG, WebP для статичных картинок; GIF для анимации. SVG и анимации других форматов отклоняются. Имя файла и заявленный MIME не определяют результат. Сервер декодирует, удаляет необязательные метаданные, уменьшает и заново кодирует файл. Картинки сохраняются как PNG, анимации как GIF.

Ограничение Значение
Исходный файл До 2 МиБ, стороны до 2048 пикселей
Результат Обе стороны не больше 128 пикселей
Картинка До 256 КиБ
GIF До 512 КиБ, до 60 кадров, до 5 секунд за цикл

Для достижения лимита размера сервер может уменьшить стороны до 96, 64 или 48 пикселей. Задержка кадра GIF нормализуется минимум до 20 мс; лимит длительности проверяется после нормализации. Слишком сложный/повреждённый файл возвращает 400; тело запроса выше транспортного лимита может вернуть 413.

Обработка использует SixLabors.ImageSharp 3.1.12 с Six Labors Split License; пакет не требует лицензионного ключа для сборки. Условия использования доступны в пакете NuGet. Переход на ImageSharp 4 требует отдельно настроить build-time license key.

Настройки канала

Группы с IsChannel=true поддерживают ограничения. Новые и существующие каналы после миграции используют All. Управлять политикой может незаблокированный участник, записанный в GroupAdmins этого канала; глобальная роль Admin сама по себе не даёт этих прав.

Метод Маршрут Результат
GET /api/groups/{groupId}/reactions Политика для участников
PUT /api/groups/{groupId}/reactions { "mode": 2, "reactionIds": ["<GUID>"] }; обновлённая политика

mode: All=0 — все активные реакции; None=1 — новые реакции запрещены; Selected=2 — только выбранные ID (до 100). Для All/None reactionIds должен быть пустым. Пустой Selected запрещает все новые реакции. Выбираются только активные элементы активных паков. Результат: groupId, mode, version, reactionIds. После успешного PUT приходит ChannelReactionPolicyChanged. Обычная группа не поддерживает PUT политики (400). Изменение политики не удаляет историю; собственную реакцию разрешено снять при любом режиме.

Обновление базы и проверка

Из корня серверного проекта:

dotnet ef database update --project Govor.Domain --startup-project Govor.API
dotnet test tests/Govor.Server.Tests/Govor.Server.Tests.csproj -c Release

Миграция 20261003101700_ReactionPacksAndChannelPolicies создаёт каталог, установки, разрешения канала, версии и базовый пак; старые реакции сохраняются. Применение к конкретной установке проверяется отдельно через миграции и /server/ready. Тестирование и границы проверки.