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

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 (статус связи для «О программе») |