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

- 누적 작업트리 커밋: 회기 평가 복구·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

@ -68,11 +68,7 @@ class InProcSession:
turns: list[TurnRecord] = field(default_factory=list)
ended: bool = False
prev_rapport_credit: float = 0.0 # carry-over delta 계산용
def recent_turns(self, k: int = 6, visible_to: str | None = None) -> list[dict[str, str]]:
"""최근 K턴 버퍼(L6 직전 맥락). 마스킹본 사용."""
turns = self.turns if visible_to is None else self.turns_visible_to(visible_to)
return [{"speaker": t.speaker, "text": t.text_masked} for t in turns[-k:]]
learner_label: str | None = None
def turns_visible_to(self, role: str) -> list[TurnRecord]:
return [turn for turn in self.turns if turn.is_visible_to(role)]
@ -81,6 +77,10 @@ class InProcSession:
turns = self.turns if visible_to is None else self.turns_visible_to(visible_to)
return [{"speaker": t.speaker, "text": t.text_masked} for t in turns]
def recent_turns(self, k: int = 6, visible_to: str | None = None) -> list[dict[str, str]]:
"""최근 K턴 버퍼(L6 직전 맥락). 마스킹본은 masked_turns 단일 소유, 여기선 꼬리 K개만."""
return self.masked_turns(visible_to)[-k:]
class SessionStore:
"""in-memory 세션 저장소. DB degraded 시 SoR 대용."""