Files
shtil/docs/journal/2026-11-09-frontend-1.8-helper-tray-poc.md
TMSH 22d1698764
ci / smoke (push) Successful in 3s
[1.8] PoC Помощника: трей и замеры на Windows (#8)
**Задача:** #1.8
**Пункты:** 1.8.1, 1.8.2

## Что сделано
- PoC в poc/helper-tray/: Tauri 2 только с иконкой в трее (окна при старте нет), меню из трёх пунктов, окно создаётся по клику и уничтожается при закрытии.
- Форма «Сообщить о проблеме» по прототипу; «Выход» только в debug-сборке.
- Замер времени открытия — команда first_paint (invoke после двойного rAF); сценарий --measure-scenario + measure.ps1: PrivateBytes и WorkingSetPrivate дерева процессов по отметкам этапов в логе.
- Замеры Windows 11 (release, 5 прогонов, медиана): покой 2,0 МБ PB, окно 155,3 МБ PB (цель 150 — не дотянуто ~5 МБ), после закрытия 5,2 МБ, открытие 580/555 мс. Выводы и методика — docs/research/helper-tray-poc.md.
- AGENTS.md: добавлена временная папка poc/ (удаляется после ADR-0005).

## Как проверить
1. cd poc/helper-tray && pnpm install && pnpm tauri build
2. Запустить src-tauri/target/release/helper-tray.exe — только трей, без окна.
3. powershell -ExecutionPolicy Bypass -File measure.ps1 — 5 прогонов, таблица.
4. На Linux: сборка по docs/research/helper-tray-poc.md, замер через PSS.

## Чек-лист
- [x] Коммиты и название PR по-русски, в каждом коммите есть Refs:
- [x] Ветка свежая: git rebase origin/main, конфликтов нет
- [x] Секретов и персональных данных в коде, логах и документах нет
- [x] Документация обновлена: запись журнала, docs/status/, docs/research/
- [ ] Ссылка на этот PR добавлена в «Ссылки» задачи в дорожной карте
<!-- Прочие пункты шаблона неприменимы: нет запросов к БД, прав, миграций, флагов -->

Reviewed-on: #8
Co-authored-by: BrowenSiz <top.timashevsky@gmail.com>
2026-11-10 21:42:07 +00:00

40 lines
3.9 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.
---
date: 2026-11-09
zone: frontend
task: "1.8"
items: ["1.8.1", "1.8.2"]
branch: feat/1.8-helper-tray-poc
pr: —
impact: shared
status: на проверке
author: Frontend
---
# [1.8] PoC Помощника: Tauri только с иконкой в трее
## Сделано
- `poc/helper-tray/` — Tauri 2 приложение только с иконкой в трее: `app.windows: []`, трей с меню из трёх пунктов, окна создаются через `WebviewWindowBuilder` и уничтожаются при закрытии, `prevent_exit` только при `code.is_none()` (иначе `app.exit(0)` блокируется). Форма «Сообщить о проблеме» по прототипу (категории, описание, «Отправить» без отправки).
- Замер времени открытия — команда `first_paint` по invoke после двойного rAF (capability с пустым `permissions` на `win-*`).
- `poc/helper-tray/measure.ps1` + флаг `--measure-scenario`: сценарий 30 с покой → окно → 10 с → закрыть → 10 с → повтор → закрыть; отметки этапов в `helper-tray-poc.measure.log` (рядом с exe или в `%TEMP%`), скрипт снимает **PrivateBytes** и WorkingSetPrivate дерева процессов.
- Замеры Windows 11 (release, 5 прогонов, медиана): покой **2,0 МБ PB**, окно **155,3 МБ PB** (цель 150 — не дотянуто ~5 МБ), после закрытия **5,2 МБ PB**, открытие **580/555 мс**. Таблица и выводы — `docs/research/helper-tray-poc.md`.
- `AGENTS.md` раздел 5: добавлена строка про `poc/`.
## Решения
- Пункты «Мои обращения» и «О программе» открывают окно-заглушку через ту же фабрику — иначе меню выглядело бы сломанным.
- Команды приложения в Tauri 2.12 не входят в ACL: для `first_paint` отдельного permission нет, capability окон с пустым `permissions`.
- Решающая метрика ОЗУ — PrivateBytes: WorkingSetPrivate у простаивающих процессов занижен Windows.
- CSP: `connect-src ipc: http://ipc.localhost` — иначе на Linux/macOS IPC уходит в postMessage-запасной режим.
## Для другой стороны
- Максиму: повторить замер на Astra 1.8, когда будет VM (#1.12.5). Инструкция — `docs/research/helper-tray-poc.md` (measure.ps1 Windows-only, для Linux PSS/`smem`).
- Замеры нужны для ADR-0005 (#1.8.3) — решение принимаем вместе, сам по себе PoC технологию не выбирает.
## Проверка
- `pnpm tauri build` release — чисто, без предупреждений. `vue-tsc --noEmit`, `cargo clippy`, `cargo fmt --check` проходят.
- `measure.ps1` 5 прогонов — сценарий доходит до `stage done`, приложение завершается само во всех прогонах (`app.exit(0)` не блокируется).
- Ручной проклик меню трея не автоматизирован: `open_window` проверена сценарием замера, обработчик меню вызывает ту же функцию. Предупреждение о postMessage-запасном IPC проверить в devtools можно только вручную — на Windows IPC идёт через `window.ipc.postMessage` и не зависит от `connect-src`.
## Осталось
- [ ] Замер на Astra 1.8 — Максим, VM #1.12.5.
- [ ] После ADR-0005 папку `poc/` удалить.