lct-hack/backend/app/scoring/timing.py

"""Временная составляющая оценки по занятой методике.

Скорость даёт непрерывный вклад, а превышение норматива дополнительно
отмечается как 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:
    """Формулировки норматива времени: нормативы различаются словами и кодом
    отметки, расчёт вклада и формат факта у них общие."""

    key: str
    title: str
    summary: str
    action: str
    unmeasured: str
    incomplete: str
    code: ErrorCode = ErrorCode.E3
    source: FindingSource = FindingSource.TIMERS
    competency: Competency = Competency.NORMS
    ref: str = TIME_REF


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
        # Превышение до полусекунды при округлении до целых читалось бы
        # как «45 с (+0 с)» при нормативе 45 с — тогда нужна десятая доля.
        precise = 0 < delta_ms <= 500

        def seconds(ms: int) -> str:
            return f"{ms / 1000:.1f}" if precise else f"{round(ms / 1000)}"

        if delta_ms > 0:
            deviation = f"+{seconds(delta_ms)} с сверх норматива"
        elif delta_ms < 0:
            deviation = f"на {round(abs(delta_ms) / 1000)} с быстрее норматива"
        else:
            deviation = "точно в норматив"
        fact = f"{seconds(elapsed_ms)} с ({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=norm.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=norm.code,
        source=norm.source,
        summary=norm.summary,
        fact=fact,
        norm=norm_text,
        ref=norm.ref,
        competency=norm.competency,
        metric_key=norm.key,
    )