# Задачи клиента ## Текущий запрос: 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 уже исправлен. Не запускать тестовые приложения на рабочем столе пользователя.