From 24c3c822e3f1464c420d78a2dc8455b6aa5973d1 Mon Sep 17 00:00:00 2001 From: BrowenSiz Date: Sun, 15 Nov 2026 17:12:31 +0300 Subject: [PATCH 1/2] =?UTF-8?q?docs:=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2?= =?UTF-8?q?=D0=BB=D0=B5=D0=BD=D0=B0=20=D0=B7=D0=B0=D0=BF=D0=B8=D1=81=D1=8C?= =?UTF-8?q?=20=D0=B6=D1=83=D1=80=D0=BD=D0=B0=D0=BB=D0=B0=20=D0=B2=D0=B5?= =?UTF-8?q?=D1=82=D0=BA=D0=B8=20=D0=BE=D0=B1=D1=80=D0=B0=D1=89=D0=B5=D0=BD?= =?UTF-8?q?=D0=B8=D0=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Refs: 1.9.5, 1.9.6, 1.9.7 --- ...026-11-11-frontend-1.8-helper-functions.md | 2 +- .../2026-11-15-frontend-1.9-user-tickets.md | 35 +++++++++++++++++++ 2 files changed, 36 insertions(+), 1 deletion(-) create mode 100644 docs/journal/2026-11-15-frontend-1.9-user-tickets.md 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..0ca0648 --- /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): сценарий обращения, поля формы, статусы, маршрутизация, правила скриншотов, переписка и подтверждение «Решено». +- `poc/helper-ticket/` — макет окна Помощника (#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). -- 2.54.0 From 63229b5a2e7c41f8c3748dd0792c02b6fcb4424a Mon Sep 17 00:00:00 2001 From: BrowenSiz Date: Sun, 15 Nov 2026 17:19:24 +0300 Subject: [PATCH 2/2] =?UTF-8?q?docs:=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2?= =?UTF-8?q?=D0=BB=D0=B5=D0=BD=D1=8B=20ADR-0006=20=D0=B8=20=D0=BC=D0=B0?= =?UTF-8?q?=D0=BA=D0=B5=D1=82=20=D0=BE=D0=BA=D0=BD=D0=B0=20=D0=9F=D0=BE?= =?UTF-8?q?=D0=BC=D0=BE=D1=89=D0=BD=D0=B8=D0=BA=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - docs/adr/0006-user-tickets.md: сценарий обращения, форма без срочности, статусы с переоткрытием, кнопка «Решено» политикой, скриншоты 30 дней — статус «Предложено» - docs/ux/helper-window.html: функциональный макет окна по прототипу — форма, список обращений, переписка, «О программе» Refs: 1.9.6, 1.9.7 --- docs/adr/0006-user-tickets.md | 46 ++++ .../2026-11-15-frontend-1.9-user-tickets.md | 2 +- docs/status/frontend.md | 8 +- docs/status/shared.md | 3 +- docs/ux/helper-window.html | 220 ++++++++++++++++++ 5 files changed, 274 insertions(+), 5 deletions(-) create mode 100644 docs/adr/0006-user-tickets.md create mode 100644 docs/ux/helper-window.html 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-15-frontend-1.9-user-tickets.md b/docs/journal/2026-11-15-frontend-1.9-user-tickets.md index 0ca0648..930ec6b 100644 --- a/docs/journal/2026-11-15-frontend-1.9-user-tickets.md +++ b/docs/journal/2026-11-15-frontend-1.9-user-tickets.md @@ -14,7 +14,7 @@ author: Frontend ## Сделано - `docs/adr/0006-user-tickets.md` — черновик ADR-0006 со статусом «Предложено» (#1.9.6): сценарий обращения, поля формы, статусы, маршрутизация, правила скриншотов, переписка и подтверждение «Решено». -- `poc/helper-ticket/` — макет окна Помощника (#1.9.7): живая HTML-страница по прототипу — форма с категориями, описанием, автоскриншотом с превью и «Убрать»; «Мои обращения» со статусами и перепиской. +- `docs/ux/helper-window.html` — макет окна Помощника (#1.9.7): живая HTML-страница по прототипу — форма с категориями, описанием со счётчиком, автоскриншотом с превью и «Убрать»; «Мои обращения» со статусами, перепиской и подтверждением «Решено»; «О программе». - Правки записи журнала ветки 1.8-functions: статус «смержено». ## Решения (по ответам в карточке 1.9) 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.7 — по прототипу из карточки 1.9. Это схема экранов, не визуальный дизайн: цвета и стиль задаст тема приложения позже. Ширина окна ~400px.

+ +
+ + +
+
Экран 1 · Сообщить о проблеме
+
+
Сообщить о проблеме— □ ×
+
+
+
🖨Не печатает
+
🌐Нет сети
+
🐢Медленно
+
⚠Программа
+
🔑Доступ / ПО
+
💬Другое
+
+
+ + +
+
+ +
Скриншот приложится
автоматически
+ +
+
+ + +
+ +
+
+
+ + +
+
Экран 2 · Мои обращения
+
+
Мои обращения— □ ×
+
+
+
Нет сетиЖдёт вас
+
#1042 · сегодня, 14:02
+
+
+
Не печатает HPВ работе
+
#1031 · 12 ноя, Козлов Д.
+
+
+
Нужен 1С:ЗУПЗакрыто
+
#0987 · 3 ноя
+
+
+
Медленно грузитсяОтклонено
+
#0950 · 28 окт
+
+
+
+
+ + +
+
Экран 3 · Обращение и переписка
+
+
#1042 · Нет сетиЖдёт вас
+
+
+
вы · 14:02Пропал интернет минут 15 назад, значок жёлтый.
+
Козлов Д. · 14:10Вижу, у всего этажа пропал DHCP. Перезапускаю службу, проверьте через минуту.
+
вы · 14:13Появилась сеть, спасибо!
+
Козлов Д. отметил как «Решено» · 14:15
+
+
+
Проблема решена? Через 3 дня обращение закроется само.
+
+ + +
+
+
+
+
+
+ + +
+
Экран 4 · О программе
+
+
О программе— □ ×
+
+
+
ПриложениеШтиль Помощник
+
Версия0.9.2 (64-bit)
+
ОрганизацияООО «Ромашка»
+
УстройствоWS-0142
+
Связь с агентомподключено
+
+
+
+
+
+ +

+Что учтено из решения 1.9: поля «срочность» нет (приоритет ставит админ); описание со счётчиком до 1000; скриншот — превью с «Убрать»; кнопки «Решено / Не помогло» показываются только в статусе «Ожидает пользователя» и только когда политика организации включила подтверждение; список — последние 10 обращений. +

+ + + -- 2.54.0