VNOX-Server/docs/design/ownership-and-admin-audit.md
loki5512344 c18ccadf99
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.
2026-11-01 15:31:20 +01:00

7.4 KiB
Raw Permalink Blame History

Владение узлом и сообществом: состояние реализации

Обновлено 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/, правила авторизации.

Чего нет и что требует исправления

  1. Установка сервера на VPS не привязывает автоматически аккаунт оператора. Настройка admin_account_ids уже реализована; root/оператор явно указывает Central UUID. Одноразовый claim/bootstrap через клиент пока не реализован. Нельзя выдавать админку первому подключившемуся.
  2. Передача owner_id другому участнику не реализована. В спецификации Community Model поле пока обозначено 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-прав и сохранение каналов после загрузки БД. Это не подтверждает слышимость реального микрофона и воспроизведения.