VNOX-Client/TODO.md

33 KiB
Raw Permalink Blame History

Задачи клиента

Текущий запрос: 2026-11-01

Сначала фиксируем задачи здесь; завершение отмечаем только после проверки.

Проверка объединённого клиента 2026-11-01: 190 тестов прошли, 2 существующих игнорируются; headless GUI с изолированным профилем проверяет 12 тем и модели. Сервер с вложениями и профилями установлен; 164 теста релизного workspace прошли. Живая проверка слышимости двумя людьми остаётся отдельной открытой задачей.

Форумы: отдельные темы и ответы через gateway

  • Сначала согласовать LNEx-контракт: список тем, создание, открытие, история и ответы; capability старого gateway, права узла/сообщества и лимиты.
  • Добавить сетевые команды/события и состояние форума с защитой от устаревших ответов после смены сервера/канала и понятными состояниями загрузки/ошибки.
  • Показывать настоящий список тем, создание темы с первым сообщением, открытие истории и ответы, подтверждённые gateway; не подменять форум плоским чатом.
  • Сохранить безопасное поведение аудио: форум и категория никогда не инициируют voice join или захват микрофона; старый gateway не получает новые пакеты.
  • Проверить wire/state регрессии, отсутствие ложного успеха при отказе, контекст узла/сообщества и headless UI только в виртуальном display/профиле.

Дополнение: профили, присутствие, темы и виртуальная QA

План палитр: тёмные Extra dark (black), Graphite (dark), Midnight, Pine, Aubergine, Espresso; светлые Porcelain (light), Mist, Glacier, Sage, Rose, Sand. Проверка: 12 сохраняемых пресетов, переключатель группы 6 карточек, точные миниатюры, сохранение старых идентификаторов; WCAG 2.2 — текст ≥4.5:1, значимые границы/фокус ≥3:1, выбранное состояние обозначено галочкой. GUI QA — только виртуальный дисплей/изолированный профиль.

  • Запоминать последний успешно подключённый сервер и восстанавливать подключение при запуске после восстановления/подтверждения Central-сессии; учитывать ручное отключение и настройку автоматического подключения. План восстановления: отдельный connection.json хранит только нормализованный адрес успешного подключения, auto-reconnect и явное ручное отключение. Черновик адреса не сохраняется; запуск и завершение входа используют обычный Connect с онлайн-проверкой Central и TLS. Отзыв входа возвращает панель входа. Проверки: сериализация, черновик/успех, нормализация, выключенный auto-reconnect, ручное отключение и отсутствие аккаунта; GUI — изолированный virtual display.
  • Исправить присутствие одного аккаунта с несколькими сессиями: не дублировать участника, не удалять его при закрытии только одной сессии, корректно учитывать последнюю сессию. Проверить две сессии и выход в обоих порядках.
  • Исправить отображение аватара Central в клиенте и данных профиля при входе; отдельный локальный QA-профиль не должен подменять профиль пользователя.
  • Сделать Extra dark темой по умолчанию для новых профилей, сохранив явный выбор существующего пользователя. Обновить миниатюры тем под реальные палитры.
  • Добавить 6 тёмных и 6 светлых тем, переключатель группы вместо показа всех 12 одновременно, сохранение выбора и согласованное отображение настроек.
  • Все дальнейшие GUI-проверки запускать в отдельном виртуальном display и изолированном профиле. Не создавать тестовые окна в Hyprland пользователя, не менять фокус/буфер/настройки рабочего стола и не использовать его аккаунт.

Плавный локальный тест микрофона

  • Исправить задержку/рывки live-monitor: убрать callback-аллокации и try_lock-потери, сохранять фазу ресемплера между callback, ограничить очередь 60 мс с начальным заполнением 20 мс и удалением старого хвоста только consumer.
  • Запрашивать поддерживаемый CPAL buffer около 5 мс с fallback к default; сгладить индикатор hold/decay. Проверить 44.1/48/96 kHz, произвольные размеры callback, overflow/underrun/clock drift и отсутствие callback-аллокаций.
  • Сверить реализацию с официальными CPAL/PulseAudio/RNNoise; проверять синтетически/в виртуальной среде. Физическую задержку и слышимость без отдельной живой проверки не считать измеренными.

Трей и закрытие окна

  • При закрытии окна сворачивать приложение в системный трей, сохраняя подключение и голос; полностью завершать процесс через явный пункт «Выйти».
  • Меню трея: «Открыть», «Настройки», «О программе», разделитель, «Перезапустить», «Выйти». Нажатие на значок возвращает существующее окно.
  • Проверить поддержку Linux StatusNotifierItem и восстановление окна, отсутствие второго экземпляра при повторном открытии, корректное отключение голоса и сети при выходе/перезапуске. GUI-проверки только в виртуальной среде.
  • Предусмотреть настройку «Сворачивать в трей при закрытии» и обычное закрытие, если системный трей недоступен, чтобы окно не исчезало безвозвратно.

Медиа в чате

  • Показывать изображения и анимированные GIF по прямым HTTPS-ссылкам в сообщениях (включая пример пользователя https://evolationstudios.ru/admindata/gifs/cuckoding2.gif).
  • Добавить вставку картинки из системного буфера, предпросмотр, отмену и отправку настоящего вложения, доступного другим участникам и после перезапуска.
  • Сначала описать хранение и передачу вложений, права доступа и лимиты; проверить форматы, размер, декодирование и ограничения загрузок.
  • Проверить GIF-анимацию, ошибки/отсутствие сети, вставку при русской раскладке и отсутствие повторной загрузки при каждом обновлении UI.
  • Отложено: голосовые сообщения. В текущий объём реализации не входят.
  • Следующий этап вложений: очистка неиспользуемых файлов после удаления сообщений и политика хранения; сейчас удаление сообщения не освобождает квоту немедленно. Добавить отправку вложений в DM после отдельного контракта.

Текущие вложения: PNG/JPEG/GIF до 3 MiB в текстовом канале, с явным подтверждением отправки. Прямые HTTPS-ссылки отображаются отдельно.

  • Перейти на нативные PipeWire/PulseAudio в Linux, показывать системные входы/выходы без технических ALSA-дублей и с постоянным выбором по ID.
  • Добавить выбор микрофона/выхода по ПКМ на нижних кнопках, сохранив обычное нажатие для mute/deafen.
  • Усилить контраст встроенных тем, кнопок и блока голосового подключения.
  • Добавить локальную проверку микрофона с уровнем и прослушиванием, остановкой при закрытии настроек и без отправки теста собеседникам.
  • Добавить работающий переключатель RNNoise и сохранение настройки.
  • Показывать заметную обводку своего аватара при передаче голоса.
  • Обязать вход в Central до подключения; gateway должен проверять подтверждение аккаунта, привязанное к ключу клиента. Сначала спецификация авторизации desktop и LNEx; несовместимые изменения требуют новой версии.
  • Собрать и установить обновлённый клиент. Установленный release проверен в отдельном Xvfb с пустым профилем: экран обязательного входа, открытие настроек, переход к темам, переключение группы и выбор палитры настоящими X11-кликами. Проверка слышимости с реальными устройствами остаётся отдельной задачей ниже.
  • Исследовать и исправить Ctrl+V из системного буфера в поля Slint при русской и английской раскладке; сначала проверить документацию/известные проблемы и воспроизвести в этой сборке. Проверены реальные Wayland-события EN/RU, обычное поле, пароль и TextEdit; причина и ограничения: буфер Wayland. Shift+Insert штатно не поддерживается Slint 1.18.1; этот фикс его не добавляет.
  • Показывать дату и время у сообщений не за сегодняшний день; для сегодняшних оставить короткое время. Проверить полночь и локальный часовой пояс.

Связанные задачи сайта: сохраняемая серверная сессия, собственный аватар в шапке, генерируемый VNOX-аватар вместо GitHub и его замена загрузкой.

Актуальные локальные задачи. Подробности пользовательского теста и уже исправленные дефекты: UX-дефекты. Общий план платформы: roadmap сервера. docs/slint-migration-plan.md является историческим планом миграции.

Отзывчивость и звук

  • Перенести повторный опрос аудиоустройств при открытии настроек из потока интерфейса. Сохранять текущий выбор по ID, объединять повторные запросы, сохранять предыдущий список при ошибке. Проверить медленный опрос тестом.
  • Проверить слышимость голоса между двумя реальными клиентами после исправлений из потока B. Автоматический UDP-тест не проверяет микрофон, устройства воспроизведения и слышимость речи человеком.

Central и аватары

  • Реализовать вход клиента через Central после документирования серверного контракта авторизации desktop/device enrollment и проверки доказательств аккаунта на gateway. Наличие браузерной сессии Hub само по себе не решает эту задачу. См. пункты 10d и 10e списка UX-дефектов.
  • Определить и реализовать получение профиля и аватара других участников, обновление кэша и правила видимости после согласования LNEx-контракта. Собственный аватар и аватары авторов сообщений загружаются из Central; профиль хранится в UI без чтения аккаунта с диска на каждом обновлении. См. пункты 2, 12b и 12c списка UX-дефектов.

Изменения LNEx сначала описываются в документации протокола. Значительные изменения аккаунтов и обязательного входа требуют обсуждения до реализации.

Сообщества и администрирование

Аудит кода: владение и админка.

  • Сохранять owner_id в GuildState, показывать владельца сообщества.
  • Доделать создание сообщества и работу с приглашениями в Slint.
  • Добавить управление участниками, ролями и каналами с обработкой подтверждений/отказов gateway и изменения прав во время работы.
  • Реализовать получение админки узла и передачу владения после утверждения серверных контрактов. Запуск VPS и публикация в каталоге не выдают эти права.
  • Добавить просмотр каталога серверов и удобный перенос адреса в подключение.

Account presence and Central member profiles (2026-11-01)

  • Keep authenticated Central account IDs separate from Ed25519 device IDs. Channel subscriptions and voice routes remain session/device scoped; account member rows aggregate devices. Closing either of two sessions must retain the other session, member and online presence.

  • Distribute Central-signed display names and same-origin avatar paths in additive member metadata; fetch bounded PNGs without forwarding credentials, cache successful results, and retain initials on errors. Preserve guild ownership and historical device IDs.

  • Verify two-device and repeated-device lifecycle, profile propagation and rejected avatar origins with regression tests.

  • Own Central profile is cached on startup/sign-in; Central avatar overrides local photo, clears at logout, and message authors use the same member avatar cache. Failed public PNG fetches retry after 30 seconds.

Установленная сборка — 2026-11-01

Release 20261101-45c6c964b447, запускается через ~/.local/bin/vnox-client. Предыдущая сборка сохранена. GUI QA: /tmp/vnox-virtual-release-eo95no3t, 67 headless снимков: /tmp/vnox-theme-qa/screens. Рабочий стол пользователя не использовался; его запущенный клиент не перезапускался.

Исправление сетки тем — 2026-11-01

  • Выровнять ширину карточек независимо от подписей и ограничить ширину сетки, чтобы превью не растягивались на широком окне. Проверить 1024/1280/1920 px в изолированном headless renderer, затем установить исправленную сборку.

Desktop Central avatar correction (2026-11-01)

  • Refresh and persist the Central summary at admission and bounded background/profile-view refresh; deliver updates to UI without reading credentials every tick. Drop late results after logout or enrollment replacement.

  • Restore desktop photo choose/crop/upload/delete against Central enrollment-authenticated endpoints. Reuse normalized PNG storage/default avatar and account/IP budgets; no browser cookie or profile migration 6.

  • Verify website-avatar refresh, authenticated PNG upload/delete, device binding, expired/revoked secrets, invalid image limits, and summary/UI propagation.

  • Add desktop editable Central display_name with signed enrollment-authorized profile mutation, existing 64-character/control validation, persisted summary/watch update and name-adjacent Save/status controls. Unique handle and ownership IDs remain unchanged.

Desktop name/photo mutations update the own account UI and persisted enrollment immediately. Live signed profile propagation below supersedes the original admission-only peer refresh limitation; no forced reconnect is used.

Проверка исправлений профиля/звука: 199 тестов клиента прошли, 2 существующих пропущены. Новый Hub: 167 тестов; live endpoints требуют авторизацию (401 без неё). Подробности звука и источники: локальный монитор.

Дополнительная причина пустого аватара: live Cloudflare возвращал 403 запросам публичного PNG без User-Agent; с VNOX-Desktop/0.1 тот же адрес возвращал 200 image/png. Загрузчик публичных аватаров теперь использует этот User-Agent.

Обновление профиля и звука установлено — 2026-11-01

Release 20261101-0cf5ad21b61a: выбор/обрезка/загрузка/удаление фото Central, редактирование имени, обновление профиля с сайта, исправление HTTP403 аватаров, ровная сетка тем, новый локальный микрофонный монитор. 199 тестов клиента, 2 прежних ignored; all-target Clippy и форматирование проходят. Hub: 167 тестов. Установленный бинарник проверен в Xvfb /tmp/vnox-virtual-release-jfhth5xz: открытие профиля, поле имени, кнопки фото, успешная загрузка публичного PNG через production Cloudflare. Использовался отдельный фиктивный кэш профиля без действующей авторизации; реальные пользовательские учётные данные не читались. Фиктивный файл удалён. Настоящая задержка гарнитуры не измерялась.

Live signed Central profile propagation (2026-11-01)

  • Add documented device/account-bound signed ProfileUpdate/ProfileUpdated packets; gateway verifies claims, prevents older-timestamp downgrade and broadcasts only through current shared-channel visibility.
  • Forward existing refresh proofs; coalesce background refresh before new chat/voice join with five-second TTL while UDP/keepalives continue. Update member/message/voice profile maps without adding members or reconnecting.
  • Verify two-client old→new name/avatar after chat and voice rejoin, no membership duplication/disconnect, rejected forged/wrong-account/stale proof and visibility revocation.

Ник при регистрации и первое знакомство

  • Генерировать дружелюбный русский слово_0000 CSPRNG только при первом создании email/GitHub-аккаунта; не брать имя провайдера, не менять handle и существующие пользовательские имена. Сохранить JSON-словарь, источник и лицензию.
  • Предложить «Изменить сейчас / Позже» в веб-профиле; явное решение хранить на сервере, существующим аккаунтам не навязывать onboarding. Новый независимый endpoint имени не должен требовать отложенную миграцию профилей/handle.
  • Проверить регистрацию обоими способами, повторный вход/свой ник, формат, CSRF/Origin, идемпотентное решение и Web-сборку/тесты в изолированной среде.

Живой профиль, первый ник и стандартные аватары — 2026-11-01

  • Передавать подтверждённый Central профиль без переподключения TCP: обновлять при сообщении/повторном входе в войс и после изменения имени/фото. Не доверять неподписанным именам, сохранять права и ключи устройств.
  • Первый ник: словарь JSON с источником/лицензией, слово_0000, назначение только при создании аккаунта; предложение изменить сейчас/позже с сохранением решения. Выбранные существующие имена не перезаписывать.
  • Стандартные аватары v2: стабильные пиксельные монстрики из публичного UUID, новые versioned URL из-за immutable cache; прежний v1 продолжает работать. Проверить разнообразие/детерминизм/PNG256, отсутствие запросов о наличии аккаунта.

Управление каналами администратором узла

  • Принять server-advertised Session.node_admin и сбрасывать право при отключении. Показать управление только глобальными каналами вне guild/DM.
  • Добавить создание text/voice, переименование и подтверждённое удаление; повторно проверять capability/scope перед отправкой, ждать server ack/error с таймаутом, не менять список оптимистично. Gateway остаётся авторитетом.
  • Подключить существующий ChannelEdit (0x36), проверить не-admin/false-default, потерю прав, input validation и headless create/rename/delete/error/confirm.

Explicit node administrator capability (2026-11-01)

  • Advertise additive Session.node_admin; global channel controls require operator-configured verified Central account UUID, never first visitor/name/device alone. Guild permissions remain separate.

  • Verify account's second device, unlisted accounts, cross-guild denial, bootstrap protection and channel persistence across cache/bootstrap reload.

  • Negotiate Session.live_profiles (field 5): legacy v4 gateways receive no ProfileUpdate packets and no profile-based activity delay; capable gateways retain proof-before-action ordering.

Завершение живого профиля и админки

  • Неподдерживаемый старым V4-сервером ProfileUpdate не отправляется: поддержка определяется Session.live_profiles; чат/голос продолжают работать.
  • Ошибка обновления профиля не отменяет вход в голос; выход отменяет также ожидающий join, включая ожидание reconnect. Создание voice-канала не включает микрофон.
  • Команды администратора привязаны к конкретной сессии и отбрасываются после смены узла; старый запрос не переносится на новый сервер.
  • На VPS аккаунту loki назначен gateway.admin_account_ids, сохранены серверные ключи/данные, новый Hub и Web установлены. Финальные серверные проверки: 181 тест, Clippy, fmt; Web: 28 тестов и сборка.

Клиент: 218 тестов прошли, 2 существующих ignored; all-target Clippy и каталоги 297 native / 459 shared проверены. Графический тест — изолированный headless renderer, включая настоящие software-click проверки создания/изменения/удаления.

Установлено — финальная сборка 2026-11-01

Release 20261101-f16a49f9c678, запуск через ~/.local/bin/vnox-client. 218 тестов, 2 ignored, Clippy/fmt/каталоги проходят. Виртуальная native-проверка установленного бинарника: /tmp/vnox-virtual-release-r1fnf8kh, профиль с новым монстриком загружается через production HTTP; тестовый кэш без действительной авторизации удалён. Source snapshot и предыдущий бинарник сохранены рядом с release. Реальный пользовательский процесс не перезапускался и экран не использовался.

Меню узла, настройки и категории

  • Добавить раскрытие меню по имени сервера и отдельные настройки узла только по подтверждённым правам; настоящее сохранение имени сервера с ACK/error.
  • По правой кнопке в списке каналов открыть меню «Текстовый / Голосовой / Категория / Форум»; контекст категории сохранять, правая кнопка не входит в голос.
  • Показать категории с дочерними каналами и сворачиванием; повторно проверять capability и session fence для всех операций. Меню закрываются Escape/вне меню, клавиатурные действия поддерживаются; никаких пустых страниц настроек.
  • Проверить сохранение имени/категорий через сервер и виртуальные UI-сценарии меню, outside click, Escape, запрет не-admin, создание внутри категории.

Версии, обновления и публичный релиз — запрос 2026-11-01

  • Ввести согласованную версию клиента/протокола/релизных артефактов; показывать установленную версию и состояние обновления в настройках.
  • Проверка новых версий через Central и GitHub Releases; ручное обновление и отключаемое автообновление. Проверять подписанный manifest/хеши, защищаться от подмены, downgrade, опасной распаковки и запуска непроверенных файлов.
  • Безопасное атомарное обновление с сохранением профиля и возможностью отката; разделить проверку, загрузку и установку, не прерывать активный войс.
  • После завершения настроек/категорий/форумов выполнить сквозную проверку голосового чата в изолированной среде; не считать сетевой relay-тест подтверждением слышимости реальной гарнитуры человеком.
  • Настроить/проверить CI сборок Linux и Windows; выпустить GitHub Release с бинарниками, подписанным manifest, контрольными суммами и changelog.

Репозиторий публичных релизов подтверждён пользователем: https://git.wihuk.pro/boba/VNOX-Client.git. Cargo.repository приведён к origin. Проверка/публикация обновлений должна использовать этот сервис, а не GitHub.

Контрольная точка: остановлено по просьбе пользователя — 2026-11-01

Все три агента остановлены. Работающие версии оставлены установленными:

  • Client: 20261101-f16a49f9c678 (218 тестов, 2 ignored, Clippy проходил).
  • Gateway VPS: 20261101-live-capability-219376accf98.
  • Central: 20261101-live-admin-91595d45652a; Web: 20261101-names-monsters-ff473f423565.
  • Аккаунт loki имеет права управления глобальными каналами узла.

В коммитах сохранён НЕЗАВЕРШЁННЫЙ следующий этап, не опубликованный в production:

  • меню заголовка/ПКМ, настройки имени/описания узла, категории и форумы;
  • серверное хранилище уже имеет 6 проходивших focused-регрессий, но общий финальный client/server build и интеграционная проверка ещё не завершены.
  • версии/автообновление/релиз Linux+Windows пока только запланированы.

Продолжение: сначала завершить сборку и общие тесты текущего черновика, затем проверить voice relay/чат/форумы в изолированной среде, собрать и развернуть; после этого реализовать updater с подписанным manifest и выпустить бинарники в https://git.wihuk.pro/boba/VNOX-Client.git. Cargo.repository уже исправлен. Не запускать тестовые приложения на рабочем столе пользователя.