Files
shtil/docs/architecture/helper.md
T
TMSH 891dd7207c
ci / smoke (pull_request) Successful in 3s
docs: добавлены функции Помощника по фазам и черновик ADR-0005
- docs/architecture/helper.md: фаза 1 (обращения), фаза 2 (удалённый
  доступ, уведомления, захват экрана), границы, черновой список IPC
- docs/adr/0005-agent-and-helper.md: статус «Предложено», решение
  по технологии открыто до замера на Astra 1.8 (#1.8.3)

Refs: 1.8.4, 1.8.5
2026-11-11 00:54:05 +03:00

57 lines
5.3 KiB
Markdown

# Помощник «Штиль» — функции по фазам
- **Задача:** #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 (статус связи для «О программе») |