Files
shtil/docs/adr/0006-user-tickets.md
TMSH 3d2e23dd9b
ci / smoke (push) Successful in 2s
[1.9] Обращения: ADR-0006 и макет окна Помощника (#10)
**Задача:** #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>
2026-11-15 14:23:13 +00:00

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