Files
TMSH 9a0533b102
ci / smoke (push) Successful in 3s
[1.8] Функции Помощника по фазам и черновик ADR-0005 (#9)
**Задача:** #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>
2026-11-10 21:57:00 +00:00

5.3 KiB

Помощник «Штиль» — функции по фазам

  • Задача: #1.8.4 · Статус: черновик, утверждается решением #1.8.3 → ADR-0005
  • Источники: карточка #1.8 (диаграмма), #1.9 (обращения), #1.10 (удалённый доступ)

Роль и ограничения

Помощник — процесс в сессии пользователя, единственный компонент на устройстве с интерфейсом.

  • Прав администратора нет, установки драйверов/служб не требует.
  • С сервером напрямую не общается — только с агентом по IPC (named pipe / unix socket, Protobuf).
  • Запуск: Windows — агентом при входе пользователя (служба в Session 0 окон не имеет); Linux — XDG autostart, агент контролирует наличие.
  • Пункта «Выход» нет; при падении агент перезапускает.
  • На серверах не ставится по умолчанию (параметр установки).
  • Устанавливается одним инсталлятором с агентом; иконка и название переопределяются конфигом (white-label).

Фаза 1 — обращения (MVP)

Функция Содержание
Иконка в трее Меню: «Сообщить о проблеме», «Мои обращения», «О программе». Без окон при старте; окно создаётся по клику и уничтожается при закрытии
Форма обращения Категории-кнопки: Не печатает · Нет сети/интернета · Медленно работает · Не работает программа · Нужен доступ или ПО · Другое. Описание (обязательно, ≤ 2000), срочность (обычная / срочно — работа стоит), контакт (телефон/кабинет, запоминается)
Скриншот Снимается автоматически, показывается превью, кнопка «Убрать». Организация может отключить политикой
Отправка Помощник → агент по IPC. Агент добавляет автодиагностику и отправляет; без связи копит в своей очереди — у Помощника очереди нет
«Мои обращения» Последние 10: статус и ответы администратора, простая переписка внутри обращения
«О программе» Версия, организация, статус связи с агентом

Фаза 2 — удалённый доступ и уведомления

Функция Содержание
Диалог согласия Кто подключается и причина. Кнопки: Разрешить / Только просмотр / Отклонить. Нет ответа 30 с — отказ
Индикатор сеанса Красная рамка по краю экрана + панель «К вам подключён {имя} · {время} · Завершить». Пользователь может прервать сеанс в любой момент
Захват экрана По команде агента: служба в Session 0 рабочий стол не видит, снимает только процесс сессии. Передача потока агенту
Уведомления Всплывающие: ответ по обращению, сообщения от администратора, события сеанса удалённого доступа

Чего Помощник не делает

  • Не хранит данные дольше сессии, не имеет своей БД и очереди.
  • Не показывает настроек пользователю (кроме white-label через конфиг агента).
  • Не принимает решений по безопасности: показ диалога согласия решает агент по подписанной политике.
  • Не работает в Session 0 и без графической сессии.

Черновой список методов IPC (proto/helper/v1)

Для оценки поверхности протокола, детали — в #1.8.5 и позже.

Метод Направление Фаза
TicketSubmit Помощник → агент 1
TicketList / TicketReply Помощник ↔ агент 1
ConsentRequest / ConsentResponse агент → Помощник → агент 2
SessionIndicator (start/stop) агент → Помощник 2
Notify агент → Помощник 2
ScreenCapture (start/stop) агент → Помощник 2
GetState Помощник → агент 1 (статус связи для «О программе»)