chore(server): checkpoint deployed services and unfinished forums
User requested a checkpoint and stopped all agents. Deployed artifacts remain the last verified releases; unfinished settings/categories/forums are preserved as WIP. See TODO/roadmap for verification and remaining release/updater work.
This commit is contained in:
parent
d6d406bbf5
commit
c18ccadf99
96 changed files with 8665 additions and 276 deletions
|
|
@ -1,6 +1,6 @@
|
|||
# Vnox: регистрация, устройства и аватары
|
||||
|
||||
Статус: продуктовая и техническая спецификация. Регистрация Hub пока не реализована. Клиентский редактор аватара реализуется отдельно; до появления API сохраняет реальное изображение локально.
|
||||
Статус на 2026-10-25: сервер Hub поддерживает браузерный вход через GitHub и почтовый код, API выбора уникального handle и отображаемого имени, а также собственные аватары. Контракт: `hub/AUTH.md`. Экран завершения регистрации, авторизация desktop, привязка устройств и проверка аккаунта на gateway ещё не реализованы. Редактор аватара desktop сохраняет изображение локально; синхронизации с Hub и другими участниками пока нет. Последующие разделы описывают целевую модель и не означают готовность всех функций.
|
||||
|
||||
## Вход и создание аккаунта
|
||||
|
||||
|
|
|
|||
74
docs/design/ownership-and-admin-audit.md
Normal file
74
docs/design/ownership-and-admin-audit.md
Normal file
|
|
@ -0,0 +1,74 @@
|
|||
# Владение узлом и сообществом: состояние реализации
|
||||
|
||||
Обновлено 2026-11-01 после проверки и установки LNEx v4. Администраторы узла
|
||||
задаются оператором в `[gateway] admin_account_ids = ["Central-account-UUID"]`.
|
||||
Проверяется аккаунт конкретной аутентифицированной сессии; имя и ключ другого
|
||||
устройства сами по себе прав не дают. Администратор управляет глобальными
|
||||
текстовыми/голосовыми каналами; права внутри сообществ остаются отдельными.
|
||||
Клиент получает capability `Session.node_admin` и показывает создание,
|
||||
переименование и подтверждение удаления каналов. Решение всегда принимает сервер.
|
||||
|
||||
Это аудит поведения и список следующих шагов, а не замена документации протокола.
|
||||
|
||||
## Что уже есть
|
||||
|
||||
- При `GuildCreate` gateway берёт владельца из аутентифицированной сессии,
|
||||
а не из пользовательского запроса. Создатель записывается в `guilds.owner_id`
|
||||
и становится участником своего сообщества.
|
||||
- Владелец проходит проверки прав своего сообщества независимо от ролей.
|
||||
Удаление сообщества разрешено только владельцу; владельца нельзя исключить.
|
||||
- Роли содержат битовую маску, включая `MANAGE_ROLES`, `MANAGE_CHANNELS`,
|
||||
`KICK_MEMBERS` и `ADMINISTRATOR`. Назначение роли проверяет принадлежность
|
||||
роли и участника тому же сообществу. Ограниченный управляющий ролями не может
|
||||
выдать права, которых у него нет.
|
||||
- Это права сообщества. Для глобальных каналов действует отдельный список
|
||||
`gateway.admin_account_ids`. Базовые `general` и `voice` нельзя удалить.
|
||||
Адрес `gateway.admin_bind` предоставляет health/version/metrics и не выдаёт админку.
|
||||
|
||||
Источники: `gateway/src/handler/guild/`,
|
||||
`gateway/src/domain/storage/guilds/`, [правила авторизации](channel-authorization.md).
|
||||
|
||||
## Чего нет и что требует исправления
|
||||
|
||||
1. Установка сервера на VPS не привязывает автоматически аккаунт оператора.
|
||||
Настройка `admin_account_ids` уже реализована; root/оператор явно указывает
|
||||
Central UUID. Одноразовый claim/bootstrap через клиент пока не реализован.
|
||||
Нельзя выдавать админку первому подключившемуся.
|
||||
2. Передача `owner_id` другому участнику не реализована. В спецификации
|
||||
[Community Model](../07-community-model.md) поле пока обозначено immutable.
|
||||
Нужны сначала контракт и политика восстановления, затем атомарная операция
|
||||
с проверкой текущего владельца, целевого участника, подтверждением и аудитом.
|
||||
3. Создаваемая роль `@everyone` содержит `u64::MAX` и назначается только
|
||||
создателю. Новые участники не получают её автоматически. Поэтому сейчас это
|
||||
фактически административная роль с неверным названием, а не базовые права
|
||||
всех участников. Нельзя начать автоматически назначать её всем: это выдаст
|
||||
административные права. Нужны безопасные базовые права и явная миграция.
|
||||
4. В текущем Slint-клиенте есть сетевые команды создания сообщества, ролей,
|
||||
приглашений и назначения ролей, но нет законченного интерфейса управления.
|
||||
`GuildState` теряет `owner_id` при обработке списка и создания сообщества;
|
||||
результаты создания ролей и приглашений пока не используются интерфейсом.
|
||||
5. LNEx v4 связывает Central-аккаунт с ключом устройства подписанным proof.
|
||||
Владение существующим сообществом по-прежнему определяется device identity;
|
||||
простой вход в Central не переносит это владение. Важно сохранять её ключ.
|
||||
|
||||
## Следующие шаги клиента
|
||||
|
||||
1. Сохранить `owner_id`, участников, роли и подтверждённые сервером права
|
||||
в состоянии клиента; показывать владельца и доступные действия.
|
||||
2. Доделать создание сообщества, приглашения, управление каналами, ролями,
|
||||
назначениями и исключением участников. Обрабатывать отказ сервера и
|
||||
обновление прав во время открытого окна управления.
|
||||
3. Добавить получение админки узла и передачу владения только после согласования
|
||||
соответствующих серверных контрактов; интерфейс не может сам выдать права.
|
||||
4. Добавить каталог серверов/переход с сайта отдельно от получения прав.
|
||||
Автор объявления в каталоге не считается владельцем VPS или сообщества.
|
||||
|
||||
## Проверка существующего хостинга
|
||||
|
||||
На 2026-11-01 узел `185.176.94.38:7600` работает через `vnox-server.service`
|
||||
(`vnox-serverd`, автозапуск включён), голосовой UDP-порт `7700` используется
|
||||
без изменения протокола. Health отвечает `ok`, gateway сообщает LNEx v4.
|
||||
Оператором настроены права управления глобальными каналами аккаунта `loki`.
|
||||
Проверены подпись аккаунта, второе устройство, отказ другому аккаунту с тем же
|
||||
ключом, отсутствие обхода guild-прав и сохранение каналов после загрузки БД.
|
||||
Это не подтверждает слышимость реального микрофона и воспроизведения.
|
||||
Loading…
Add table
Add a link
Reference in a new issue