Files
Govor/docs/architecture.md
T
Artemy 29cc51ee0c Add reactions, reliable push & session checks
Implements message reactions and reaction packs (domain models, services, admin HTTP API, media processing via ImageSharp and limits) and adds reliable push delivery (ChatPushNotification, ChatPushDispatcher, ChatPushWorker, improved ChatNotificationService). Enhances message reading (ReadChat API, unread counts, concurrency-safe receipts) and tightens session security (access-token session validation in JWT, hub filter, SessionAuthorization). Improves SignalR behavior (session groups, reaction/channel events, hub/error mappings). Adds EF migrations, many controller fixes (Forbid handling, password API), tests (Govor.Server.Tests), docs, CI and tooling updates (Dockerfile → .NET 10, GH Actions matrix for sqlite/postgres, Govor.Server.slnx, global.json), and small infra changes (AutoMapper bump, NullPushProvider, storage/token handling).
2026-10-03 17:42:24 +07:00

3.8 KiB

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

Поток запроса

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.Domain Сущности, DbContext, EF-конфигурации и миграции

Это многослойное приложение, но Domain уже зависит от EF Core и содержит инфраструктуру БД. Не следует описывать его как полностью независимую доменную модель.

Хранение и идентификаторы

PrivateChat связывает UserAId и UserBId. Message хранит SenderId и полиморфный RecipientId: ID PrivateChat для RecipientType.User или ID ChatGroup для RecipientType.Group. Ошибки возникают там, где этот ID сравнивают с ID пользователя.

Роль access token получается из приглашения пользователя (Invite.IsAdmin), хотя есть отдельная сущность Admin. Нужен один источник истины для ролей.

Состояние соединений

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.