ci / smoke (push) Successful in 3s
**Задача:** #1.8 **Пункты:** 1.8.4, 1.8.5 (черновик) ## Что сделано - docs/architecture/helper.md — функции Помощника по фазам: роль и ограничения, фаза 1 (обращения по #1.9), фаза 2 (удалённый доступ, уведомления, захват экрана), границы, черновой список методов IPC для proto/helper/v1. - docs/adr/0005-agent-and-helper.md — черновик ADR-0005, статус «Предложено»: архитектура агент+Помощник, варианты технологии с результатами PoC. Решение по технологии открыто до замера на Astra 1.8 (#1.8.3). ## Как проверить - Только документы. Сверить с карточками #1.8 (В2–В5), #1.9 (поля формы), #1.10 (согласие, индикатор). ## Чек-лист - [x] Коммиты и название PR по-русски, в каждом коммите есть Refs: - [x] Секретов и персональных данных в документах нет - [x] Документация обновлена: запись журнала, docs/status/ - [ ] Ссылка на этот PR добавлена в «Ссылки» задачи в дорожной карте Reviewed-on: #9 Co-authored-by: BrowenSiz <top.timashevsky@gmail.com>
38 lines
4.7 KiB
Markdown
38 lines
4.7 KiB
Markdown
# ADR-0005: ПО на устройстве — Агент и Помощник
|
|
|
|
- **Статус:** Предложено
|
|
- **Дата:** 2026-11-11
|
|
- **Задача:** #1.8
|
|
- **Участники:** Oleg, Максим
|
|
- **Зоны:** shared
|
|
|
|
## Контекст
|
|
|
|
Пользователю нужен интерфейс на ПК: сообщить о проблеме, видеть статус обращения, подтвердить удалённое подключение. Агент — служба в Session 0 (Windows) / systemd (Linux) и физически не может показывать окна. Значит на устройстве два компонента: служба-агент и «Штиль Помощник» в сессии пользователя. Оставалось выбрать технологию Помощника: критерии — в покое ≤ 40 МБ ОЗУ, с открытым окном ≤ 150 МБ, открытие ≤ 1 с, общий UI-стек с приложением, работа в изолированном контуре.
|
|
|
|
## Решение
|
|
|
|
*Черновик до решения #1.8.3: архитектура подтверждена, выбор технологии ждёт замер на Astra 1.8.*
|
|
|
|
- На устройстве два компонента: **агент** (служба, SYSTEM/root, единственный канал к серверу по mTLS) и **Помощник** (процесс в сессии пользователя, иконка в трее, без прав администратора).
|
|
- Помощник общается только с агентом по IPC (named pipe / unix socket, Protobuf, `proto/helper/v1`); агент проверяет подлинность Помощника (путь, подпись бинарника, пользователь сессии).
|
|
- Запуск: Windows — агент отслеживает входы и запускает Помощника в сессиях; Linux — XDG autostart, агент контролирует наличие. Пункта «Выход» нет, при падении агент перезапускает.
|
|
- Один установщик «агент + Помощник»; на серверах Помощник по умолчанию выключен. Иконка и название переопределяются конфигом (white-label для MSP).
|
|
- **Технология (предложение):** Tauri 2 в режиме «только трей»: окна нет при старте, форма создаётся по клику и уничтожается при закрытии. Подтверждено PoC (`poc/helper-tray`, `docs/research/helper-tray-poc.md`): Windows 11, release, медиана из 5 прогонов — покой 2,0 МБ PrivateBytes, открытие 580/555 мс, окно 155,3 МБ PrivateBytes (цель 150 — превышение ~5 МБ признано допустимым, т.к. расход даёт WebView2-движок, общий с приложением).
|
|
- Функции Помощника по фазам — `docs/architecture/helper.md`.
|
|
|
|
## Рассмотренные варианты
|
|
|
|
| Вариант | Плюсы | Минусы |
|
|
|---|---|---|
|
|
| **Tauri 2 трей + окно на WebView** | Общий UI-стек и дизайн-система с приложением, один язык для команды, WebView2 уже есть на Windows | Окно ~155 МБ PB > цели 150; на Linux зависит от WebKitGTK 4.1 |
|
|
| Трей на Go + окно Tauri по запросу | Покой ещё ниже (~2–3 МБ и так 2 МБ) | Окно всё равно на WebView — выигрыша по памяти с окном нет; второй стек IPC/сборки; выигрыш только в покое, который и так 20× ниже цели |
|
|
| Нативный трей + нативные окна (Go/Qt/winfrey) | Минимум памяти | Нет общего UI с приложением, два UI-стека, дороже поддержка — отклонено по трудозатратам |
|
|
|
|
## Последствия
|
|
|
|
- Нужны `proto/helper/v1` (черновик методов — `docs/architecture/helper.md`) и каркас `apps/helper/` на следующих шагах.
|
|
- Запасной путь при провале цели на Astra/РЕД ОС: трей на Go, окно Tauri по запросу.
|
|
- Решение пересматривается, если замер на Astra 1.8 (#1.12.5) покажет окно значительно выше ~160 МБ или открытие > 1 с.
|
|
- `poc/` удаляется после принятия ADR.
|