Phase 3 KPI 계약 상수 분리

docs/ops/backlog-2026-06-26.md

@@ -71,7 +71,7 @@
 
 ## Phase 3 파일럿 게이트 (실참여자 필요)
 
-- [ ] 20명 교육용 파일럿 운영 / 효과성·KPI 측정(SUS·자기효능감·κ/ICC·환각률) / 재귀학습 데이터셋 approved 산출 / 개인정보·동의 감사. 문서/checker와 dry-run exporter는 준비됨(`docs/phase3/*`, `scripts/check-phase3-artifacts.py`, `scripts/export-recursive-dataset.py`). 2026-06-27 checker 강화로 CSV enum, KPI metric required fields, approved export의 PII pass·κ/ICC·withdrawn exclusion·consent scope·file sha256 false-positive 차단을 추가했다. 2026-06-28에는 3척도 pre/post aggregate evidence 원장 `app.learner_prepost_measure`, 학습자 본인용 `GET/PUT /users/me/prepost-measures`, `SessionReview` 입력 UI를 추가했고, `app.services.phase3_kpi_export`/`scripts/export-phase3-kpi.py`로 `prepost_measures.csv`와 `kpi_report.json` scaffold를 생성한다. participant id는 가명화하고 3척도 paired normalized delta, complete/missing pair를 계산한다. 공식 문항 확정, 통계 검정, 실험/통제군 배정, 실제 approved evidence는 파일럿·steward/legal 검수·IAA 통과 시점. **검증: `python -B -m py_compile app/services/phase3_kpi_export.py app/test_phase3_kpi_export.py scripts/export-phase3-kpi.py`, `python -B -m pytest -p no:cacheprovider app/test_user_support_tickets.py app/test_runtime_policy.py app/test_admin_ops.py app/test_phase3_kpi_export.py app/test_phase3_artifact_checker.py -q` 45 passed, `python scripts/export-phase3-kpi.py --help`.**
+- [ ] 20명 교육용 파일럿 운영 / 효과성·KPI 측정(SUS·자기효능감·κ/ICC·환각률) / 재귀학습 데이터셋 approved 산출 / 개인정보·동의 감사. 문서/checker와 dry-run exporter는 준비됨(`docs/phase3/*`, `scripts/check-phase3-artifacts.py`, `scripts/export-recursive-dataset.py`). 2026-06-27 checker 강화로 CSV enum, KPI metric required fields, approved export의 PII pass·κ/ICC·withdrawn exclusion·consent scope·file sha256 false-positive 차단을 추가했다. 2026-06-28에는 3척도 pre/post aggregate evidence 원장 `app.learner_prepost_measure`, 학습자 본인용 `GET/PUT /users/me/prepost-measures`, `SessionReview` 입력 UI를 추가했고, `app.services.phase3_kpi_export`/`scripts/export-phase3-kpi.py`로 `prepost_measures.csv`와 `kpi_report.json` scaffold를 생성한다. participant id는 가명화하고 3척도 paired normalized delta, complete/missing pair를 계산한다. `phase3_kpi_contract.py`는 KPI metric 이름·필수키·`computed_prepost`/`design_pending` status 값을 공유해 exporter/checker/test drift를 줄이고, checker는 status unknown 값을 error로 처리한다. 공식 문항 확정, 통계 검정, 실험/통제군 배정, 실제 approved evidence는 파일럿·steward/legal 검수·IAA 통과 시점. **검증: `py -3.11 -X utf8 -m py_compile apps\api\app\services\phase3_kpi_contract.py apps\api\app\services\phase3_kpi_export.py apps\api\app\test_phase3_kpi_export.py apps\api\app\test_phase3_artifact_checker.py scripts\check-phase3-artifacts.py scripts\export-phase3-kpi.py`, `py -3.11 -X utf8 -m pytest -p no:cacheprovider app/test_phase3_kpi_export.py app/test_phase3_artifact_checker.py -q` 10 passed, `py -3.11 -X utf8 -m pytest -p no:cacheprovider app/test_user_support_tickets.py app/test_runtime_policy.py app/test_admin_ops.py app/test_phase3_kpi_export.py app/test_phase3_artifact_checker.py -q` 46 passed, `py -3.11 -X utf8 scripts\export-phase3-kpi.py --help`, `py -3.11 -X utf8 scripts\check-phase3-artifacts.py --help`.**
 
 ---