docs: добавлены результаты замеров PoC Помощника

Покой 1,6 МБ, окно 97,3 МБ, открытие 583/564 мс — цели #1.8
подтверждены на Windows 11. В AGENTS.md добавлена папка poc/.

Refs: 1.8.1, 1.8.2
This commit is contained in:
TMSH committed 2026-11-09 22:53:43 +03:00
1 parent d663869304
commit 4abe485e73
5 files changed
+154 -15

No files matched your search

@@ -6,26 +6,32 @@ items: ["1.8.1", "1.8.2"]
branch: feat/1.8-helper-tray-poc
pr: —
impact: shared
status: в работе
status: на проверке
author: Frontend
---
# [1.8] PoC Помощника: Tauri только с иконкой в трее
## Сделано
- Ветка создана, каркас и замеры в работе. Код — `poc/helper-tray/` (временная папка прототипов, удаляется после ADR-0005).
- `poc/helper-tray/` — Tauri 2 приложение только с иконкой в трее: `app.windows: []`, трей с меню из трёх пунктов, окна создаются через `WebviewWindowBuilder` и уничтожаются при закрытии, `prevent_exit` от завершения по закрытию последнего окна. Форма «Сообщить о проблеме» по прототипу (категории, описание, «Отправить» без отправки).
- Замер времени открытия — команда `first_paint` по invoke (capability только `core:default` на `win-*`).
- `poc/helper-tray/measure.ps1` + флаг `--measure-scenario`: сценарий 30 с покой → окно → 10 с → закрыть → 10 с → повтор → закрыть; отметки этапов в `helper-tray-poc.measure.log`, скрипт снимает private working set дерева процессов по отметкам.
- Замеры Windows 11 (release, 5 прогонов, медиана): покой **1,6 МБ**, окно **97,3 МБ**, после закрытия **3,6 МБ**, открытие **583/564 мс**. Все цели выполнены. Таблица и выводы — `docs/research/helper-tray-poc.md`.
- `AGENTS.md` раздел 5: добавлена строка про `poc/`.
## Решения
- Замер времени открытия окна — через invoke команды `first_paint` с отдельной capability, не через события.
- Сценарий замера — флаг `--measure-scenario`: приложение само по таймеру открывает и закрывает окна и пишет отметки этапов в лог-файл; `measure.ps1` снимает private working set по отметкам.
- Пункты «Мои обращения» и «О программе» открывают окно-заглушку через ту же фабрику — иначе меню выглядело бы сломанным.
- Команды приложения в Tauri 2.12 не входят в ACL: для `first_paint` отдельного permission нет, минимальный capability — `core:default`.
## Для другой стороны
- Максиму: повторить замер на Astra 1.8, когда будет VM (#1.12.5). Инструкция — `docs/research/helper-tray-poc.md`.
- Максиму: повторить замер на 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` проходит.
- `measure.ps1` 5 прогонов — сценарий доходит до `stage done`, метрики записаны.
- Ручной проклик меню трея не автоматизирован: `open_window` проверена сценарием замера, обработчик меню вызывает ту же функцию.
## Осталось
- [ ] PoC: трей, меню, окно формы, сценарий замера, measure.ps1.
- [ ] Release-замеры на Windows 11 по методике (5 прогонов, медиана).
- [ ] `docs/research/helper-tray-poc.md`, статусы, `AGENTS.md` (папка `poc/`).
- [ ] Замер на Astra 1.8 — Максим, VM #1.12.5.
- [ ] После ADR-0005 папку `poc/` удалить.