Files

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