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
+109
View File
@@ -0,0 +1,109 @@
# Частые вопросы
## Запуск и сервер
### Нужны ли Firebase и production-БД для разработки?
Нет. Для запуска API нужна отдельная PostgreSQL, а Firebase можно выключить `Firebase__Enabled=false`. Серверные тесты по умолчанию используют SQLite in-memory и подменённые зависимости. [Быстрый старт](getting-started.md), [тесты](testing.md).
### Почему сборка проходит, а сервер не запускается?
Сборка не проверяет runtime-секреты, доступ к БД и Firebase credentials. Проверьте обязательные переменные, файл модерации, порт и журналы. [Диагностика](diagnostics.md).
### Почему /server/ping отвечает 200, а /server/ready — 503?
Процесс доступен, но БД недоступна либо есть неприменённые миграции. Примените миграции отдельным `--migrate-only` на нужной БД. Не запускайте его вслепую на неизвестной базе.
### Создаётся ли первый администратор автоматически?
Сам аккаунт автоматически не создаётся. Оператор задаёт `InvitationAdmin__Key` и создаёт административное приглашение через `/api/admin/InviteUser/InvitationWithKey`, передавая секрет в теле. JWT для этого метода не нужен; без настроенного ключа — 503. Затем выполняется обычная регистрация по коду. После настройки отключите этот способ, убрав ключ. [Администрирование](endpoints/admin-and-groups.md).
### Можно ли запускать несколько серверов?
Не без дополнительной работы: presence, подключения, SRP challenge и rate limit локальны процессу; файлы тоже локальные. Нужны общая инфраструктура событий/файлов и согласованная обработка challenge. [Эксплуатация](operations.md).
## Вход и история
### Чем access отличается от refresh?
Access авторизует HTTP/SignalR; refresh меняет пару токенов на `/api/auth/token/refresh`. Refresh не работает как bearer access. По умолчанию access действует 10 минут, refresh-сессия — 30 дней с продлением. [Аутентификация](endpoints/authentication/README.md).
### Почему старый парольный login перестал работать?
SRP-аккаунт получает `Auth.PasswordProofRequired`: используйте обновлённый клиент. Старый bcrypt-вход остался только для миграции. Не делайте автоматический fallback с передачей открытого пароля. [Переход](password-recovery.md).
### Почему после обновления токена второй запрос получил InvalidToken?
Refresh одноразово заменяет хеш. Параллельные обновления конкурируют; используйте один общий refresh и сохраните новую пару. Потеря ответа после сохранения также может потребовать нового входа.
### Вошёл на новом устройстве, но старые сообщения не читаются. Почему?
Авторизация и ключи истории — разные данные. Если парольная копия настроена, архив восстанавливается по паролю; иначе нужен резервный код или доверенное устройство с ключами. Сервер не может создать отсутствующий приватный ключ. [Восстановление](password-recovery.md).
### Что делать, если забыт пароль?
Администратор может сбросить доступ, но не расшифровать историю. После входа задайте новый пароль и восстановите архив кодом/с устройства. Без старого пароля, кода и устройства можно лишь явно начать с новыми ключами. Полученные собеседниками копии этим не удаляются.
### Нужно ли удалять ключи при выходе или сетевой ошибке?
Не удаляйте единственную копию истории автоматически. Завершение сессии и стирание архива — разные операции. Перед отказом от старого устройства проверьте восстановление на новом.
### Может ли сервер читать зашифрованные сообщения?
Он хранит ciphertext и зашифрованные архивы, но не пользовательские секреты. Метаданные, участники, время и размеры видны; профиль, аватары и реакции не входят в ciphertext сообщения. Первая встреча и состав группы доверяют серверу. FS/PCS и прозрачности ключей нет. [Подробные границы E2EE](e2ee.md).
## Чаты, файлы и события
### Что передавать в recipientId личного сообщения?
ID PrivateChat, полученный через `/api/user/{friendId}/private-chat`. Это не friendId. Для группы передаётся groupId и `recipientType=1`.
### Почему «публичная» группа не отдаёт историю всем?
Публичность разрешает поиск и вступление. История и команды требуют активного незаблокированного членства. Администратор сервера и администратор группы — разные роли. [Группы](groups.md).
### Почему отправка сообщает E2EE_DEVICES_CHANGED?
Каталог устройств изменился между загрузкой ключей и отправкой. Перечитайте его и заново подготовьте согласованный конверт. Не переходите на открытый текст.
### Можно ли повторить Send после сетевого сбоя?
Тот же E2EE-конверт с тем же messageId и контекстом распознаётся как сохранённая отправка. Новый messageId создаёт другую операцию. События могут повториться, поэтому объединяйте по ID. Это не общая идемпотентность всех методов.
### Почему HTTP возвращает id, а хаб — messageId?
Это разные DTO. Явно преобразуйте их в общую клиентскую модель. Также различаются структуры HTTP/SignalR вложений. [Сериализация](code-docs/hubresult-less-than-t-greater-than.md).
### Почему загрузка обычной картинки как вложения даёт 400?
Вложение сообщения сначала шифруется клиентом. MIME upload — `application/vnd.govor.encrypted`, ключ не передаётся открытым полем. Лимит 20 000 000 байт относится ко всему запросу, а не только исходному файлу. [Медиа](endpoints/mediacontroller.md).
### Почему отправленное сообщение не равно прочитанному?
Сохранение, доставка SignalR, принятие FCM и просмотр пользователем — разные этапы. Прочтение фиксируется отдельной командой. [Прочтение](endpoints/message-read.md).
### Почему online не означает доступность для push?
Online отражает соединения PresenceHub в памяти процесса. Push зависит от FCM-токена сессии, разрешений ОС и провайдера. HTTP ping отдельно обновляет lastSeen.
### Как восстановить пропущенные события?
После reconnect загрузите HTTP-снимки истории, счётчиков, реакций, групп/прав, заявок и открытых профилей. SignalR не предоставляет долговременный журнал. Порядок параллельных событий не определяет актуальные права.
### Почему при выключенном Firebase нет отложенных push после включения?
NullPushProvider считает задачи обработанными. Он предназначен для работы без доставки, а не для накопления. [Push](endpoints/push.md).
## Обновления и поддержка
### Сохранятся ли вложения после нового Docker-образа?
Только при постоянном uploads и правильном mount. Сама БД хранит ссылки, но не заменяет файлы. [VPS](vps-deployment.md), [резервные копии](operations.md).
### Можно ли откатить только образ после миграций?
Только если старый код совместим с новой схемой. Скрипт не откатывает БД автоматически. Нужны проверенная копия и план восстановления.
### Какие данные приложить к сообщению об ошибке?
Версию сервера/клиента, UTC-время, метод/маршрут или команду хаба, HTTP/HubResult status, errorCode и обезличенный фрагмент лога. Не прикладывайте пароли, токены, runtime.env, service account или приватные ключи.