세션 평가·라이브코치·교수자 분석 라운드 마감 + 문서 정리 + 코드품질 리팩터
- 누적 작업트리 커밋: 회기 평가 복구·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:
parent
7c41c3ce79
commit
778e8526d4
108 changed files with 6457 additions and 455 deletions
96
docs/README.md
Normal file
96
docs/README.md
Normal file
|
|
@ -0,0 +1,96 @@
|
|||
# Vignette 문서 인덱스 (docs/ 통합 목차)
|
||||
|
||||
> **여기가 문서의 단일 진입점이다.** `docs/` 안의 모든 정보를 카테고리로 묶어 링크한다.
|
||||
> 무엇을 찾든 여기서 시작하라. 상태·결정·로드맵의 권위 기준은 SSOT 대시보드, 남은 작업은 통합 TODO가 소유한다.
|
||||
|
||||
## 🎯 먼저 볼 것
|
||||
|
||||
| 문서 | 역할 |
|
||||
|---|---|
|
||||
| **[`dev_dashboard.html`](./dev_dashboard.html)** | **SSOT(단일 진실 공급원)** — 상태·검증 증거·결정·로드맵의 권위 기준 |
|
||||
| **[`TODO.md`](./TODO.md)** | **할 일(안된 것들) 통합** — 흩어진 열린 작업을 주제별로 모은 인덱스 |
|
||||
| [`../AGENTS.md`](../AGENTS.md) | 에이전트 작업 지침 원본(OS 선파악·증거 정직성·SSOT 동기화·이미지/아바타 파이프라인) |
|
||||
|
||||
## 🗺 원천문서·갭 로드맵
|
||||
|
||||
| 문서 | 역할 |
|
||||
|---|---|
|
||||
| [`guides/source-docs-and-gaps.md`](./guides/source-docs-and-gaps.md) | 원천문서·갭 로드맵 요약(대시보드와 동기화) |
|
||||
| [`ops/source-docs-gap-analysis-2026-06-26.md`](./ops/source-docs-gap-analysis-2026-06-26.md) | 원천문서 갭 분석 상세 근거(C1~L1) |
|
||||
| [`ops/backlog-2026-06-26.md`](./ops/backlog-2026-06-26.md) | 운영 백로그 — 열린 항목만 얇게(B1~B4·Phase3 게이트) |
|
||||
|
||||
## 📐 근본 설계·비전 (reference — 완료 기록 아님)
|
||||
|
||||
| 문서 | 역할 |
|
||||
|---|---|
|
||||
| [`MASTERPLAN.md`](./MASTERPLAN.md) | 통합 기준 설계·비전·아키텍처·분류체계·Phase 로드맵 |
|
||||
| [`redteam/MASTERPLAN_REVISIONS.md`](./redteam/MASTERPLAN_REVISIONS.md) | 마스터플랜 재설계 패치·의사결정 정정(§9 열린 결정 포함) · 대상 결함 [`redteam/REDTEAM_FINDINGS.md`](./redteam/REDTEAM_FINDINGS.md) |
|
||||
| [`MEMORY_KNOWLEDGE_PERSONA_DESIGN.md`](./MEMORY_KNOWLEDGE_PERSONA_DESIGN.md) | 메모리·지식·페르소나·3-AI 정보비대칭 통합 아키텍처(스키마 DDL 포함) |
|
||||
| [`taxonomy.md`](./taxonomy.md) | 상담 발화 라벨 분류체계 SoT(기법/내담자상태/슈퍼바이저논평) |
|
||||
| [`DESIGN_CONCEPT.md`](./DESIGN_CONCEPT.md) | 디자인 시스템·색토큰·아바타·세션UX·3역할 대시보드 SSOT |
|
||||
| [`design-concepts/prompts/vignette-design-prompts-2026-06-27.md`](./design-concepts/prompts/vignette-design-prompts-2026-06-27.md) | 화면 시안 이미지 생성 프롬프트·공통 시각 방향 |
|
||||
|
||||
## 🛠 개발·운영 가이드
|
||||
|
||||
| 문서 | 역할 |
|
||||
|---|---|
|
||||
| [`guides/local-development.md`](./guides/local-development.md) | 로컬 개발 환경 구축·실행 (1-커맨드 dev 스택) |
|
||||
| [`guides/architecture.md`](./guides/architecture.md) | 시스템 아키텍처(엔진/오케스트레이터/저항/마스킹/음성/평가/데이터) |
|
||||
| [`guides/testing.md`](./guides/testing.md) | 테스트·검증(pytest, typecheck, Playwright E2E 게이트) |
|
||||
| [`DEPLOYMENT.md`](./DEPLOYMENT.md) | docker compose 배포·엔진 어댑터·환경변수·외부공개 운영 |
|
||||
| [`HANDOFF.md`](./HANDOFF.md) | 최신 세션 인수인계 — 현재 상태·남은 외부 게이트·다음 우선순위 |
|
||||
|
||||
## ⚙️ 운영 런북·게이트 트래커 (`ops/`)
|
||||
|
||||
| 문서 | 역할 |
|
||||
|---|---|
|
||||
| [`ops/public-runtime-watchdog.md`](./ops/public-runtime-watchdog.md) | 공개 런타임 워치독 설치·복구 절차(런북) |
|
||||
| [`ops/tailscale-vnet-runtime-2026-06-27.md`](./ops/tailscale-vnet-runtime-2026-06-27.md) | Tailnet 런타임 + 공개 vnet 외부 게이트 추적 |
|
||||
| [`ops/hanshin-data-governance-gate.md`](./ops/hanshin-data-governance-gate.md) | 한신대 데이터/SSO 외부 증거 게이트 체크리스트 |
|
||||
| [`ops/code-quality-research-2026-06-26.md`](./ops/code-quality-research-2026-06-26.md) | 코드품질 분석 + 미실행 리팩터 로드맵 |
|
||||
| [`ops/postgres-rls-audit-smoke.md`](./ops/postgres-rls-audit-smoke.md) | RLS·감사로그 격리 스모크 절차(재현 런북) |
|
||||
| [`ops/engine-rss-smoke-2026-06-28.md`](./ops/engine-rss-smoke-2026-06-28.md) · [`ops/resistance-openness-db-smoke-2026-06-28.md`](./ops/resistance-openness-db-smoke-2026-06-28.md) | 대시보드가 인용하는 live 실측 증거 |
|
||||
| [`ops/layout-research-2026-06-27/persona-dashboard-layout-guideline.md`](./ops/layout-research-2026-06-27/persona-dashboard-layout-guideline.md) | 페르소나 스튜디오·대시보드 레이아웃 원칙 |
|
||||
|
||||
## 🧩 의사결정 기록 (ADR — `decisions/`)
|
||||
|
||||
| 문서 | 역할 |
|
||||
|---|---|
|
||||
| [`decisions/backend-node-transition.md`](./decisions/backend-node-transition.md) | 백엔드 언어 방향(FastAPI 유지·Node 계약 우선 전환) |
|
||||
| [`decisions/voice-s2s-poc.md`](./decisions/voice-s2s-poc.md) | 음성 s2s 2차 PoC 채택 판단 기준 |
|
||||
|
||||
## 🧪 Phase 3 파일럿 (forward — 아직 미실행)
|
||||
|
||||
| 문서 | 역할 |
|
||||
|---|---|
|
||||
| [`phase3/README.md`](./phase3/README.md) | Phase3 파일럿 게이트 인덱스·증거 루트 |
|
||||
| [`phase3/pilot-runbook.md`](./phase3/pilot-runbook.md) | 20명 파일럿 진입/완료 게이트·운영 절차 |
|
||||
| [`phase3/kpi-measurement-plan.md`](./phase3/kpi-measurement-plan.md) | KPI 정의·리포트 형식·측정 방법 |
|
||||
| [`phase3/dataset-export-manifest.md`](./phase3/dataset-export-manifest.md) | 재귀학습 데이터셋 export 매니페스트·승인 게이트 계약 |
|
||||
| [`phase3/privacy-consent-audit.md`](./phase3/privacy-consent-audit.md) | 동의·철회·프라이버시 감사 체크리스트 |
|
||||
|
||||
## 🖼 아바타 파이프라인
|
||||
|
||||
| 문서 | 역할 |
|
||||
|---|---|
|
||||
| [`ops/handoff-avatar-seoyeon-2026-06-27.md`](./ops/handoff-avatar-seoyeon-2026-06-27.md) | 서연(P1) 아바타 작업 핸드오프(별도 세션 진행) |
|
||||
| [`avatar-art/personas/README.md`](./avatar-art/personas/README.md) | P4~P7 Live2D 파츠 생성 규칙 |
|
||||
| `avatar-art/` | 페르소나별 파츠·재현 스크립트·QA 자산(활성 파이프라인) |
|
||||
|
||||
## 🗄 아카이브 (읽지 않는다)
|
||||
|
||||
| 문서 | 역할 |
|
||||
|---|---|
|
||||
| [`archive/README.md`](./archive/README.md) | **냉동 보관소** — 완료 기록·실행된 계획·일회성 스냅샷. 현재 상태 근거로 삼지 않는다 |
|
||||
|
||||
## 📦 그 외 자산 (문서가 아니라 참조 자산)
|
||||
|
||||
`design-verification/`(실제 렌더 검증 캡처) · `mockups/`(디자인 목업) · `design-concepts/generated/`(시안 PNG) ·
|
||||
`voice-art/`(음성 PoC 샘플·스크립트) · `golden_schema.jsonl`(평가 골든셋 스키마). 각 문서가 필요 시 참조하며,
|
||||
단독으로 읽는 계획 정보는 아니다.
|
||||
|
||||
---
|
||||
|
||||
> 유지 원칙: 완료된 작업 기록이 다시 쌓이면 `archive/`로 옮겨 이 인덱스와 활성 문서를 얇게 유지한다.
|
||||
> 상태·결정 변경은 별도 문서로만 남기지 말고 **SSOT 대시보드**에 반영·동기화한다.
|
||||
> 새 문서를 만들면 이 인덱스에 한 줄 추가하고, 새 열린 작업은 [`TODO.md`](./TODO.md)에 반영한다.
|
||||
Loading…
Add table
Add a link
Reference in a new issue