feat(sprint3): редактор системного промпта и правил с версионированием

Операторы получают веб-редактор: правят системный промпт и правила, сохраняют как новую версию, активируют, откатываются. Активная версия используется в «Песочнице» на каждый /chat. Принципы, согласованные заранее: - Сохранённые версии не редактируются — только создание новой. Честный откат: v1 всегда та же, что была при создании. - Правила на этом этапе — свободный markdown (textarea). Переход на структурированные правила (pattern → instruction) — в бэклог. - Файл prompts/system_prompt.md становится сид-источником: при первом старте, если таблица agent_configs пустая, из него создаётся v1 и активируется. Дальше правда идёт из БД, файл не трогаем. - rules_text конкатенируется с system_prompt в один system-message через compose_full_system_prompt: "{prompt}\n\nДополнительные правила:\n{rules}". - Активную версию удалить нельзя — сначала активируют другую. Модель и миграция: - db/models/AgentConfig: id, version (unique/indexed), name (nullable), system_prompt, rules_text, is_active (indexed), created_at. Без updated_at — версии неизменяемы. - Миграция b4450e33664d_add_agent_configs_table. Сервисы и роутеры: - services/config_service: ensure_seed (seed v1 из файла), list/get/get_active/create (version=max+1, при activate атомарно сбрасывает is_active у остальных и ставит новой), activate_config (та же схема), delete_config (возвращает причину отказа: not_found / active), compose_full_system_prompt. - services/chat_service.send_message: берёт active_cfg, собирает system_prompt через compose_full_system_prompt, пишет thread.agent_config_id при создании треда (колонка была nullable ещё со Спринта 2 — пригодилась именно здесь). - routers/configs: GET /configs, GET /configs/active, GET /configs/{id}, POST /configs (activate-флаг), POST /configs/{id}/activate, DELETE /configs/{id} (404 / 400 если активная). - Pydantic: AgentConfigCreateRequest, AgentConfigInfo, ListResponse, DeleteResponse. - main.py: ensure_seed в lifespan после инициализации БД/Chroma/LLM. UI: - static/settings.html — трёхблочная страница: имя версии, textarea промпта, textarea правил, «Сохранить как новую» + галка «Сразу активировать», «Загрузить активную в редактор». Справа — список версий с бейджем «активная», действиями «Активировать» / «Удалить» (disabled у активной) / «Загрузить в редактор». При первом заходе активная версия автоматом подгружается в редактор. - В nav на index.html и sandbox.html добавлена ссылка «Настройки». - В шапке «Песочницы» — зелёный кликабельный бейдж «активная: vN · имя» (ведёт на /settings.html), обновляется раз в 15 с. E2E проверено: создана v2 с правилом «ВСЕГДА начинай со слов СПАСИБО ЗА ВОПРОС», активирована; следующий /chat вернул ответ, начинающийся ровно с этой фразы; assembled_prompt содержит блок «Дополнительные правила». После отката на v1 тест-v2 удалена. SPRINTS.md: Спринт 3 помечен закрытым. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-23 19:59:06 +05:00
parent 6348d9a206
commit 7ec2ba3c8f
13 changed files with 796 additions and 5 deletions
@@ -123,7 +123,7 @@
 ### Цель
 Дать операторам веб-редактор системного промпта и списка правил («если спрашивают про X — отвечай так-то», «если пациент злится — делай то-то»). Версионирование: можно сохранить конфигурацию и откатиться.

-### Статус: ⏳ Запланирован
+### Статус: ✅ Закрыт

 ### Задачи
 - [ ] Хранилище (SQLite): `agent_configs` (version, created_at, system_prompt, rules_text, is_active)
@@ -1,5 +1,6 @@
+from db.models.agent_config import AgentConfig
 from db.models.document import Document
 from db.models.message import Message
 from db.models.thread import Thread

-__all__ = ["Thread", "Message", "Document"]
+__all__ = ["Thread", "Message", "Document", "AgentConfig"]
@@ -0,0 +1,27 @@
+from datetime import datetime, timezone
+
+from sqlalchemy import Boolean, DateTime, Integer, String, Text
+from sqlalchemy.orm import Mapped, mapped_column
+
+from db.base import Base
+
+
+def _utcnow() -> datetime:
+    return datetime.now(timezone.utc)
+
+
+class AgentConfig(Base):
+    """Версионируемая конфигурация агента: системный промпт + правила.
+
+    Принцип: сохранённые версии не редактируются, только создаются новые.
+    Активна одна версия одновременно.
+    """
+    __tablename__ = "agent_configs"
+
+    id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
+    version: Mapped[int] = mapped_column(Integer, nullable=False, unique=True, index=True)
+    name: Mapped[str | None] = mapped_column(String(200), nullable=True)
+    system_prompt: Mapped[str] = mapped_column(Text, nullable=False)
+    rules_text: Mapped[str] = mapped_column(Text, nullable=False, default="")
+    is_active: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False, index=True)
+    created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=_utcnow, nullable=False)
@@ -23,6 +23,8 @@ logging.basicConfig(
    force=True,
 )

+from db.session import SessionLocal  # noqa: E402
+from services import config_service  # noqa: E402
 from services.embeddings import EmbeddingService  # noqa: E402
 from services.llm_client import LLMClient  # noqa: E402
 from services.vectorstore import VectorStoreService  # noqa: E402
@@ -56,6 +58,10 @@ async def lifespan(app: FastAPI):
    logger.info("ChromaDB initialized at %s", settings.chroma_persist_dir)
    llm_client = LLMClient()
    logger.info("LLM client ready (model=%s)", llm_client.model)
+
+    async with SessionLocal() as session:
+        await config_service.ensure_seed(session)
+
    yield
    logger.info("Shutting down")

@@ -75,12 +81,13 @@ app.add_middleware(
    allow_headers=["*"],
 )

-from routers import chat, documents, health, query, threads  # noqa: E402
+from routers import chat, configs, documents, health, query, threads  # noqa: E402

 app.include_router(health.router)
 app.include_router(documents.router)
 app.include_router(query.router)
 app.include_router(chat.router)
 app.include_router(threads.router)
+app.include_router(configs.router)

 app.mount("/", StaticFiles(directory="static", html=True), name="static")
@@ -0,0 +1,43 @@
+"""add agent_configs table
+
+Revision ID: b4450e33664d
+Revises: 7ee7296ccd6d
+Create Date: 2026-04-23 19:03:27.867415
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+
+
+# revision identifiers, used by Alembic.
+revision: str = 'b4450e33664d'
+down_revision: Union[str, None] = '7ee7296ccd6d'
+branch_labels: Union[str, Sequence[str], None] = None
+depends_on: Union[str, Sequence[str], None] = None
+
+
+def upgrade() -> None:
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.create_table('agent_configs',
+    sa.Column('id', sa.Integer(), autoincrement=True, nullable=False),
+    sa.Column('version', sa.Integer(), nullable=False),
+    sa.Column('name', sa.String(length=200), nullable=True),
+    sa.Column('system_prompt', sa.Text(), nullable=False),
+    sa.Column('rules_text', sa.Text(), nullable=False),
+    sa.Column('is_active', sa.Boolean(), nullable=False),
+    sa.Column('created_at', sa.DateTime(timezone=True), nullable=False),
+    sa.PrimaryKeyConstraint('id')
+    )
+    op.create_index(op.f('ix_agent_configs_is_active'), 'agent_configs', ['is_active'], unique=False)
+    op.create_index(op.f('ix_agent_configs_version'), 'agent_configs', ['version'], unique=True)
+    # ### end Alembic commands ###
+
+
+def downgrade() -> None:
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.drop_index(op.f('ix_agent_configs_version'), table_name='agent_configs')
+    op.drop_index(op.f('ix_agent_configs_is_active'), table_name='agent_configs')
+    op.drop_table('agent_configs')
+    # ### end Alembic commands ###
@@ -19,3 +19,10 @@ class ChatRequest(BaseModel):

 class ThreadRenameRequest(BaseModel):
    name: str = Field(..., min_length=1, max_length=200)
+
+
+class AgentConfigCreateRequest(BaseModel):
+    system_prompt: str = Field(..., min_length=1)
+    rules_text: str = Field("", description="Правила в свободной markdown-форме")
+    name: str | None = Field(None, max_length=200)
+    activate: bool = Field(False, description="Сразу сделать новую версию активной")
@@ -123,3 +123,22 @@ class ChatResponse(BaseModel):
 class ThreadDeleteResponse(BaseModel):
    ok: bool = True
    deleted_messages: int
+
+
+class AgentConfigInfo(BaseModel):
+    id: int
+    version: int
+    name: str | None = None
+    system_prompt: str
+    rules_text: str = ""
+    is_active: bool
+    created_at: str
+
+
+class AgentConfigListResponse(BaseModel):
+    configs: list[AgentConfigInfo]
+    total: int
+
+
+class AgentConfigDeleteResponse(BaseModel):
+    ok: bool = True
@@ -0,0 +1,89 @@
+import logging
+
+from fastapi import APIRouter, Depends, HTTPException
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from db.models import AgentConfig
+from db.session import get_session
+from models.requests import AgentConfigCreateRequest
+from models.responses import (
+    AgentConfigDeleteResponse,
+    AgentConfigInfo,
+    AgentConfigListResponse,
+)
+from services import config_service
+
+logger = logging.getLogger(__name__)
+
+router = APIRouter(prefix="/configs", tags=["configs"])
+
+
+def _to_info(cfg: AgentConfig) -> AgentConfigInfo:
+    return AgentConfigInfo(
+        id=cfg.id,
+        version=cfg.version,
+        name=cfg.name,
+        system_prompt=cfg.system_prompt,
+        rules_text=cfg.rules_text or "",
+        is_active=cfg.is_active,
+        created_at=cfg.created_at.isoformat(),
+    )
+
+
+@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))
+
+
+@router.get("/active", response_model=AgentConfigInfo)
+async def get_active(session: AsyncSession = Depends(get_session)):
+    cfg = await config_service.get_active_config(session)
+    if cfg is None:
+        raise HTTPException(status_code=404, detail="No active config")
+    return _to_info(cfg)
+
+
+@router.get("/{config_id}", response_model=AgentConfigInfo)
+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)
+
+
+@router.post("", response_model=AgentConfigInfo)
+async def create_config(
+    req: AgentConfigCreateRequest,
+    session: AsyncSession = Depends(get_session),
+):
+    cfg = await config_service.create_config(
+        session=session,
+        system_prompt=req.system_prompt,
+        rules_text=req.rules_text,
+        name=req.name,
+        activate=req.activate,
+    )
+    return _to_info(cfg)
+
+
+@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)
+
+
+@router.delete("/{config_id}", response_model=AgentConfigDeleteResponse)
+async def delete_config(config_id: int, session: AsyncSession = Depends(get_session)):
+    ok, reason = await config_service.delete_config(session, config_id)
+    if not ok:
+        if reason == "not_found":
+            raise HTTPException(status_code=404, detail="Config not found")
+        if reason == "active":
+            raise HTTPException(
+                status_code=400,
+                detail="Нельзя удалить активную версию — сначала активируйте другую",
+            )
+    return AgentConfigDeleteResponse(ok=True)
@@ -7,6 +7,7 @@ from sqlalchemy.ext.asyncio import AsyncSession
 from sqlalchemy.orm import selectinload

 from db.models import Message, Thread
+from services import config_service
 from services.llm_client import LLMClient
 from services.vectorstore import VectorStoreService

@@ -50,8 +51,14 @@ async def send_message(
    max_tokens: int | None = None,
 ) -> dict:
    """Добавить реплику пациента в тред, получить ответ ассистента, сохранить оба сообщения."""
+    active_cfg = await config_service.get_active_config(session)
+    system_prompt = config_service.compose_full_system_prompt(active_cfg) if active_cfg else None
+
    if thread_id is None:
-        thread = Thread(name=_auto_thread_name(text))
+        thread = Thread(
+            name=_auto_thread_name(text),
+            agent_config_id=active_cfg.id if active_cfg else None,
+        )
        session.add(thread)
        await session.flush()
    else:
@@ -81,6 +88,7 @@ async def send_message(
        question=text,
        sources=retrieved,
        history=history,
+        system_prompt=system_prompt,
        temperature=temperature,
        max_tokens=max_tokens,
    )
@@ -0,0 +1,115 @@
+"""Версионируемые конфигурации агента: создание, активация, чтение."""
+import logging
+from pathlib import Path
+
+from sqlalchemy import func, select, update
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from db.models import AgentConfig
+
+logger = logging.getLogger(__name__)
+
+SEED_PROMPT_PATH = Path(__file__).resolve().parent.parent / "prompts" / "system_prompt.md"
+
+
+def _load_seed_prompt() -> str:
+    try:
+        return SEED_PROMPT_PATH.read_text(encoding="utf-8").strip()
+    except FileNotFoundError:
+        logger.warning("Seed prompt file not found at %s — creating empty v1", SEED_PROMPT_PATH)
+        return ""
+
+
+async def ensure_seed(session: AsyncSession) -> None:
+    """Если таблица пустая, создать v1 из prompts/system_prompt.md и активировать."""
+    count = (await session.execute(select(func.count(AgentConfig.id)))).scalar_one()
+    if count > 0:
+        return
+
+    seed_text = _load_seed_prompt()
+    seed = AgentConfig(
+        version=1,
+        name="Исходная версия (из prompts/system_prompt.md)",
+        system_prompt=seed_text,
+        rules_text="",
+        is_active=True,
+    )
+    session.add(seed)
+    await session.commit()
+    logger.info("Seeded agent_configs with v1 from %s", SEED_PROMPT_PATH.name)
+
+
+async def list_configs(session: AsyncSession) -> list[AgentConfig]:
+    stmt = select(AgentConfig).order_by(AgentConfig.version.desc())
+    return list((await session.execute(stmt)).scalars().all())
+
+
+async def get_config(session: AsyncSession, config_id: int) -> AgentConfig | None:
+    return await session.get(AgentConfig, config_id)
+
+
+async def get_active_config(session: AsyncSession) -> AgentConfig | None:
+    stmt = select(AgentConfig).where(AgentConfig.is_active.is_(True)).limit(1)
+    return (await session.execute(stmt)).scalar_one_or_none()
+
+
+async def create_config(
+    session: AsyncSession,
+    system_prompt: str,
+    rules_text: str,
+    name: str | None = None,
+    activate: bool = False,
+) -> AgentConfig:
+    """Создать новую версию. При activate=True — сразу сделать активной."""
+    next_version = (await session.execute(select(func.coalesce(func.max(AgentConfig.version), 0)))).scalar_one() + 1
+
+    if activate:
+        await session.execute(
+            update(AgentConfig).where(AgentConfig.is_active.is_(True)).values(is_active=False)
+        )
+
+    cfg = AgentConfig(
+        version=next_version,
+        name=(name or "").strip() or None,
+        system_prompt=system_prompt,
+        rules_text=rules_text or "",
+        is_active=activate,
+    )
+    session.add(cfg)
+    await session.commit()
+    await session.refresh(cfg)
+    return cfg
+
+
+async def activate_config(session: AsyncSession, config_id: int) -> AgentConfig | None:
+    cfg = await session.get(AgentConfig, config_id)
+    if cfg is None:
+        return None
+    await session.execute(
+        update(AgentConfig).where(AgentConfig.is_active.is_(True)).values(is_active=False)
+    )
+    cfg.is_active = True
+    await session.commit()
+    await session.refresh(cfg)
+    return cfg
+
+
+async def delete_config(session: AsyncSession, config_id: int) -> tuple[bool, str]:
+    """Удалить версию. Нельзя удалить активную. Возвращает (ok, reason_if_fail)."""
+    cfg = await session.get(AgentConfig, config_id)
+    if cfg is None:
+        return False, "not_found"
+    if cfg.is_active:
+        return False, "active"
+    await session.delete(cfg)
+    await session.commit()
+    return True, ""
+
+
+def compose_full_system_prompt(cfg: AgentConfig) -> str:
+    """Собрать из system_prompt + rules_text единую строку для LLM."""
+    base = (cfg.system_prompt or "").strip()
+    rules = (cfg.rules_text or "").strip()
+    if not rules:
+        return base
+    return f"{base}\n\nДополнительные правила:\n{rules}"
@@ -342,6 +342,7 @@
  <nav class="nav">
    <a href="/" class="nav-link active">Отладка</a>
    <a href="/sandbox.html" class="nav-link">Песочница</a>
+    <a href="/settings.html" class="nav-link">Настройки</a>
  </nav>
  <span class="status"><span class="dot" id="dot"></span><span id="status-text">проверяю…</span></span>
  <span class="stats" id="stats"></span>
@@ -54,8 +54,19 @@
  }
  .nav-link:hover { background: var(--chip-bg); color: var(--fg); }
  .nav-link.active { background: var(--accent); color: #fff; }
-  .status {
+  .active-config {
    margin-left: auto;
+    padding: 4px 10px;
+    border-radius: 999px;
+    background: #ecfdf5;
+    color: #065f46;
+    border: 1px solid #a7f3d0;
+    font-size: 12px;
+    cursor: pointer;
+  }
+  .active-config:empty { display: none; }
+  .active-config:hover { background: #d1fae5; }
+  .status {
    display: inline-flex;
    align-items: center;
    gap: 6px;
@@ -375,7 +386,9 @@
  <nav class="nav">
    <a href="/" class="nav-link">Отладка</a>
    <a href="/sandbox.html" class="nav-link active">Песочница</a>
+    <a href="/settings.html" class="nav-link">Настройки</a>
  </nav>
+  <span class="active-config" id="active-config" title="Нажмите, чтобы перейти в Настройки" onclick="location.href='/settings.html'"></span>
  <span class="status"><span class="dot" id="dot"></span><span id="status-text">проверяю…</span></span>
 </header>

@@ -457,6 +470,22 @@ async function api(path, opts = {}) {
  return res.json();
 }

+/* ---------- active config ---------- */
+async function refreshActiveConfig() {
+  try {
+    const res = await fetch("/configs/active");
+    if (!res.ok) {
+      $("active-config").textContent = "";
+      return;
+    }
+    const c = await res.json();
+    const label = `активная: v${c.version}${c.name ? " · " + c.name : ""}`;
+    $("active-config").textContent = label;
+  } catch (_) {
+    $("active-config").textContent = "";
+  }
+}
+
 /* ---------- health ---------- */
 async function refreshHealth() {
  try {
@@ -674,8 +703,10 @@ async function deleteThread(id, name) {

 /* ---------- init ---------- */
 refreshHealth();
+refreshActiveConfig();
 refreshThreads();
 setInterval(refreshHealth, 15000);
+setInterval(refreshActiveConfig, 15000);
 </script>

 </body>
@@ -0,0 +1,443 @@
+<!DOCTYPE html>
+<html lang="ru">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Chat Agent for Patients — Настройки</title>
+<style>
+  :root {
+    --bg: #f5f6f8;
+    --panel: #ffffff;
+    --border: #e1e4ea;
+    --muted: #6b7280;
+    --fg: #111827;
+    --accent: #2563eb;
+    --accent-hover: #1d4ed8;
+    --ok: #16a34a;
+    --warn: #d97706;
+    --err: #dc2626;
+    --chip-bg: #eef2ff;
+    --mono: ui-monospace, SFMono-Regular, Menlo, monospace;
+  }
+  * { box-sizing: border-box; }
+  body {
+    margin: 0;
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+    background: var(--bg);
+    color: var(--fg);
+    font-size: 14px;
+    line-height: 1.5;
+  }
+  header {
+    background: var(--panel);
+    border-bottom: 1px solid var(--border);
+    padding: 14px 24px;
+    display: flex;
+    align-items: center;
+    gap: 16px;
+    position: sticky;
+    top: 0;
+    z-index: 10;
+  }
+  header h1 { margin: 0; font-size: 16px; font-weight: 600; }
+  .nav { display: flex; gap: 4px; }
+  .nav-link {
+    text-decoration: none;
+    color: var(--muted);
+    padding: 6px 12px;
+    border-radius: 6px;
+    font-size: 13px;
+    font-weight: 500;
+  }
+  .nav-link:hover { background: var(--chip-bg); color: var(--fg); }
+  .nav-link.active { background: var(--accent); color: #fff; }
+  .stats {
+    margin-left: auto;
+    font-size: 13px;
+    color: var(--muted);
+  }
+  .stats b { color: var(--fg); }
+
+  main {
+    padding: 24px;
+    max-width: 1400px;
+    margin: 0 auto;
+    display: grid;
+    grid-template-columns: 1fr 420px;
+    gap: 20px;
+  }
+  .panel {
+    background: var(--panel);
+    border: 1px solid var(--border);
+    border-radius: 10px;
+    padding: 18px 20px;
+  }
+  .panel h2 {
+    margin: 0 0 14px 0;
+    font-size: 15px;
+    font-weight: 600;
+  }
+  .panel .sub {
+    font-size: 12px;
+    color: var(--muted);
+    margin: -10px 0 12px 0;
+  }
+
+  .field { margin-bottom: 14px; }
+  .field label {
+    display: block;
+    font-size: 12px;
+    font-weight: 500;
+    color: var(--muted);
+    margin-bottom: 4px;
+  }
+  .field input[type=text],
+  .field textarea {
+    width: 100%;
+    border: 1px solid var(--border);
+    border-radius: 6px;
+    padding: 8px 10px;
+    font: inherit;
+    font-size: 13px;
+    background: #fff;
+    outline: none;
+  }
+  .field input[type=text]:focus,
+  .field textarea:focus { border-color: var(--accent); }
+  .field textarea {
+    font-family: var(--mono);
+    resize: vertical;
+    min-height: 160px;
+  }
+  .field textarea.prompt { min-height: 260px; }
+  .field textarea.rules { min-height: 160px; }
+
+  .editor-actions {
+    display: flex;
+    gap: 10px;
+    align-items: center;
+    flex-wrap: wrap;
+  }
+  .editor-actions button {
+    background: var(--accent);
+    color: #fff;
+    border: none;
+    padding: 8px 16px;
+    border-radius: 6px;
+    font-size: 13px;
+    font-weight: 500;
+    cursor: pointer;
+  }
+  .editor-actions button:hover { background: var(--accent-hover); }
+  .editor-actions button.secondary {
+    background: none;
+    color: var(--fg);
+    border: 1px solid var(--border);
+  }
+  .editor-actions button.secondary:hover { background: #f9fafb; }
+  .editor-actions label {
+    display: inline-flex;
+    align-items: center;
+    gap: 6px;
+    font-size: 13px;
+    color: var(--muted);
+    cursor: pointer;
+  }
+
+  /* Список версий */
+  .versions { max-height: 70vh; overflow-y: auto; }
+  .version-card {
+    border: 1px solid var(--border);
+    border-radius: 8px;
+    padding: 12px 14px;
+    margin-bottom: 10px;
+    background: #fafbfd;
+  }
+  .version-card.active {
+    background: #fff;
+    border-color: var(--accent);
+    box-shadow: 0 0 0 1px var(--accent);
+  }
+  .version-head {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    margin-bottom: 4px;
+  }
+  .v-num {
+    background: var(--chip-bg);
+    color: var(--accent);
+    padding: 2px 8px;
+    border-radius: 10px;
+    font-size: 11px;
+    font-weight: 600;
+  }
+  .v-name {
+    font-weight: 500;
+    font-size: 13px;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+  .v-name.empty { color: var(--muted); font-style: italic; font-weight: normal; }
+  .v-active-badge {
+    margin-left: auto;
+    background: var(--ok);
+    color: #fff;
+    padding: 2px 8px;
+    border-radius: 10px;
+    font-size: 10px;
+    font-weight: 600;
+    text-transform: uppercase;
+  }
+  .v-meta {
+    font-size: 11px;
+    color: var(--muted);
+    margin-bottom: 8px;
+  }
+  .v-actions {
+    display: flex;
+    gap: 6px;
+    flex-wrap: wrap;
+  }
+  .v-actions button {
+    background: none;
+    border: 1px solid var(--border);
+    padding: 3px 10px;
+    border-radius: 4px;
+    font-size: 11px;
+    cursor: pointer;
+    color: var(--fg);
+  }
+  .v-actions button:hover { background: #fff; }
+  .v-actions button.primary { background: var(--accent); color: #fff; border-color: var(--accent); }
+  .v-actions button.primary:hover { background: var(--accent-hover); }
+  .v-actions button.del:hover { border-color: var(--err); color: var(--err); }
+  .v-actions button:disabled { opacity: 0.4; cursor: not-allowed; }
+
+  .mini { color: var(--muted); font-size: 12px; font-style: italic; }
+
+  .toast {
+    position: fixed;
+    bottom: 30px;
+    left: 50%;
+    transform: translateX(-50%);
+    background: #111827;
+    color: #fff;
+    padding: 10px 16px;
+    border-radius: 8px;
+    font-size: 13px;
+    opacity: 0;
+    pointer-events: none;
+    transition: opacity 0.2s;
+    z-index: 100;
+  }
+  .toast.show { opacity: 1; }
+  .toast.err { background: var(--err); }
+</style>
+</head>
+<body>
+
+<header>
+  <h1>Chat Agent for Patients</h1>
+  <nav class="nav">
+    <a href="/" class="nav-link">Отладка</a>
+    <a href="/sandbox.html" class="nav-link">Песочница</a>
+    <a href="/settings.html" class="nav-link active">Настройки</a>
+  </nav>
+  <span class="stats" id="stats"></span>
+</header>
+
+<main>
+
+  <section class="panel">
+    <h2>Редактор конфигурации агента</h2>
+    <div class="sub">При сохранении всегда создаётся новая версия — существующие не меняются. Это даёт честный откат.</div>
+
+    <div class="field">
+      <label for="f-name">Имя версии (необязательно)</label>
+      <input type="text" id="f-name" placeholder="например: строгий тон, v2 после фидбэка операторов" maxlength="200">
+    </div>
+
+    <div class="field">
+      <label for="f-prompt">Системный промпт</label>
+      <textarea id="f-prompt" class="prompt" spellcheck="false"></textarea>
+    </div>
+
+    <div class="field">
+      <label for="f-rules">Правила (в дополнение к промпту; свободная markdown-форма)</label>
+      <textarea id="f-rules" class="rules" spellcheck="false" placeholder="Например:&#10;- Если пациент спрашивает про цены — не называй конкретных сумм, переведи на оператора.&#10;- Если злится — сначала извинись, подтверди, что сейчас поможешь."></textarea>
+    </div>
+
+    <div class="editor-actions">
+      <button id="btn-save" onclick="saveVersion(false)">Сохранить как новую версию</button>
+      <button class="secondary" onclick="loadActiveIntoEditor()">Загрузить активную в редактор</button>
+      <label><input type="checkbox" id="chk-activate"> Сразу сделать активной</label>
+    </div>
+  </section>
+
+  <aside class="panel">
+    <h2>Версии</h2>
+    <div class="sub">Активная версия используется в «Песочнице» на каждый запрос.</div>
+    <div class="versions" id="versions">
+      <div class="mini">загружаю…</div>
+    </div>
+  </aside>
+
+</main>
+
+<div class="toast" id="toast"></div>
+
+<script>
+const $ = (id) => document.getElementById(id);
+const esc = (s) => String(s ?? "").replace(/[&<>"']/g, c => ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]));
+
+let configs = [];
+
+function toast(msg, kind = "ok") {
+  const t = $("toast");
+  t.textContent = msg;
+  t.className = "toast show" + (kind === "err" ? " err" : "");
+  setTimeout(() => t.className = "toast", 2500);
+}
+
+async function api(path, opts = {}) {
+  const res = await fetch(path, opts);
+  if (!res.ok) {
+    let msg = `${res.status}`;
+    try { const d = await res.json(); msg = d.detail || JSON.stringify(d); } catch (_) {}
+    throw new Error(msg);
+  }
+  if (res.status === 204) return null;
+  return res.json();
+}
+
+function fmtDate(iso) {
+  try {
+    const d = new Date(iso);
+    return d.toLocaleString("ru-RU", { day: "2-digit", month: "2-digit", year: "2-digit", hour: "2-digit", minute: "2-digit" });
+  } catch (_) { return iso; }
+}
+
+async function refreshHealth() {
+  try {
+    const h = await api("/health");
+    const active = configs.find(c => c.is_active);
+    const vTag = active ? `активная: v${active.version}${active.name ? " · " + esc(active.name) : ""}` : "нет активной";
+    $("stats").innerHTML = `${vTag} · документов <b>${h.documents_count}</b> · чанков <b>${h.chunks_count}</b>`;
+  } catch (e) {
+    $("stats").textContent = "недоступен";
+  }
+}
+
+async function refreshConfigs() {
+  try {
+    const d = await api("/configs");
+    configs = d.configs;
+    renderVersions();
+    refreshHealth();
+  } catch (e) {
+    $("versions").innerHTML = `<div class="mini" style="color:var(--err)">${esc(e.message)}</div>`;
+  }
+}
+
+function renderVersions() {
+  if (!configs.length) {
+    $("versions").innerHTML = '<div class="mini">версий ещё нет</div>';
+    return;
+  }
+  $("versions").innerHTML = configs.map(c => `
+    <div class="version-card ${c.is_active ? "active" : ""}">
+      <div class="version-head">
+        <span class="v-num">v${c.version}</span>
+        <span class="v-name ${c.name ? "" : "empty"}" title="${esc(c.name || '')}">${esc(c.name || "без имени")}</span>
+        ${c.is_active ? '<span class="v-active-badge">активная</span>' : ""}
+      </div>
+      <div class="v-meta">${esc(fmtDate(c.created_at))} · промпт ${c.system_prompt.length} симв.${c.rules_text ? " · правил " + c.rules_text.length : ""}</div>
+      <div class="v-actions">
+        <button onclick="loadIntoEditor(${c.id})">Загрузить в редактор</button>
+        ${!c.is_active ? `<button class="primary" onclick="activate(${c.id})">Активировать</button>` : ""}
+        ${!c.is_active ? `<button class="del" onclick="deleteVersion(${c.id}, ${c.version})">Удалить</button>` : '<button class="del" disabled title="Активную удалить нельзя — сначала активируйте другую">Удалить</button>'}
+      </div>
+    </div>
+  `).join("");
+}
+
+function loadIntoEditor(id) {
+  const c = configs.find(x => x.id === id);
+  if (!c) return;
+  $("f-name").value = c.name ? `${c.name} (на основе v${c.version})` : `v${c.version} — копия`;
+  $("f-prompt").value = c.system_prompt;
+  $("f-rules").value = c.rules_text || "";
+  toast(`Загружена v${c.version}`);
+  window.scrollTo({ top: 0, behavior: "smooth" });
+}
+
+function loadActiveIntoEditor() {
+  const active = configs.find(c => c.is_active);
+  if (!active) {
+    toast("Активной версии нет", "err");
+    return;
+  }
+  loadIntoEditor(active.id);
+}
+
+async function saveVersion() {
+  const name = $("f-name").value.trim();
+  const system_prompt = $("f-prompt").value.trim();
+  const rules_text = $("f-rules").value.trim();
+  const activate = $("chk-activate").checked;
+
+  if (!system_prompt) {
+    toast("Системный промпт не может быть пустым", "err");
+    return;
+  }
+
+  $("btn-save").disabled = true;
+  try {
+    const r = await api("/configs", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ name: name || null, system_prompt, rules_text, activate }),
+    });
+    toast(`Сохранена v${r.version}${activate ? " · активирована" : ""}`);
+    $("chk-activate").checked = false;
+    await refreshConfigs();
+  } catch (e) {
+    toast("Ошибка: " + e.message, "err");
+  } finally {
+    $("btn-save").disabled = false;
+  }
+}
+
+async function activate(id) {
+  try {
+    const r = await api(`/configs/${id}/activate`, { method: "POST" });
+    toast(`Активирована v${r.version}`);
+    refreshConfigs();
+  } catch (e) {
+    toast("Ошибка: " + e.message, "err");
+  }
+}
+
+async function deleteVersion(id, version) {
+  if (!confirm(`Удалить версию v${version}?`)) return;
+  try {
+    await api(`/configs/${id}`, { method: "DELETE" });
+    toast(`v${version} удалена`);
+    refreshConfigs();
+  } catch (e) {
+    toast("Ошибка: " + e.message, "err");
+  }
+}
+
+/* ---------- init ---------- */
+(async function init() {
+  await refreshConfigs();
+  // При первом заходе загружаем активную в редактор для удобства.
+  loadActiveIntoEditor();
+})();
+</script>
+
+</body>
+</html>