lct-05: состояние сессии, таймеры по событиям, четыре канала

Таймеры объявлены таблицей «событие → старт/стоп», а не разбросаны
по обработчикам: так видно целиком, что чем запускается, и норматив
нельзя потерять по дороге. Опрос стартует на ответе курсанта и
останавливается передачей в ДДС — событием, а не таймаутом.

Канал наблюдателя без единого обработчика входящих: кадры читаются
и выбрасываются, не разбираясь, только чтобы заметить разрыв. Без
чтения задача сокета висела бы на очереди до первой отправки, а
закрытая вкладка монитора оставляла бы подписку. Тест проверяет, что
наблюдатель не может ни изменить карточку, ни завершить занятие.

Пульт теперь заводит сессию в журнале: запущенное с него занятие жило
только в памяти, и реплики с подсказками уходили в нарушение внешнего
ключа — журнал об этом честно сообщал в лог.

Тикер таймеров гасится при остановке приложения, иначе задачи переживают
выключение и держат событийный цикл.

Проверено вживую через uvicorn: монитор, подключённый посреди занятия,
получает снимок с заполненной карточкой; такт таймера идёт раз в секунду.

backend/app/api/ws/observe.py

@@ -0,0 +1,62 @@
+"""Канал наблюдателя: внешний монитор и пульт преподавателя.
+
+**На этом сокете нет ни одного обработчика входящих сообщений.** Внешний
+монитор физически не может повлиять на занятие: у него нет ни аудио, ни канала
+записи. Преподаватель смотрит здесь, а пишет через отдельный `control`.
+
+Входящие кадры читаются и выбрасываются, не разбираясь: чтение нужно ровно
+затем, чтобы заметить разрыв соединения. Без него задача сокета висела бы
+на очереди до первой неудачной отправки, а закрытая вкладка монитора оставляла
+бы за собой подписку. Разбора, диспетчеризации и эффекта у входящих нет.
+"""
+
+import asyncio
+from uuid import UUID
+
+from fastapi import APIRouter, WebSocket, WebSocketDisconnect
+
+from app.domain.events import ErrorEvent, ErrorKind
+from app.session.hub import hub
+
+router = APIRouter()
+
+
+async def _pump(ws: WebSocket, queue: asyncio.Queue) -> None:
+    while True:
+        event = await queue.get()
+        await ws.send_text(event.model_dump_json())
+
+
+async def _wait_for_disconnect(ws: WebSocket) -> None:
+    """Единственное назначение — дождаться разрыва. Содержимое кадров
+    не читается и никуда не передаётся."""
+    while True:
+        message = await ws.receive()
+        if message["type"] == "websocket.disconnect":
+            return
+
+
+@router.websocket("/ws/observe/{session_id}")
+async def observe(ws: WebSocket, session_id: UUID) -> None:
+    await ws.accept()
+
+    state = hub.get(session_id)
+    if state is None:
+        await ws.send_text(
+            ErrorEvent(code=ErrorKind.SESSION_NOT_FOUND, message="Занятие не запущено").model_dump_json()
+        )
+        await ws.close()
+        return
+
+    # Снимок при подключении обязателен: монитор в классе включают посреди
+    # занятия, и он должен показать текущее состояние, а не ждать событий.
+    await ws.send_text(state.snapshot().model_dump_json())
+
+    with hub.observer(session_id) as queue:
+        sender = asyncio.create_task(_pump(ws, queue))
+        try:
+            await _wait_for_disconnect(ws)
+        except WebSocketDisconnect:
+            pass
+        finally:
+            sender.cancel()