Files
shtil/docs/adr/0006-user-tickets.md
T
TMSH 63229b5a2e
ci / smoke (pull_request) Successful in 3s
docs: добавлены ADR-0006 и макет окна Помощника
- docs/adr/0006-user-tickets.md: сценарий обращения, форма без
  срочности, статусы с переоткрытием, кнопка «Решено» политикой,
  скриншоты 30 дней — статус «Предложено»
- docs/ux/helper-window.html: функциональный макет окна по
  прототипу — форма, список обращений, переписка, «О программе»

Refs: 1.9.6, 1.9.7
2026-11-15 17:19:24 +03:00

5.7 KiB
Raw Blame History

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) покажут, что пользователям нужен живой чат или поле срочности.