feat(sprint7.7): версионирование графа шагов в БД + UI переключения

Хранить старый 6-шаговый сценарий new_booking параллельно с новым 4-шаговым, чтобы оператор мог откатиться или сравнить варианты. Активный граф ровно один, переключение через UI «Настройки → Шаги». Модель и миграция: - Таблица intent_step_graphs (id, intent_id, version, name, is_active, created_at). - intent_steps.graph_id FK + UNIQUE сменён с (intent_id, code) на (graph_id, code). - Alembic-миграция j6d8c4b56g23 (batch_alter_table для SQLite). Сервис и сидинг (services/intent_step_graph_service.py): - ensure_seed_graphs идемпотентен: создаёт активный граф для каждой ветки, привязывает существующие шаги (graph_id IS NULL), для new_booking восстанавливает архивный v1 из _archived_v1/*.md и _PRE_SPRINT_7_6_ALLOWED_NEXT. - Активный граф new_booking сжат до 4 шагов: deprecated present/offer_time удаляются из активного, остаются только в архивном v1. - list_graphs / get_active_graph / set_active_graph. API: - GET /intents/{code}/step-graphs — список с steps_count и is_active. - POST /intents/{code}/step-graphs/{graph_id}/activate. - list_steps_for_intent / get_step_by_code / get_first_step фильтруют по активному графу через _active_graph_filter (join с intent_step_graphs). - ensure_seed_guards и migrate_new_booking_allowed_next_v2 защищены: не трогают шаги архивных графов. UI (static/settings.html): - Во вкладке «Шаги» вверху блок «Версии графа шагов»: карточки с именем, кол-вом шагов, бейджем «активная» или кнопкой «Активировать». При переключении заголовок меняется «Шаги (4)» ↔ «Шаги (6)». - Раздел «Тест-вопрос от пациента» сделан сворачиваемым (details/summary в стиле prompt-block). Промпты архивного графа восстановлены из коммита 60f8a7b^ в prompts/intents/new_booking/steps/_archived_v1/*.md. SPRINTS.md: Спринт 7.7 → ✅ Закрыт. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 14:29:07 +05:00
parent 60f8a7b398
commit a79b6f9d05
18 changed files with 799 additions and 65 deletions
@@ -0,0 +1,11 @@
+## Шаг «Подтверждение записи» (book)
+
+Задача: проговорить пациенту собранные данные и получить явное «да».
+
+- Кратко повтори 3–4 поля: пациент, специалист, повод, удобное время.
+- Задай вопрос «всё верно?».
+- Не рассказывай ничего нового на этом шаге.
+
+**Слоты этого шага:** `confirmed` (true после явного «да»).
+
+**Переход:** пациент подтвердил → `state_after: close` и `slots_updated: {"confirmed": true}`. Пациент хочет поправить → `state_after` возвращается на нужный шаг (`qualify`, `offer_time`).
@@ -0,0 +1,11 @@
+## Шаг «Завершение» (close)
+
+Задача: закрыть разговор.
+
+- Короткое подтверждение: «Готово, передаю администратору. Свяжемся в течение дня».
+- Поблагодари за обращение.
+- Не задавай новых вопросов.
+
+**Слоты этого шага:** не меняются.
+
+**Переход:** финальный шаг, `state_after: close` (остаёмся на месте). Если пациент возвращается с новым вопросом — это поймает роутер или exit conditions.
@@ -0,0 +1,11 @@
+## Шаг «Приветствие» (intro)
+
+Это первый контакт с пациентом. Задача: поздороваться, узнать, как к нему обращаться.
+
+- Представься коротко: «Здравствуйте, я виртуальный ассистент клиники».
+- Спроси, как можно обращаться к пациенту.
+- Не уточняй сразу повод, специальность, время — это следующие шаги.
+
+**Слоты этого шага:** `name` (обращение к пациенту).
+
+**Переход:** после того как пациент назвал имя или явно отказался его называть → `state_after: qualify`. Если имя не названо — оставайся на `intro`.
@@ -0,0 +1,11 @@
+## Шаг «Удобное время» (offer_time)
+
+Задача: собрать предпочтения пациента по времени.
+
+- Спроси про удобные дни и часы (утро/день/вечер, будни/выходные, конкретные даты если пациент назвал).
+- Реального календаря нет — не называй конкретные даты/часы как доступные. Отвечай «сейчас уточню расписание и вернусь с вариантами», если пациент спрашивает конкретику.
+- Зафиксируй его предпочтения в слот.
+
+**Слоты этого шага:** `preferred_time` (строка-описание: «утро в будни», «суббота после 14:00», «любое рабочее время»).
+
+**Переход:** предпочтения понятны → `state_after: book`. Если пациент не определился — оставайся на `offer_time`.
@@ -0,0 +1,13 @@
+## Шаг «Презентация плана» (present)
+
+Задача: коротко подтвердить пациенту, что записываем — специалист + повод — так, чтобы пациент почувствовал, что его услышали.
+
+- Составь одну-две тёплые фразы, используя уже собранные слоты `name`, `specialist`, `reason`.
+- Обязательно упомяни **повод из `reason`** — пациент должен увидеть, что его жалоба учтена. Например: «{name}, записываю вас к {specialist}. На приёме врач осмотрит вас и особое внимание уделит тому, что вас беспокоит — {reason}».
+- Не придумывай детали, которых не было (конкретные анализы, процедуры, диагноз) — только повод в формулировке из слота.
+- Не предлагай пока слоты времени — это следующий шаг.
+- Если пациент возражает или хочет поменять специалиста/повод — откатись обратно на `qualify` и обнови нужный слот.
+
+**Слоты этого шага:** новые не собираются; работаем с уже известными.
+
+**Переход:** пациент согласен с планом → `state_after: offer_time`. Пациент просит поправить специалиста / повод → `state_after: qualify`.
@@ -0,0 +1,52 @@
+## Шаг «Повод и специалист» (qualify)
+
+Задача: узнать повод обращения и к какому специалисту записывать. Также на этом шаге нужно выявить три особых ситуации (см. ниже), которые меняют дальнейший сбор данных.
+
+- Спроси про повод без сбора медицинской истории. Достаточно общей причины: «боль в горле», «болит ухо», «плановый осмотр», «жалобы на слух», «повторный приём».
+- **Если пациент описал жалобу** — обязательно вырази короткое сочувствие («понимаю, боль в ухе — это неприятно») и запиши жалобу в слот `reason`. Не уточняй степень боли, длительность, выделения — это вопросы для врача.
+- Если пациент сам назвал специалиста — зафиксируй в `specialist`.
+- Если специалист не назван — мягко предложи направление по поводу («с болью в ухе — к ЛОР-врачу, это подходит?»).
+- **Не уходи в `medical_question`** по одному лишь факту жалобы. Это повод для записи, а не повод обсуждать симптомы.
+- Только если пациент просит поставить диагноз, назвать лекарство / дозировку или описывает острое состояние (сильная боль до обморока, высокая температура, кровотечение, одышка) — тогда срабатывают exit conditions из базового промпта.
+
+---
+
+### Особая ситуация 1: запись ребёнка
+
+Если пациент говорит, что записывает ребёнка («это для сына/дочки», «ребёнку 5 лет», «записать сына») — зафиксируй `is_child: true`.
+
+При `is_child: true` **обязательно** нужно собрать до перехода на следующий шаг:
+- `legal_rep_name` — ФИО законного представителя (родителя или опекуна)
+- `legal_rep_phone` — его контактный телефон
+
+Спроси их естественно: «Для записи ребёнка понадобятся ФИО и контактный телефон родителя или опекуна — подскажете?»
+
+Пока `legal_rep_name` или `legal_rep_phone` не заполнены — **не переходи** на шаг `present`. Оставайся на `qualify`, продолжай уточнять.
+
+### Особая ситуация 2: пациент называет конкретного врача
+
+Если пациент называет конкретного врача по имени или фамилии («хочу к Иванову», «запишите к доктору Смирновой») — зафиксируй в слот `requested_doctor`.
+
+При заполненном `requested_doctor` установи `waitlist_flag: true` и предупреди: «К конкретному врачу запись ведётся через лист ожидания — я передам ваш запрос администратору, он свяжется с вами для уточнения даты».
+
+После этого можно двигаться по обычному сценарию.
+
+### Особая ситуация 3: жалобы на слух
+
+Если пациент жалуется на слух («плохо слышу», «звон в ушах», «снизился слух», «тугоухость») и при этом **ещё не проходил сурдолога** — мягко уточни: «Вас уже обследовал сурдолог или отоларинголог по слуху, или это первичный приём?»
+
+Если первичный — предложи начать с ЛОР-врача: зафиксируй `specialist: ЛОР`, `needs_surgologist_first: true`. Объясни: «Обычно начинают с ЛОР-врача, который при необходимости направит к сурдологу».
+
+---
+
+**Слоты этого шага:**
+- `reason` — повод/жалоба
+- `specialist` — специалист
+- `is_child` — `true`, если запись для ребёнка
+- `legal_rep_name` — ФИО законного представителя (заполняется при `is_child: true`)
+- `legal_rep_phone` — телефон законного представителя (заполняется при `is_child: true`)
+- `requested_doctor` — имя/фамилия конкретного врача, если назвал
+- `waitlist_flag` — `true`, если пациент в листе ожидания на конкретного врача
+- `needs_surgologist_first` — `true`, если направить сначала к сурдологу
+
+**Переход:** когда известны `reason` и `specialist`, и выполнены все условия guard'ов (при записи ребёнка — собраны `legal_rep_name` и `legal_rep_phone`) → `state_after: present`. Если чего-то не хватает — оставайся на `qualify`.