Files
Govor/docs
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
..

Govor — документация сервера

Govor — мессенджер с сервером ASP.NET Core и отдельным клиентом .NET MAUI. Здесь описаны запуск сервера, HTTP API, SignalR, шифрование, восстановление доступа и эксплуатация.

Документация сверена с серверным master, коммит a3401ce, 30 октября 2026 года. Описанное поведение относится к этой версии; установленный сервер может быть старше. Адреса и секреты в примерах условные.

С чего начать

Задача Раздел
Запустить API локально Быстрый старт
Подключить собственный клиент Путь интеграции, карта HTTP API
Разобраться с входом и токенами Аутентификация
Восстановить историю или сменить пароль Пароли и восстановление
Понять шифрование E2EE, API устройств и архивов
Настроить сервер на Timeweb VPS или App Platform
Найти причину ошибки Диагностика, частые вопросы
Проверить изменения Тестирование

Возможности

  • Регистрация по приглашению, вход с доказательством пароля SRP, access/refresh токены и управление сессиями.
  • Друзья, заявки, личные чаты, группы и каналы с отдельными ролями, приглашениями и модерацией.
  • История, отправка и редактирование сообщений, прочтение, удаление, реакции и паки.
  • E2EE сообщений и вложений, сертификаты устройств, ротация ключей, зашифрованный архив и восстановление по паролю/коду.
  • Профили, аватары, присутствие, SignalR-события и очередь push через Firebase.
  • PostgreSQL, миграции, Docker и GitHub Actions для развёртывания.

Что важно знать до интеграции

userId — пользователь, sessionId — сеанс входа, chatId — чат. Для личного сообщения recipientId означает PrivateChat.Id, а не ID собеседника. recipientType: 0 — личный чат, 1 — группа/канал.

HTTP загружает состояние, SignalR передаёт команды и события. После переподключения клиент перечитывает состояние через HTTP. События могут повторяться или пропускаться; push не подтверждает прочтение.

E2EE реализовано прикладным протоколом JOSE. Он не предоставляет forward secrecy, post-compromise security и прозрачность ключей; первая встреча и состав групп доверяют серверу. Модель доверия обязательна к прочтению перед реализацией другого клиента.

В проверке этой ревизии прошли 735 серверных тестов на SQLite. Это не подтверждение доставки Firebase на устройство или состояния production-инсталляции. Ограничения проверки.

Исходный код: Govor, a3401ce.