Files
Govor/docs
Artemy 33ef17f73d Support --migrate-only startup and secrets handling
Add a Timeweb deployment guide and improve secret handling and migrations.

- docs/timeweb-deployment.md: deployment and migration instructions for Timeweb.
- .gitignore: ignore a secrets/ folder.
- Govor.API.csproj: ensure secrets/** are not copied to output/publish.
- Program.cs: add --migrate-only flag (removes it from args), skip Firebase init when migrating, accept Firebase credentials via CredentialsJson or CredentialsPath/GOOGLE_APPLICATION_CREDENTIALS, resolve relative paths against content root, apply pending EF Core migrations and exit while logging progress.

Normal API startup behaviour unchanged (migrations are applied only with --migrate-only).
2026-10-04 11:22:39 +07:00
..

Govor.API — обзор

Govor — мессенджер на ASP.NET Core и .NET MAUI. Эта документация описывает сервер Govor.API и его контракт с клиентом. Стек сервера: .NET 10, EF Core, PostgreSQL, JWT, SignalR, Firebase и локальное хранилище файлов.

Что реализовано

Изменения рабочей копии сервера описаны в исправлениях, включая API прочтения. Страницы со ссылками на commit 4603be9 описывают исходную версию до этих исправлений.

Область Состояние по коду
Регистрация и вход Регистрация по приглашению, BCrypt, открытие сессии и пара токенов
Сессии Список, отзыв одной или всех сессий, обновление токенов
Друзья Поиск, списки, отправка/принятие/отклонение заявок через SignalR
Личные чаты Создание между друзьями, история, отправка и редактирование
Прочтение и удаление HTTP/SignalR, видимые сообщения/граница/весь чат, квитанции и счётчики; удаление с проверкой прав
Реакции HTTP/SignalR, базовые эмодзи, общие паки картинок/GIF, административный API и выбор разрешённых реакций канала
Профиль Описание, аватар, загрузка профиля и события изменений
Присутствие События подключения/отключения; исправлены зависимости HTTP status
Медиа и push Доступ к вложениям, привязка FCM к сессии, очередь и повторные попытки
Группы и каналы Публичный поиск, приватные приглашения, владелец/админы/участники, баны, модерация и обязательный канал
Шифрование Есть хранение публичных ключей, но готового E2EE нет

Как читать

Начните с «Запуск и конфигурация» и «Аутентификация». Для чатов используйте HTTP для истории и SignalR для команд и событий. Раздел «Диагностика» описывает ограничения, которые нельзя считать рабочими гарантиями API.

Имена userId, friendId, chatId обозначают разные сущности. В сообщениях личного чата recipientId — ID записи PrivateChat, а не ID собеседника.

Границы готовности

Документация новых групп и реакций описывает рабочую серверную копию с исправлениями доступа. Проверки HTTP/JWT, SQL и прав выполняются автоматическими тестами; реальная доставка на устройства и производственное развёртывание требуют отдельной проверки. Страницы с commit 4603be9 фиксируют старую диагностику и не описывают все текущие исправления.

Эффект стекла относится к MAUI-интерфейсу. API передаёт данные и события; производительность размытия, контрастность и анимации нужно проверять отдельно на устройствах.

Регистрация сейчас требует код приглашения. Обещание отключить приглашения после релиза является продуктовым планом, а не поведением текущего кода.


Проверено по исходникам на 03.10.2026, commit 4603be9. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.

Источник: Govor.API/Program.cs.