VNOX-Client/TODO.md

338 lines
33 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Задачи клиента
## Текущий запрос: 2026-11-01
Сначала фиксируем задачи здесь; завершение отмечаем только после проверки.
Проверка объединённого клиента 2026-11-01: 190 тестов прошли, 2 существующих
игнорируются; headless GUI с изолированным профилем проверяет 12 тем и модели.
Сервер с вложениями и профилями установлен; 164 теста релизного workspace прошли.
Живая проверка слышимости двумя людьми остаётся отдельной открытой задачей.
### Форумы: отдельные темы и ответы через gateway
- [x] Сначала согласовать LNEx-контракт: список тем, создание, открытие,
история и ответы; capability старого gateway, права узла/сообщества и лимиты.
- [x] Добавить сетевые команды/события и состояние форума с защитой от устаревших
ответов после смены сервера/канала и понятными состояниями загрузки/ошибки.
- [ ] Показывать настоящий список тем, создание темы с первым сообщением,
открытие истории и ответы, подтверждённые gateway; не подменять форум плоским чатом.
- [x] Сохранить безопасное поведение аудио: форум и категория никогда не
инициируют 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 — только виртуальный дисплей/изолированный профиль.
- [x] Запоминать последний успешно подключённый сервер и восстанавливать
подключение при запуске после восстановления/подтверждения Central-сессии;
учитывать ручное отключение и настройку автоматического подключения.
План восстановления: отдельный `connection.json` хранит только нормализованный
адрес успешного подключения, auto-reconnect и явное ручное отключение.
Черновик адреса не сохраняется; запуск и завершение входа используют обычный
Connect с онлайн-проверкой Central и TLS. Отзыв входа возвращает панель входа.
Проверки: сериализация, черновик/успех, нормализация, выключенный auto-reconnect,
ручное отключение и отсутствие аккаунта; GUI — изолированный virtual display.
- [x] Исправить присутствие одного аккаунта с несколькими сессиями: не дублировать
участника, не удалять его при закрытии только одной сессии, корректно
учитывать последнюю сессию. Проверить две сессии и выход в обоих порядках.
- [x] Исправить отображение аватара Central в клиенте и данных профиля при входе;
отдельный локальный QA-профиль не должен подменять профиль пользователя.
- [x] Сделать Extra dark темой по умолчанию для новых профилей, сохранив явный
выбор существующего пользователя. Обновить миниатюры тем под реальные палитры.
- [x] Добавить 6 тёмных и 6 светлых тем, переключатель группы вместо показа всех
12 одновременно, сохранение выбора и согласованное отображение настроек.
- [ ] Все дальнейшие GUI-проверки запускать в отдельном виртуальном display и
изолированном профиле. Не создавать тестовые окна в Hyprland пользователя,
не менять фокус/буфер/настройки рабочего стола и не использовать его аккаунт.
### Плавный локальный тест микрофона
- [x] Исправить задержку/рывки live-monitor: убрать callback-аллокации и
try_lock-потери, сохранять фазу ресемплера между callback, ограничить очередь
60 мс с начальным заполнением 20 мс и удалением старого хвоста только consumer.
- [x] Запрашивать поддерживаемый CPAL buffer около 5 мс с fallback к default;
сгладить индикатор hold/decay. Проверить 44.1/48/96 kHz, произвольные размеры
callback, overflow/underrun/clock drift и отсутствие callback-аллокаций.
- [x] Сверить реализацию с официальными CPAL/PulseAudio/RNNoise; проверять
синтетически/в виртуальной среде. Физическую задержку и слышимость без
отдельной живой проверки не считать измеренными.
### Трей и закрытие окна
- [ ] При закрытии окна сворачивать приложение в системный трей, сохраняя
подключение и голос; полностью завершать процесс через явный пункт «Выйти».
- [ ] Меню трея: «Открыть», «Настройки», «О программе», разделитель,
«Перезапустить», «Выйти». Нажатие на значок возвращает существующее окно.
- [ ] Проверить поддержку Linux StatusNotifierItem и восстановление окна,
отсутствие второго экземпляра при повторном открытии, корректное отключение
голоса и сети при выходе/перезапуске. GUI-проверки только в виртуальной среде.
- [ ] Предусмотреть настройку «Сворачивать в трей при закрытии» и обычное
закрытие, если системный трей недоступен, чтобы окно не исчезало безвозвратно.
### Медиа в чате
- [x] Показывать изображения и анимированные GIF по прямым HTTPS-ссылкам в
сообщениях (включая пример пользователя `https://evolationstudios.ru/admindata/gifs/cuckoding2.gif`).
- [x] Добавить вставку картинки из системного буфера, предпросмотр, отмену и
отправку настоящего вложения, доступного другим участникам и после перезапуска.
- [x] Сначала описать хранение и передачу вложений, права доступа и лимиты;
проверить форматы, размер, декодирование и ограничения загрузок.
- [ ] Проверить GIF-анимацию, ошибки/отсутствие сети, вставку при русской
раскладке и отсутствие повторной загрузки при каждом обновлении UI.
- [ ] Отложено: голосовые сообщения. В текущий объём реализации не входят.
- [ ] Следующий этап вложений: очистка неиспользуемых файлов после удаления
сообщений и политика хранения; сейчас удаление сообщения не освобождает квоту
немедленно. Добавить отправку вложений в DM после отдельного контракта.
Текущие вложения: PNG/JPEG/GIF до 3 MiB в текстовом канале, с явным
подтверждением отправки. Прямые HTTPS-ссылки отображаются отдельно.
- [x] Перейти на нативные PipeWire/PulseAudio в Linux, показывать системные
входы/выходы без технических ALSA-дублей и с постоянным выбором по ID.
- [x] Добавить выбор микрофона/выхода по ПКМ на нижних кнопках, сохранив
обычное нажатие для mute/deafen.
- [x] Усилить контраст встроенных тем, кнопок и блока голосового подключения.
- [x] Добавить локальную проверку микрофона с уровнем и прослушиванием,
остановкой при закрытии настроек и без отправки теста собеседникам.
- [x] Добавить работающий переключатель RNNoise и сохранение настройки.
- [x] Показывать заметную обводку своего аватара при передаче голоса.
- [x] Обязать вход в Central до подключения; gateway должен проверять
подтверждение аккаунта, привязанное к ключу клиента. Сначала спецификация
авторизации desktop и LNEx; несовместимые изменения требуют новой версии.
- [x] Собрать и установить обновлённый клиент. Установленный release проверен
в отдельном Xvfb с пустым профилем: экран обязательного входа, открытие настроек,
переход к темам, переключение группы и выбор палитры настоящими X11-кликами.
Проверка слышимости с реальными устройствами остаётся отдельной задачей ниже.
- [x] Исследовать и исправить Ctrl+V из системного буфера в поля Slint
при русской и английской раскладке; сначала
проверить документацию/известные проблемы и воспроизвести в этой сборке.
Проверены реальные Wayland-события EN/RU, обычное поле, пароль и TextEdit;
причина и ограничения: [буфер Wayland](docs/maintenance/clipboard-wayland.md).
Shift+Insert штатно не поддерживается Slint 1.18.1; этот фикс его не добавляет.
- [x] Показывать дату и время у сообщений не за сегодняшний день; для
сегодняшних оставить короткое время. Проверить полночь и локальный часовой пояс.
Связанные задачи сайта: сохраняемая серверная сессия, собственный аватар в
шапке, генерируемый VNOX-аватар вместо GitHub и его замена загрузкой.
Актуальные локальные задачи. Подробности пользовательского теста и уже
исправленные дефекты: [UX-дефекты](docs/maintenance/ux-defects-2026-10-24.md).
Общий план платформы: [roadmap сервера](../VNOX-Server/docs/06-roadmap.md).
`docs/slint-migration-plan.md` является историческим планом миграции.
## Отзывчивость и звук
- [x] Перенести повторный опрос аудиоустройств при открытии настроек из потока
интерфейса. Сохранять текущий выбор по ID, объединять повторные запросы,
сохранять предыдущий список при ошибке. Проверить медленный опрос тестом.
- [ ] Проверить слышимость голоса между двумя реальными клиентами после
исправлений из потока B. Автоматический UDP-тест не проверяет микрофон,
устройства воспроизведения и слышимость речи человеком.
## Central и аватары
- [x] Реализовать вход клиента через Central после документирования серверного
контракта авторизации desktop/device enrollment и проверки доказательств
аккаунта на gateway. Наличие браузерной сессии Hub само по себе не решает
эту задачу. См. пункты 10d и 10e списка UX-дефектов.
- [x] Определить и реализовать получение профиля и аватара других участников,
обновление кэша и правила видимости после согласования LNEx-контракта.
Собственный аватар и аватары авторов сообщений загружаются из Central; профиль
хранится в UI без чтения аккаунта с диска на каждом обновлении.
См. пункты 2, 12b и 12c списка UX-дефектов.
Изменения LNEx сначала описываются в документации протокола. Значительные
изменения аккаунтов и обязательного входа требуют обсуждения до реализации.
## Сообщества и администрирование
Аудит кода: [владение и админка](../VNOX-Server/docs/design/ownership-and-admin-audit.md).
- [ ] Сохранять `owner_id` в `GuildState`, показывать владельца сообщества.
- [ ] Доделать создание сообщества и работу с приглашениями в Slint.
- [ ] Добавить управление участниками, ролями и каналами с обработкой
подтверждений/отказов gateway и изменения прав во время работы.
- [ ] Реализовать получение админки узла и передачу владения после утверждения
серверных контрактов. Запуск VPS и публикация в каталоге не выдают эти права.
- [ ] Добавить просмотр каталога серверов и удобный перенос адреса в подключение.
## Account presence and Central member profiles (2026-11-01)
- [x] 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.
- [x] 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.
- [x] Verify two-device and repeated-device lifecycle, profile propagation and rejected avatar origins with regression tests.
- [x] 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
- [x] Выровнять ширину карточек независимо от подписей и ограничить ширину
сетки, чтобы превью не растягивались на широком окне. Проверить 1024/1280/1920 px
в изолированном headless renderer, затем установить исправленную сборку.
## Desktop Central avatar correction (2026-11-01)
- [x] 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.
- [x] 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.
- [x] Verify website-avatar refresh, authenticated PNG upload/delete, device binding, expired/revoked secrets, invalid image limits, and summary/UI propagation.
- [x] 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 без неё).
Подробности звука и источники: [локальный монитор](docs/maintenance/microphone-monitor.md).
Дополнительная причина пустого аватара: 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)
- [x] Add documented device/account-bound signed ProfileUpdate/ProfileUpdated packets; gateway verifies claims, prevents older-timestamp downgrade and broadcasts only through current shared-channel visibility.
- [x] 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.
- [x] 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.
### Ник при регистрации и первое знакомство
- [x] Генерировать дружелюбный русский `слово_0000` CSPRNG только при первом
создании email/GitHub-аккаунта; не брать имя провайдера, не менять handle и
существующие пользовательские имена. Сохранить JSON-словарь, источник и лицензию.
- [x] Предложить «Изменить сейчас / Позже» в веб-профиле; явное решение хранить
на сервере, существующим аккаунтам не навязывать onboarding. Новый независимый
endpoint имени не должен требовать отложенную миграцию профилей/handle.
- [x] Проверить регистрацию обоими способами, повторный вход/свой ник, формат,
CSRF/Origin, идемпотентное решение и Web-сборку/тесты в изолированной среде.
## Живой профиль, первый ник и стандартные аватары — 2026-11-01
- [x] Передавать подтверждённый Central профиль без переподключения TCP:
обновлять при сообщении/повторном входе в войс и после изменения имени/фото.
Не доверять неподписанным именам, сохранять права и ключи устройств.
- [x] Первый ник: словарь JSON с источником/лицензией, слово_0000, назначение
только при создании аккаунта; предложение изменить сейчас/позже с сохранением
решения. Выбранные существующие имена не перезаписывать.
- [x] Стандартные аватары v2: стабильные пиксельные монстрики из публичного UUID,
новые versioned URL из-за immutable cache; прежний v1 продолжает работать.
Проверить разнообразие/детерминизм/PNG256, отсутствие запросов о наличии аккаунта.
### Управление каналами администратором узла
- [x] Принять server-advertised `Session.node_admin` и сбрасывать право при
отключении. Показать управление только глобальными каналами вне guild/DM.
- [x] Добавить создание text/voice, переименование и подтверждённое удаление;
повторно проверять capability/scope перед отправкой, ждать server ack/error
с таймаутом, не менять список оптимистично. Gateway остаётся авторитетом.
- [x] Подключить существующий ChannelEdit (0x36), проверить не-admin/false-default,
потерю прав, input validation и headless create/rename/delete/error/confirm.
## Explicit node administrator capability (2026-11-01)
- [x] 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.
- [x] Verify account's second device, unlisted accounts, cross-guild denial, bootstrap protection and channel persistence across cache/bootstrap reload.
- [x] 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.
### Завершение живого профиля и админки
- [x] Неподдерживаемый старым V4-сервером ProfileUpdate не отправляется:
поддержка определяется `Session.live_profiles`; чат/голос продолжают работать.
- [x] Ошибка обновления профиля не отменяет вход в голос; выход отменяет также
ожидающий join, включая ожидание reconnect. Создание voice-канала не включает микрофон.
- [x] Команды администратора привязаны к конкретной сессии и отбрасываются после
смены узла; старый запрос не переносится на новый сервер.
- [x] На 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.
Реальный пользовательский процесс не перезапускался и экран не использовался.
### Меню узла, настройки и категории
- [x] Добавить раскрытие меню по имени сервера и отдельные настройки узла
только по подтверждённым правам; настоящее сохранение имени сервера с ACK/error.
- [x] По правой кнопке в списке каналов открыть меню «Текстовый / Голосовой /
Категория / Форум»; контекст категории сохранять, правая кнопка не входит в голос.
- [x] Показать категории с дочерними каналами и сворачиванием; повторно проверять
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 уже исправлен.
Не запускать тестовые приложения на рабочем столе пользователя.