mirror of
https://github.com/Govor-team/Govor.git
synced 2026-11-17 12:59:25 +00:00
GITBOOK-14: Govor.API: документация по текущему коду и диагностика 03.10.2026
This commit is contained in:
committed by
gitbook-bot
parent
4603be9f71
commit
6c8abb23e3
+25
-30
@@ -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).
|
||||
|
||||
Reference in New Issue
Block a user