회기 무발화 0턴 분리, 자기예측 락 불변식 및 TDD 회귀 검증 완료

apps/api/app/services/outcome_repository_values.py

@@ -0,0 +1,40 @@
+"""결과 저장소가 공유하는 순수 값 정규화 도우미."""
+
+from __future__ import annotations
+
+import hashlib
+import json
+from collections.abc import Mapping
+from typing import Any
+
+from ..deps import Principal, Role
+
+
+def value(row: Mapping[str, Any], key: str, default: Any = None) -> Any:
+    try:
+        return row[key]
+    except (KeyError, TypeError):
+        return default
+
+
+def canonical_hash(payload: Any) -> str:
+    serialized = json.dumps(
+        payload,
+        ensure_ascii=False,
+        separators=(",", ":"),
+        sort_keys=True,
+        default=str,
+    )
+    return hashlib.sha256(serialized.encode("utf-8")).hexdigest()
+
+
+def public_row(row: Mapping[str, Any]) -> dict[str, Any]:
+    """API 응답에서 학습자 피드백 정책 판정 전용 열을 제거한다."""
+
+    payload = dict(row)
+    payload.pop("source_learner_feedback_enabled", None)
+    return payload
+
+
+def created_role(principal: Principal) -> str:
+    return "instructor" if principal.role == Role.TEACHER else principal.role.value