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:
Artemy
2026-10-31 18:29:40 +07:00
parent a3401ceedf
commit 632ac04b56
78 changed files with 5284 additions and 720 deletions
+40 -61
View File
@@ -1,77 +1,56 @@
# Диагностика и порядок исправлений
# Диагностика
## Основание и пределы проверки
Сначала установите commit/digest сервера, версию клиента и окружение. Эта документация описывает `a3401ce`; симптомы старой версии не следует автоматически переносить на новую. Локальные тесты и опубликованный production — разные среды.
Проверен master Govor-team/Govor, commit 4603be9f714135e0af72d505d17f3d1709834bea (GitHub и локальный checkout совпали). Изучены контроллеры, хабы, сервисы, DTO, EF-модели, DI, запуск и часть MAUI-интеграции. Старый опубликованный GitBook оставался на ревизии 18.12.2025 и расходился с кодом.
## Запуск и доступность
При исходной диагностике сборка API на SDK 10.0.400 прошла с 90 предупреждениями, но тесты .NET 8 не восстанавливались из-за NU1201. Обновление 24.10.2026: серверные тесты перенесены в `tests`, обновлены до .NET 10; Release-сборка и 710 тестов проходят на SQLite и изолированной PostgreSQL. Покрытие Application: 98,88% строк и 93,53% ветвей. Инструкции и ограничения проверки — в [tests/README.md](../tests/README.md). Production, Firebase и UI на устройствах не проверялись.
| Симптом | Что проверить |
| --- | --- |
| SDK не найден | .NET SDK 10 и правила global.json |
| Нет configs/ban_usernames.json | ContentRoot, файл в publish/образе, регистр пути Linux |
| Ошибка обязательного секрета | Runtime-переменные нужного приложения, двойные подчёркивания, значение не пустое |
| Firebase ломает запуск | Enabled, service account JSON/путь и права; для разработки выключить |
| ping=200, ready=503 | Доступ к БД, TLS/CA, ожидающие миграции |
| Connection refused/502 | Порт приложения, состояние контейнера, reverse proxy и его журналы |
| После деплоя пропали файлы | Постоянный uploads, mount, права и прежняя структура путей |
| Browser CORS error | Точный origin включая схему/порт в Cors:AllowedOrigins |
Ниже «подтверждено» означает выявлено по конкретному коду или диагностике сборки, а не воспроизведено атакой на живой сервис.
[Запуск](getting-started.md), [конфигурация](configuration.md), [VPS](vps-deployment.md), [App Platform](timeweb-deployment.md).
## P0 — закрыть до публичного доступа
## HTTP и команды
| Проблема | Доказательство | Последствие | Исправление |
| --- | --- | --- | --- |
| Административные приглашения доступны анонимно | InviteUserController: Authorize закомментирован; isAdmin принимается из запроса | Получение административной роли через собственное приглашение | Admin policy и серверная проверка права выдавать роль |
| Смена чужого пароля и выдача passwordHash обычному пользователю | UsersController: только Authorize; GET setpassword; BuildUserDtos включает PasswordHash | Захват аккаунтов, раскрытие хешей, пароль в URL | Admin policy, убрать hash из DTO, POST-команда, аудит и отзыв сессий |
| Чужая история и отправка в чужой личный чат | MessagesLoader игнорирует currentUser; Send проверяет только существование PrivateChat | Чтение и запись по чужому chatId | Общая проверка участия в конкретном чате |
| Неправильная авторизация Read | CanReadMessage проверяет любой PrivateChat пользователя | Отметки чужих сообщений прочитанными | Привязать проверку к message.RecipientId |
| Криптосессия выдаётся как EF-сущность с UserSession | SessionKeysReader Include(UserSession), контроллер Ok(keys) | Риск раскрытия внутренних полей и циклов JSON | PublicSessionKeysDto, проекция только публичных полей |
| Ответ | Действие |
| --- | --- |
| 400 | Проверить DTO, enum, длины, errorCode и контекст E2EE; refresh тоже может вернуть 400 |
| 401 | Проверить access/refresh, sid, срок/отзыв и серверное время; сериализовать refresh |
| 403 | Проверить участие/бан, автора, роль и владельца файла; смена токена не выдаёт права |
| 404 | Проверить тип ID: пользователь, чат, заявка и сообщение не взаимозаменяемы |
| 409 | Перечитать ревизию/поколение/состояние и повторить согласованную операцию |
| 413 | Учесть лимит хоста/прокси, multipart-overhead и размер ciphertext |
| 429 | Остановить частые повторы входа; за прокси проверить RemoteIpAddress |
| 500 | Сопоставить время, маршрут и журнал; не показывать внутреннее исключение пользователю |
## P1 — восстановить корректность
Тело ошибки бывает ProblemDetails, строкой или пустым. У SignalR status находится внутри HubResult; успешное соединение не означает успешную команду. [Форматы](code-docs/hubresult-less-than-t-greater-than.md).
| Проблема | Где | Действие |
| --- | --- | --- |
| rotate/used всегда обращаются к null | SessionKeysController._oneTimePreKeysRotator | Передать зависимость конструктору |
| online/status всегда падает | OnlinePingingController, две зависимости не присвоены | Исправить DI и проверку поведения |
| Вступление в группу неработоспособно | InviteController._currentUser и незарегистрированный IGroupService | Завершить сервис и инъекцию |
| HideForMe физически удаляет сообщение автора | MessageRemovingService игнорирует ForceRemove | Реализовать отдельную запись скрытия |
| Удаление группового сообщения сравнивает userId с groupId | MessageRemovingService | Проверять автора/администратора и участие |
| Собеседнику не приходят Edit/Remove/Read | NotifyParticipantsAsync адресует ID чата как группу пользователя | Определять обоих участников чата |
| Личные вложения недоступны получателю | AccesserToDownloadMediaService сравнивает RecipientId с userId | Проверять участников PrivateChat |
| Нет владения вложениями и аватаром | Send; ProfileHub.SetAvatar; OwnerType от клиента | Серверная политика ownership, лимиты и whitelist |
| EncryptedKey теряется | MediaService и MessageSendingService не сохраняют ключ | Выбрать и реализовать контракт хранения/доставки |
| Отзыв сессии не отзывает access/соединение | Program.cs; UserSessionRevoker | Проверять sid и закрывать соединения по политике |
| Refresh может повторяться/конфликтовать | JwtService без jti/sid; hash unique; неатомарная ротация | Случайный refresh, атомарная ротация и replay-политика |
| Ошибки превращаются в ложные статусы | ResultExtensions, Forbid(text), хабы, фильтр | Единый mapping, 500 для server errors, корректный объект из фильтра |
| Тестовая инфраструктура отстала | API.Tests net8, API net10; устаревшие проекты | Выровнять TFM/EF и восстановить CI |
| Контейнер не соответствует проекту | Dockerfile .NET 8, ссылки Core/Data | Обновить слои сборки и зависимости |
## Сообщения и шифрование
## P2 — надёжность и сопровождение
- Нет истории: проверьте chatId и recipientType, доступ, якорь и параметры пагинации.
- Файл загружен, но Send отклонён: проверьте uploader/OwnerType, MIME, пустой открытый encryptedKey и совпадение mediaIds в конверте.
- `E2EE_DEVICES_CHANGED`: перечитайте каталог и согласуйте получателей заново.
- Новое устройство не читает старое: проверьте восстановление архива и наличие прежних ключей; не генерируйте новый корень поверх старого архива автоматически.
- Ошибка времени конверта: E2EE проверяет отклонение CreatedAt до пяти минут; синхронизируйте часы.
- Повтор сообщения в UI: объединяйте HTTP, ответ Send и события по ID.
- Конкурентные регистрации могут превысить лимит приглашения; IsActive не проверяется. Нужна атомарная квота.
- Повторный Read конфликтует при гонке по unique(MessageId, UserId); требуется идемпотентная запись.
- Нет clientMessageId/outbox: после сохранения уведомление может упасть, а повторная отправка создаст дубль.
- Пагинация только по SentAt пропускает одинаковые timestamps; нужен стабильный курсор.
- Состояние соединений локально процессу; для нескольких инстансов требуется общее решение.
- CORS принимает любой origin с credentials; sensitive EF logging включён без ограничения окружения.
- Firebase обязателен даже для локального старта; внешние зависимости должны включаться явно.
- global.json содержит некорректную sdk/version; solution зависит от внешнего SmartRes, а API — от DLL в libs.
- Дубликат маппинга UserProfileDto, nullable выключен в API, а предупреждения CS0649 уже указывают реальные дефекты.
- Приглашение определяет роль одновременно с отдельной таблицей Admin; выбрать один источник.
- PrivacyUserSettings и Blocked-модель не означают, что приватность и блокировка покрывают все сценарии.
[Клиентский сценарий](client-integration.md), [E2EE](e2ee.md), [восстановление](password-recovery.md).
NuGet сообщил NU1903 для AutoMapper 16.0.0. [GHSA-rvv3-g6hj-g44x](https://github.com/advisories/GHSA-rvv3-g6hj-g44x) описывает DoS от рекурсивного mapping; исправленная версия ветки 16 — 16.1.1. Это подтверждение уязвимости зависимости; доступность конкретного exploit-пути в Govor отдельно не доказана.
## SignalR и push
## MAUI и стеклянный интерфейс
Проверьте правильный `/hubs/...`, актуальный access token, регистрацию обработчиков до StartAsync и поддержку WebSocket прокси. После reconnect перечитайте HTTP-состояние. При logout остановите автоматические повторы.
MessagesListController присваивает EncryptedContent = text; mapping читает его прямо в Text, а репозиторий редактирует как NewEncryptedContent = newText. Следовательно, в проверенном пути сообщения передаются обычным текстом. Хранение ключей на сервере не делает этот путь E2EE.
Для push проверьте Enabled, актуальный FCM-токен **текущей сессии**, разрешения ОС, Android channel `chat_messages`, APNs для iOS и журнал worker. Активный SignalR не подавляет push сам по себе; прочитавшие исключаются. Принятие FCM не гарантирует отображение. [Диагностика доставки](endpoints/push.md).
ChatHub клиента отбрасывает сообщения с пустым текстом, даже если есть вложение. Клиент подписан на MessageSent, которое сервер не отправляет. Перезапуск из Closed может конфликтовать с logout; refresh на любом HTTP-сбое очищает токены. MessagesListController.SendAsync возвращает Success(true), не проверяя результат SendMessageAsync; экран может считать неуспешную отправку успешной. Эти проблемы важнее полировки оформления.
## Что известно о качестве
В ChatPage.xaml есть слои с Opacity и Shadow. Визуально подтвердить эффект, FPS и поведение blur без запуска приложения нельзя. Рекомендуется отдельно измерить скролл длинного чата, работу клавиатуры, контраст текста на светлом/тёмном фоне и отключение тяжёлых эффектов. Полный UI-аудит не проводился.
735 тестов SQLite прошли на проверенной ревизии; сборка выдаёт предупреждения, в том числе уязвимости ImageSharp 3.1.12. Текущий прогон не подтверждает production, PostgreSQL, реальные устройства и Firebase. [Проверки и ограничения](testing.md).
## Последовательность работ
1. Закрыть P0, добавить проверки «пользователь C не может читать/писать/читать ключи чата A–B; User не управляет Admin».
2. Выровнять .NET и тесты; проверить реальные PostgreSQL-запросы и DI через старт приложения.
3. Исправить P1: события двух участников, HideForMe, медиа, ключи, logout.
4. Закрепить API контрактами и интеграционными тестами HTTP/SignalR, включая повторные и параллельные операции.
5. Решить E2EE и доставку; после этого расширять группы и оптимизировать визуальные эффекты.
Критерий готовности: воспроизводимый запуск, зелёные проверки доступа, согласованный MAUI-контракт и отсутствие известных неработающих методов. Архитектурная переработка должна опираться на эти проверки, а не начинаться с переписывания всего приложения.
---
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; сервер с БД и Firebase в рамках диагностики не запускался.
Источник: [Govor.API/Program.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.API/Program.cs).
Старый отчёт от 03.10.2026 описывал дефекты исходной версии, многие из которых уже устранены. Его утверждения об отсутствии E2EE, сломанном HTTP presence, отсутствии проверки sid и неправильном SDK не являются текущими ограничениями.