mirror of
https://github.com/Govor-team/Govor.git
synced 2026-11-18 13:24:59 +00:00
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:
+20
-41
@@ -1,54 +1,33 @@
|
||||
# Исправления серверной части — 03.10.2026
|
||||
# Актуальность документации и история
|
||||
|
||||
Этот документ описывает изменения рабочей копии относительно диагностики commit `4603be9`. Криптографический протокол E2EE не добавлялся. Страницы, снабжённые ссылками на этот commit, сохраняют описание исходной версии; нижеприведённые изменения и новый контракт прочтения уточняют её поведение.
|
||||
## Базовая версия
|
||||
|
||||
## Доступ и сессии
|
||||
Текущая документация сверена с `master`, коммит `a3401ce`, 30.10.2026. Ссылки на исходники закреплены за этой ревизией. Тестовый результат: 735 тестов SQLite Release без ошибок/пропусков; [подробности](testing.md).
|
||||
|
||||
Чтение, история, отправка, редактирование, удаление и скачивание вложений проверяют участие в конкретном PrivateChat/ChatGroup. Забаненный участник группы доступа не получает. В канале отправлять могут только его администраторы. Связь replyTo ограничена тем же чатом; вложения отправителя должны принадлежать ему и иметь тип Message. Аватар нельзя назначить из чужого файла или приватного вложения.
|
||||
## Что изменилось относительно старой документации
|
||||
|
||||
Глобальное удаление разрешено автору либо администратору группы с действующим участием. HideForMe возвращает 400: отдельного механизма скрытия ещё нет, и запрос больше не удаляет сообщение для всех.
|
||||
- Запуск использует .NET 10, рабочие серверное решение и Dockerfile, runtime-секреты, отключаемый Firebase, migrate-only и readiness.
|
||||
- Регистрация транзакционно расходует приглашение и добавляет обязательный канал.
|
||||
- HTTP проверяет активную сессию; refresh имеет случайный jti и условную ротацию; хабы проверяют сессию перед командой.
|
||||
- История проверяет доступ и сортируется по (SentAt, Id); вложения проверяют владельца.
|
||||
- Реализованы E2EE, сертификаты/ротация устройств, зашифрованный архив, SRP-вход, парольная копия кода и явный сброс ключей.
|
||||
- Исправлены зависимости HTTP presence, старого API ключей, обработка ошибок профиля и HTTP ServerError.
|
||||
- Справочники групп, реакций, прочтения и push включены в общую навигацию.
|
||||
|
||||
Административные пользователи и приглашения требуют Admin. Хеши паролей исключены из ответа. Изменение пароля: `POST /api/admin/Users/user/{id}/password`, JSON `{"password":"<new-password>"}`; прежний GET с паролем в URL удалён. Успех 204, неизвестный пользователь 404. Смена пароля отзывает сессии и отключает push-токены.
|
||||
Ранняя диагностика `4603be9` и список исправлений 03.10.2026 были историческими снимками. Они заменены актуальной [диагностикой](diagnostics.md), а не оставлены как параллельный контракт API. Историю реализации смотрите в Git.
|
||||
|
||||
JWT access проверяется по userId/sid: сессия должна принадлежать пользователю, быть неотозванной и неистёкшей. Refresh JWT не принимается как access. Каждый вход создаёт отдельную сессию; DeviceInfo служит подписью устройства. Refresh получает уникальный jti, а ротация хеша условно-атомарна. Повторно использованный refresh не перезаписывает результат другого запроса. Hub-фильтр перепроверяет сессию перед каждой командой и возвращает объект HubResult. Соединения закрываются при истечении access token. Чат-события адресуются группам активных сессий.
|
||||
## Как поддерживать документацию
|
||||
|
||||
Исправлены отсутствующие зависимости OnlinePingingController и SessionKeysController. Последний возвращает DTO публичных ключей вместо EF-графа с UserSession. Это исправление существующего экспериментального API, а не реализация E2EE.
|
||||
При изменении маршрута, DTO, прав, событий или конфигурации обновляйте соответствующую страницу, [карту API](api-reference.md), [путь интеграции](client-integration.md) и FAQ, если меняется пользовательский сценарий. Отделяйте проверенные результаты от планов. Не обновляйте дату проверки без чтения кода и выполнения относящихся к изменению проверок.
|
||||
|
||||
## Уведомления и прочтение
|
||||
`docs/SUMMARY.md` задаёт навигацию. Сохраняйте прежние страницы как короткие ссылки на канонический раздел, если их URL уже использовались; не храните две независимые копии контракта. Локальные ссылки должны вести на страницы внутри docs либо на исходники по полному GitHub URL.
|
||||
|
||||
ReceiveMessage, изменения и квитанции приходят обоим участникам личного чата либо действующим участникам группы. MessageSent синхронизирует исходящее сообщение на устройствах отправителя. Сбой SignalR не превращает сохранённое сообщение в неудачный Send. При восстановлении соединения клиент загружает историю; SignalR не является журналом событий.
|
||||
## GitBook и репозитории
|
||||
|
||||
Сохранение сообщения и ChatPushNotification выполняется одним SaveChanges. ChatPushWorker опрашивает очередь каждые 2 секунды; ChatPushDispatcher получает условную двухминутную аренду, отправляет push, удаляет успешные задачи и повторяет ошибки с задержкой 2–300 секунд. После перезапуска задачи остаются в БД. Удаление сообщения каскадно удаляет задачу. При отправке заново проверяются получатели и прочтение; прочитавшим push не отправляется.
|
||||
На момент проверки GitBook Govor-API имеет активный Git Sync с `Govor-team/Govor`, веткой `master`, каталогом `docs`. Проверенный здесь код находится в `stalcker2288969/Govor`. Это разные репозитории; push в текущий origin сам по себе не обновляет подключённое пространство.
|
||||
|
||||
Это доставка как минимум один раз до принятия push провайдером: после прерывания между ответом Firebase и удалением задачи push может повториться. Используйте messageId для дедупликации и tag чата. Принятие Firebase не подтверждает показ уведомления устройством. У сообщения пока нет клиентского ключа идемпотентности: повторять Send после потери ответа следует осторожно.
|
||||
Настройка Git Sync меняется в интерфейсе GitBook. Владельцу нужно выбрать единый канонический репозиторий и синхронизировать с ним документацию, иначе последующий импорт старой ветки может вернуть устаревший текст. Эта переработка не переключает Git Sync и не меняет права интеграции.
|
||||
|
||||
FCM разбивается на пачки до 500. Временный отказ провайдера не удаляет все регистрации. Автоматически удаляются только токены Unregistered. Выборка учитывает активность и принадлежность сессии; обновление реактивирует токен, смена аккаунта переносит уникальную регистрацию устройства.
|
||||
## Изменение публичных адресов
|
||||
|
||||
[Контракт HTTP/SignalR и интеграция со скроллом](endpoints/message-read.md). История включает messageViews и reactions; порядок по времени и ID предотвращает пропуск сообщений с одинаковым временем.
|
||||
|
||||
## Сборка и обновление
|
||||
|
||||
Используйте .NET SDK 10 и `Govor.Server.slnx`: она включает актуальный сервер и Govor.Server.Tests, без удалённых проектов и внешнего исходного проекта SmartRes. Бинарный `libs/SmartRes.dll` используется по существующему правилу репозитория. Обновление 24.10.2026: серверные тесты перенесены в tests, обновлены до .NET 10 и подключены к обоим solution. Инструкции и результаты — в [tests/README.md](../tests/README.md).
|
||||
|
||||
```powershell
|
||||
dotnet restore Govor.Server.slnx
|
||||
dotnet build Govor.Server.slnx --no-restore -c Release
|
||||
dotnet test Govor.Server.slnx --no-build -c Release
|
||||
dotnet ef database update --project Govor.Domain --startup-project Govor.API
|
||||
```
|
||||
|
||||
Перед запуском новой версии примените миграцию `20261003070406_ReliableChatPush` к серверной PostgreSQL. Она добавляет очередь с FK и индексом; существующие сообщения/прочтения не изменяет. Пользовательская БД в ходе работы не обновлялась. SQL для миграции можно сформировать `dotnet ef migrations script --project Govor.Domain --startup-project Govor.API`.
|
||||
|
||||
Dockerfile обновлён до .NET 10 и текущих проектов; секреты, uploads, bin/obj исключены из build context. Учётные данные Firebase передавайте в контейнер при запуске, например volume `/app/secrets/firebase-adminsdk.json`. Контейнер в данной среде не запускался: Docker daemon недоступен.
|
||||
|
||||
`Firebase:Enabled=false` выключает Firebase и использует NullPushProvider для разработки; при этом реальная push-доставка отключена. Production требует Firebase service account. Переменные окружения имеют стандартный приоритет над appsettings.json. Для веб-клиента задайте `Cors:AllowedOrigins`; нативному MAUI CORS не требуется. Подробные ошибки БД включаются явно через Database:EnableDetailedErrors; значения SQL-параметров не логируются. Swagger UI доступен в Development; production-документ требует авторизации.
|
||||
|
||||
## Проверка и ограничения
|
||||
|
||||
Исходный набор этих исправлений был проверен 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 не запускались.
|
||||
|
||||
Примитивное управление группами и каналами, приглашениями, ролями и обязательным каналом добавлено отдельным этапом: [контракт групп](groups.md). PresenceStore остаётся локальным процессу; для нескольких экземпляров понадобится общая инфраструктура SignalR/presence. Старые журналы с чувствительными SQL-параметрами и уже выданные права нужно оценивать отдельно от этих изменений.
|
||||
Страницы сгруппированы под началом работы, аутентификацией, E2EE, HTTP API, SignalR и развёртыванием. ID существующих страниц сохранены, внутренние ссылки GitBook используют стабильные ID. Публичные пути перемещённых страниц изменились. Автоматические site redirects недоступны на текущем тарифе; внешние закладки/ссылки на старые пути нужно обновить либо настроить redirects после подключения подходящего тарифа.
|
||||
|
||||
Reference in New Issue
Block a user