d4f0d0a0f8
ТЗ называет обучаемого оператором ДДС, а его работа в системе-112 состоит из одного действия: получить карточку и правильно проставить статус реагирования с комментарием. Памятка заказчика посвящена этому целиком. Наш АРМ умел два статуса из девяти. - domain/statuses.py: девять статусов реагирования с автоматом переходов, семь статусов карточки, обязательные комментарии к отказам. Формулировки из памятки дословно — диспетчер должен узнать слова своего боевого АРМ. - Автомат на сервере: фронт рисует только пришедшее в available. Отвергнутая отметка не попадает в журнал и возвращается текстом для курсанта. - scoring/dispatcher.py: D1, D2, D3, D4, D6 детерминированно. D3 (отказ от профильного происшествия) проверяется по списку оповещения из ЕКП — без классификатора его было бы не на чем посчитать. D5 оставлен судье. - Отметки D идут в отчёт рядом с E: в живой цепочке 112 → ДДС участвуют обе роли. - Экран ДДС: таблица служб со статусами, поле комментария у отказов, журнал отметок, статус карточки красным в трёх случаях из семи. Сквозной тест повис на ожидании station.state и вскрыл продуктовый дефект: снимок уходил только в ответ на действие диспетчера, то есть список оповещения он видел лишь после того, как что-то нажмёт. Теперь station.state отправляется сразу за card.received. Упрощения записаны в карточке: статусы «Проверена» и «Не завершено» не считаются — первый требует главного специалиста, второй 48 часов. 148 тестов зелёных (23 новых), make typecheck чистый.
115 lines
5.2 KiB
Python
115 lines
5.2 KiB
Python
"""Сокет диспетчера ДДС.
|
||
|
||
**Только JSON: аудио здесь нет вообще** — значит, нет ни VAD, ни распознавания,
|
||
ни синтеза. Голосовой контур станция не трогает (docs/arch/CONTRACT.md).
|
||
|
||
Самая ценная механика цепочки — `card.bounce`: диспетчер видит, что не указан
|
||
этаж, и отбивает карточку обратно. Неполнота КИО перестаёт быть процентом
|
||
в отчёте и становится сорванным выездом с конкретной причиной.
|
||
"""
|
||
|
||
import asyncio
|
||
import logging
|
||
from uuid import UUID
|
||
|
||
from fastapi import APIRouter, WebSocket, WebSocketDisconnect
|
||
from pydantic import TypeAdapter, ValidationError
|
||
|
||
from app.domain.events import ErrorEvent, ErrorKind, StationState, StationToServer
|
||
from app.domain.statuses import PRIMARY, ServiceStatus, StatusError
|
||
from app.session.hub import hub
|
||
from app.session.state import now_utc
|
||
|
||
log = logging.getLogger(__name__)
|
||
router = APIRouter()
|
||
|
||
_adapter = TypeAdapter(StationToServer)
|
||
|
||
|
||
async def _handle(session_id: UUID, state, event) -> None:
|
||
match event.type:
|
||
case "card.ack":
|
||
# Подтверждение приёма — это статус «Принята» у главной службы.
|
||
# Кнопка осталась ради живой цепочки 112 → ДДС (lct-20), где
|
||
# диспетчер один и выбирать службу не из чего.
|
||
state.on_event("card.ack")
|
||
state.dds_log.append(("card.ack", now_utc(), None))
|
||
services = state.notified_services()
|
||
if services:
|
||
try:
|
||
state.set_service_status(services[0], ServiceStatus.ACCEPTED)
|
||
except StatusError:
|
||
pass # статус уже стоит: повторное нажатие ничего не меняет
|
||
case "card.status":
|
||
try:
|
||
state.set_service_status(
|
||
event.service, event.status, event.comment, author="диспетчер"
|
||
)
|
||
except StatusError as exc:
|
||
hub.to_station(
|
||
session_id,
|
||
ErrorEvent(code=ErrorKind.UNSUPPORTED_EVENT, message=str(exc)),
|
||
)
|
||
return
|
||
# Первичный статус останавливает норматив 30 секунд.
|
||
if event.status in PRIMARY:
|
||
state.on_event("card.ack")
|
||
case "card.bounce":
|
||
# Карточка вернулась: в разборе это E6 с конкретной причиной.
|
||
state.bounced_fields = list(event.missing_fields)
|
||
state.dds_log.append(("card.bounce", now_utc(), event.comment))
|
||
case "zone.decision":
|
||
state.on_event("zone.decision")
|
||
state.dds_log.append(("zone.decision", now_utc(), "в зоне" if event.in_zone else "не в зоне"))
|
||
case "crew.dispatched":
|
||
state.kio = state.kio.model_copy(update={"dispatch_order_at": event.at})
|
||
state.dds_log.append(("crew.dispatched", now_utc(), None))
|
||
case "crew.arrived":
|
||
state.on_event("crew.arrived")
|
||
state.kio = state.kio.model_copy(update={"arrival_at": event.at})
|
||
state.dds_log.append(("crew.arrived", now_utc(), None))
|
||
hub.to_station(session_id, StationState(snapshot=state.station_snapshot()))
|
||
hub.to_observers(session_id, state.snapshot())
|
||
|
||
|
||
async def _pump(ws: WebSocket, queue: asyncio.Queue) -> None:
|
||
while True:
|
||
event = await queue.get()
|
||
await ws.send_text(event.model_dump_json())
|
||
|
||
|
||
@router.websocket("/ws/station/{session_id}")
|
||
async def station(ws: WebSocket, session_id: UUID, role: str = "dds") -> 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
|
||
|
||
with hub.station(session_id) as queue:
|
||
sender = asyncio.create_task(_pump(ws, queue))
|
||
try:
|
||
# Карточка, переданная до подключения станции, не теряется:
|
||
# диспетчер садится за АРМ, когда вызов уже идёт.
|
||
if state.dispatched_card is not None:
|
||
hub.to_station(session_id, state.card_received_event())
|
||
hub.to_station(session_id, StationState(snapshot=state.station_snapshot()))
|
||
while True:
|
||
payload = await ws.receive_json()
|
||
try:
|
||
event = _adapter.validate_python(payload)
|
||
except ValidationError:
|
||
hub.to_station(
|
||
session_id,
|
||
ErrorEvent(code=ErrorKind.UNSUPPORTED_EVENT, message=str(payload)[:200]),
|
||
)
|
||
continue
|
||
await _handle(session_id, state, event)
|
||
except WebSocketDisconnect:
|
||
return
|
||
finally:
|
||
sender.cancel()
|