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:
@@ -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,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)
|
||||
|
||||
@@ -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
|
||||
)
|
||||
Reference in New Issue
Block a user