Merge branch 'feat/finding-review'

lct-35: разбор по отметкам — подтвердить, снять, добавить с пересчётом балла
2026-09-27 23:21:24 +03:00 · 2026-09-27 23:21:24 +03:00 · c1a67badbf
commit c1a67badbf
parent 8ff51a8955 08e9d076f4
24 changed files with 1409 additions and 27 deletions
--- a/frontend/src/features/debrief/Debrief.tsx
+++ b/frontend/src/features/debrief/Debrief.tsx
@ -37,6 +37,7 @@ export function Debrief({ report, big = false }: { report: SessionReport; big?:
        <article className="debrief-stat">
          <span>Автоматическая оценка</span><strong>{report.score_auto.toFixed(0)}<small> из 100</small></strong>
          <small>{report.overridden_by ? "до корректировки преподавателя" : "расчёт по критериям занятия"}</small>
+          {report.score_reviewed != null && <small>после разбора отметок: {report.score_reviewed.toFixed(0)}</small>}
        </article>
        <article className="debrief-stat">
          <span>Упражнение</span><strong>{report.exercise === "dds" ? "ДДС" : report.exercise === "card" ? "КИО" : report.exercise === "call" ? "Вызов 112" : "112 → ДДС"}</strong>
@ -89,7 +90,8 @@ export function Debrief({ report, big = false }: { report: SessionReport; big?:
      {Boolean(report.card_results?.length) && <section className="debrief-card-results">
        <h3>Карточки занятия ({report.card_results!.length})</h3>
        {report.card_results!.map((card, index) => <details key={card.card_id}>
-          <summary>Карточка {index + 1}: {card.title || card.scenario_id} · {card.score_auto.toFixed(0)} / 100
+          <summary>Карточка {index + 1}: {card.title || card.scenario_id} · {(card.score_reviewed ?? card.score_auto).toFixed(0)} / 100
+            {card.score_reviewed != null && ` после разбора (автооценка ${card.score_auto.toFixed(0)})`}
            {card.address ? ` · ${card.address}` : ""}</summary>
          {card.managed_service && <p><strong>Ответственная служба:</strong> {card.managed_service}</p>}
          <p><strong>Ответ диспетчера:</strong> {card.reply_text || "не внесён"}</p>
@ -144,6 +146,10 @@ export function Debrief({ report, big = false }: { report: SessionReport; big?:
                  <td>
                    {finding.summary}
                    <div className="ref">{finding.fact}{finding.norm && ` · ${finding.norm}`}</div>
+                    {finding.source === "instructor" && <div className="ref">отметка преподавателя {finding.author ?? ""}</div>}
+                    {(finding.reviews ?? []).map((review, reviewIndex) => <div className="ref" key={reviewIndex}>
+                      {review.decision === "dismissed" ? "снята" : "подтверждена"} преподавателем {review.author}: {review.reason}
+                    </div>)}
                  </td>
                </tr>
              ))}
--- a/frontend/src/features/debrief/FindingReview.tsx
+++ b/frontend/src/features/debrief/FindingReview.tsx
@ -0,0 +1,162 @@
+// Разбор по отметкам: преподаватель подтверждает, снимает и добавляет отметку.
+//
+// Балл пересчитывает сервер теми же метриками и весами (lct-35): здесь только
+// решение и его причина. Причина обязательна — она остаётся в отчёте и в CSV/PDF.
+
+import { useRef, useState } from "react";
+
+import type { ErrorCode, FindingDecision, SessionReport } from "@/shared/types/generated";
+
+const DDS_CODES: ErrorCode[] = ["D1", "D2", "D3", "D4", "D5", "D6"];
+const CALL_CODES: ErrorCode[] = ["E1", "E2", "E3", "E4", "E5", "E6"];
+
+async function send(url: string, body: unknown): Promise<SessionReport> {
+  const response = await fetch(url, {
+    method: "POST",
+    credentials: "same-origin",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body),
+  });
+  const data = await response.json().catch(() => null);
+  if (!response.ok) {
+    const detail = data && typeof data === "object" && "detail" in data ? data.detail : response.statusText;
+    throw new Error(typeof detail === "string" ? detail : "Не удалось сохранить решение.");
+  }
+  return data as SessionReport;
+}
+
+export function FindingReview({ report, onChange }: {
+  report: SessionReport;
+  onChange: (report: SessionReport) => void;
+}) {
+  const cards = report.card_results ?? [];
+  const codes = report.exercise === "dds" ? DDS_CODES
+    : cards.length ? [...CALL_CODES, ...DDS_CODES] : CALL_CODES;
+  const [reasons, setReasons] = useState<Record<number, string>>({});
+  const [code, setCode] = useState<ErrorCode>(codes[0]);
+  // В ДДС все метрики принадлежат карточкам очереди. В связке 112 → ДДС
+  // E-коды относятся к занятию, а D-код без карточки — к живой карточке звонка.
+  const [card, setCard] = useState(report.exercise === "dds" && cards.length ? "1" : "");
+  const cardChoice = cards.length > 0 && (report.exercise === "dds" || code.startsWith("D"));
+  // Один ключ на отметку, пока она не сохранена: повтор после сбоя сети
+  // не добавит её второй раз.
+  const pendingId = useRef<string | null>(null);
+  const [fact, setFact] = useState("");
+  const [norm, setNorm] = useState("");
+  const [busy, setBusy] = useState(false);
+  const [error, setError] = useState("");
+  const base = `/api/sessions/${report.session_id}/findings`;
+
+  async function run(action: () => Promise<SessionReport>) {
+    setBusy(true);
+    setError("");
+    try {
+      onChange(await action());
+    } catch (cause) {
+      setError(cause instanceof Error ? cause.message : "Не удалось сохранить решение.");
+    } finally {
+      setBusy(false);
+    }
+  }
+
+  function decide(index: number, decision: FindingDecision) {
+    const reason = (reasons[index] ?? "").trim();
+    if (!reason) {
+      setError("Укажите причину решения по отметке.");
+      return;
+    }
+    void run(async () => {
+      const updated = await send(`${base}/${index}/review`, { decision, reason });
+      setReasons((current) => ({ ...current, [index]: "" }));
+      return updated;
+    });
+  }
+
+  function addFinding() {
+    if (!fact.trim() || !norm.trim()) {
+      setError("Для отметки нужны факт и норма.");
+      return;
+    }
+    pendingId.current ??= crypto.randomUUID();
+    const clientId = pendingId.current;
+    void run(async () => {
+      const updated = await send(base, {
+        code, fact: fact.trim(), norm: norm.trim(), card: cardChoice && card ? Number(card) : null,
+        client_id: clientId,
+      });
+      pendingId.current = null;
+      setFact("");
+      setNorm("");
+      return updated;
+    });
+  }
+
+  return (
+    <section className="debrief finding-review">
+      <h2>Разбор по отметкам</h2>
+      <p className="ref">
+        Снятая отметка не штрафует свою метрику, добавленная — штрафует. Балл пересчитывается
+        по тем же критериям и весам; автоматическая оценка ({report.score_auto.toFixed(1)}) сохраняется рядом.
+        {report.score_reviewed != null && ` После разбора: ${report.score_reviewed.toFixed(1)}.`}
+      </p>
+      <table className="grid">
+        <tbody>
+          {report.findings.map((finding, index) => (
+            <tr key={index}>
+              <th>{finding.code}</th>
+              <td>
+                {finding.summary}
+                <div className="ref">{finding.fact}{finding.norm && ` · ${finding.norm}`}</div>
+                {(finding.reviews ?? []).map((review, reviewIndex, all) => <div key={reviewIndex}
+                  className={reviewIndex < all.length - 1 || review.decision === "dismissed" ? "ref" : "state-violated"}>
+                  {review.decision === "dismissed" ? "Снята" : "Подтверждена"} ({review.author},{" "}
+                  {new Date(review.at).toLocaleString("ru-RU")}): {review.reason}
+                </div>)}
+                <div className="finding-review-actions">
+                  <input aria-label={`Причина решения по отметке ${index + 1}`} maxLength={1000}
+                    placeholder="Причина решения" value={reasons[index] ?? ""}
+                    onChange={(event) => setReasons((current) => ({ ...current, [index]: event.target.value }))} />
+                  <button type="button" disabled={busy} onClick={() => decide(index, "confirmed")}>Подтвердить</button>
+                  <button type="button" disabled={busy} onClick={() => decide(index, "dismissed")}>Снять</button>
+                </div>
+              </td>
+            </tr>
+          ))}
+          {report.findings.length === 0 && <tr><td colSpan={2}>Автоматических отметок нет.</td></tr>}
+        </tbody>
+      </table>
+
+      <h3>Добавить отметку</h3>
+      <div className="finding-review-form">
+        <label>Код
+          <select value={code} onChange={(event) => {
+            pendingId.current = null;
+            setCode(event.target.value as ErrorCode);
+          }}>
+            {codes.map((item) => <option key={item} value={item}>{item}</option>)}
+          </select>
+        </label>
+        {cardChoice && <label>Карточка
+          <select value={card} onChange={(event) => { pendingId.current = null; setCard(event.target.value); }}>
+            {report.exercise !== "dds" && <option value="">занятие (без карточки)</option>}
+            {cards.map((item, index) => <option key={item.card_id} value={String(index + 1)}>
+              {index + 1}: {item.title || item.scenario_id}
+            </option>)}
+          </select>
+        </label>}
+        <label>Факт
+          <input maxLength={1000} value={fact} onChange={(event) => { pendingId.current = null; setFact(event.target.value); }}
+            placeholder="Что сделал курсант" />
+        </label>
+        <label>Норма
+          <input maxLength={1000} value={norm} onChange={(event) => { pendingId.current = null; setNorm(event.target.value); }}
+            placeholder="Как требовалось" />
+        </label>
+        <button type="button" disabled={busy || !fact.trim() || !norm.trim()} onClick={addFinding}>
+          {busy ? "Сохраняем…" : "Добавить отметку"}
+        </button>
+      </div>
+      {error && <p className="violated" role="alert">{error}</p>}
+    </section>
+  );
+}
--- a/frontend/src/features/instructor/ScoreWeightsEditor.tsx
+++ b/frontend/src/features/instructor/ScoreWeightsEditor.tsx
@ -39,6 +39,10 @@ const CARD_METRICS = OPERATOR_METRICS.filter(({ key }) => [
  "required_fields", "description_grammar", "card_fill_time",
 ].includes(key));
 const CALL_METRICS = OPERATOR_METRICS.filter(({ key }) => key !== "card_fill_time");
+// Метрика появляется, только когда ручной отметке преподавателя нечего провалить.
+const REVIEW_METRICS: MetricOption[] = [
+  { key: "instructor_finding", label: "Отметка преподавателя", hint: "Ручная отметка на разборе без связанной метрики (например, D4)." },
+];

 export function ScoreWeightsEditor({
  exercise,
@ -57,6 +61,7 @@ export function ScoreWeightsEditor({
      : exercise === "card_dds"
        ? [["Карточка КИО", CARD_METRICS], ["Реагирование ДДС", DDS_METRICS]]
        : [["Опрос 112", CALL_METRICS], ["Реагирование ДДС", DDS_METRICS]];
+  groups.push(["Разбор", REVIEW_METRICS]);

  function setWeight(key: string, raw: string) {
    const next = { ...values };
--- a/frontend/src/pages/dds/Dds.tsx
+++ b/frontend/src/pages/dds/Dds.tsx
@ -384,7 +384,8 @@ export function Dds() {
        {Boolean(report.card_results?.length) && <>
          <h3>Результаты по карточкам</h3>
          {report.card_results?.map((item, index) => <details className="dds-details" key={item.card_id}>
-            <summary>Карточка {index + 1} · {item.scenario_id} · {item.score_auto.toFixed(0)} / 100</summary>
+            <summary>Карточка {index + 1} · {item.scenario_id} · {(item.score_reviewed ?? item.score_auto).toFixed(0)} / 100
+              {item.score_reviewed != null && ` после разбора (автооценка ${item.score_auto.toFixed(0)})`}</summary>
            <p><b>Ответ диспетчера:</b> {item.reply_text || "не внесён"}</p>
            {item.metrics.filter((metric) => !metric.passed || (metric.credit != null && metric.credit < 1)).map((metric) =>
              <p key={metric.key} className={metric.passed ? "ref" : "state-violated"}>
--- a/frontend/src/pages/instructor/Instructor.tsx
+++ b/frontend/src/pages/instructor/Instructor.tsx
@ -7,6 +7,7 @@
 import { useEffect, useRef, useState } from "react";

 import { Debrief } from "@/features/debrief/Debrief";
+import { FindingReview } from "@/features/debrief/FindingReview";
 import { Director } from "@/features/instructor/Director";
 import { ScoreWeightsEditor } from "@/features/instructor/ScoreWeightsEditor";
 import { ScenarioEditor } from "@/features/instructor/ScenarioEditor";
@ -814,6 +815,8 @@ export function Instructor() {
      {session.report && <>
        <Debrief report={overrideReport?.session_id === session.report.session_id
          ? overrideReport : session.report} />
+        <FindingReview report={overrideReport?.session_id === session.report.session_id
+          ? overrideReport : session.report} onChange={setOverrideReport} />
        <section className="debrief debrief-score-override">
          <h2>Ручная корректировка оценки</h2>
          <p className="ref">Автоматическая оценка: {session.report.score_auto.toFixed(1)} из 100. Меняйте её только при необходимости: причина сохранится в журнале вместе с вашим логином.</p>
--- a/frontend/src/shared/types/generated.ts
+++ b/frontend/src/shared/types/generated.ts
@ -177,6 +177,7 @@ export interface DdsCardReport {
  card_id: string;
  scenario_id: string;
  score_auto: number;
+  score_reviewed?: number | null;
  reply_text: string;
  metrics: Array<Metric>;
  findings: Array<Finding>;
@ -267,6 +268,23 @@ export interface Finding {
  competency?: Competency | null;
  transcript_ref?: string | null;
  at?: string | null;
+  metric_key?: string | null;
+  card?: number | null;
+  service?: string | null;
+  author?: string | null;
+  client_id?: string | null;
+  reviews?: Array<FindingReview>;
+}
+
+/** Решение преподавателя по отметке на разборе. */
+export type FindingDecision = "confirmed" | "dismissed";
+
+/** Кто, когда и почему подтвердил или снял отметку. Сама отметка остаётся. */
+export interface FindingReview {
+  decision: FindingDecision;
+  reason: string;
+  author: string;
+  at: string;
 }

 /** Источник объяснимой отметки; `judge` оставлен для старых отчётов. */
@ -409,6 +427,10 @@ export interface Metric {
  passed: boolean;
  weight?: number;
  credit?: number | null;
+  card?: number | null;
+  service?: string | null;
+  passed_auto?: boolean | null;
+  credit_auto?: number | null;
 }

 export interface ModeSet {
@ -610,6 +632,7 @@ export interface SessionReport {
  self_assessment_diff?: SelfAssessmentDiff | null;
  notes?: Array<InstructorNoteShown>;
  score_auto: number;
+  score_reviewed?: number | null;
  score_final: number;
  overridden_by?: string | null;
  override_comment?: string | null;
--- a/frontend/src/styles.css
+++ b/frontend/src/styles.css
@ -197,6 +197,9 @@ button:disabled { opacity: 0.5; cursor: default; }
 .debrief-stat > strong { font-size: 24px; line-height: 1.15; overflow-wrap: anywhere; }
 .debrief-stat > strong small { font-size: 14px; font-weight: 500; }
 .debrief-stat > small { color: #5a6068; font-size: 12px; }
+.finding-review-actions { display: flex; flex-wrap: wrap; gap: 6px; margin-top: 6px; }
+.finding-review-actions input { flex: 1 1 200px; min-width: 0; }
+.finding-review-form { display: grid; grid-template-columns: repeat(auto-fit, minmax(180px, 1fr)); gap: 8px; align-items: end; }
 .debrief-stat.is-passed { border-left-color: var(--ok); }
 .debrief-stat.is-failed { border-left-color: var(--violated); }
 .debrief-next-step { margin: 12px 0 18px; padding: 12px 15px; border: 1px solid var(--line); border-left: 4px solid #6b7780; border-radius: 5px; background: #fff; }