99 lines
3.9 KiB
Python
99 lines
3.9 KiB
Python
"""Временная составляющая оценки по занятой методике.
|
||
|
||
Скорость даёт непрерывный вклад, а превышение норматива дополнительно
|
||
отмечается как E3. Линейный множитель 1 − t/(2T) ограничен диапазоном 0–1:
|
||
нулевое время даёт полный вклад, два норматива и более — нулевой.
|
||
"""
|
||
|
||
from dataclasses import dataclass
|
||
|
||
from app.domain.events import Metric
|
||
from app.domain.taxonomy import Competency, ErrorCode, Finding, FindingSource
|
||
from app.scoring.taxonomy import METRIC_WEIGHTS
|
||
|
||
TIME_REF = "ТЗ задачи № 9; сессия вопросов и ответов 16.09.2026"
|
||
|
||
|
||
def time_credit(elapsed_ms: int | None, limit_ms: int) -> float:
|
||
"""Доля веса временной метрики, 0–1; отсутствие доказанного времени — 0."""
|
||
if elapsed_ms is None or elapsed_ms < 0 or limit_ms <= 0:
|
||
return 0.0
|
||
return round(max(0.0, min(1.0, 1.0 - elapsed_ms / (2 * limit_ms))), 4)
|
||
|
||
|
||
@dataclass(frozen=True)
|
||
class TimeNorm:
|
||
"""Формулировки норматива времени: карточка 112 и карточка ДДС различаются
|
||
только словами, расчёт и отметка E3 у них общие."""
|
||
|
||
key: str
|
||
title: str
|
||
summary: str
|
||
action: str
|
||
unmeasured: str
|
||
incomplete: str
|
||
|
||
|
||
CARD_FILL_TIME = TimeNorm(
|
||
key="card_fill_time",
|
||
title="Время заполнения карточки",
|
||
summary="Время заполнения карточки: норматив не выполнен",
|
||
action="сдать карточку",
|
||
unmeasured="время не зафиксировано",
|
||
incomplete="карточка не сдана",
|
||
)
|
||
DDS_WORK_TIME = TimeNorm(
|
||
key="dds_work_time",
|
||
title="Отработка карточки ДДС",
|
||
summary="ДДС: норматив времени отработки карточки не выполнен",
|
||
action="завершить",
|
||
unmeasured="время обработки не зафиксировано",
|
||
incomplete="карточка не завершена",
|
||
)
|
||
|
||
|
||
def time_metric(
|
||
norm: TimeNorm, elapsed_ms: int | None, limit_ms: int, *, completed: bool
|
||
) -> tuple[Metric, Finding | None]:
|
||
"""Метрика норматива и отметка E3, если он не выполнен.
|
||
|
||
Незавершённая работа не получает временного вклада: быстрое, но брошенное
|
||
заполнение не должно выглядеть скоростью.
|
||
"""
|
||
if elapsed_ms is None:
|
||
fact = norm.unmeasured
|
||
else:
|
||
delta_ms = elapsed_ms - limit_ms
|
||
if delta_ms > 0:
|
||
deviation = f"+{round(delta_ms / 1000)} с сверх норматива"
|
||
elif delta_ms < 0:
|
||
deviation = f"на {round(abs(delta_ms) / 1000)} с быстрее норматива"
|
||
else:
|
||
deviation = "точно в норматив"
|
||
fact = f"{round(elapsed_ms / 1000)} с ({deviation})"
|
||
if not completed:
|
||
fact = f"{norm.incomplete}; {fact}"
|
||
norm_text = f"{norm.action} за {round(limit_ms / 1000)} с"
|
||
passed = completed and elapsed_ms is not None and elapsed_ms <= limit_ms
|
||
metric = Metric(
|
||
key=norm.key,
|
||
title=norm.title,
|
||
fact=fact,
|
||
norm=norm_text,
|
||
ref=TIME_REF,
|
||
passed=passed,
|
||
weight=METRIC_WEIGHTS[norm.key],
|
||
credit=time_credit(elapsed_ms, limit_ms) if completed else 0.0,
|
||
)
|
||
if passed:
|
||
return metric, None
|
||
return metric, Finding(
|
||
code=ErrorCode.E3,
|
||
source=FindingSource.TIMERS,
|
||
summary=norm.summary,
|
||
fact=fact,
|
||
norm=norm_text,
|
||
ref=TIME_REF,
|
||
competency=Competency.NORMS,
|
||
metric_key=norm.key,
|
||
)
|