lct-03 и lct-04: журнал сессий и библиотека сценариев

БД: 11 таблиц, первая миграция. Группы и связь trainee → group заложены
сразу, даже пустыми — размечать накопленные сессии задним числом значит
делать лишнюю миграцию. Номер попытки живёт в сессии, отдельной таблицы
попыток нет: дельта считается запросом по (trainee_id, scenario_id).

Сценарии: строгая схема — опечатка в имени поля падает на старте, а не
игнорируется молча. ground_truth собирается кодом, попытка задать
incident_type, dds или required_facts в YAML отвергается: иначе генератор
разведёт факты и эталон и курсанта оштрафуют за правильный ответ. Руками
задаются только нормализованные адрес и число пострадавших — из фразы
«улица Ленина, 14, квартира 47, 5-й этаж» кодом «улица Ленина, 14»
не достать.

GET /api/scenarios/{id} больше не отдаёт чек-лист. Это содержимое
подсказок: отдать его целиком значит выдать в контрольном режиме то,
чего там быть не должно, в обход выдачи по одному пункту.

Тесты базы поднимают свой движок на каждый тест: глобальный кэшируется
и привязывается к первому событийному циклу.

backend/tests/test_db.py

@@ -0,0 +1,113 @@
+"""Журнал сессий. Тесты идут против живой базы из `make dev`;
+если её нет — пропускаются, чтобы `make test` оставался запускаемым везде.
+"""
+
+from datetime import datetime, timezone
+from uuid import uuid4
+
+import pytest
+from sqlalchemy import delete, text
+from sqlalchemy.ext.asyncio import async_sessionmaker, create_async_engine
+
+from app.config import get_settings
+from app.db import repo
+from app.db.models import Group, Scenario, Session, Trainee
+
+
+@pytest.fixture
+async def db():
+    """Свой движок на каждый тест: глобальный в app.db.base кэшируется и
+    привязывается к первому событийному циклу, а pytest даёт новый на каждый тест."""
+    engine = create_async_engine(get_settings().database_url, poolclass=None)
+    try:
+        async with engine.connect() as probe:
+            await probe.execute(text("select 1"))
+    except Exception as exc:  # noqa: BLE001 — важен факт недоступности, не причина
+        await engine.dispose()
+        pytest.skip(f"Postgres недоступен ({type(exc).__name__}) — подними `make dev`")
+
+    maker = async_sessionmaker(engine, expire_on_commit=False)
+    async with maker() as session:
+        yield session
+    await engine.dispose()
+
+
+@pytest.fixture
+async def scenario(db):
+    row = Scenario(
+        id=f"test-{uuid4().hex[:8]}",
+        title="Тестовый",
+        incident_type="fire",
+        level="L1",
+        topics=[],
+        modes=["training"],
+        body={},
+    )
+    db.add(row)
+    await db.commit()
+    yield row
+    await db.execute(delete(Session).where(Session.scenario_id == row.id))
+    await db.execute(delete(Scenario).where(Scenario.id == row.id))
+    await db.commit()
+
+
+async def test_attempts_count_up(db, scenario):
+    """Дельта попыток — измеримый цикл: разбор → повтор → дельта."""
+    group = await repo.ensure_group(db, f"группа-{uuid4().hex[:6]}")
+    trainee = await repo.ensure_trainee(db, f"курсант-{uuid4().hex[:6]}", group)
+
+    first = await repo.create_session(
+        db, scenario_id=scenario.id, mode="training", trainee_id=trainee.id, group_id=group.id
+    )
+    second = await repo.create_session(
+        db, scenario_id=scenario.id, mode="exam", trainee_id=trainee.id, group_id=group.id
+    )
+
+    assert (first.attempt, second.attempt) == (1, 2)
+    assert second.group_id == group.id, "группа размечается с первой миграции"
+
+    await db.execute(delete(Trainee).where(Trainee.id == trainee.id))
+    await db.execute(delete(Group).where(Group.id == group.id))
+    await db.commit()
+
+
+async def test_transcript_keeps_order_and_anchors(db, scenario):
+    session = await repo.create_session(db, scenario_id=scenario.id, mode="training")
+    at = datetime.now(timezone.utc)
+
+    await repo.append_utterance(
+        db, session_id=session.id, ref="u1", speaker="caller", text="Алло! Горим!", at=at, mood="panic"
+    )
+    await repo.append_utterance(
+        db, session_id=session.id, ref="u2", speaker="operator", text="Назовите адрес", at=at
+    )
+
+    rows = await repo.transcript(db, session.id)
+    assert [row.ref for row in rows] == ["u1", "u2"]
+    assert rows[0].mood == "panic"
+
+
+async def test_history_filters_by_mode(db, scenario):
+    await repo.create_session(db, scenario_id=scenario.id, mode="training")
+    await repo.create_session(db, scenario_id=scenario.id, mode="exam")
+
+    exams = await repo.history(db, mode="exam")
+    assert exams, "контрольные сессии не нашлись"
+    assert all(row.mode == "exam" for row in exams)
+
+
+async def test_hints_are_logged(db, scenario):
+    """Счёт подсказок — материал разбора, а не вычитаемое из баллов,
+    но он обязан быть в журнале."""
+    session = await repo.create_session(db, scenario_id=scenario.id, mode="training")
+    await repo.record_hint(
+        db,
+        session_id=session.id,
+        checklist_id="q_people",
+        question="Есть ли люди в помещении?",
+        at=datetime.now(timezone.utc),
+    )
+    count = await db.scalar(
+        text("select count(*) from hint_uses where session_id = :sid").bindparams(sid=session.id)
+    )
+    assert count == 1

backend/tests/test_scenarios.py

@@ -0,0 +1,102 @@
+"""Загрузчик библиотеки. Сломанный сценарий обязан падать на старте
+с сообщением, понятным методисту, а не трассировкой pydantic.
+"""
+
+from pathlib import Path
+
+import pytest
+
+from app.scenarios.loader import ScenarioError, load_file, load_library
+
+LIBRARY = Path(__file__).resolve().parents[2] / "scenarios"
+
+VALID = """
+id: t-1
+title: "Проверочный"
+type: fire
+level: L1
+persona: { base: calm }
+first_line: "Алло"
+facts:
+  - { id: f_addr, value: "Ленина, 1", reveal_on: { question: q_addr } }
+checklist:
+  - { id: q_addr, question: "Адрес?", fact: f_addr }
+ground_truth:
+  address: "Ленина, 1"
+"""
+
+
+def write(tmp_path: Path, body: str, name: str = "t-1.yaml") -> Path:
+    path = tmp_path / name
+    path.write_text(body, encoding="utf-8")
+    return path
+
+
+def test_library_loads():
+    scenarios = load_library(LIBRARY)
+    assert scenarios, "библиотека пуста"
+    assert all(s.ground_truth.dds for s in scenarios), "ДДС не выведен"
+
+
+def test_extends_inherits_whole_checklist():
+    """Общий чек-лист по классификатору наследуется целиком,
+    локальные пункты дополняют его."""
+    scenario = load_file(LIBRARY / "fire-apartment-l2.yaml", LIBRARY)
+    ids = [item.id for item in scenario.checklist]
+    assert "q_caller" in ids, "пункт из общего чек-листа потерялся"
+    assert all(item.question for item in scenario.checklist), "пункт без текста вопроса"
+
+
+def test_ground_truth_is_derived_not_written():
+    scenario = load_file(LIBRARY / "fire-apartment-l2.yaml", LIBRARY)
+    assert scenario.ground_truth.incident_type.value == "fire"
+    assert scenario.ground_truth.dds.value == "01"
+    assert scenario.ground_truth.required_facts, "обязательные факты не собраны"
+
+
+def test_derived_fields_in_yaml_are_rejected(tmp_path):
+    """Иначе генератор сценариев разведёт факты и эталон, и курсанта
+    оштрафуют за правильный ответ."""
+    path = write(tmp_path, VALID + '  dds: "03"\n')
+    with pytest.raises(ScenarioError, match="выводится кодом"):
+        load_file(path, tmp_path)
+
+
+def test_broken_yaml_names_the_file(tmp_path):
+    path = write(tmp_path, "id: [не закрыт\n")
+    with pytest.raises(ScenarioError, match="битый YAML"):
+        load_file(path, tmp_path)
+
+
+def test_hidden_fact_without_approach_is_rejected(tmp_path):
+    body = VALID.replace(
+        '  - { id: f_addr, value: "Ленина, 1", reveal_on: { question: q_addr } }',
+        '  - { id: f_addr, value: "Ленина, 1", hidden: true, reveal_on: { question: q_addr } }',
+    )
+    with pytest.raises(ScenarioError, match="hidden требует"):
+        load_file(write(tmp_path, body), tmp_path)
+
+
+def test_checklist_pointing_at_missing_fact_is_rejected(tmp_path):
+    body = VALID.replace("fact: f_addr }", "fact: f_нет }")
+    with pytest.raises(ScenarioError, match="которого нет"):
+        load_file(write(tmp_path, body), tmp_path)
+
+
+def test_typo_in_field_name_is_rejected(tmp_path):
+    """Схема строгая: опечатка должна падать на старте, а не игнорироваться."""
+    body = VALID.replace("level: L1", "level: L1\nfirst_lines: 'опечатка'")
+    with pytest.raises(ScenarioError):
+        load_file(write(tmp_path, body), tmp_path)
+
+
+def test_era_block_requires_era_type(tmp_path):
+    body = VALID + """
+era_glonass:
+  vin: "X"
+  coords: { lat: 1, lon: 2 }
+  passengers: 1
+  impact_force: "сильный"
+"""
+    with pytest.raises(ScenarioError, match="era_glonass"):
+        load_file(write(tmp_path, body), tmp_path)