# Частые вопросы ## Запуск и сервер ### Нужны ли 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 или приватные ключи.