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