Files
Artemy 632ac04b56 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.
2026-10-31 18:29:40 +07:00

11 KiB
Raw Permalink Blame History

Частые вопросы

Запуск и сервер

Нужны ли Firebase и production-БД для разработки?

Нет. Для запуска API нужна отдельная PostgreSQL, а Firebase можно выключить Firebase__Enabled=false. Серверные тесты по умолчанию используют SQLite in-memory и подменённые зависимости. Быстрый старт, тесты.

Почему сборка проходит, а сервер не запускается?

Сборка не проверяет runtime-секреты, доступ к БД и Firebase credentials. Проверьте обязательные переменные, файл модерации, порт и журналы. Диагностика.

Почему /server/ping отвечает 200, а /server/ready — 503?

Процесс доступен, но БД недоступна либо есть неприменённые миграции. Примените миграции отдельным --migrate-only на нужной БД. Не запускайте его вслепую на неизвестной базе.

Создаётся ли первый администратор автоматически?

Сам аккаунт автоматически не создаётся. Оператор задаёт InvitationAdmin__Key и создаёт административное приглашение через /api/admin/InviteUser/InvitationWithKey, передавая секрет в теле. JWT для этого метода не нужен; без настроенного ключа — 503. Затем выполняется обычная регистрация по коду. После настройки отключите этот способ, убрав ключ. Администрирование.

Можно ли запускать несколько серверов?

Не без дополнительной работы: presence, подключения, SRP challenge и rate limit локальны процессу; файлы тоже локальные. Нужны общая инфраструктура событий/файлов и согласованная обработка challenge. Эксплуатация.

Вход и история

Чем access отличается от refresh?

Access авторизует HTTP/SignalR; refresh меняет пару токенов на /api/auth/token/refresh. Refresh не работает как bearer access. По умолчанию access действует 10 минут, refresh-сессия — 30 дней с продлением. Аутентификация.

Почему старый парольный login перестал работать?

SRP-аккаунт получает Auth.PasswordProofRequired: используйте обновлённый клиент. Старый bcrypt-вход остался только для миграции. Не делайте автоматический fallback с передачей открытого пароля. Переход.

Почему после обновления токена второй запрос получил InvalidToken?

Refresh одноразово заменяет хеш. Параллельные обновления конкурируют; используйте один общий refresh и сохраните новую пару. Потеря ответа после сохранения также может потребовать нового входа.

Вошёл на новом устройстве, но старые сообщения не читаются. Почему?

Авторизация и ключи истории — разные данные. Если парольная копия настроена, архив восстанавливается по паролю; иначе нужен резервный код или доверенное устройство с ключами. Сервер не может создать отсутствующий приватный ключ. Восстановление.

Что делать, если забыт пароль?

Администратор может сбросить доступ, но не расшифровать историю. После входа задайте новый пароль и восстановите архив кодом/с устройства. Без старого пароля, кода и устройства можно лишь явно начать с новыми ключами. Полученные собеседниками копии этим не удаляются.

Нужно ли удалять ключи при выходе или сетевой ошибке?

Не удаляйте единственную копию истории автоматически. Завершение сессии и стирание архива — разные операции. Перед отказом от старого устройства проверьте восстановление на новом.

Может ли сервер читать зашифрованные сообщения?

Он хранит ciphertext и зашифрованные архивы, но не пользовательские секреты. Метаданные, участники, время и размеры видны; профиль, аватары и реакции не входят в ciphertext сообщения. Первая встреча и состав группы доверяют серверу. FS/PCS и прозрачности ключей нет. Подробные границы E2EE.

Чаты, файлы и события

Что передавать в recipientId личного сообщения?

ID PrivateChat, полученный через /api/user/{friendId}/private-chat. Это не friendId. Для группы передаётся groupId и recipientType=1.

Почему «публичная» группа не отдаёт историю всем?

Публичность разрешает поиск и вступление. История и команды требуют активного незаблокированного членства. Администратор сервера и администратор группы — разные роли. Группы.

Почему отправка сообщает E2EE_DEVICES_CHANGED?

Каталог устройств изменился между загрузкой ключей и отправкой. Перечитайте его и заново подготовьте согласованный конверт. Не переходите на открытый текст.

Можно ли повторить Send после сетевого сбоя?

Тот же E2EE-конверт с тем же messageId и контекстом распознаётся как сохранённая отправка. Новый messageId создаёт другую операцию. События могут повториться, поэтому объединяйте по ID. Это не общая идемпотентность всех методов.

Почему HTTP возвращает id, а хаб — messageId?

Это разные DTO. Явно преобразуйте их в общую клиентскую модель. Также различаются структуры HTTP/SignalR вложений. Сериализация.

Почему загрузка обычной картинки как вложения даёт 400?

Вложение сообщения сначала шифруется клиентом. MIME upload — application/vnd.govor.encrypted, ключ не передаётся открытым полем. Лимит 20 000 000 байт относится ко всему запросу, а не только исходному файлу. Медиа.

Почему отправленное сообщение не равно прочитанному?

Сохранение, доставка SignalR, принятие FCM и просмотр пользователем — разные этапы. Прочтение фиксируется отдельной командой. Прочтение.

Почему online не означает доступность для push?

Online отражает соединения PresenceHub в памяти процесса. Push зависит от FCM-токена сессии, разрешений ОС и провайдера. HTTP ping отдельно обновляет lastSeen.

Как восстановить пропущенные события?

После reconnect загрузите HTTP-снимки истории, счётчиков, реакций, групп/прав, заявок и открытых профилей. SignalR не предоставляет долговременный журнал. Порядок параллельных событий не определяет актуальные права.

Почему при выключенном Firebase нет отложенных push после включения?

NullPushProvider считает задачи обработанными. Он предназначен для работы без доставки, а не для накопления. Push.

Обновления и поддержка

Сохранятся ли вложения после нового Docker-образа?

Только при постоянном uploads и правильном mount. Сама БД хранит ссылки, но не заменяет файлы. VPS, резервные копии.

Можно ли откатить только образ после миграций?

Только если старый код совместим с новой схемой. Скрипт не откатывает БД автоматически. Нужны проверенная копия и план восстановления.

Какие данные приложить к сообщению об ошибке?

Версию сервера/клиента, UTC-время, метод/маршрут или команду хаба, HTTP/HubResult status, errorCode и обезличенный фрагмент лога. Не прикладывайте пароли, токены, runtime.env, service account или приватные ключи.