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:
Loki 2026-11-01 15:31:20 +01:00
parent d6d406bbf5
commit c18ccadf99
Signed by: boba
GPG key ID: 253067914055423B
96 changed files with 8665 additions and 276 deletions

View file

@ -1,6 +1,6 @@
# Vnox: регистрация, устройства и аватары
Статус: продуктовая и техническая спецификация. Регистрация Hub пока не реализована. Клиентский редактор аватара реализуется отдельно; до появления API сохраняет реальное изображение локально.
Статус на 2026-10-25: сервер Hub поддерживает браузерный вход через GitHub и почтовый код, API выбора уникального handle и отображаемого имени, а также собственные аватары. Контракт: `hub/AUTH.md`. Экран завершения регистрации, авторизация desktop, привязка устройств и проверка аккаунта на gateway ещё не реализованы. Редактор аватара desktop сохраняет изображение локально; синхронизации с Hub и другими участниками пока нет. Последующие разделы описывают целевую модель и не означают готовность всех функций.
## Вход и создание аккаунта

View 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-прав и сохранение каналов после загрузки БД.
Это не подтверждает слышимость реального микрофона и воспроизведения.