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

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

46
docs/archive/README.md Normal file
View file

@ -0,0 +1,46 @@
# docs/archive — 냉동 보관소 (읽지 않아도 되는 완료 기록)
> **에이전트 주의: 이 디렉터리는 평상시 작업에서 읽지 않는다.**
> 여기에는 **이미 완료·검증된 작업의 변경 로그**, 실행이 끝난 구현/리팩터 계획,
> 일회성 smoke·RSS·RLS 실측 기록, 특정 날짜 핸드오프, 완료된 재설계의 이미지 생성
> 프롬프트·리서치 스냅샷만 모아 둔다. 이는 감사·회고용 이력이며 현재 상태의 근거가 아니다.
## 왜 아카이브했나
작업 진행에 따라 백로그와 ops 문서에 완료된 작업의 검증 로그가 계속 쌓여
"지금 무엇이 열려 있는가"를 읽어내기 어려운 노이즈가 됐다. 완료 기록을 여기로 옮겨
활성 문서를 얇게 유지한다. (2026-07-02 정리)
## 현재 상태·열린 작업은 어디서 보나
- **상태·검증 증거·결정·로드맵의 SSOT**: `docs/dev_dashboard.html`
- **열린 작업(외부/환경 게이트) 추적**: `docs/ops/backlog-2026-06-26.md` (얇게 정리된 현행본)
- **원천문서 갭 요약**: `docs/guides/source-docs-and-gaps.md`
여기 있는 문서를 근거로 현재 상태를 판단하지 마라. 필요하면 이력 확인 용도로만 참고한다.
## 색인 (열어보지 않아도 무엇인지 알도록)
**백로그 전체 이력**
- `ops/backlog-2026-06-26-full-history.md` — 구 백로그 전체본. "최신 동기화 추가" 변경 로그, "이번 세션에
닫은 것", B1~B3 `[x]` 완료 항목의 상세·검증 로그. 열린 항목은 `docs/ops/backlog-2026-06-26.md` 현행본이 소유.
**완료된 날짜 핸드오프**
- `ops/layout-redesign-handoff-2026-06-26.md` — 2026-06-26 레이아웃 재설계 인수인계. 구현·E2E·시각 수용 종료.
- `ops/handoff-2026-06-27.md` — 2026-06-27 세션 인계. 위기게이트 109·교수자 추적 UI 등 CRITICAL 착수안(구현 완료).
**실행 완료된 구현/리팩터 계획**
- `ops/dark-ui-refresh-implementation-plan-2026-06-28.md` — 다크 UI v2 시안→React/CSS 전환 계획·실행 기록.
- `ops/refactor-rag-patches-2026-06-26.md` / `.json` — 리팩터 4종·KB 시드 적용 전 충돌분석·패치 스펙(적용 완료).
- `ops/layout-research-2026-06-28/` — 레이아웃 정렬 라운드 완료 리포트 + before/after·final-gate 캡처.
**완료된 재설계의 이미지 생성 프롬프트**
- `design-concepts/prompts/learner-home-dashboard-redesign-2026-06-27.md` — 학습자 홈 재설계 프롬프트(반영 완료).
- `design-concepts/prompts/learner-history-archive-redesign-2026-06-28.md` — 학습자 기록/아카이브 재설계 프롬프트(반영 완료).
- `design-concepts/prompts/vignette-dark-ui-refresh-2026-06-28.md` — 다크 UI 컨셉 이미지 재생성 프롬프트(산출 완료).
**일회성 PoC 기록**
- `voice-art/bimec-persona-voice-poc-2026-06-27.md` — P1 서연 Higgs v3 무참조 음성 PoC(스모크 완료, 대체 provider 채택으로 초과됨).
> 참고: 이 아카이브 문서 내부의 상대 링크는 이동으로 인해 일부 깨질 수 있다(냉동 기록이므로 보정하지 않음).
> 활성 문서(대시보드·가이드·현행 백로그)의 링크는 이동에 맞춰 갱신했다.