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.
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.