Harden published curriculum and student flows

2026-09-30 08:22:17 +03:00
parent e8163fe265
commit ce7b0fcf14
53 changed files with 4723 additions and 3317 deletions
@@ -0,0 +1,44 @@
+<?php
+declare(strict_types=1);
+
+namespace App\Services;
+
+/** A human approval must not silently override missing or blocking findings. */
+final class VideoReviewReportValidator
+{
+    public static function approvable(array $report): bool
+    {
+        $coverage = $report['coverage'] ?? null;
+        if (!is_array($coverage) || ($coverage['truncated'] ?? true) !== false ||
+            !array_key_exists('unprocessed_intervals', $coverage) || $coverage['unprocessed_intervals'] !== [] ||
+            !is_array($coverage['section_results'] ?? null) || $coverage['section_results'] === [] ||
+            !is_array($coverage['objective_results'] ?? null) || $coverage['objective_results'] === [] ||
+            ($report['missing_inputs'] ?? null) !== [] || !is_array($report['issues'] ?? null)) {
+            return false;
+        }
+        foreach (['section_results', 'objective_results'] as $field) {
+            foreach ($coverage[$field] as $result) {
+                if (!is_array($result) || !in_array($result['status'] ?? null, ['covered', 'out_of_declared_scope'], true)) {
+                    return false;
+                }
+                if (($result['status'] ?? '') === 'covered' &&
+                    empty($result['evidence_refs']) && empty($result['evidence_ref'])) {
+                    return false;
+                }
+                if (($result['status'] ?? '') === 'out_of_declared_scope' &&
+                    trim((string)($result['reason'] ?? '')) === '') {
+                    return false;
+                }
+            }
+        }
+        foreach ($report['issues'] as $issue) {
+            if (!is_array($issue) ||
+                (in_array($issue['severity'] ?? null, ['critical', 'major'], true) &&
+                 (($issue['resolution_status'] ?? '') !== 'resolved' ||
+                  trim((string)($issue['resolution_evidence'] ?? '')) === ''))) {
+                return false;
+            }
+        }
+        return true;
+    }
+}