세션 평가·라이브코치·교수자 분석 라운드 마감 + 문서 정리 + 코드품질 리팩터

- 누적 작업트리 커밋: 회기 평가 복구·durable 저장, 라이브 코치 이력/근거, 교수자 학생분석, 음성 비언어 메타, PII 마스킹, 운영 티켓/헬스 등
- 문서: 완료 기록 docs/archive/ 냉동 보관, docs/ 단일 인덱스(docs/README.md)+통합 TODO(docs/TODO.md)로 정리
- 리팩터(행위 보존): Stage enum SSOT(taxonomy 소유·state_machine re-export), store recent/masked_turns 중복 제거, speaker_ko_label 단일 헬퍼, _list_sessions N+1 제거(state/turns 배치 + 턴평가 하이드레이션 배치)
- 검증: 백엔드 pytest 352 passed, _list_sessions E2E chromium-single-run 2 passed
This commit is contained in:
Yun Chan 2026-07-02 02:50:36 +09:00
parent 7c41c3ce79
commit 778e8526d4
108 changed files with 6457 additions and 455 deletions

View file

@ -113,9 +113,9 @@ class LearnerDashboardTest(unittest.IsolatedAsyncioTestCase):
with (
patch.object(
sessions.session_persistence,
"list_sessions",
"list_recent_sessions",
AsyncMock(return_value=(owned_sessions, True)),
) as list_sessions,
) as list_recent_sessions,
patch.object(
sessions.session_persistence,
"load_session_evaluation",
@ -129,7 +129,7 @@ class LearnerDashboardTest(unittest.IsolatedAsyncioTestCase):
):
response = await sessions.learner_dashboard(principal)
list_sessions.assert_awaited_once_with(principal, include_turn_evaluation=True)
list_recent_sessions.assert_awaited_once_with(principal, include_turn_evaluation=True)
list_session_archives.assert_awaited_once_with(
[sess.session_id for sess in owned_sessions],
principal,
@ -155,6 +155,59 @@ class LearnerDashboardTest(unittest.IsolatedAsyncioTestCase):
self.assertEqual(len(response.recent_feedback), 3)
self.assertIn("근거 기반 피드백", response.recent_feedback[0].note)
async def test_dashboard_excludes_failed_fast_loop_evaluations_from_growth_and_feedback(self) -> None:
principal = _principal()
good_session = _session(
session_id="00000000-0000-0000-0000-00000000b211",
session_no=1,
persona_code=P1.code,
score="pos",
rapport=0.5,
technique="reflection",
created_at=1_000.0,
)
failed_session = _session(
session_id="00000000-0000-0000-0000-00000000b212",
session_no=2,
persona_code=P1.code,
score="neutral",
rapport=0.2,
technique="failed evaluator",
created_at=2_000.0,
)
failed_eval = failed_session.turns[0].evaluation
assert failed_eval is not None
failed_eval["error"] = "engine_error"
failed_eval["appropriateness_note"] = "이 문장은 최근 피드백에 노출되면 안 됩니다."
failed_eval["techniques"] = []
with (
patch.object(
sessions.session_persistence,
"list_recent_sessions",
AsyncMock(return_value=([good_session, failed_session], True)),
),
patch.object(
sessions.session_persistence,
"load_session_evaluation",
AsyncMock(return_value=({"status": "ready"}, True)),
),
patch.object(
sessions.session_persistence,
"list_session_archives",
AsyncMock(return_value=({}, True)),
),
):
response = await sessions.learner_dashboard(principal)
self.assertEqual(response.growth.evaluated_sessions, 1)
self.assertEqual(response.growth.first_score, 1.0)
self.assertEqual(response.growth.latest_score, 1.0)
self.assertEqual(response.growth.avg_score, 1.0)
self.assertEqual(len(response.recent_feedback), 1)
self.assertIn("reflection 근거 기반 피드백", response.recent_feedback[0].note)
self.assertNotIn("노출되면 안 됩니다", response.model_dump_json())
async def test_session_list_marks_archived_rows_from_learner_archive_state(self) -> None:
principal = _principal()
owned_sessions = [
@ -190,9 +243,9 @@ class LearnerDashboardTest(unittest.IsolatedAsyncioTestCase):
with (
patch.object(
sessions.session_persistence,
"list_sessions",
"list_recent_sessions",
AsyncMock(return_value=(owned_sessions, True)),
) as list_sessions,
) as list_recent_sessions,
patch.object(
sessions.session_persistence,
"list_session_archives",
@ -202,7 +255,7 @@ class LearnerDashboardTest(unittest.IsolatedAsyncioTestCase):
):
response = await sessions.list_learner_sessions(principal)
list_sessions.assert_awaited_once_with(principal)
list_recent_sessions.assert_awaited_once_with(principal)
list_session_archives.assert_awaited_once_with(
[sess.session_id for sess in owned_sessions],
principal,
@ -263,7 +316,7 @@ class LearnerDashboardTest(unittest.IsolatedAsyncioTestCase):
with (
patch.object(
sessions.session_persistence,
"list_sessions",
"list_recent_sessions",
AsyncMock(return_value=(owned_sessions, True)),
),
patch.object(