- docs/adr/0006-user-tickets.md: сценарий обращения, форма без срочности, статусы с переоткрытием, кнопка «Решено» политикой, скриншоты 30 дней — статус «Предложено» - docs/ux/helper-window.html: функциональный макет окна по прототипу — форма, список обращений, переписка, «О программе» Refs: 1.9.6, 1.9.7
5.7 KiB
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) покажут, что пользователям нужен живой чат или поле срочности.