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>

routers/chat.py

@@ -15,9 +15,9 @@ router = APIRouter(prefix="/chat", tags=["chat"])
 
 @router.post("", response_model=ChatResponse)
 async def chat(req: ChatRequest, session: AsyncSession = Depends(get_session)):
-    from main import llm_client, vectorstore_service
+    from main import llm_client, router_client, vectorstore_service
 
-    if vectorstore_service is None or llm_client is None:
+    if vectorstore_service is None or llm_client is None or router_client is None:
         raise HTTPException(status_code=503, detail="Service not ready")
 
     try:
@@ -25,6 +25,7 @@ async def chat(req: ChatRequest, session: AsyncSession = Depends(get_session)):
             session=session,
             vectorstore=vectorstore_service,
             llm=llm_client,
+            router=router_client,
             text=req.text,
             thread_id=req.thread_id,
             top_k=req.top_k,
@@ -41,6 +42,10 @@ async def chat(req: ChatRequest, session: AsyncSession = Depends(get_session)):
         thread_id=result["thread_id"],
         thread_name=result["thread_name"],
         message_id=result["message_id"],
+        intent_code=result["intent_code"],
+        intent_name=result["intent_name"],
+        config_version=result["config_version"],
+        router_version=result.get("router_version"),
         answer=result["answer"],
         sources=[SourceInfo(**s) for s in result["sources"]],
         model_used=result["model_used"],

routers/configs.py

@@ -1,6 +1,6 @@
 import logging
 
-from fastapi import APIRouter, Depends, HTTPException
+from fastapi import APIRouter, Depends, HTTPException, Query
 from sqlalchemy.ext.asyncio import AsyncSession
 
 from db.models import AgentConfig
@@ -11,16 +11,19 @@ from models.responses import (
     AgentConfigInfo,
     AgentConfigListResponse,
 )
-from services import config_service
+from services import config_service, intent_service
 
 logger = logging.getLogger(__name__)
 
 router = APIRouter(prefix="/configs", tags=["configs"])
 
 
-def _to_info(cfg: AgentConfig) -> AgentConfigInfo:
+def _to_info(cfg: AgentConfig, intent_code: str = "", intent_name: str = "") -> AgentConfigInfo:
     return AgentConfigInfo(
         id=cfg.id,
+        intent_id=cfg.intent_id,
+        intent_code=intent_code,
+        intent_name=intent_name,
         version=cfg.version,
         name=cfg.name,
         system_prompt=cfg.system_prompt,
@@ -30,18 +33,44 @@ def _to_info(cfg: AgentConfig) -> AgentConfigInfo:
     )
 
 
+async def _resolve_intent_meta(session: AsyncSession, intent_id: int | None) -> tuple[str, str]:
+    if intent_id is None:
+        return "", ""
+    from db.models import Intent
+    intent = await session.get(Intent, intent_id)
+    if intent is None:
+        return "", ""
+    return intent.code, intent.name
+
+
 @router.get("", response_model=AgentConfigListResponse)
-async def list_configs(session: AsyncSession = Depends(get_session)):
-    configs = await config_service.list_configs(session)
-    return AgentConfigListResponse(configs=[_to_info(c) for c in configs], total=len(configs))
+async def list_configs(
+    intent_code: str = Query(..., description="Код ветки (обязателен): фильтр версий по ветке"),
+    session: AsyncSession = Depends(get_session),
+):
+    intent = await intent_service.get_intent_by_code(session, intent_code)
+    if intent is None:
+        raise HTTPException(status_code=404, detail=f"Intent {intent_code!r} not found")
+
+    configs = await config_service.list_configs_for_intent(session, intent.id)
+    return AgentConfigListResponse(
+        configs=[_to_info(c, intent.code, intent.name) for c in configs],
+        total=len(configs),
+    )
 
 
 @router.get("/active", response_model=AgentConfigInfo)
-async def get_active(session: AsyncSession = Depends(get_session)):
-    cfg = await config_service.get_active_config(session)
+async def get_active(
+    intent_code: str = Query(..., description="Код ветки"),
+    session: AsyncSession = Depends(get_session),
+):
+    intent = await intent_service.get_intent_by_code(session, intent_code)
+    if intent is None:
+        raise HTTPException(status_code=404, detail=f"Intent {intent_code!r} not found")
+    cfg = await config_service.get_active_config_for_intent(session, intent.id)
     if cfg is None:
-        raise HTTPException(status_code=404, detail="No active config")
-    return _to_info(cfg)
+        raise HTTPException(status_code=404, detail=f"No active config for intent {intent_code!r}")
+    return _to_info(cfg, intent.code, intent.name)
 
 
 @router.get("/{config_id}", response_model=AgentConfigInfo)
@@ -49,7 +78,8 @@ async def get_config(config_id: int, session: AsyncSession = Depends(get_session
     cfg = await config_service.get_config(session, config_id)
     if cfg is None:
         raise HTTPException(status_code=404, detail="Config not found")
-    return _to_info(cfg)
+    code, name = await _resolve_intent_meta(session, cfg.intent_id)
+    return _to_info(cfg, code, name)
 
 
 @router.post("", response_model=AgentConfigInfo)
@@ -57,22 +87,29 @@ async def create_config(
     req: AgentConfigCreateRequest,
     session: AsyncSession = Depends(get_session),
 ):
+    from db.models import Intent
+    intent = await session.get(Intent, req.intent_id)
+    if intent is None:
+        raise HTTPException(status_code=404, detail=f"Intent {req.intent_id} not found")
+
     cfg = await config_service.create_config(
         session=session,
+        intent_id=req.intent_id,
         system_prompt=req.system_prompt,
         rules_text=req.rules_text,
         name=req.name,
         activate=req.activate,
     )
-    return _to_info(cfg)
+    return _to_info(cfg, intent.code, intent.name)
 
 
 @router.post("/{config_id}/activate", response_model=AgentConfigInfo)
 async def activate_config(config_id: int, session: AsyncSession = Depends(get_session)):
     cfg = await config_service.activate_config(session, config_id)
     if cfg is None:
-        raise HTTPException(status_code=404, detail="Config not found")
-    return _to_info(cfg)
+        raise HTTPException(status_code=404, detail="Config not found or has no intent")
+    code, name = await _resolve_intent_meta(session, cfg.intent_id)
+    return _to_info(cfg, code, name)
 
 
 @router.delete("/{config_id}", response_model=AgentConfigDeleteResponse)

routers/intents.py

@@ -0,0 +1,55 @@
+import logging
+
+from fastapi import APIRouter, Depends, HTTPException
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from db.models import Intent
+from db.session import get_session
+from models.requests import IntentToggleRequest
+from models.responses import IntentInfo, IntentListResponse
+from services import config_service, intent_service
+
+logger = logging.getLogger(__name__)
+
+router = APIRouter(prefix="/intents", tags=["intents"])
+
+
+async def _to_info(session: AsyncSession, intent: Intent) -> IntentInfo:
+    active_cfg = await config_service.get_active_config_for_intent(session, intent.id)
+    return IntentInfo(
+        id=intent.id,
+        code=intent.code,
+        name=intent.name,
+        description=intent.description or "",
+        is_enabled=intent.is_enabled,
+        order_index=intent.order_index,
+        active_config_id=active_cfg.id if active_cfg else None,
+        active_config_version=active_cfg.version if active_cfg else None,
+    )
+
+
+@router.get("", response_model=IntentListResponse)
+async def list_intents(session: AsyncSession = Depends(get_session)):
+    intents = await intent_service.list_intents(session)
+    infos = [await _to_info(session, i) for i in intents]
+    return IntentListResponse(intents=infos, total=len(infos))
+
+
+@router.get("/{code}", response_model=IntentInfo)
+async def get_intent(code: str, session: AsyncSession = Depends(get_session)):
+    intent = await intent_service.get_intent_by_code(session, code)
+    if intent is None:
+        raise HTTPException(status_code=404, detail="Intent not found")
+    return await _to_info(session, intent)
+
+
+@router.patch("/{code}", response_model=IntentInfo)
+async def toggle_intent(
+    code: str,
+    req: IntentToggleRequest,
+    session: AsyncSession = Depends(get_session),
+):
+    intent = await intent_service.set_intent_enabled(session, code, req.is_enabled)
+    if intent is None:
+        raise HTTPException(status_code=404, detail="Intent not found")
+    return await _to_info(session, intent)