feat(sprint6c+sprint7): терминология, сверка примеров с кодом, мульти-RAG (часть A)

Спринт 6c — терминология и сверка документации с реальным кодом:
- Словарь терминов в static/docs.html: «маршрутизатор» вместо «роутер»,
  «защитное условие» вместо «guard», «пошаговая ветка» вместо «многошаговая».
  Разделены концепты «намерение» (intent) и «ветка» (branch) с пометкой,
  что в коде они хранятся как одна сущность 1:1.
- Песочница: «Решение маршрутизатора» виден всегда (зелёный/жёлтый),
  счётчик переключений «N из 3» отдельной плашкой, бейджи под словарь.
- Настройки: «Условия перехода» → «Защитные условия (guards, JSON)».
- GRAPH_ARCHITECTURE_v4.md: имена полей thread_state и слоты приведены
  к реальной БД (db/models/thread_state.py) и таксономии промптов шагов
  (prompts/intents/new_booking/steps/). Ссылки на *_v2 примеры. На v3
  поставлена шапка «устарело».
- 4 примера переписаны как *_v2: реальные current_intent_code/
  current_step_code/slots_json, реальные allowed_next без двойных переходов,
  реальная таксономия слотов name/reason/specialist/preferred_time/confirmed.
  Удалены вымышленные CRM tool calls и слоты, которых нет в коде.
- static/example.html — параметризованная страница с навигацией между
  4 примерами; роут GET /api/docs/examples/{name} в main.py отдаёт
  markdown без дублирования файлов.
- Редактирование документов в Отладке: GET/PUT /documents/{id}/raw,
  textarea с переразметкой и обновлением Chroma при сохранении.

Спринт 7, часть A — мульти-RAG через подписку ветка↔документы:
- Миграция: таблица intent_documents (M:N), модель IntentDocument,
  индекс по document_id для обратного поиска.
- API: GET/PUT /intents/{code}/documents и GET/PUT /documents/{id}/intents
  с PUT-семантикой «полный список», атомарно. Сервис
  services/intent_document_service.py.
- Retrieval-фильтр в chat_service: подтягивает document_ids активной
  ветки и передаёт в vectorstore.query(). Дефолт пустой подписки —
  document_ids=[] (= 0 чанков), не «вся коллекция»: пустая подписка
  означает «ветка не настроена», подмешивать случайное хуже, чем
  ничего. vectorstore.query() различает None (нет фильтра) и [] (0).
- UI Настроек: блок «Документы базы знаний» в правом сайдбаре,
  всегда видим независимо от вкладки, сортировка по имени, счётчик
  «N из M», PUT при сохранении.
- UI Отладки: третья кнопка «привязка» рядом с «удалить» —
  раскрывашка со списком веток (галочки), быстрая привязка прямо
  на странице загрузки.
- Песочница: блок «Срез RAG» с подпиской/найдено, ворнинг при пустой
  подписке. Поле rag_subscription в QueryResponse и ChatResponse.
- Системный промпт страницы Отладки переехал в обычную ветку _debug
  («Страница отладки»). Удалён prompts/system_prompt.md и логика
  DEFAULT_SYSTEM_PROMPT в llm_client. routers/query.py подтягивает
  активный конфиг ветки _debug и её подписки. Дефолт пустой подписки
  для _debug — None (вся коллекция), не [] как для пациентских — чтобы
  Отладка работала «из коробки». На странице Отладки info-bar показывает
  активную версию и счётчик подписок, ссылка → Настройки.
- Тест-блок «Тест-вопрос» в центре Настроек: расширил /query
  параметрами intent_code (default _debug), system_prompt (override
  для теста черновика из textarea), disable_rag (для _router).
  Редактор промпта обёрнут в <details open> — можно свернуть до
  одной строки. Под ним — три колонки результата (RAG / промпт /
  ответ). Для _router показывается подсказка про отсутствие RAG.

Документы:
- data/datasets/*.md — наработки по 6 веткам (рабочие материалы оператора).
- docs/BRANCH_MAP_AND_PROMPTS_v1.md, docs/OPTIMIZATION_CONVERSION_v1.md,
  docs/guides/state_machine_and_slots.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

models/requests.py

@@ -7,6 +7,9 @@ class QueryRequest(BaseModel):
     document_ids: list[str] | None = Field(None, description="Ограничить поиск конкретными документами")
     temperature: float | None = Field(None, ge=0.0, le=2.0)
     max_tokens: int | None = Field(None, ge=100, le=8000)
+    intent_code: str | None = Field(None, description="Код ветки, чей промпт и подписки использовать. По умолчанию — _debug (страница Отладки).")
+    system_prompt: str | None = Field(None, description="Если задан — используется как системный промпт вместо активного конфига ветки. Для тестирования черновика из textarea Настроек.")
+    disable_rag: bool = Field(False, description="Если true — retrieval пропускается, чанки не подмешиваются. Для тестирования веток без RAG (например, _router).")
 
 
 class ChatRequest(BaseModel):
@@ -39,3 +42,15 @@ class IntentStepUpdateRequest(BaseModel):
     system_prompt: str | None = None
     allowed_next: list[str] | None = None
     guards: dict | None = None
+
+
+class IntentDocumentsUpdateRequest(BaseModel):
+    document_ids: list[str] = Field(default_factory=list, description="Полный новый список document_id, на которые подписана ветка")
+
+
+class DocumentIntentsUpdateRequest(BaseModel):
+    intent_codes: list[str] = Field(default_factory=list, description="Полный новый список кодов веток, к которым привязан документ")
+
+
+class DocumentRawUpdateRequest(BaseModel):
+    raw_text: str = Field(..., min_length=1, description="Новый исходный текст документа; запускает переразметку и обновление Chroma")

models/responses.py

@@ -55,6 +55,16 @@ class DocumentDeleteResponse(BaseModel):
     deleted_chunks: int
 
 
+class IntentDocumentsResponse(BaseModel):
+    intent_code: str
+    document_ids: list[str] = Field(default_factory=list)
+
+
+class DocumentIntentsResponse(BaseModel):
+    document_id: str
+    intent_codes: list[str] = Field(default_factory=list)
+
+
 class SourceInfo(BaseModel):
     document_id: str
     document_name: str
@@ -69,6 +79,9 @@ class QueryResponse(BaseModel):
     sources: list[SourceInfo]
     model_used: str
     assembled_prompt: str = ""
+    intent_code: str = "_debug"
+    config_version: int | None = None
+    rag_subscription: dict | None = None  # {"subscribed_count": int, "found_count": int} — Спринт 7
 
 
 class HealthResponse(BaseModel):
@@ -168,6 +181,7 @@ class ChatResponse(BaseModel):
     escalation_reason: str | None = None
     operator_summary: dict | None = None
     router_assembled_prompt: str = ""
+    rag_subscription: dict | None = None  # {"subscribed_count": int, "found_count": int} — Спринт 7
 
 
 class ThreadDeleteResponse(BaseModel):