GITBOOK-14: Govor.API: документация по текущему коду и диагностика 03.10.2026

This commit is contained in:
stalcke2288969
2026-10-03 06:20:45 +00:00
committed by gitbook-bot
parent 4603be9f71
commit 6c8abb23e3
27 changed files with 827 additions and 1901 deletions
+25 -30
View File
@@ -3,46 +3,41 @@ icon: face-confounded
coverY: 0
---
# The invitation code RU
# Govor.API — обзор
### Что это такое
Govor — мессенджер на ASP.NET Core и .NET MAUI. Эта документация описывает сервер Govor.API и его контракт с клиентом. Стек сервера: .NET 10, EF Core, PostgreSQL, JWT, SignalR, Firebase и локальное хранилище файлов.
**Код приглашения** — это временный механизм доступа, действующий на этапах **альфа-** и **бета-тестирования** мессенджера **Говор**.\
Он используется для **ограничения количества аккаунтов** и **контроля числа пользователей**, получающих ранний доступ к продукту.
## Что реализовано
Пока Говор находится в стадии активной разработки и внутреннего тестирования, регистрация новых пользователей возможна **только при наличии действующего кода приглашения**.
| Область | Состояние по коду |
| -------------------- | ------------------------------------------------------------------------------ |
| Регистрация и вход | Регистрация по приглашению, BCrypt, открытие сессии и пара токенов |
| Сессии | Список, отзыв одной или всех сессий, обновление токенов |
| Друзья | Поиск, списки, отправка/принятие/отклонение заявок через SignalR |
| Личные чаты | Создание между друзьями, история, отправка и редактирование |
| Прочтение и удаление | Методы есть; проверки доступа и семантика требуют исправления |
| Профиль | Описание, аватар, загрузка профиля и события изменений |
| Присутствие | События подключения/отключения; HTTP status сломан |
| Медиа и push | Загрузка/скачивание файлов, регистрация FCM-токена |
| Группы | Модели и часть сервисов сообщений; полноценный сценарий управления не завершён |
| Шифрование | Есть хранение публичных ключей, но готового E2EE нет |
### Как получить код приглашения
## Как читать
Коды приглашения **создаются администрацией проекта** и **выдаются вручную** по мере готовности новых тестовых слотов.
Начните с «Запуск и конфигурация» и «Аутентификация». Для чатов используйте HTTP для истории и SignalR для команд и событий. Раздел «Диагностика» описывает ограничения, которые нельзя считать рабочими гарантиями API.
Чтобы запросить код приглашения:
Имена `userId`, `friendId`, `chatId` обозначают разные сущности. В сообщениях личного чата `recipientId` — ID записи PrivateChat, а не ID собеседника.
1. Свяжитесь с командой разработчиков.
2. Кратко опишите, зачем вы хотите протестировать Говор.
3. Дождитесь ответа с вашим уникальным кодом.
## Границы готовности
📩 **Контакт для запроса:**\
`BurntRoostersOfficial@protonmail.com`
Текущая версия не готова к открытому развёртыванию: обнаружены критичные ошибки авторизации и доступа к личным чатам. Контракты ниже полезны для разработки, но не являются подтверждением безопасности.
### Как выглядит код
Эффект стекла относится к MAUI-интерфейсу. API передаёт данные и события; производительность размытия, контрастность и анимации нужно проверять отдельно на устройствах.
Код приглашения представляет собой **уникальный случайно сгенерированный идентификатор** (объект `Guid`).\
Пример:
Регистрация сейчас требует код приглашения. Обещание отключить приглашения после релиза является продуктовым планом, а не поведением текущего кода.
```
c7a5f1b3-8c64-47e2-9e3e-b7df6a2b021f
```
***
### Ограничения
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
Каждый код приглашения имеет:
* 🔹 **Ограниченное количество регистраций.**\
После достижения лимита использование кода становится невозможным.
* ⏳ **Ограниченный срок действия.**\
По истечении времени жизни код автоматически теряет актуальность.
### После официального релиза
После выхода **первой стабильной версии Говора** система кодов приглашений будет **отключена**, и регистрация станет **открытой для всех пользователей**.
Источник: [Govor.API/Program.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.API/Program.cs).