Files
Govor/docs/architecture.md
T

4.2 KiB

Архитектура и границы

MAUI → HTTP Controller / SignalR Hub → Application service → GovorDbContext → PostgreSQL. Бинарные файлы хранятся через IStorageService; транспорт событий и push вынесен в ChatNotificationService.

Проект Ответственность
Govor.API Маршруты, хабы, активные access-сессии, DI, ошибки, DTO и уведомления
Govor.Application Пользователи, группы/каналы, права, сообщения, реакции, медиа и push
Govor.Contracts HTTP/SignalR запросы и ответы
Govor.Domain Сущности, DbContext, EF-конфигурации и миграции

Domain зависит от EF Core и содержит инфраструктуру БД. PrivateChat связывает двух пользователей; Message.RecipientId указывает на PrivateChat при RecipientType.User=0 либо ChatGroup при Group=1. Это ID чата, а не получателя-пользователя.

Роль сервера в JWT берётся из Invitation.IsAdmin. Роль группы вычисляется отдельно: ChatGroup.OwnerUserId — владелец, GroupAdmins — админы, активная GroupMembership — участники. GroupAccess объединяет права владельца/админа с незаблокированным членством; ChatAccess проверяет доступ к конкретному чату. Уникальные индексы запрещают дубли членства и административных ролей.

GroupManagementService сериализует изменения членства, ролей и ссылок на строке группы. Публикации, редактура, удаление, реакции и настройки канала используют тот же порядок блокировки. GroupAvatarService меняет аватар только для действующего владельца. Регистрация атомарно создаёт пользователя, расходует приглашение и добавляет членство в обязательном канале из ServerCommunitySettings; изменение этой настройки сериализуется с регистрацией.

Соединения ChatsHub автоматически входят в группы сессий. SignalR-события направляются активным сессиям действующих участников из БД; заблокированные участники исключаются. ConnectionStore и OnlineUserStore остаются в памяти одного процесса; для нескольких экземпляров нужна общая инфраструктура SignalR/presence.

Сообщение и задача push сохраняются атомарно; ChatPushWorker повторяет неудачные доставки. SignalR-события не имеют долговременной очереди. Клиент восстанавливает историю, прочтение и версии реакций после reconnect через HTTP. Для реакций/политик push не отправляется; изменения группы пока восстанавливаются чтением профиля/участников.

Группы и каналы, реакции, прочтение описывают текущую рабочую версию. E2EE, согласованное присутствие между инстансами и ключ идемпотентности отправки сообщений остаются отдельными задачами.