ci / smoke (pull_request) Successful in 3s
- 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
57 lines
5.3 KiB
Markdown
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 (статус связи для «О программе») |
|