[1.9] Обращения: ADR-0006 и макет окна Помощника (#10)
ci / smoke (push) Successful in 2s

**Задача:** #1.9
**Пункты:** 1.9.5, 1.9.6, 1.9.7

## Что сделано
- docs/adr/0006-user-tickets.md — черновик ADR-0006, статус "Предложено": цепочка обращения, форма (1000 знаков, без срочности), статусы с переоткрытием в 3 дня, кнопка "Решено" политикой, скриншоты 30 дней и доступ по tickets.manage.
- docs/ux/helper-window.html — функциональный макет окна Помощника: форма с категориями и превью скриншота, список "Мои обращения", переписка с подтверждением, "О программе". Это схема экранов, не визуальный дизайн.
- Правка статуса записи журнала ветки 1.8-functions (забыл включить в PR #9).

## Как проверить
- Открыть docs/ux/helper-window.html в браузере — 4 экрана.
- ADR-0006 сверить с ответами В1-В6 и текстом решения в карточке 1.9.

## Чек-лист
- [x] Коммиты и название PR по-русски, в каждом коммите есть Refs:
- [x] Секретов и персональных данных нет
- [x] Документация обновлена: запись журнала, docs/status/
- [ ] Ссылка на этот PR добавлена в «Ссылки» задачи в дорожной карте

Reviewed-on: #10
Co-authored-by: BrowenSiz <top.timashevsky@gmail.com>
This commit was merged in pull request #10.
This commit is contained in:
TMSH authored and TMSH committed 2026-11-15 14:23:13 +00:00
1 parent 9a0533b102
commit 3d2e23dd9b
6 files changed
+309 -5

No files matched your search

+46
View File
@@ -0,0 +1,46 @@
# ADR-0006: Обращения пользователей
- **Статус:** Предложено
- **Дата:** 2026-11-15
- **Задача:** #1.9
- **Участники:** Oleg, Максим
- **Зоны:** shared
## Контекст
Обращение (`ticket`) — сообщение сотрудника через Помощника: ключевая функция для пользователей и основа будущего Service Desk. Цель: сообщить о проблеме в два клика, а администратор сразу видит, кто, откуда и что случилось — без звонков. Алерт — автоматическое событие мониторинга (фаза 2); оба типа попадают в раздел «Входящие».
## Решение
**Сценарий.** Пользователь: трей → «Сообщить о проблеме» → форма. Помощник → агент по IPC (агент добавляет автодиагностику и отправляет; без связи — в очереди агента). Сервер создаёт обращение и отдаёт пользователям с правом `tickets.manage` на подразделение устройства, иначе владельцу организации. Пользователь видит статус и ответ в Помощнике.
**Форма.** 6 категорий-кнопок + «Другое»; описание обязательно до 1000 знаков; автоскриншот с превью и «Убрать» (отключается политикой организации); контакт запоминается после первого ввода. Поля «срочность» нет — приоритет ставит администратор при обработке.
**Автодиагностика** (добавляет агент): имя ПК, IP, подразделение, пользователь ОС, ОС и аптайм, CPU/ОЗУ, место на дисках, доступность шлюза, DNS и сервера «Штиль», ошибки системного журнала (за 1 час, до 20). Для «Не печатает» — принтеры, состояние и очередь печати.
**Статусы:** Новое → В работе → Ожидает пользователя → Решено → Закрыто (автоматически через 3 дня) · Отклонено. Ответ пользователя после «Решено» в течение 3 дней переоткрывает обращение.
**Переписка и подтверждение.** Комментарии внутри обращения (не отдельный чат). Кнопка «Решено» у пользователя — политика организации, по умолчанию включена, наследуется по подразделениям: включена — админ ставит «Ожидает пользователя», пользователь подтверждает или переоткрывает; выключена — админ закрывает сам.
**Скриншоты** — персональные данные: хранение 30 дней, доступ по `tickets.manage`, сжатие до 2 МБ, отключение политикой.
**Защита.** Обращение подписано сертификатом устройства; лимит 5 обращений за 10 минут с устройства.
**История и права.** «Мои обращения» — последние 10. Наблюдатель филиала видит обращения филиала только на чтение. Каналы без агента (веб-форма, почта, Telegram) — фаза 2 и позже.
## Рассмотренные варианты
| Вопрос | Выбрано | Альтернатива и почему отказались |
|---|---|---|
| Ответ админа | Комментарии внутри обращения | Живой чат — создаёт ожидание мгновенного ответа, админ не колл-центр |
| Срочность | Ставит админ при обработке | Поле у пользователя — все ставят «срочно», сигнала нет |
| Описание | До 1000 знаков | 2000 — поощряет простыни; 400 — мало для текста ошибки |
| Скриншот | Включён с «Убрать» | Выключен по умолчанию — теряется главная польза диагностики |
| Окно жизни чата | Таймер авто-закрытия (3 дня) | Отдельная механика «активного чата» — лишняя сложность |
## Последствия
- Нужен `proto/helper/v1` (`TicketSubmit` с диагностикой и ссылкой на скриншот — #2.6.4) и `proto/agent/v1` пересылка на сервер.
- Реализация формы и «Входящих» — шаг 6 (#2.15); макет окна Помощника — `docs/ux/helper-window.html` (#1.9.7).
- Политики: скриншоты вкл/выкл, кнопка «Решено», сроки хранения — войдут в каталог функций (#2.3).
- Решение пересматривается, если интервью (#1.14) покажут, что пользователям нужен живой чат или поле срочности.