diff --git a/docs/adr/0006-user-tickets.md b/docs/adr/0006-user-tickets.md new file mode 100644 index 0000000..f6eca22 --- /dev/null +++ b/docs/adr/0006-user-tickets.md @@ -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) покажут, что пользователям нужен живой чат или поле срочности. diff --git a/docs/journal/2026-11-11-frontend-1.8-helper-functions.md b/docs/journal/2026-11-11-frontend-1.8-helper-functions.md index 650e07e..529c3ce 100644 --- a/docs/journal/2026-11-11-frontend-1.8-helper-functions.md +++ b/docs/journal/2026-11-11-frontend-1.8-helper-functions.md @@ -6,7 +6,7 @@ items: ["1.8.4", "1.8.5"] branch: feat/1.8-helper-functions pr: — impact: shared -status: в работе +status: смержено author: Frontend --- diff --git a/docs/journal/2026-11-15-frontend-1.9-user-tickets.md b/docs/journal/2026-11-15-frontend-1.9-user-tickets.md new file mode 100644 index 0000000..930ec6b --- /dev/null +++ b/docs/journal/2026-11-15-frontend-1.9-user-tickets.md @@ -0,0 +1,35 @@ +--- +date: 2026-11-15 +zone: frontend +task: "1.9" +items: ["1.9.5", "1.9.6", "1.9.7"] +branch: feat/1.9-user-tickets +pr: — +impact: shared +status: в работе +author: Frontend +--- + +# [1.9] Обращения: ADR-0006 и макет окна Помощника + +## Сделано +- `docs/adr/0006-user-tickets.md` — черновик ADR-0006 со статусом «Предложено» (#1.9.6): сценарий обращения, поля формы, статусы, маршрутизация, правила скриншотов, переписка и подтверждение «Решено». +- `docs/ux/helper-window.html` — макет окна Помощника (#1.9.7): живая HTML-страница по прототипу — форма с категориями, описанием со счётчиком, автоскриншотом с превью и «Убрать»; «Мои обращения» со статусами, перепиской и подтверждением «Решено»; «О программе». +- Правки записи журнала ветки 1.8-functions: статус «смержено». + +## Решения (по ответам в карточке 1.9) +- Описание обязательно, до 1000 знаков (изначально в карте 2000 — сократили, чтобы не писали простыни). +- Поля «срочность» нет: приоритет ставит администратор при обработке — пользователи всегда ставят «срочно». +- Переписка — комментарии внутри обращения, не отдельный чат; ответ после «Решено» в течение 3 дней переоткрывает. +- Кнопка «Решено» у пользователя — политика организации, по умолчанию включена. +- Скриншоты: хранение 30 дней, доступ по `tickets.manage`, отключение политикой (#1.9.5). + +## Для другой стороны +- Максиму: ADR-0006 фиксирует автодиагностику и очередь на агенте — это его реализация на шаге 6. + +## Проверка +- Макет открыт в браузере и проверен вручную; документы сверены с ответами в карточке 1.9. + +## Осталось +- [ ] Решение 1.9 перевести в «Принято» и ADR-0006 в «Принято» после ревью. +- [ ] Макет окна согласовать с Максимом (он часть результата шага 1). diff --git a/docs/status/frontend.md b/docs/status/frontend.md index 06033d0..d70c1a0 100644 --- a/docs/status/frontend.md +++ b/docs/status/frontend.md @@ -1,6 +1,6 @@ # Состояние: Frontend -Обновлено: 2026-11-11 · Владелец: Frontend-разработчик +Обновлено: 2026-11-15 · Владелец: Frontend-разработчик Снимок, а не история. Внутренние правила зоны — `docs/frontend/`. @@ -12,11 +12,13 @@ - #1.2 правила git, шаблон PR, хуки, личные заметки `docs/private/`. - #1.3 версии инструментов; hello world Tauri и Go на Windows (#1.3.9, часть Frontend/Windows). - #1.8.1–1.8.2 PoC трея Помощника (`poc/helper-tray/`): покой 2,0 МБ PB, окно 155,3 МБ PB (цель 150 не дотянута ~5 МБ), открытие ~0,58 с. Замеры — `docs/research/helper-tray-poc.md`. PR #8 смержен. -- #1.8.4 список функций Помощника по фазам — `docs/architecture/helper.md`; черновик ADR-0005 «Предложено» — `docs/adr/0005-agent-and-helper.md`. +- #1.8.4 список функций Помощника по фазам — `docs/architecture/helper.md`; черновик ADR-0005 «Предложено» — `docs/adr/0005-agent-and-helper.md`. PR #9 смержен. +- #1.9.6 черновик ADR-0006 — `docs/adr/0006-user-tickets.md`; #1.9.7 макет окна Помощника — `docs/ux/helper-window.html`. ## В работе -- #1.8 · `feat/1.8-helper-functions` · осталось — замер на Astra 1.8 (Максим, #1.12.5) и решение в #1.8.3 +- #1.9 · `feat/1.9-user-tickets` · ADR-0006 и макет окна; осталось — ревью и «Принято» +- #1.8 · осталось — замер на Astra 1.8 (Максим, #1.12.5) и решение в #1.8.3 - #1.4 · без ветки · обсуждение поддерживаемых ОС (взял в работу) ## Ждём от Backend diff --git a/docs/status/shared.md b/docs/status/shared.md index 3eddf14..26b9afb 100644 --- a/docs/status/shared.md +++ b/docs/status/shared.md @@ -1,6 +1,6 @@ # Состояние: общее (shared) -Обновлено: 2026-11-11 · Шаг 1 «Решения и подготовка» · Версия — +Обновлено: 2026-11-15 · Шаг 1 «Решения и подготовка» · Версия — Снимок, а не история. Правила — `docs/ai/PROTOCOL.md`, разделы 2 и 6. @@ -29,6 +29,7 @@ - 2026-11-08 · frontend → backend · версии инструментов зафиксированы: `git pull`, `mise trust && mise install` по `docs/environment.md` - 2026-11-09 · frontend → backend · PoC трея Помощника (#1.8.1–1.8.2): на Windows 11 по PrivateBytes покой 2,0 МБ (≤40 ✅), окно 155,3 МБ (цель 150 — не дотянуто ~5 МБ), открытие ~0,58 с ✅. Методика и как повторить на Astra 1.8 — `docs/research/helper-tray-poc.md`; нужен замер Максима для ADR-0005 (#1.8.3) - 2026-11-11 · frontend → backend · функции Помощника по фазам (#1.8.4) — `docs/architecture/helper.md` с черновым списком методов IPC для `proto/helper/v1`; черновик ADR-0005 «Предложено» — `docs/adr/0005-agent-and-helper.md` +- 2026-11-15 · frontend → backend · обращения пользователей (#1.9): черновик ADR-0006 — `docs/adr/0006-user-tickets.md` (автодиагностика и очередь — на агенте, шаг 6); макет окна Помощника — `docs/ux/helper-window.html` ## Запросы между зонами diff --git a/docs/ux/helper-window.html b/docs/ux/helper-window.html new file mode 100644 index 0000000..0e46ef3 --- /dev/null +++ b/docs/ux/helper-window.html @@ -0,0 +1,220 @@ + + +
+ + +Функциональный макет #1.9.7 — по прототипу из карточки 1.9. Это схема экранов, не визуальный дизайн: цвета и стиль задаст тема приложения позже. Ширина окна ~400px.
+ ++Что учтено из решения 1.9: поля «срочность» нет (приоритет ставит админ); описание со счётчиком до 1000; скриншот — превью с «Убрать»; кнопки «Решено / Не помогло» показываются только в статусе «Ожидает пользователя» и только когда политика организации включила подтверждение; список — последние 10 обращений. +
+ + +