4511383cd9
- 전수 순회: IA 전 라우트 412개 기능 인벤토리를 체크리스트 백로그로 관리 (docs/ops/e2e-full-sweep-2026-07-27.md), 신규 full-sweep 스펙 10파일 추가. RED→GREEN으로 결함 12건 수정: 관리자 무한 렌더 프리즈(TanStack autoReset 루프), 복수 코호트 저장 유실, 페르소나 보관 503(SQL 컬럼 모호성), PII 과잉 마스킹, /admin/ai watchdog 오탐 오버레이, 모바일 겹침 2건, 설정 스크롤 스파이, 온보딩 전화번호 무검증, 리뷰 조사·난도 라벨, pending 피드백 등. - 소유자 결정 구현: 설정 아바타 변경, 동의 철회·재동의 전체 흐름, 신규 학습자 기초 우선 추천, 학생 분석 테이블 가상화(@tanstack/react-virtual), 저작 모드 죽은 레일 정리, 감정 밸런스 타임라인 차트(deep turn_valence + 결정론 파생 폴백). - 디자인 감사(142차): 라이트 팔레트 AA 대비, 다크 토큰 별칭 통일, 미정의 CSS 변수 정리, 한글 keep-all 전역화, 탭 타깃 24px, LCP preconnect. - 검증: npm run e2e 병렬 432 수집 GREEN + 직렬 49/49 exit 0, 백엔드 pytest 421, gateway 29, typecheck/build/design-ssot/dead-code/중복 게이트 통과, layout-visual-gate 15/15, session-layout 8/8. 상세는 SSOT 대시보드 142~144차 노트. |
||
|---|---|---|
| .. | ||
| archive | ||
| avatar-art | ||
| decisions | ||
| design/darkmode-2026-07-14 | ||
| design-concepts | ||
| guides | ||
| mockups | ||
| ops | ||
| phase3 | ||
| redteam | ||
| voice-art | ||
| DEPLOYMENT.md | ||
| DESIGN_CONCEPT.md | ||
| dev_dashboard.html | ||
| golden_schema.jsonl | ||
| HANDOFF.md | ||
| MASTERPLAN.md | ||
| MEMORY_KNOWLEDGE_PERSONA_DESIGN.md | ||
| README.md | ||
| taxonomy.md | ||
| TODO.md | ||
Vignette 문서 인덱스 (docs/ 통합 목차)
여기가 문서의 단일 진입점이다.
docs/안의 모든 정보를 카테고리로 묶어 링크한다. 무엇을 찾든 여기서 시작하라. 상태·결정·로드맵의 권위 기준은 SSOT 대시보드, 남은 작업은 통합 TODO가 소유한다.
🎯 먼저 볼 것
| 문서 | 역할 |
|---|---|
dev_dashboard.html |
SSOT(단일 진실 공급원) — 상태·검증 증거·결정·로드맵의 권위 기준 |
TODO.md |
할 일(안된 것들) 통합 — 흩어진 열린 작업을 주제별로 모은 인덱스 |
../AGENTS.md |
에이전트 작업 지침 원본(OS 선파악·증거 정직성·SSOT 동기화·이미지/아바타 파이프라인) |
🗺 원천문서·갭 로드맵
| 문서 | 역할 |
|---|---|
guides/source-docs-and-gaps.md |
원천문서·갭 로드맵 요약(대시보드와 동기화) |
ops/source-docs-gap-analysis-2026-06-26.md |
원천문서 갭 분석 상세 근거(C1~L1) |
ops/backlog-2026-06-26.md |
운영 백로그 — 열린 항목만 얇게(B1~B4·Phase3 게이트) |
📐 근본 설계·비전 (reference — 완료 기록 아님)
| 문서 | 역할 |
|---|---|
MASTERPLAN.md |
통합 기준 설계·비전·아키텍처·분류체계·Phase 로드맵 |
redteam/MASTERPLAN_REVISIONS.md |
마스터플랜 재설계 패치·의사결정 정정(§9 열린 결정 포함) · 대상 결함 redteam/REDTEAM_FINDINGS.md |
MEMORY_KNOWLEDGE_PERSONA_DESIGN.md |
메모리·지식·페르소나·3-AI 정보비대칭 통합 아키텍처(스키마 DDL 포함) |
taxonomy.md |
상담 발화 라벨 분류체계 SoT(기법/내담자상태/슈퍼바이저논평) |
DESIGN_CONCEPT.md |
디자인 시스템·색토큰·아바타·세션UX·3역할 대시보드 SSOT |
design-concepts/prompts/vignette-design-prompts-2026-06-27.md |
화면 시안 이미지 생성 프롬프트·공통 시각 방향 |
🛠 개발·운영 가이드
| 문서 | 역할 |
|---|---|
guides/collaboration-for-researchers.md |
비개발자(연구팀·디자인 담당)용 GitHub 협업 가이드 — 브랜치·PR·문구 수정 흐름·금지 사항 |
guides/local-development.md |
로컬 개발 환경 구축·실행 (1-커맨드 dev 스택) |
guides/architecture.md |
시스템 아키텍처(엔진/오케스트레이터/저항/마스킹/음성/평가/데이터) |
guides/testing.md |
테스트·검증(pytest, typecheck, Playwright E2E 게이트) |
DEPLOYMENT.md |
docker compose 배포·엔진 어댑터·환경변수·외부공개 운영 |
HANDOFF.md |
최신 세션 인수인계 — 현재 상태·남은 외부 게이트·다음 우선순위 |
⚙️ 운영 런북·게이트 트래커 (ops/)
🧩 의사결정 기록 (ADR — decisions/)
| 문서 | 역할 |
|---|---|
decisions/backend-node-transition.md |
백엔드 언어 방향(FastAPI 유지·Node 계약 우선 전환) |
decisions/voice-s2s-poc.md |
음성 s2s 2차 PoC 채택 판단 기준 |
🧪 Phase 3 파일럿 (forward — 아직 미실행)
| 문서 | 역할 |
|---|---|
phase3/README.md |
Phase3 파일럿 게이트 인덱스·증거 루트 |
phase3/pilot-runbook.md |
20명 파일럿 진입/완료 게이트·운영 절차 |
phase3/kpi-measurement-plan.md |
KPI 정의·리포트 형식·측정 방법 |
phase3/dataset-export-manifest.md |
재귀학습 데이터셋 export 매니페스트·승인 게이트 계약 |
phase3/privacy-consent-audit.md |
동의·철회·프라이버시 감사 체크리스트 |
🖼 아바타 파이프라인
| 문서 | 역할 |
|---|---|
ops/handoff-avatar-seoyeon-2026-06-27.md |
서연(P1) 래스터 아바타 보류 상태·보존 파이프라인 핸드오프 |
avatar-art/personas/README.md |
P4~P7 Live2D 파츠 생성 규칙 |
avatar-art/ |
페르소나별 파츠·재현 스크립트·QA 자산(활성 파이프라인) |
🗄 아카이브 (읽지 않는다)
| 문서 | 역할 |
|---|---|
archive/README.md |
냉동 보관소 — 완료 기록·실행된 계획·일회성 스냅샷. 현재 상태 근거로 삼지 않는다 |
📦 그 외 자산 (문서가 아니라 참조 자산)
design-verification/(실제 렌더 검증 캡처) · mockups/(디자인 목업) · design-concepts/generated/(시안 PNG) ·
voice-art/(음성 PoC 샘플·스크립트) · golden_schema.jsonl(평가 골든셋 스키마). 각 문서가 필요 시 참조하며,
단독으로 읽는 계획 정보는 아니다.
유지 원칙: 완료된 작업 기록이 다시 쌓이면
archive/로 옮겨 이 인덱스와 활성 문서를 얇게 유지한다. 상태·결정 변경은 별도 문서로만 남기지 말고 SSOT 대시보드에 반영·동기화한다. 새 문서를 만들면 이 인덱스에 한 줄 추가하고, 새 열린 작업은TODO.md에 반영한다.