feat(sprint4): фундамент графа — intents + роутер + переключение веток

Первый шаг графовой архитектуры из GRAPH_ARCHITECTURE.md. Заменили
«один активный промпт на всё» на «свой промпт на каждую ветку +
роутер выбирает ветку на каждой реплике».

Данные:
- Новая таблица intents (code, name, description, is_enabled,
  order_index). Коды с префиксом `_` — системные (не responder).
- В agent_configs добавлен intent_id (nullable, FK SET NULL); убрана
  глобальная уникальность version, вместо неё UniqueConstraint
  (intent_id, version) — у каждой ветки свой счётчик версий.
- В messages добавлен intent_id (nullable, FK) — фиксируем, какую
  ветку выбрал роутер для каждой реплики.
- Миграция cd0a88ef9080 в batch-режиме (SQLite не умеет ALTER для
  constraints напрямую).

Сид:
- Стартовые 7 веток: new_booking, reschedule, price_question,
  medical_question, general_info, escalate_human + `_router` как
  системная ветка для промпта классификатора.
- Для каждой ветки — свой v1-промпт из prompts/intents/{code}.md.
- migrate_legacy_config_to_general_info: старый v1 из Спринта 3
  (без intent_id) переносится на general_info с сохранением версии.
- ensure_seed_intents досиживает недостающие коды, существующие не
  трогает — безопасно при добавлении новых веток.

Оркестрация и роутер:
- services/router_client.RouterClient — отдельный класс от LLMClient
  (под будущую смену модели на более дешёвую). Метод classify(session,
  history, text) возвращает {code, version}. Промпт классификатора
  подтягивается из активного конфига ветки `_router`, fallback —
  prompts/intents/_router.md. При сомнении/ошибке возвращает
  general_info.
- services/chat_service.send_message теперь идёт через router.classify
  → берёт активный конфиг выбранной ветки → llm.chat. В сообщения
  пишется intent_id, в треде фиксируется начальный agent_config_id.
  В ответе — intent_code, intent_name, config_version, router_version.

API:
- GET /intents, GET /intents/{code}, PATCH /intents/{code} —
  список веток со счётчиком версий, получение и переключение
  is_enabled.
- /configs теперь требует intent_code как Query-параметр
  (GET /configs, GET /configs/active) — выборка версий в рамках
  ветки. POST /configs принимает intent_id.
- get_thread_detail JOIN-ит Intent — каждая реплика возвращает
  intent_code + intent_name.

UI:
- settings.html переработан в 3-колоночный макет: слева список веток
  с подгруппой «Системные» для `_router` (пометка «система» вместо
  свитча), в центре редактор промпта/правил активной версии выбранной
  ветки, справа список версий с активировать/удалить/загрузить.
  Каждая ветка редактируется независимо — своя история версий,
  своя активная.
- sandbox.html: у каждой реплики бейдж с intent_code, в отладке новый
  блок «Решение роутера» (подсвеченный зелёным) с названием ветки,
  версией её активного конфига и версией промпта роутера. Старый
  «активная: v1» индикатор убран — он больше не имеет смысла (активная
  у каждой ветки своя).

E2E проверено: разные реплики уходят в корректные ветки, каждая
отвечает по своему узкому промпту, промпт роутера редактируется в UI
как v2/v3 и откатывается — классификация сразу использует новую
версию.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
AR 15 M4
2026-04-23 21:20:23 +05:00
parent 2e2f2321c3
commit b24e985f82
25 changed files with 1135 additions and 261 deletions
@@ -0,0 +1,74 @@
"""add intents, link agent_configs and messages to intent
Revision ID: cd0a88ef9080
Revises: b4450e33664d
Create Date: 2026-04-23 20:29:39.135855
SQLite не поддерживает ALTER для constraints — используем batch_alter_table,
он пересоздаёт таблицу и переносит данные.
"""
from typing import Sequence, Union
from alembic import op
import sqlalchemy as sa
revision: str = 'cd0a88ef9080'
down_revision: Union[str, None] = 'b4450e33664d'
branch_labels: Union[str, Sequence[str], None] = None
depends_on: Union[str, Sequence[str], None] = None
def upgrade() -> None:
# Новая таблица intents.
op.create_table(
'intents',
sa.Column('id', sa.Integer(), autoincrement=True, nullable=False),
sa.Column('code', sa.String(length=50), nullable=False),
sa.Column('name', sa.String(length=200), nullable=False),
sa.Column('description', sa.Text(), nullable=False),
sa.Column('is_enabled', sa.Boolean(), nullable=False),
sa.Column('order_index', sa.Integer(), nullable=False),
sa.Column('created_at', sa.DateTime(timezone=True), nullable=False),
sa.PrimaryKeyConstraint('id'),
)
op.create_index(op.f('ix_intents_code'), 'intents', ['code'], unique=True)
# agent_configs: добавляем intent_id, меняем уникальность version на составную (intent_id, version).
with op.batch_alter_table('agent_configs', recreate='always') as batch:
batch.add_column(sa.Column('intent_id', sa.Integer(), nullable=True))
batch.drop_index('ix_agent_configs_version')
batch.create_index('ix_agent_configs_version', ['version'], unique=False)
batch.create_index('ix_agent_configs_intent_id', ['intent_id'], unique=False)
batch.create_unique_constraint('uq_config_intent_version', ['intent_id', 'version'])
batch.create_foreign_key(
'fk_agent_configs_intent_id_intents', 'intents',
['intent_id'], ['id'], ondelete='SET NULL',
)
# messages: добавляем intent_id.
with op.batch_alter_table('messages', recreate='always') as batch:
batch.add_column(sa.Column('intent_id', sa.Integer(), nullable=True))
batch.create_index('ix_messages_intent_id', ['intent_id'], unique=False)
batch.create_foreign_key(
'fk_messages_intent_id_intents', 'intents',
['intent_id'], ['id'], ondelete='SET NULL',
)
def downgrade() -> None:
with op.batch_alter_table('messages', recreate='always') as batch:
batch.drop_constraint('fk_messages_intent_id_intents', type_='foreignkey')
batch.drop_index('ix_messages_intent_id')
batch.drop_column('intent_id')
with op.batch_alter_table('agent_configs', recreate='always') as batch:
batch.drop_constraint('fk_agent_configs_intent_id_intents', type_='foreignkey')
batch.drop_constraint('uq_config_intent_version', type_='unique')
batch.drop_index('ix_agent_configs_intent_id')
batch.drop_index('ix_agent_configs_version')
batch.create_index('ix_agent_configs_version', ['version'], unique=True)
batch.drop_column('intent_id')
op.drop_index(op.f('ix_intents_code'), table_name='intents')
op.drop_table('intents')