mirror of
https://github.com/Govor-team/Govor.git
synced 2026-11-16 20:56:03 +00:00
Add primitive groups and required channel
Adds server-side group and channel management, private invitations, member moderation, avatar handling, and required-channel configuration. This change also introduces SignalR group profile/member notifications, updates registration to atomically join required channels, and adds EF migration and test coverage for group membership, permissions, and invitation expiry rules.
This commit is contained in:
+2
-2
@@ -17,7 +17,7 @@ Govor — мессенджер на ASP.NET Core и .NET MAUI. Эта докум
|
||||
| Профиль | Описание, аватар, загрузка профиля и события изменений |
|
||||
| Присутствие | События подключения/отключения; исправлены зависимости HTTP status |
|
||||
| Медиа и push | Доступ к вложениям, привязка FCM к сессии, очередь и повторные попытки |
|
||||
| Группы | Модели и часть сервисов сообщений; полноценный сценарий управления не завершён |
|
||||
| Группы и каналы | [Публичный поиск, приватные приглашения, владелец/админы/участники, баны, модерация и обязательный канал](endpoints/groups.md) |
|
||||
| Шифрование | Есть хранение публичных ключей, но готового E2EE нет |
|
||||
|
||||
## Как читать
|
||||
@@ -28,7 +28,7 @@ Govor — мессенджер на ASP.NET Core и .NET MAUI. Эта докум
|
||||
|
||||
## Границы готовности
|
||||
|
||||
Текущая версия не готова к открытому развёртыванию: обнаружены критичные ошибки авторизации и доступа к личным чатам. Контракты ниже полезны для разработки, но не являются подтверждением безопасности.
|
||||
Документация новых групп и реакций описывает рабочую серверную копию с исправлениями доступа. Проверки HTTP/JWT, SQL и прав выполняются автоматическими тестами; реальная доставка на устройства и производственное развёртывание требуют отдельной проверки. Страницы с commit `4603be9` фиксируют старую диагностику и не описывают все текущие исправления.
|
||||
|
||||
Эффект стекла относится к MAUI-интерфейсу. API передаёт данные и события; производительность размытия, контрастность и анимации нужно проверять отдельно на устройствах.
|
||||
|
||||
|
||||
+2
-1
@@ -14,12 +14,13 @@
|
||||
* [История сообщений](endpoints/chatloadcontroller.md)
|
||||
* [Прочтение сообщений и счётчики](endpoints/message-read.md)
|
||||
* [Реакции, паки и настройки каналов](endpoints/reactions.md)
|
||||
* [Группы и каналы](endpoints/groups.md)
|
||||
* [Медиа](endpoints/mediacontroller.md)
|
||||
* [Профиль и аватар](endpoints/profile.md)
|
||||
* [Push-уведомления](endpoints/push.md)
|
||||
* [HTTP-присутствие — ограничения](endpoints/onlinepingingcontroller-ne-rabotaet.md)
|
||||
* [Ключи сессий — экспериментальный API](endpoints/session-keys.md)
|
||||
* [Администрирование и незавершённые группы](endpoints/admin-and-groups.md)
|
||||
* [Администрирование сервера](endpoints/admin-and-groups.md)
|
||||
* [ChatsHub — сообщения](signalr/chathub.md)
|
||||
* [PresenceHub — online и offline](signalr/presencehub.md)
|
||||
* [FriendsHub — заявки](friendshub/README.md)
|
||||
|
||||
+12
-29
@@ -1,41 +1,24 @@
|
||||
# Архитектура и границы
|
||||
|
||||
## Поток запроса
|
||||
MAUI → HTTP Controller / SignalR Hub → Application service → GovorDbContext → PostgreSQL. Бинарные файлы хранятся через IStorageService; транспорт событий и push вынесен в ChatNotificationService.
|
||||
|
||||
MAUI → HTTP Controller / SignalR Hub → Application service → GovorDbContext → PostgreSQL. Медиа-сервис сохраняет бинарные данные через LocalStorageService; ChatNotificationService отправляет SignalR-события и push через Firebase.
|
||||
|
||||
| Проект | Ответственность сейчас |
|
||||
| Проект | Ответственность |
|
||||
| --- | --- |
|
||||
| Govor.API | Маршруты, хабы, авторизация, DI, преобразование ошибок и DTO |
|
||||
| Govor.Application | Сценарии пользователей, друзей, сообщений, медиа и push |
|
||||
| Govor.Contracts | HTTP/SignalR запросы, ответы и DTO |
|
||||
| Govor.API | Маршруты, хабы, активные access-сессии, DI, ошибки, DTO и уведомления |
|
||||
| Govor.Application | Пользователи, группы/каналы, права, сообщения, реакции, медиа и push |
|
||||
| Govor.Contracts | HTTP/SignalR запросы и ответы |
|
||||
| Govor.Domain | Сущности, DbContext, EF-конфигурации и миграции |
|
||||
|
||||
Это многослойное приложение, но Domain уже зависит от EF Core и содержит инфраструктуру БД. Не следует описывать его как полностью независимую доменную модель.
|
||||
Domain зависит от EF Core и содержит инфраструктуру БД. PrivateChat связывает двух пользователей; Message.RecipientId указывает на PrivateChat при RecipientType.User=0 либо ChatGroup при Group=1. Это ID чата, а не получателя-пользователя.
|
||||
|
||||
## Хранение и идентификаторы
|
||||
Роль сервера в JWT берётся из Invitation.IsAdmin. Роль группы вычисляется отдельно: ChatGroup.OwnerUserId — владелец, GroupAdmins — админы, активная GroupMembership — участники. GroupAccess объединяет права владельца/админа с незаблокированным членством; ChatAccess проверяет доступ к конкретному чату. Уникальные индексы запрещают дубли членства и административных ролей.
|
||||
|
||||
PrivateChat связывает UserAId и UserBId. Message хранит SenderId и полиморфный RecipientId: ID PrivateChat для RecipientType.User или ID ChatGroup для RecipientType.Group. Ошибки возникают там, где этот ID сравнивают с ID пользователя.
|
||||
GroupManagementService сериализует изменения членства, ролей и ссылок на строке группы. Публикации, редактура, удаление, реакции и настройки канала используют тот же порядок блокировки. GroupAvatarService меняет аватар только для действующего владельца. Регистрация атомарно создаёт пользователя, расходует приглашение и добавляет членство в обязательном канале из ServerCommunitySettings; изменение этой настройки сериализуется с регистрацией.
|
||||
|
||||
Роль access token получается из приглашения пользователя (`Invite.IsAdmin`), хотя есть отдельная сущность Admin. Нужен один источник истины для ролей.
|
||||
Соединения ChatsHub автоматически входят в группы сессий. SignalR-события направляются активным сессиям действующих участников из БД; заблокированные участники исключаются. ConnectionStore и OnlineUserStore остаются в памяти одного процесса; для нескольких экземпляров нужна общая инфраструктура SignalR/presence.
|
||||
|
||||
## Состояние соединений
|
||||
Сообщение и задача push сохраняются атомарно; ChatPushWorker повторяет неудачные доставки. После успешного HTTP сохранения ChatNotificationService отправляет GroupProfileChanged и GroupMemberChanged через ChatsHub. Профиль перечитывается индивидуально через HTTP; статус/роль членства читаются после команды. При бане/выходе только событие собственного членства дополнительно доставляется пользователю, потерявшему доступ. Остальные события по-прежнему получают действующие участники. Отказ в правах/валидации не создаёт событий; сбой доставки не отменяет сохранение.
|
||||
|
||||
ConnectionStore и OnlineUserStore — singleton в памяти одного процесса. Подключения автоматически вступают в группы пользователя, его чатов и групп. Перезапуск очищает это состояние; несколько инстансов без общего решения для SignalR и presence не имеют согласованного состояния.
|
||||
|
||||
## Рекомендуемые решения
|
||||
|
||||
1. Ввести общую проверку участия в конкретном чате и применять её к истории, Send, Read, медиа и событиям.
|
||||
2. Разделить команды и чтение: создание чата и смена пароля не должны выполняться GET-запросами.
|
||||
3. Возвращать только DTO, особенно для криптосессий и медиа.
|
||||
4. Описать ошибки единым контрактом, сохранив совместимость с MAUI.
|
||||
5. Для доставки отделить сохранение сообщения от внешних уведомлений: outbox и повторная доставка с дедупликацией.
|
||||
6. Принять отдельное решение о E2EE: протокол, проверка ключей, несколько устройств, восстановление и миграция существующих сообщений.
|
||||
|
||||
Это предложения, они не внедрены в рамках переписывания документации.
|
||||
|
||||
---
|
||||
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
|
||||
|
||||
Источник: [Govor.Domain/GovorDbContext.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.Domain/GovorDbContext.cs).
|
||||
SignalR-события не имеют долговременной очереди. Клиент восстанавливает историю, прочтение, версии реакций, свои группы, открытый профиль и участников после reconnect через HTTP. Для реакций/политик и изменений сообществ push не отправляется. При параллельных командах порядок событий не гарантирован, поэтому актуальные права берутся из HTTP состояния, а не из последнего полученного уведомления.
|
||||
|
||||
[Группы и каналы](endpoints/groups.md), [реакции](endpoints/reactions.md), [прочтение](endpoints/message-read.md) описывают текущую рабочую версию. E2EE, согласованное присутствие между инстансами и ключ идемпотентности отправки сообщений остаются отдельными задачами.
|
||||
|
||||
@@ -1,35 +1,20 @@
|
||||
# Администрирование и незавершённые группы
|
||||
# Администрирование сервера
|
||||
|
||||
## Административные маршруты
|
||||
Серверные административные маршруты требуют роль Admin и активную access-сессию. Администратор сервера и админ группы — разные права: роль в группе не открывает маршруты `/api/admin`.
|
||||
|
||||
Следующая таблица показывает фактические атрибуты, а не требуемую безопасную политику.
|
||||
|
||||
| Метод | Маршрут | Защита сейчас |
|
||||
| Метод | Маршрут | Назначение |
|
||||
| --- | --- | --- |
|
||||
| POST | /api/admin/InviteUser/Invitation | Без Authorize |
|
||||
| GET | /api/admin/InviteUser | Без Authorize |
|
||||
| GET | /api/admin/InviteUser/GetAllActiveInvitations | Без Authorize |
|
||||
| GET | /api/admin/InviteUser/{id} | Без Authorize |
|
||||
| GET | /api/admin/Users/all | Любой аутентифицированный пользователь |
|
||||
| GET | /api/admin/Users/{id} | Любой аутентифицированный пользователь |
|
||||
| GET | /api/admin/Users/user/{id}/setpassword/{password} | Любой аутентифицированный пользователь |
|
||||
| POST | `/api/admin/InviteUser/Invitation` | Приглашение регистрации: endDate, maxParticipants, isAdmin, description |
|
||||
| GET | `/api/admin/InviteUser` | Список приглашений |
|
||||
| GET | `/api/admin/InviteUser/GetAllActiveInvitations` | Активные приглашения |
|
||||
| GET | `/api/admin/InviteUser/{id}` | Приглашение по ID |
|
||||
| GET | `/api/admin/Users/all` | До 50 пользователей |
|
||||
| GET | `/api/admin/Users/{id}` | Пользователь по ID |
|
||||
| POST | `/api/admin/Users/user/{id}/password` | `{ "password": "..." }`; 204, отзыв сессий и push-токенов |
|
||||
| GET / PUT | `/api/admin/required-channel` | Канал для всех новых пользователей, право выхода |
|
||||
|
||||
CreateInvitationRequest: endDate, maxParticipants, isAdmin, description. Генератор возвращает строковый код в JSON (200). Списки приглашений возвращают id, description, isAdmin, maxParticipants, code, createdAt, endAt, isActive, participantCount.
|
||||
UserResponse не содержит passwordHash. Старый GET смены пароля с паролем в URL удалён. JWT роль Admin формируется по Invitation.IsAdmin пользователя. Настройки обязательного канала и изменения паков реакций дополнительно проверяют это право в БД.
|
||||
|
||||
Users/all фактически ограничен 50 записями без стабильной пагинации. Ответ UserResponse включает passwordHash, что недопустимо для клиентского контракта. Смена пароля выполняется GET и кладёт пароль в URL.
|
||||
|
||||
Эти маршруты нужно закрыть ролью Admin до публичного использования. Создание административного приглашения вместе с регистрацией позволяет получить роль Admin. Не подключайте их к пользовательскому интерфейсу.
|
||||
|
||||
## Группы
|
||||
|
||||
GET /invite/{code} задуман как вход в группу и требует Authorize. IGroupService не зарегистрирован в AddServices, а _currentUser не присваивается. Маршрут не является рабочим сценарием вступления.
|
||||
|
||||
GroupsHub пуст и не подключён MapHub. Административный FriendshipsController содержит только закомментированные действия, поэтому рабочих endpoints у него нет.
|
||||
|
||||
Наличие моделей ChatGroup/GroupMembership/GroupInvitation и проверки участия в групповом Send не подтверждает готовый продуктовый сценарий групп и каналов.
|
||||
|
||||
---
|
||||
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
|
||||
|
||||
Источник: [Govor.API/Controllers/AdminStuff/UsersController.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.API/Controllers/AdminStuff/UsersController.cs).
|
||||
Паки: [административный API реакций](reactions.md). Обязательный канал, владелец/админы, приглашения и модерация: [группы и каналы](groups.md).
|
||||
|
||||
Создание административных приглашений выдаёт возможность зарегистрировать серверного администратора, поэтому этот API предназначен только для доверенных администраторов сервера. Административный FriendshipsController и пустой GroupsHub остаются неиспользуемыми заготовками.
|
||||
|
||||
@@ -0,0 +1,156 @@
|
||||
# Группы и каналы
|
||||
|
||||
Рабочий серверный API от 04.10.2026. Все маршруты требуют access token и активную сессию. Группа — чат с публикацией для всех активных участников; канал — группа с IsChannel=true, где публиковать и редактировать свои публикации могут только владелец и админы. Тип сообщества задаётся при создании и не меняется через профиль.
|
||||
|
||||
Публичные сообщества доступны поиску Govor и вступлению по ID. Приватные сообщества не появляются в поиске: вступление выполняется по действующей ссылке. История, участники, закрытые аватары и команды сообщений доступны только незаблокированным участникам, даже если само сообщество публично.
|
||||
|
||||
## Создание, поиск и профиль
|
||||
|
||||
| Метод | Маршрут | Тело / результат |
|
||||
| --- | --- | --- |
|
||||
| POST | `/api/groups` | name, description, isPrivate, isChannel; GroupResponse |
|
||||
| GET | `/api/groups/search?q=...&skip=0&take=50` | Публичные группы и каналы, поиск по имени/описанию |
|
||||
| GET | `/api/groups/mine?skip=0&take=50` | Сообщества текущего пользователя без банов |
|
||||
| GET | `/api/groups/{groupId}` | Профиль; приватный профиль только участникам |
|
||||
| PUT | `/api/groups/{groupId}` | name, description, isPrivate; только владелец |
|
||||
| POST | `/api/groups/{groupId}/join` | Вступить в публичное сообщество |
|
||||
| DELETE | `/api/groups/{groupId}/members/me` | Выйти; HTTP 204 |
|
||||
| POST | `/api/groups/{groupId}/avatar` | multipart/form-data с file; только владелец |
|
||||
| DELETE | `/api/groups/{groupId}/avatar` | Убрать текущий аватар; только владелец, 204 |
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "Новости Govor",
|
||||
"description": "Обновления проекта",
|
||||
"isPrivate": false,
|
||||
"isChannel": true
|
||||
}
|
||||
```
|
||||
|
||||
POST/PUT/Join возвращают 200, остальные успешные команды без DTO — 204. name — 1–100 символов, description — до 500; q — до 100. skip >= 0, take — 1–100. По умолчанию новое сообщество приватное; создатель автоматически становится участником и владельцем.
|
||||
|
||||
GroupResponse: id, name, description, imageId, imageUrl, isPrivate, isChannel, ownerUserId, createdAt, memberCount, myRole, isRequiredChannel, canLeave. myRole: Member=0, Admin=1, Owner=2, null — не участник. memberCount не включает заблокированных. canLeave учитывает владение и запрет выхода из обязательного канала.
|
||||
|
||||
Аватар: статичный PNG/JPEG/WebP, исходный файл до 2 МиБ и сторон до 2048 px; после обработки PNG до 128×128 и 256 КиБ. GIF не принимается. Загрузка возвращает imageId и mediaUrl. Скачать можно через `/api/media/download/{imageId}` с Bearer token. Текущий публичный аватар доступен всем авторизованным незаблокированным пользователям; приватный — только активным участникам. Старые файлы не удаляются автоматически, но не выдаются посторонним как публичный аватар.
|
||||
|
||||
## Роли и модерация
|
||||
|
||||
| Возможность | Владелец | Админ | Участник |
|
||||
| --- | --- | --- | --- |
|
||||
| Читать и реагировать | Да | Да | Да |
|
||||
| Писать в обычную группу | Да | Да | Да |
|
||||
| Публиковать/редактировать свои сообщения канала | Да | Да | Нет |
|
||||
| Менять имя, описание, приватность, аватар | Да | Нет | Нет |
|
||||
| Назначать/снимать админов | Да | Нет | Нет |
|
||||
| Выпускать/отзывать ссылки | Да | Да | Нет |
|
||||
| Банить/разбанивать участников | Да | Да | Нет |
|
||||
| Банить других админов | Да | Нет | Нет |
|
||||
| Удалять сообщения других участников | Да | Да | Нет |
|
||||
| Выбирать реакции канала | Да | Да | Нет |
|
||||
| Передавать владение | Да | Нет | Нет |
|
||||
|
||||
Глобальная роль серверного Admin не заменяет роль в группе. Владельца и самого себя банить нельзя. Назначение админа требует активного участника. Бан админа владельцем снимает его административную роль; после разбана он возвращается как участник. При выходе роль админа снимается.
|
||||
|
||||
| Метод | Маршрут | Назначение |
|
||||
| --- | --- | --- |
|
||||
| GET | `/api/groups/{groupId}/members?bannedOnly=false&skip=0&take=50` | Активные участники; список bannedOnly=true только модераторам |
|
||||
| PUT | `/api/groups/{groupId}/members/{userId}/administrator` | Назначить админа, только владелец |
|
||||
| DELETE | `/api/groups/{groupId}/members/{userId}/administrator` | Снять админа, только владелец |
|
||||
| PUT | `/api/groups/{groupId}/members/{userId}/ban` | Заблокировать |
|
||||
| DELETE | `/api/groups/{groupId}/members/{userId}/ban` | Разблокировать |
|
||||
| DELETE | `/api/groups/{groupId}/messages/{messageId}` | Удалить сообщение для всех; автор либо модератор |
|
||||
| POST | `/api/groups/{groupId}/ownership/{userId}` | Передать владение активному участнику |
|
||||
|
||||
Участник в списке: userId, username, role, isBanned, memberSince. Пароли/токены и сущности User не возвращаются. Удаление сообщения проверяет его принадлежность именно указанной группе и отправляет существующее событие MessageRemoved.
|
||||
|
||||
Бан сохраняет запись участника, поэтому повторное вступление через поиск или другую ссылку его не обходит. Он блокирует историю, чтение, отправку, редактуру, реакции и файлы сообщества. События и push фильтруются по действующим участникам. Разбан возвращает членство; автоматического удаления старых сообщений при бане нет — модератор удаляет их отдельными командами.
|
||||
|
||||
Владелец не может выйти, пока не передаст владение. При передаче прежний владелец становится админом и затем может выйти. Владение всегда у одного пользователя.
|
||||
|
||||
## Приглашение по ссылке
|
||||
|
||||
```http
|
||||
POST /api/groups/{groupId}/invitations
|
||||
Authorization: Bearer <access-token>
|
||||
Content-Type: application/json
|
||||
|
||||
{ "validForDays": 7, "maxParticipants": 100, "description": "Приглашение" }
|
||||
```
|
||||
|
||||
Ответ GroupInvitationResponse содержит id, groupId, invitationCode, sharePath, previewPath, joinPath, description, endDate, maxParticipants, usedCount, isRevoked. sharePath имеет вид `/invite/{code}`; добавьте доверенный API base URL, чтобы передать полную ссылку. Клиент, открывший ссылку, извлекает code, показывает preview и выполняет POST join после действия пользователя. Все запросы используют его access token; ссылка не является токеном авторизации аккаунта.
|
||||
|
||||
| Метод | Маршрут | Назначение |
|
||||
| --- | --- | --- |
|
||||
| GET | `/api/groups/{groupId}/invitations` | До 100 последних ссылок, только модераторы |
|
||||
| DELETE | `/api/groups/{groupId}/invitations/{invitationId}` | Отозвать ссылку, 204 |
|
||||
| GET | `/api/group-invites/{code}` | Превью профиля по действующему коду, без вступления |
|
||||
| POST | `/api/group-invites/{code}/join` | Вступление, GroupResponse |
|
||||
|
||||
Совместимые пути: GET `/invite/{code}` — только превью, POST `/invite/{code}/join` — вступление. Старый побочный эффект вступления через GET устранён: сканеры ссылок и предварительная загрузка не добавляют участников.
|
||||
|
||||
validForDays — 1–365 (по умолчанию 7), maxParticipants — 0–1 000 000; 0 означает без лимита. usedCount — число успешных вступлений по ссылке, а не текущий размер группы. Повтор POST уже вступившего пользователя не расходует лимит; выход не освобождает использованный слот. Просроченная или отозванная ссылка не работает. Отзыв не удаляет ранее вступивших участников.
|
||||
|
||||
## Сообщения и реакции
|
||||
|
||||
Используйте `/hubs/chats`: Send с recipientType=1 и recipientId=groupId. История — GET `/api/groups/{groupId}/messages`; прочтение — [существующий API](message-read.md). Публичность сообщества не даёт доступ к его истории без вступления.
|
||||
|
||||
В канале владелец/админ задаёт политику через PUT `/api/groups/{groupId}/reactions`: All=0, None=1, Selected=2 с reactionIds. GET возвращает текущую политику; изменения приходят как ChannelReactionPolicyChanged. Эмодзи, изображения/GIF, HTTP/SignalR установка реакции описаны в [реакциях](reactions.md). Бан и снятие админа применяются к этим же сервисам.
|
||||
|
||||
## Обновления группы через SignalR
|
||||
|
||||
С 04.10.2026 изменения сообщества приходят через тот же `/hubs/chats`. Нужны Bearer access token и активная сессия. Дополнительная подписка на группу не требуется: сервер доставляет события всем активным сессиям действующих участников, включая другие устройства автора команды. Старый пустой GroupsHub не используется; команды управления остаются HTTP API и подходят будущему боту.
|
||||
|
||||
| Событие | Payload | Когда отправляется |
|
||||
| --- | --- | --- |
|
||||
| GroupProfileChanged | `{ groupId }` | Имя, описание, приватность, загрузка/удаление аватара, передача владения, настройка обязательного канала |
|
||||
| GroupMemberChanged | `{ groupId, userId, status, role }` | Создание группы, вступление через поиск/ссылку, выход, назначение/снятие админа, бан/разбан, передача владения, автоматическое добавление нового аккаунта в обязательный канал |
|
||||
|
||||
status: Active=0, Banned=1, Left=2. role: Member=0, Admin=1, Owner=2; null для заблокированного или вышедшего. Статус/роль читаются из БД после завершения команды. При передаче владения отправляются GroupProfileChanged и два GroupMemberChanged: прежний владелец становится Admin, новый — Owner.
|
||||
|
||||
Заблокированный или вышедший пользователь получает GroupMemberChanged о **себе** на свои активные сессии вместе с оставшимися участниками. После этого ему не направляются изменения профиля, чужого членства и события сообщений. Остальные заблокированные, посторонние пользователи, отозванные и истёкшие сессии исключены. При разбане статус Active с ролью Member; автоматическое вступление при регистрации уведомляет уже подключённых участников обязательного канала.
|
||||
|
||||
GroupProfileChanged — сигнал перечитать GET `/api/groups/{groupId}`. Он не содержит общий GroupResponse: myRole и canLeave зависят от конкретного пользователя. Клиент обновляет имя/описание, аватар, приватность, владельца, свои права и возможность выхода из полученного HTTP ответа. Смена обязательного канала уведомляет участников прежнего и нового канала; смена allowLeave — участников текущего.
|
||||
|
||||
При GroupMemberChanged перечитайте профиль и видимую страницу участников; это обновляет memberCount и myRole. Если событие касается текущего пользователя, пересчитайте доступность кнопок отправки и модерации. Если профиль публичного сообщества вернул myRole=null, членство уже потеряно, даже при HTTP 200. Ответ 403/404 также означает потерю доступа: закройте экран сообщества, уберите его из локального списка и перечитайте `/api/groups/mine`. Обновляйте UI MAUI на главном потоке. Все серверные команды независимо проверяют действующие права в БД.
|
||||
|
||||
Пример регистрации обработчиков в .NET-клиенте (Reload — методы приложения, выполняющие описанные HTTP запросы):
|
||||
|
||||
```csharp
|
||||
hub.On<GroupProfileChangedResponse>("GroupProfileChanged",
|
||||
change => ReloadGroupAsync(change.GroupId));
|
||||
hub.On<GroupMemberChangedResponse>("GroupMemberChanged",
|
||||
change => ReloadGroupAndMembersAsync(change.GroupId));
|
||||
```
|
||||
|
||||
Событие отправляется только после успешного сохранения, отказ в правах/валидации не создаёт события. Повтор успешной идемпотентной команды может повторить уведомление: обработчики должны быть идемпотентными. SignalR не хранит очередь и не гарантирует порядок между параллельными HTTP командами; payload членства — подсказка, актуальный HTTP ответ является источником прав. После reconnect перечитайте mine, открытый профиль и участников. Ошибка доставки логируется, но не отменяет уже сохранённое изменение и не превращает успешную команду в ошибку. Для этих событий push не отправляется.
|
||||
|
||||
## Обязательный канал сервера
|
||||
|
||||
Требуется серверная роль Admin; сервис дополнительно проверяет Invite.IsAdmin пользователя в БД.
|
||||
|
||||
```http
|
||||
PUT /api/admin/required-channel
|
||||
Content-Type: application/json
|
||||
Authorization: Bearer <admin-access-token>
|
||||
|
||||
{ "channelId": "<GUID канала>", "allowLeave": false }
|
||||
```
|
||||
|
||||
GET `/api/admin/required-channel` возвращает channelId и allowLeave. PUT принимает существующий канал с владельцем; обычная группа не подходит. Канал может быть приватным. `{ "channelId": null, "allowLeave": true }` отключает автоматическое добавление.
|
||||
|
||||
После включения все новые зарегистрированные пользователи становятся обычными участниками выбранного канала, без расходования приглашения группы. Создание аккаунта, расходование приглашения регистрации и членство сохраняются одной транзакцией; сбой записи не оставляет частичную регистрацию. allowLeave=false запрещает выход из текущего обязательного канала, true разрешает выход обычным участникам/админам. Владелец сначала передаёт владение независимо от этой настройки.
|
||||
|
||||
Существующие пользователи автоматически не добавляются. Настройка выхода действует на всех текущих участников выбранного канала. Смена канала не удаляет старое членство, а ограничение выхода относится только к новому выбранному каналу. Статус обязательного канала не выдаёт административных прав и не отменяет модерацию.
|
||||
|
||||
## Миграция и проверка
|
||||
|
||||
```powershell
|
||||
dotnet ef database update --project Govor.Domain --startup-project Govor.API
|
||||
dotnet test Govor.Server.Tests/Govor.Server.Tests.csproj -c Release
|
||||
```
|
||||
|
||||
Миграция `20261003131521_PrimitiveGroupsAndRequiredChannel` добавляет владельца, время создания, настройки сервера, лимиты/отзыв ссылок и уникальные индексы членства/админов/кодов. Старые дубли членства объединяются с сохранением бана; удаляются ссылки на отсутствующих пользователей и роли неактивных участников. Неоднозначные старые коды приглашений отзываются. Известное использование старых ссылок восстанавливается по сохранённым членствам; сведения о ранее вышедших пользователях в старой модели отсутствовали.
|
||||
|
||||
Для существующей группы владельцем выбирается самый ранний активный админ, а при его отсутствии — самый ранний активный участник. Пустые сообщества без активных участников остаются без владельца; для них миграция не назначает владельца произвольно. Новые сообщества всегда создаются с владельцем. Исправляется лишняя связь членства с теневым ChatGroupId; основной GroupId сохраняется.
|
||||
|
||||
Удаление сообщества, заявки на вступление, тонкие разрешения админов и UI MAUI в этот примитивный серверный сценарий не входят. Миграция подготовлена, но к рабочей пользовательской БД автоматически не применялась. Локально проверяются SQLite, реальные HTTP/JWT запросы и обработка файлов; PostgreSQL тестируется в существующем CI при его запуске.
|
||||
@@ -45,10 +45,10 @@ Dockerfile обновлён до .NET 10 и текущих проектов; с
|
||||
|
||||
## Проверка и ограничения
|
||||
|
||||
Release-сборка Govor.Server.slnx завершилась без ошибок (88 предупреждений). Все 31 локальных серверных теста прошли; пропущенных тестов нет. EF не обнаружил расхождений модели с последней миграцией.
|
||||
Исходный набор этих исправлений был проверен Release-сборкой и 31 серверным тестом. Новые проверки реакций и групп добавлены в ту же suite Govor.Server.Tests. EF не обнаружил расхождений модели с последней миграцией.
|
||||
|
||||
Локальные тесты выполняют реальную SQL-запись в SQLite, тестируют HTTP pipeline с JWT и маршруты доставки с mock SignalR/Firebase. Покрыты чужие/забаненные участники, редактура/удаление, media/reply, три режима прочтения, повторения и конкурирующая запись/удаление, очередь/retry, перенос push-токена и отзыв access-сессии. Отдельно проверяется перевод границы в SQL Npgsql и соответствие модели миграции.
|
||||
|
||||
CI запускает эту же серверную suite на SQLite и PostgreSQL 16. Для самостоятельного PostgreSQL запуска задайте TEST_POSTGRES_CONNECTION на отдельную БД с именем, заканчивающимся `_tests`; каждый тест применяет миграции в отдельной временной схеме. Локально PostgreSQL и реальная доставка Firebase/MAUI не запускались.
|
||||
|
||||
Групповой InviteController/IGroupService остаются незавершёнными; это не реализация управления группами. PresenceStore остаётся локальным процессу; для нескольких экземпляров понадобится общая инфраструктура SignalR/presence. Старые журналы с чувствительными SQL-параметрами и уже выданные права нужно оценивать отдельно от этих изменений.
|
||||
Примитивное управление группами и каналами, приглашениями, ролями и обязательным каналом добавлено отдельным этапом: [контракт групп](endpoints/groups.md). PresenceStore остаётся локальным процессу; для нескольких экземпляров понадобится общая инфраструктура SignalR/presence. Старые журналы с чувствительными SQL-параметрами и уже выданные права нужно оценивать отдельно от этих изменений.
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# ChatsHub — сообщения
|
||||
|
||||
Подключение: `/hubs/chats`, Bearer access token и активная сессия. Команды возвращают `HubResult<T>` (status, result, errorMessage); события приходят независимо от ответа команды. Этот раздел описывает рабочую копию с исправлениями от 03.10.2026.
|
||||
Подключение: `/hubs/chats`, Bearer access token и активная сессия. Команды возвращают `HubResult<T>` (status, result, errorMessage); события приходят независимо от ответа команды. Этот раздел описывает рабочую копию с исправлениями от 04.10.2026.
|
||||
|
||||
## Команды
|
||||
|
||||
@@ -42,6 +42,8 @@ Send/Read/React и чтение истории проверяют участие
|
||||
| ChatRead | ChatReadResponse |
|
||||
| MessageReactionsChanged | MessageReactionsChangedResponse |
|
||||
| ChannelReactionPolicyChanged | ChannelReactionPolicyResponse |
|
||||
| GroupProfileChanged | GroupProfileChangedResponse: `{ groupId }` |
|
||||
| GroupMemberChanged | GroupMemberChangedResponse: `{ groupId, userId, status, role }` |
|
||||
|
||||
Опечатка MessageReaded сохранена для совместимости. При подключении сервер автоматически добавляет соединение в группу его сессии. События чата направляются активным сессиям участников; заблокированные участники групп исключаются. Не требуется вручную подписываться на SignalR-группу чата. Отзыв сессии прекращает её участие в маршрутизации и проверяется для команд; истечение токена закрывает соединение.
|
||||
|
||||
@@ -53,6 +55,10 @@ MessageRemovedResponse: messageId, senderId, recipientId, requestType, recipient
|
||||
|
||||
## Доставка и восстановление
|
||||
|
||||
GroupProfileChanged сообщает об изменении имени, описания, приватности, аватара, владельца и настроек обязательного канала. Загрузите GET `/api/groups/{groupId}`: myRole и canLeave индивидуальны, поэтому событие содержит только groupId. GroupMemberChanged сообщает о вступлении/выходе, бане/разбане и роли участника. status: Active=0, Banned=1, Left=2; role: Member=0, Admin=1, Owner=2, null без активного членства. Перечитайте профиль и видимых участников; при потере доступа удалите сообщество из локального списка. Передача владения обновляет профиль и роли обоих пользователей.
|
||||
|
||||
Эти события доставляются после успешного HTTP сохранения. Заблокированный/вышедший пользователь получает только изменение собственного членства; последующие события сообщества ему не отправляются. Ошибочные команды не создают событий. Повтор успешной команды может повторить уведомление. [Группы и каналы](../endpoints/groups.md) описывают все причины событий и клиентское восстановление. Порядок параллельных уведомлений не гарантирован; HTTP состояние определяет актуальные права. После reconnect обновите mine, профиль открытой группы и список участников.
|
||||
|
||||
Сохранение в БД и доставка события — разные этапы. После reconnect загрузите историю через HTTP; объединяйте ответ Send и ReceiveMessage по messageId. Для реакций принимайте более новую version и заменяйте counts целиком, затем восстанавливайте состояние видимых сообщений через GET.
|
||||
|
||||
SignalR-события не имеют долговременной очереди. Push сообщений использует серверную очередь и повторные попытки; для реакций и политик каналов push не отправляется. Реальный push требует корректной конфигурации Firebase и зарегистрированного FCM-токена активной сессии. Повтор Send после неоднозначного сетевого сбоя всё ещё может создать дубликат: clientMessageId/idempotency-key для сообщений не реализован.
|
||||
SignalR-события не имеют долговременной очереди. Push сообщений использует серверную очередь и повторные попытки; для реакций, политик каналов и изменений сообществ push не отправляется. Реальный push требует корректной конфигурации Firebase и зарегистрированного FCM-токена активной сессии. Повтор Send после неоднозначного сетевого сбоя всё ещё может создать дубликат: clientMessageId/idempotency-key для сообщений не реализован.
|
||||
|
||||
Reference in New Issue
Block a user