feat: классификатор ЕКП — признаки вместо выбора службы (lct-32)
Оператор системы-112 службу не выбирает: он проставляет формализованные
признаки происшествия, комбинация признаков даёт код ЕКП, а коду соответствует
список оповещения, который система собирает сама (docs/spec/DATASET.md).
Прежняя модель с полем dds из пяти значений оценивала действие, которого
в боевой работе нет.
- scripts/import_ekp.py (make ekp): книга заказчика → app/domain/ekp.json,
1283 кода, 61 служба, 23 группы. Разовый импорт, результат под гитом:
читать xlsx в рантайме — лишняя зависимость и полсекунды на старте.
- domain/ekp.py: справочник с ленивой загрузкой, каскад значений признаков,
список оповещения с модификаторами (нет доступа, угроза людям, пострадавшие,
газификация и ещё десяток).
- КИО: поля signs, incident_code, notify. Последние два только на чтение
и пересчитываются при каждой правке признаков; добавленная вручную служба
не теряется, удалить службу нельзя — как в боевом АРМ.
- GET /api/ekp/signs отдаёт один уровень признаков, а не дерево на полмегабайта.
- Карточка на фронте: три каскадных селектора вместо выбора службы.
- Оценка: метрика incident_signs (E2, маршрутизация). Для размеченных сценариев
dds_choice больше не считается — список оповещения производен от признаков,
и штрафовать за него отдельно значит наказать дважды за одну ошибку.
Разбор книги оказался основной работой: имя службы лежит то в первой строке
заголовка, то во второй, то склеено с модификатором; «Классификатор МЧС» —
заголовок группы колонок, а не служба. Правила разбора в докстринге импорта.
113 тестов зелёных (14 новых в tests/test_ekp.py), make typecheck чистый.
2026-09-19 20:11:50 +03:00
|
|
|
|
"""Справочник ЕКП и карточка, которая из него считается.
|
|
|
|
|
|
|
|
|
|
|
|
Проверяются пункты приёмки lct-32: признаки дают код, список оповещения
|
|
|
|
|
|
производен и не выбирается руками, сценарий размечается признаками.
|
|
|
|
|
|
"""
|
|
|
|
|
|
|
|
|
|
|
|
import pytest
|
|
|
|
|
|
|
|
|
|
|
|
from app.domain import ekp
|
|
|
|
|
|
from app.domain.kio import KIO, derive_incident
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def test_reference_loads_whole_book():
|
|
|
|
|
|
"""Импорт не должен незаметно потерять часть строк: их 1283, и это число
|
|
|
|
|
|
сверяется с книгой заказчика."""
|
|
|
|
|
|
reference = ekp.reference()
|
|
|
|
|
|
assert reference.version == "046.24"
|
|
|
|
|
|
assert len(reference.incidents) == 1283
|
|
|
|
|
|
assert len(reference.groups) == 23
|
|
|
|
|
|
assert all(incident.type for incident in reference.incidents), "код без итогового типа"
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def test_signs_give_the_code_from_the_book():
|
|
|
|
|
|
found = ekp.by_signs(["жилой дом", "подъезд", "открытое пламя"])
|
|
|
|
|
|
assert found is not None
|
|
|
|
|
|
assert found.code == "1050701"
|
|
|
|
|
|
assert found.type == "пожар: подъезд"
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def test_signs_are_case_insensitive():
|
|
|
|
|
|
"""Методист пишет «Жилой дом», книга — «жилой дом»."""
|
|
|
|
|
|
assert ekp.by_signs(["Жилой дом", "Подъезд", "Открытое пламя"]) is not None
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def test_next_level_narrows_by_previous():
|
|
|
|
|
|
first = ekp.signs_at_level(1)
|
|
|
|
|
|
assert "жилой дом" in first
|
|
|
|
|
|
second = ekp.signs_at_level(2, ["жилой дом"])
|
|
|
|
|
|
assert "балкон" in second
|
|
|
|
|
|
assert "мусор" not in second, "«мусор» относится к улице, а не к жилому дому"
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def test_service_rows_hidden_from_operator_are_not_offered():
|
|
|
|
|
|
"""Часть строк книги существует ради интеграции и оператору не показывается."""
|
|
|
|
|
|
assert all(ekp.HIDDEN_SIGN not in sign.lower() for sign in ekp.signs_at_level(1))
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def test_notify_list_is_not_a_single_service():
|
|
|
|
|
|
"""Главное расхождение с прежней моделью: происшествие почти всегда
|
|
|
|
|
|
поднимает больше одной службы (docs/spec/DATASET.md)."""
|
|
|
|
|
|
services = ekp.notify_list("1050701")
|
|
|
|
|
|
assert "Служба 101" in services
|
|
|
|
|
|
assert len(services) > 1
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def test_modifier_adds_services_and_never_removes():
|
|
|
|
|
|
base = ekp.notify_list("1050701")
|
|
|
|
|
|
with_gas = ekp.notify_list("1050701", ["gas"])
|
|
|
|
|
|
assert set(base) < set(with_gas), "модификатор только добавляет службы"
|
|
|
|
|
|
assert "МОСГАЗ" in with_gas
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def test_unknown_code_is_empty_not_an_error():
|
|
|
|
|
|
"""Сценарий без признаков остаётся рабочим: занятие не должно падать
|
|
|
|
|
|
из-за неразмеченной карточки."""
|
|
|
|
|
|
assert ekp.notify_list("0000000") == []
|
|
|
|
|
|
assert ekp.incident("0000000") is None
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def test_card_derives_code_and_notify_from_signs():
|
|
|
|
|
|
card = derive_incident(KIO(signs=["жилой дом", "балкон", "открытое пламя"]))
|
|
|
|
|
|
assert card.incident_code == "1050201"
|
|
|
|
|
|
assert "Служба 101" in card.notify
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def test_operator_cannot_edit_the_notify_list():
|
|
|
|
|
|
"""В боевом АРМ службу можно добавить, но не удалить, и список целиком
|
|
|
|
|
|
оператор не переписывает — он производен от признаков."""
|
|
|
|
|
|
from app.domain.kio import apply_patch
|
|
|
|
|
|
|
|
|
|
|
|
card = derive_incident(KIO(signs=["жилой дом", "балкон", "открытое пламя"]))
|
|
|
|
|
|
patched = apply_patch(card, {"notify": [], "incident_code": "9999999"})
|
|
|
|
|
|
assert patched.notify == card.notify
|
|
|
|
|
|
assert patched.incident_code == card.incident_code
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def test_changing_signs_recalculates_the_card():
|
|
|
|
|
|
from app.domain.kio import apply_patch
|
|
|
|
|
|
|
|
|
|
|
|
card = derive_incident(KIO(signs=["жилой дом", "балкон", "открытое пламя"]))
|
|
|
|
|
|
moved = apply_patch(card, {"signs": ["жилой дом", "квартира", "открытое пламя"]})
|
|
|
|
|
|
assert moved.incident_code != card.incident_code
|
|
|
|
|
|
assert moved.notify, "после смены признаков список оповещения пересобирается"
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@pytest.mark.parametrize("level", [1, 2, 3])
|
|
|
|
|
|
def test_every_level_offers_something(level):
|
|
|
|
|
|
prefix = ["жилой дом", "подъезд"][: level - 1]
|
|
|
|
|
|
assert ekp.signs_at_level(level, prefix), f"уровень {level} пуст"
|
feat: исход вызова — не каждый звонок заканчивается карточкой (lct-36)
Весь продукт стоял на допущении «звонок → карточка → выезд». В билетах
заказчика оно нарушается намеренно: «поругался с продавцом Мегафон» — справка,
а вызов из Волгоградской области передаётся в систему-112 другого субъекта.
Курсант, заведший карточку на такой вызов, занял расчёт зря, и прежняя оценка
этого не видела — наоборот, награждала за полноту заполнения.
- Outcome в домене, поле outcome в сценарии, событие call.resolve у курсанта
и две кнопки на АРМ. Отдельное действие, а не «положил трубку»: система
должна отличить осознанное решение от брошенного вызова.
- Метрика outcome (E2, вес 3 — лишний выезд дороже неточного признака).
- Там, где карточка не заводится, метрики карточки не считаются вовсе.
Полнота опроса считается: передать вызов не значит не опрашивать.
- call.resolve останавливает норматив опроса, как и передача карточки.
Попутно (lct-34): библиотека стала вложенной — scenarios/tickets/, поля
ticket и position, чек-листы для медицины, полиции и ЖКХ. Перенесён билет 1
целиком: три вызова, три классификатора, третий — из другого региона.
Найдено по ходу: модификаторы списка оповещения не были подключены ни к чему.
В классификаторе скорая добавляется к массовой драке признаком «пострадавшие»,
но взять его было неоткуда. Теперь модификаторы берутся из карточки —
victims_count, life_threat, evacuation_needed, fire.gasified, — и список
оповещения пересобирается при правке любого из этих полей.
161 тест зелёный (13 новых), make typecheck чистый.
2026-09-20 08:33:30 +03:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def test_victims_bring_the_ambulance():
|
|
|
|
|
|
"""Модификатор приходит не из классификатора, а из карточки: пострадавшие
|
|
|
|
|
|
в поле `victims_count` поднимают скорую (docs/spec/DATASET.md)."""
|
|
|
|
|
|
from app.domain.kio import KIO, derive_incident
|
|
|
|
|
|
|
|
|
|
|
|
quiet = derive_incident(KIO(signs=["Драка", "Улица общественное место", "Массовая (от 10 человек)"]))
|
|
|
|
|
|
hurt = derive_incident(
|
|
|
|
|
|
KIO(signs=["Драка", "Улица общественное место", "Массовая (от 10 человек)"], victims_count=5)
|
|
|
|
|
|
)
|
|
|
|
|
|
assert "СМП" not in quiet.notify
|
|
|
|
|
|
assert "СМП" in hurt.notify
|
|
|
|
|
|
assert set(quiet.notify) < set(hurt.notify), "модификатор только добавляет службы"
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def test_gasified_object_brings_mosgaz():
|
|
|
|
|
|
from app.domain.kio import KIO, FireDetails, derive_incident
|
|
|
|
|
|
|
|
|
|
|
|
card = derive_incident(
|
|
|
|
|
|
KIO(signs=["жилой дом", "балкон", "открытое пламя"], fire=FireDetails(gasified=True))
|
|
|
|
|
|
)
|
|
|
|
|
|
assert "МОСГАЗ" in card.notify
|