[1.9] Обращения: ADR-0006 и макет окна Помощника (#10)
ci / smoke (push) Successful in 2s

**Задача:** #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>
This commit was merged in pull request #10.
This commit is contained in:
TMSH authored and TMSH committed 2026-11-15 14:23:13 +00:00
1 parent 9a0533b102
commit 3d2e23dd9b
6 files changed
+309 -5

No files matched your search

+46
View File
@@ -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) покажут, что пользователям нужен живой чат или поле срочности.
@@ -6,7 +6,7 @@ items: ["1.8.4", "1.8.5"]
branch: feat/1.8-helper-functions
pr: —
impact: shared
status: в работе
status: смержено
author: Frontend
---
@@ -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).
+5 -3
View File
@@ -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`.
## В работе
<!-- - #ID · ветка · что осталось -->
- #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
+2 -1
View File
@@ -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`
## Запросы между зонами
<!-- Формат: - [ ] YYYY-MM-DD · от зоны → к зоне · что нужно · зачем · #ID -->
+220
View File
@@ -0,0 +1,220 @@
<!DOCTYPE html>
<html lang="ru">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Макет окна «Штиль Помощник» — #1.9.7</title>
<link rel="preconnect" href="https://fonts.googleapis.com">
<link href="https://fonts.googleapis.com/css2?family=Golos+Text:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
<style>
:root{
--bg:#F4F5F7; --card:#FFFFFF; --line:#E2E5EA;
--text:#23272E; --text-2:#6B7280; --text-3:#9AA1AB;
--accent:#3D6E9E; --accent-soft:#E8F0F7;
--ok:#3F7D54; --ok-soft:#E5F0E8;
--warn:#9A7418; --warn-soft:#F7EFD8;
--err:#A94438; --err-soft:#F7E6E2;
--mut:#8A919B; --mut-soft:#EEF0F2;
--r:10px;
}
*{margin:0;padding:0;box-sizing:border-box}
body{font-family:"Golos Text",system-ui,sans-serif;background:var(--bg);color:var(--text);font-size:14px;line-height:1.5;padding:32px}
h1{font-size:20px;margin-bottom:4px}
.sub{color:var(--text-2);margin-bottom:24px;font-size:13px}
.sub code{font-family:"JetBrains Mono",monospace;font-size:12px}
.screens{display:flex;gap:24px;flex-wrap:wrap;align-items:flex-start}
.screen-cap{font-family:"JetBrains Mono",monospace;font-size:11px;letter-spacing:.1em;text-transform:uppercase;color:var(--text-3);margin-bottom:8px}
/* окно Помощника */
.win{width:400px;background:var(--card);border:1px solid var(--line);border-radius:14px;box-shadow:0 4px 20px rgba(30,35,45,.10);overflow:hidden}
.win-head{padding:14px 18px;border-bottom:1px solid var(--line);display:flex;align-items:center;gap:10px}
.win-head .ttl{font-weight:700;font-size:15px}
.win-head .min{margin-left:auto;color:var(--text-3);font-family:"JetBrains Mono",monospace;font-size:11px}
.win-body{padding:16px 18px;display:grid;gap:14px}
/* категории */
.cats{display:grid;grid-template-columns:1fr 1fr;gap:8px}
.cat{border:1px solid var(--line);border-radius:var(--r);padding:9px 12px;font-size:13px;font-weight:500;cursor:pointer;display:flex;gap:8px;align-items:center;transition:all .12s}
.cat:hover{border-color:var(--accent)}
.cat.on{border-color:var(--accent);background:var(--accent-soft);color:var(--accent);font-weight:600}
.cat .ic{font-size:15px}
/* поля */
.f label{display:block;font-size:12.5px;font-weight:600;margin-bottom:5px}
.f .hint{float:right;font-family:"JetBrains Mono",monospace;font-size:10.5px;color:var(--text-3);font-weight:400}
.f textarea,.f input{width:100%;font:inherit;font-size:13.5px;border:1px solid var(--line);border-radius:var(--r);padding:9px 11px;resize:vertical;background:#FCFCFD}
.f textarea:focus,.f input:focus{outline:none;border-color:var(--accent);box-shadow:0 0 0 3px var(--accent-soft)}
.f textarea{min-height:76px}
/* скриншот */
.shot{display:flex;gap:10px;align-items:center;border:1px dashed var(--line);border-radius:var(--r);padding:8px 10px}
.shot .prev{width:72px;height:44px;border-radius:6px;background:linear-gradient(135deg,#cdd6e0,#9fb2c8);flex:none;border:1px solid var(--line);display:flex;align-items:center;justify-content:center;font-size:16px}
.shot .nm{font-size:12.5px;color:var(--text-2)}
.shot .rm{margin-left:auto;font-size:12px;color:var(--err);font-weight:600;cursor:pointer;border:none;background:none;font-family:inherit}
.shot .rm:hover{text-decoration:underline}
/* кнопки */
.btn{font:inherit;font-weight:600;font-size:14px;padding:10px 16px;border-radius:var(--r);border:1px solid transparent;cursor:pointer;transition:all .15s}
.btn-p{background:var(--accent);color:#fff;width:100%}
.btn-p:hover{background:#335F88}
.btn-s{background:transparent;color:var(--accent);border-color:var(--line);padding:7px 13px;font-size:13px}
.btn-s:hover{border-color:var(--accent);background:var(--accent-soft)}
.btn-ok{background:var(--ok);color:#fff;padding:7px 13px;font-size:13px}
.btn-ok:hover{background:#356747}
.btn-err{background:transparent;color:var(--err);border-color:var(--line);padding:7px 13px;font-size:13px}
.btn-err:hover{border-color:var(--err);background:var(--err-soft)}
/* чипы статусов */
.chip{display:inline-flex;align-items:center;gap:5px;font-size:11.5px;font-weight:600;border-radius:999px;padding:3px 10px;white-space:nowrap}
.chip i{width:6px;height:6px;border-radius:50%;background:currentColor;font-style:normal}
.c-new{background:var(--accent-soft);color:var(--accent)}
.c-work{background:var(--warn-soft);color:var(--warn)}
.c-wait{background:var(--err-soft);color:var(--err)}
.c-done{background:var(--ok-soft);color:var(--ok)}
.c-closed,.c-rej{background:var(--mut-soft);color:var(--mut)}
/* список обращений */
.tk{border:1px solid var(--line);border-radius:var(--r);padding:11px 13px;cursor:pointer;transition:all .15s}
.tk:hover{box-shadow:0 2px 10px rgba(30,35,45,.08)}
.tk .top{display:flex;align-items:center;gap:8px}
.tk .t{font-weight:600;font-size:13.5px}
.tk .m{font-family:"JetBrains Mono",monospace;font-size:10.5px;color:var(--text-3);margin-top:3px}
.tk .chip{margin-left:auto}
/* переписка */
.thread{display:grid;gap:8px}
.msg{max-width:88%;border-radius:10px;padding:8px 11px;font-size:13px}
.msg .who{display:block;font-family:"JetBrains Mono",monospace;font-size:10px;color:var(--text-3);margin-bottom:2px}
.msg.a{background:var(--accent-soft);justify-self:start}
.msg.u{background:var(--mut-soft);justify-self:end}
.sysline{text-align:center;font-family:"JetBrains Mono",monospace;font-size:10.5px;color:var(--text-3);padding:4px 0}
.confirm{border:1px solid var(--warn);background:var(--warn-soft);border-radius:var(--r);padding:10px 12px}
.confirm .q{font-size:12.5px;font-weight:600;color:var(--warn);margin-bottom:8px}
.reply{display:flex;gap:8px}
.reply input{flex:1;font:inherit;font-size:13px;border:1px solid var(--line);border-radius:var(--r);padding:8px 11px}
.reply input:focus{outline:none;border-color:var(--accent)}
/* о программе */
.about{display:grid;gap:8px;font-size:13.5px}
.about .row{display:flex;justify-content:space-between;border-bottom:1px dashed var(--line);padding-bottom:6px}
.about .row:last-child{border-bottom:none;padding-bottom:0}
.about .k{color:var(--text-2)}
.about .v{font-weight:500}
.about .v.mono{font-family:"JetBrains Mono",monospace;font-size:12px}
.st-ok{color:var(--ok);font-weight:600}
.note{margin-top:28px;max-width:640px;color:var(--text-2);font-size:12.5px;border-left:3px solid var(--line);padding-left:14px}
@media (prefers-reduced-motion:reduce){*{transition:none!important}}
</style>
</head>
<body>
<h1>Окно «Штиль Помощник»</h1>
<p class="sub">Функциональный макет #1.9.7 — по прототипу из карточки 1.9. Это схема экранов, <b>не визуальный дизайн</b>: цвета и стиль задаст тема приложения позже. Ширина окна ~400px.</p>
<div class="screens">
<!-- ЭКРАН 1: форма -->
<div>
<div class="screen-cap">Экран 1 · Сообщить о проблеме</div>
<div class="win">
<div class="win-head"><span class="ttl">Сообщить о проблеме</span><span class="min">— □ ×</span></div>
<div class="win-body">
<div class="cats">
<div class="cat"><span class="ic">🖨</span>Не печатает</div>
<div class="cat on"><span class="ic">🌐</span>Нет сети</div>
<div class="cat"><span class="ic">🐢</span>Медленно</div>
<div class="cat"><span class="ic">⚠</span>Программа</div>
<div class="cat"><span class="ic">🔑</span>Доступ / ПО</div>
<div class="cat"><span class="ic">💬</span>Другое</div>
</div>
<div class="f">
<label>Описание <span class="hint">148 / 1000</span></label>
<textarea>Пропал интернет минут 15 назад, значок жёлтый. Соседям по кабинету то же самое.</textarea>
</div>
<div class="shot">
<div class="prev">🖥</div>
<div class="nm">Скриншот приложится<br>автоматически</div>
<button class="rm">Убрать</button>
</div>
<div class="f">
<label>Как с вами связаться</label>
<input value="каб. 214, вн. 45-12">
</div>
<button class="btn btn-p">Отправить</button>
</div>
</div>
</div>
<!-- ЭКРАН 2: список -->
<div>
<div class="screen-cap">Экран 2 · Мои обращения</div>
<div class="win">
<div class="win-head"><span class="ttl">Мои обращения</span><span class="min">— □ ×</span></div>
<div class="win-body">
<div class="tk">
<div class="top"><span class="t">Нет сети</span><span class="chip c-wait"><i></i>Ждёт вас</span></div>
<div class="m">#1042 · сегодня, 14:02</div>
</div>
<div class="tk">
<div class="top"><span class="t">Не печатает HP</span><span class="chip c-work"><i></i>В работе</span></div>
<div class="m">#1031 · 12 ноя, Козлов Д.</div>
</div>
<div class="tk" style="opacity:.75">
<div class="top"><span class="t">Нужен 1С:ЗУП</span><span class="chip c-closed"><i></i>Закрыто</span></div>
<div class="m">#0987 · 3 ноя</div>
</div>
<div class="tk" style="opacity:.75">
<div class="top"><span class="t">Медленно грузится</span><span class="chip c-rej"><i></i>Отклонено</span></div>
<div class="m">#0950 · 28 окт</div>
</div>
</div>
</div>
</div>
<!-- ЭКРАН 3: карточка с перепиской -->
<div>
<div class="screen-cap">Экран 3 · Обращение и переписка</div>
<div class="win">
<div class="win-head"><span class="ttl">#1042 · Нет сети</span><span class="chip c-wait" style="margin-left:auto"><i></i>Ждёт вас</span></div>
<div class="win-body">
<div class="thread">
<div class="msg u"><span class="who">вы · 14:02</span>Пропал интернет минут 15 назад, значок жёлтый.</div>
<div class="msg a"><span class="who">Козлов Д. · 14:10</span>Вижу, у всего этажа пропал DHCP. Перезапускаю службу, проверьте через минуту.</div>
<div class="msg u"><span class="who">вы · 14:13</span>Появилась сеть, спасибо!</div>
<div class="sysline">Козлов Д. отметил как «Решено» · 14:15</div>
</div>
<div class="confirm">
<div class="q">Проблема решена? Через 3 дня обращение закроется само.</div>
<div style="display:flex;gap:8px">
<button class="btn btn-ok">Да, решено</button>
<button class="btn btn-err">Нет, не помогло</button>
</div>
</div>
<div class="reply"><input placeholder="Написать в обращение…"><button class="btn btn-s">→</button></div>
</div>
</div>
</div>
<!-- ЭКРАН 4: о программе -->
<div>
<div class="screen-cap">Экран 4 · О программе</div>
<div class="win">
<div class="win-head"><span class="ttl">О программе</span><span class="min">— □ ×</span></div>
<div class="win-body">
<div class="about">
<div class="row"><span class="k">Приложение</span><span class="v">Штиль Помощник</span></div>
<div class="row"><span class="k">Версия</span><span class="v mono">0.9.2 (64-bit)</span></div>
<div class="row"><span class="k">Организация</span><span class="v">ООО «Ромашка»</span></div>
<div class="row"><span class="k">Устройство</span><span class="v mono">WS-0142</span></div>
<div class="row"><span class="k">Связь с агентом</span><span class="v st-ok">подключено</span></div>
</div>
</div>
</div>
</div>
</div>
<p class="note">
<b>Что учтено из решения 1.9:</b> поля «срочность» нет (приоритет ставит админ); описание со счётчиком до 1000; скриншот — превью с «Убрать»; кнопки «Решено / Не помогло» показываются только в статусе «Ожидает пользователя» и только когда политика организации включила подтверждение; список — последние 10 обращений.
</p>
</body>
</html>