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>
This commit is contained in:
AR 15 M4
2026-05-02 14:29:07 +05:00
parent 60f8a7b398
commit a79b6f9d05
18 changed files with 799 additions and 65 deletions
+5 -1
View File
@@ -3,8 +3,12 @@ from db.models.document import Document
from db.models.intent import Intent
from db.models.intent_document import IntentDocument
from db.models.intent_step import IntentStep
from db.models.intent_step_graph import IntentStepGraph
from db.models.message import Message
from db.models.thread import Thread
from db.models.thread_state import ThreadState
__all__ = ["Thread", "Message", "Document", "AgentConfig", "Intent", "IntentDocument", "IntentStep", "ThreadState"]
__all__ = [
"Thread", "Message", "Document", "AgentConfig", "Intent",
"IntentDocument", "IntentStep", "IntentStepGraph", "ThreadState",
]
+11 -3
View File
@@ -11,20 +11,28 @@ def _utcnow() -> datetime:
class IntentStep(Base):
"""Шаг state machine внутри ветки (Спринт 6a).
"""Шаг state machine внутри ветки (Спринт 6a, версионирование — Спринт 7.7).
Шаги живут в БД, а не в коде: оператор редактирует промпт шага и список
допустимых переходов через UI «Настройки → Шаги». `allowed_next` и `guards`
хранятся как JSON-строки (парсим в сервисе), чтобы не городить отдельные
таблицы. Версионирования нет: правка применяется сразу.
таблицы.
Со Спринта 7.7 каждый шаг принадлежит конкретной версии графа
(`graph_id` → `intent_step_graphs.id`); UNIQUE по `(graph_id, code)`. Старая
запись без графа допустима только в окне data-migration через
`intent_step_graph_service.ensure_seed_graphs`.
"""
__tablename__ = "intent_steps"
__table_args__ = (UniqueConstraint("intent_id", "code", name="uq_intent_step_code"),)
__table_args__ = (UniqueConstraint("graph_id", "code", name="uq_intent_step_graph_code"),)
id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
intent_id: Mapped[int] = mapped_column(
ForeignKey("intents.id", ondelete="CASCADE"), nullable=False, index=True
)
graph_id: Mapped[int | None] = mapped_column(
ForeignKey("intent_step_graphs.id", ondelete="CASCADE"), nullable=True, index=True
)
code: Mapped[str] = mapped_column(String(50), nullable=False)
name: Mapped[str] = mapped_column(String(200), nullable=False)
order_index: Mapped[int] = mapped_column(Integer, nullable=False, default=0)
+39
View File
@@ -0,0 +1,39 @@
from datetime import datetime, timezone
from sqlalchemy import Boolean, DateTime, ForeignKey, Integer, String, UniqueConstraint
from sqlalchemy.orm import Mapped, mapped_column
from db.base import Base
def _utcnow() -> datetime:
return datetime.now(timezone.utc)
class IntentStepGraph(Base):
"""Версия графа шагов state machine ветки (Спринт 7.7).
У одной ветки может быть несколько графов (исходный 6-шаговый, оптимизированный
4-шаговый Спринта 7.6 и т. п.). Активен ровно один (is_active=True): чат и
Песочница используют только его. Остальные — резерв на случай отката или
A/B-сравнения, в Песочнице не используются.
Сами шаги (`intent_steps`) ссылаются на граф через `graph_id`. Один шаг
принадлежит одному графу; чтобы шаг работал в нескольких версиях, он
дублируется при создании копии графа.
"""
__tablename__ = "intent_step_graphs"
__table_args__ = (
UniqueConstraint("intent_id", "version", name="uq_intent_step_graph_version"),
)
id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
intent_id: Mapped[int] = mapped_column(
ForeignKey("intents.id", ondelete="CASCADE"), nullable=False, index=True
)
version: Mapped[int] = mapped_column(Integer, nullable=False)
name: Mapped[str] = mapped_column(String(200), nullable=False)
is_active: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False)
created_at: Mapped[datetime] = mapped_column(
DateTime(timezone=True), default=_utcnow, nullable=False
)