Вкладка «Аналитик» — дизайн-спека

Что это и на чём основано

Спека описывает вкладку «Аналитик» конструктора отчётов РРЭ: состояния диалога, компоненты, поведение уточняющих вопросов и критерии приёмки для фронтенда.

Исходники сервиса недоступны (GITHUB_TOKEN в окружении шага отсутствует, репозиторий не клонирован — шаги 1–3 прогона по той же причине не выполнены). Поэтому спека и макет сняты с работающего сервиса sol-mspg313y-6zr.apps.sreda-ai.ru, проверено 12.08.2026:

• GET / — HTML конструктора: палитра, сетка, компоненты и текущая разметка вкладки «Аналитик»;
• POST /api/agent/chat — четыре реальных диалога: тексты вопросов, опции, конфигурации, строки результата;
• GET /api/agent/context — 7 источников, правила витрины, связи, словарь (7 562 символа), 4 открытых вопроса.

1. Экран и структура

Вкладка — четвёртая в существующей навигации (Данные · Конструктор · Отчёт ПУНЦ · Аналитик), сетка и палитра конструктора не меняются. Сверху вниз:

2. Состояния диалога

3. Уточняющие вопросы: слоты и порядок

Агент не додумывает недостающее. Порядок опроса — от того, без чего конфигурацию нельзя собрать, к деталям:

Правила поведения

• один вопрос за раз — не анкета из пяти полей;
• вопрос всегда сопровождается кнопками-вариантами из фактических значений данных, ручной ввод остаётся доступен;
• после ответа кнопки предыдущего вопроса убираются из ленты — нельзя ответить на вопрос, который уже снят;
• уже собранные слоты видны в строке понимания: пользователь не гадает, что аналитик «услышал»;
• перед расчётом — обязательное подтверждение конфигурации; никакой расчёт не идёт по догадке;
• реплика в состоянии подтверждения, отличная от «да/считай/ок», трактуется как правка, а не как отказ.

4. Компоненты и токены

Все переменные — из существующего конструктора, новых цветов не вводится: --accent:#2b6cb0, --line:#e2e5ea, --muted:#6b7684, --warnbg:#fff6e0, рост #1b6b45, снижение #a3261e.

5. Контракт с бэкендом (снят с работающего сервиса)

POST /api/agent/chat
{ "message": "покажи начисления по регионам", "state": null }

200 →
{ "status": "ask",                        // ask | confirm | result
  "reply":  "За какой период считать? В данных есть: 2024-08.",
  "question": { "slot": "period", "text": "…", "options": ["2024-08"] },
  "notes":  [],                           // оговорки → пузыри «Важно»
  "config": {…}, "summary": ["Источник: Начисления (00102)", …],
  "result": { "row_count": 5, "columns": [{key,title,role,type,unit}], "rows": [...], "warnings": [] },
  "state":  {…} }                         // вернуть без изменений в следующем запросе

GET  /api/agent/context            → dictionary, sources[7], relations, rules, open_questions
POST /api/agent/export?fmt=xlsx|csv|pdf  → файл по состоянию диалога

Дельта-колонки приходят ключами *__delta и *__delta_pct — фронтенд опознаёт их по суффиксу и раскрашивает; легенда показывается только при их наличии.

6. Дефекты, найденные на работающем сервисе

Все воспроизведены 12.08.2026 через POST /api/agent/chat; реплики приведены дословно.

7. Критерии приёмки для фронтенда

• вкладка «Аналитик» открывается в существующей навигации, палитра и сетка конструктора не изменены;
• поле ввода: Enter — отправить, Shift+Enter — перенос строки; на время запроса поле и кнопка заблокированы, в ленте — «Аналитик думает…»;
• на неоднозначный запрос приходит пузырь с вопросом, пилюля «уточняет» и кнопки вариантов из question.options;
• кнопки предыдущего вопроса исчезают после ответа; повторный клик по устаревшему варианту невозможен;
• перед расчётом показывается карточка конфигурации с summary и JSON; расчёт запускается только по «Считать» / «да»;
• в результате: счётчик строк, таблица с правым выравниванием мер, предупреждения витрины из warnings;
• при сравнении: колонки *__delta и *__delta_pct раскрашены и снабжены легендой; пустые значения — «—»;
• «Начать заново» очищает ленту, состояние, карточку конфигурации и результат;
• ошибка сервера показывается пузырём «Ошибка» и не обрывает диалог;
• на экране 360px нет горизонтального скролла; лента чата — aria-live="polite", фокус после отправки возвращается в поле ввода.

8. Что в макете не покрыто

• Сводный документ из нескольких отчётов и дашборд с графиками — отдельные шаги ТЗ, в макете вкладки не рисовались;
• Состояние сравнения с дельтой показано на макетных числах: живой сервис на диалогах 12.08.2026 до ответа с дельта-колонками не дошёл (см. UX-1 и UX-2) — числа помечены прямо в таблице;
• Выгрузки в макете не выполняются: кнопки показывают, какой запрос уйдёт на сервисе;
• макет работает на записанных ответах — браузерный вызов живого API невозможен, сервис не отдаёт заголовок Access-Control-Allow-Origin (проверено 12.08.2026).