블로커Phase 0 마감 · P1 진입
공개 Google OAuth 실제 /turn 증명
필요: 로그인 가능한 계정으로 storageState 캡처 → public-auth-turn E2E 1회 통과.
왜 당신인가: 실제 Google 계정 인터랙티브 로그인이라 자동화 불가. (owner 지시로 현재 보류 상태)
증거: public-auth.json + public /turn 성공 로그
project pulse
지금 위치: Phase 0 마감 직전 → Phase 1 진입 대기.
지금 위치: Phase 0 마감 직전 → Phase 1 진입 대기.
학습자 개인화 대시보드와 교수자 검토 상태는 1차 구현·검증 완료.
코어(저항·반응 조절, 상태머신, RAG, 이론모드, 가드레일, 평가 JSON Schema)는 잘 정렬됐고, 이번 점검에서 학습자 홈·교수자 리뷰·공개/Tailnet 런타임 스모크도 녹색이다. 막힌 건 두 종류 — 실제 계정·외부 DNS·기관 결정이 있어야 풀리는 게이트와, 임상 루브릭·콘텐츠·운영 증거처럼 아직 남은 제품 갭이다. 이 판은 그 둘을 분리해서 보여준다.
Full E2E 113 통과
Backend focused 12 통과
Layout 시각게이트 7/7 accept
Tailnet alpaca-home OK
Public API prod OK
Compose env BLOCK
원천문서 갭 critical 3
Decision P0 조건부
당신 차례 — 이걸 풀어주면 진행이 열린다
람다가 단독으로 못 정하거나(월권), 실제 계정·하드웨어·외부 합의가 필요한 항목. 각 카드는 무엇을 막는지 · 무엇이 필요한지 · 왜 당신인지를 담았다. 팀장이 우선순위를 골라 하나씩 풀어주면 된다.
🚧 GO를 막는 블로커 0
공개 Google OAuth 실제
게이트Phase 3 파일럿 · 데이터
한신대 데이터/SSO 거버넌스
필요: SSO claim 스키마, 추가 축어록 수급, 미성년 원본 활용동의, 개인정보 처리방침에 대한 한신대/데이터 steward의 written evidence.
왜 당신인가: 기관 공문·협의 영역. 로컬 문서 골격은 준비됨(hanshin-data-governance-gate.md).
🧭 소유자 결정 (DECIDE) 0
결정됨아키텍처·일정
백엔드 언어 방향
소유자 결정: 장기 교체 대상과 신규 분리 서비스는 Node.js 우선. 단, 현재 FastAPI 전면 재작성은 일정 리스크라 계약 우선 strangler 방식으로 간다.
영향: 팀 역량은 Node로 맞추되, 납품 핵심 경로는 기존 Python 동작을 보존하며 교체 가능한 경계부터 만든다.
결정Phase 3 측정
평가설계 (H1: 실험/통제군·3척도·κ/ICC)
doc4가 20명 실험/통제군·단회기 50분·3척도 pre-post를 명시. κ/ICC·환각률 목표는 doc4 미명시 — 확정 필요.
영향: 평가 타당도, Phase 3 측정력. 평가설계는 소유자 결정.
결정음성 아키텍처
s2s 2차 PoC 채택 여부
캐스케이드 1차는 확정. voice-s2s-poc.md 기준표로 비교 후 유지/폐기.
캐스케이드만 / s2s 2차 PoC 유지
결정페르소나 음성
서비스용 음성 모델·권리 정책
Higgs급 무참조 synthetic P1 샘플은 생성 완료, dev-only sample TTS provider 연결 완료. 실존 인물/성우 ref 사용 금지 확정. 서비스 배포 전 상업 라이선스·동의 ref·대체 provider 중 결정 필요.
Higgs 라이선스 / 동의 ref / 대체 TTS
결정데이터주권·레이턴시
fast-loop 외부 API 허용 여부
로컬 상주 분류기 기본 + 외부 Haiku/Solar 폴백 허용 여부.
로컬 전용 / 외부 폴백 허용
결정동의서·데이터셋
재귀학습 fine-tuning 범위
1차 few-shot 자동갱신만 vs fine-tuning 포함.
few-shot only / fine-tuning 포함
결정안전 정책
자유연습 기본값
수정안: 기본 ON + 피드백 권장 배지 + 교수자 토글.
기본 ON / 교수자 승인 후 ON
🤝 외부·임상팀 조율 0
조율위기게이트·평가·이론
임상팀 콘텐츠 (구훈정·어유경)
필요: C1 워크시트 항목·루브릭, CBT 이론별 단계 프롬프트 체인, 위기 스크립트·생명유지서약 문안, H2 평가 골든셋.
왜 당신인가: doc3 R&R상 콘텐츠는 임상팀 산출물. 코드는 '편집 가능 구조'만 선제 구축 → 조율·수급 필요.
수급평가 타당도·다양성
추가 축어록 수급 규모/일정
n=1 시드 한계 해소를 위한 추가 사례 수급 규모·일정 확정.
영향: 평가 타당도, 페르소나 다양성, Phase 3 측정력.
거버넌스계약·일정
스택 정합성·저작권 등재 (L1)
방향은 Node.js 교체 가능성 우선으로 정했다. 남은 일은 FastAPI 유지 사유, 계약 우선 전환 계획, 저작권 등재 문서 반영을 거버넌스 증거로 남기는 것이다.
권고: docs/decisions/backend-node-transition.md 기준으로 신청서/등재 문서의 스택 설명을 정합화한다.
진행 현황
아래 "상태 보드"의 작업 카드에서 자동 집계. 완료/진행/계획 비율과 트랙별 완료도. (Phase 진행률은 단계별 증거 기반 추정치 — 정밀 수치 아님)
상태 분포
추적 작업 0건 기준
완료 0
진행 0
계획·블로커 0
트랙별 완료도
카테고리별 완료 카드 / 전체 카드
관계도 — 무엇이 무엇을 막는가
왼쪽 내 차례(clay) 노드를 풀면 가운데 게이트/작업이 열리고, 오른쪽 납품·마일스톤으로 이어진다. 화살표를 따라가면 "내가 지금 풀어야 임계경로가 뚫리는 것"이 보인다.
내 차례 — 윤찬이 풀어야 열림
납품 필수 — 미구현 임계작업
게이트·마일스톤
··· 점선 = 약한/아키텍처 의존
디자인 시안 지침 — 기능 추출 기반 이미지 생성
2026-06-27 기준 주요 페이지 기능을 추출해 PC·태블릿·모바일 반응형 시안 7장과 온화한 이미지 요소 보드 2장을 만들었다. 결과물은 전부 PNG 래스터 이미지이며, 구현 확정안이 아니라 레이아웃·톤·이미지 요소 판단 기준이다.
적용 원칙: 생성 이미지 안의 문구는 참고하지 말고 실제 카피는 코드/기획서 기준으로 다시 쓴다. 세션 아바타는 기존 서연/P1 아바타 핸드오프와 `rasterArtSet` 지침을 우선한다. 교수·관리자 내비게이션은 현재 `AppShell`·`Sidebar` 구조를 유지하고, 배경 일러스트·패턴은 빈 상태·히어로·세션 주변 질감에 소량만 쓴다.
1차 적용(2026-06-27): 온화한 이미지 요소 보드는 구현 참고용으로만 두고, 앱 배경에는 전용 래스터 텍스처 `apps/web/public/design-elements/clinical-paper-ambient.png`를 연결했다. 보드·타일셋·누끼 시트 형태 이미지는 직접 UI 배경으로 쓰지 않는다.
2차 적용(2026-06-27): 생성된 관리자/설정/리뷰 시안 기준으로 admin 역할의 상단바·사이드바를 어두운 운영 콘솔 크롬으로 전환했고, 관리자 사용자 관리 행을 조밀한 운영 테이블 밀도로 낮췄다. 회기 리뷰는 헤더·인사이트 카드·피드백 스테이지에 따뜻한 래스터 질감과 낮은 채도 틴트를 적용했다.
3차 적용(2026-06-27): 상담 세션 시작/진행 화면을 시안 기준의 어두운 상담 스테이지로 재정렬했다. 시작 전 화면은 내담자 무대·브리핑·진행 초점 3영역으로 유지하고, 진행 중 화면은 어두운 캔버스 위에 중앙 스테이지와 자막/컨트롤을 배치한다.
4차 적용(2026-06-27): 교수 콘솔은 시안의 triage 콘솔 구조에 맞춰 KPI를 전폭 6칸으로 재배치하고, 종료 회기 검토 큐와 최근 회기 기록을 첫 화면 2열 핵심 영역으로 올렸다. 성장 추적·페르소나 저작·검수 보조 큐는 하단 보조 업무로 낮췄고, 교수자 사이드바는 좁은 teal rail로 전환했다.
5차 적용(2026-06-27): 회기 리뷰는 시안의 좌·중·우 작업대 구조에 맞춰 요약/액션 레일, 감정·흐름 중앙 영역, 우측 인사이트 패널로 재배치했다. 모바일에서는 트랜스크립트를 워크시트보다 먼저 노출하고, 사례개념화 워크시트는 제한 높이의 보조 패널로 낮춰 긴 문서처럼 보이지 않게 했다.
6차 적용(2026-06-27): 설정 화면은 글로벌 셸을 숨기고 설정 전용 좌측 레일을 주 내비로 승격했다. 계정, AI 운영, 테마, 음성, 알림 카드를 시안의 차분한 설정 워크스페이스 흐름에 맞춰 단일 컬럼으로 재배치했고, 모바일은 상단 고정 섹션 탭으로 모든 항목이 잘리지 않게 정리했다.
7차 적용(2026-06-27): 로그인 화면은 별도 생성한 래스터 상담실 배경(login-counseling-room.png)을 왼쪽 브랜드 패널에 적용해 시안의 실제 상담실 분위기를 반영했다. 학습자 홈은 모바일 grid 행 계산 때문에 생기던 리스트-상세 간 큰 공백을 제거하고, 회기 준비 보드가 한 흐름으로 이어지게 정리했다.
8차 적용(2026-06-27): 다크 테마가 라이트 primitive 토큰과 역할 accent에 덮여 흰 섹션이 섞이던 문제를 수정했다. 앱 부트 시 테마를 먼저 적용하고, 다크 모드에서 paper/surface/hair/ink primitive까지 스왑한다. 상담 세션 진행 화면은 테마 토글과 무관하게 어두운 콘솔 패널로 고정했고, 드래그형 종료 제스처는 명시적 회기 종료 버튼 + 확인 다이얼로그로 교체했다. 회기 리뷰도 동일한 다크 카드/축어록/워크시트 재질로 보정했다.
9차 적용(2026-06-27): 관리자 콘솔 IA를 /admin 운영 홈과 /admin/users 사용자 관리, /admin/access 접근 권한, /admin/tickets 운영 티켓 메뉴로 분리했다. 운영 홈은 실제 API가 있는 교육 진행·온라인 사용자·헬스·AI 비용·서비스 리소스를 우선 표시하고, 티켓/업타임 이력은 app.support_ticket·app.admin_health_event 기반 1차 저장 모델로 연결했다. 세분 그룹 권한 enforcement는 아직 정책 화면이며 가짜 권한 효과를 표시하지 않는다.
17차 적용(2026-06-28): 운영 홈의 티켓 요약은 resolved/closed 이력을 진행 중 위험으로 세지 않는다. high_priority_count와 미니 티켓 목록은 미해결 티켓 기준이며, E2E 운영 티켓 테스트는 제목·본문에 테스트임을 명시하고 실패 시에도 cleanup patch로 해결 처리한다.
19차 적용(2026-06-28): /admin/tickets는 현재 범위를 미해결 큐 목록과 상태 변경으로 좁혔다. 정적 분류/인사이트 탭은 제거하고, 카드에 카테고리·신고자·경로·접수/갱신 시각을 표시한다. 해결된 항목은 최근 해결 이력으로 내려간다. 필터·카테고리 큐·Claude Recipe headless 자동 처리·이슈 등록은 백로그 운영 티켓 자동 분류·처리 2차로 남겼다.
26차 적용(2026-06-28): /admin/tickets에 검색, 상태·카테고리·우선순위·담당그룹·정체 필터와 카테고리 quick queue를 추가했다. 서버는 동일 query를 DB에서 처리하고, 티켓 접수 및 관리자 수동 처리 변경은 audit.audit_log에 metadata-only로 남긴다. 중복 병합, Claude Recipe 자동 수정 후보, 이슈/PR/작업 스레드 생성은 운영자 승인 전까지 계속 후속으로 둔다.
27차 적용(2026-06-28): 백엔드 언어 방향은 Node.js 우선 교체 가능성으로 정리하되 FastAPI 전면 재작성은 보류했다. 첫 경계로 app/contracts/engine_gateway.py를 추가해 /v1/generate, /v1/stream, SSE token/done/error 계약을 FastAPI client와 현재 Python gateway가 함께 쓰게 했다. 결정 기록은 docs/decisions/backend-node-transition.md에 둔다.
20차 적용(2026-06-28): 신규 Google/SAML 사용자는 account_status=pending으로 시작하고 승인 전에는 /pending 안내 화면만 본다. yunchan@twentyoz.kr는 슈퍼 관리자 allowlist로 admin+approved를 받으며, /admin/users는 가입 승인 탭에서 pending 계정을 승인 또는 보류 처리한다.
21차 적용(2026-06-28): 관리자 페이지 진입권을 기본 역할과 분리해 app_user.admin_access로 저장한다. AUTH_SUPER_ADMIN_EMAILS 기본값은 yunchan@twentyoz.kr, hoonjungkoo@hs.ac.kr이며, 슈퍼 관리자는 학습자·교수자·관리자 공간 전환과 관리자 권한 부여/회수를 할 수 있다. 학생·교수 계정도 admin_access=true면 우측 상단 관리자 진입이 노출된다. 구성 슈퍼 관리자의 권한 회수와 계정 비활성화는 차단한다.
25차 적용(2026-06-28): /admin/users에서 허용 도메인 밖 이메일도 정확한 계정 단위로 강제 등록할 수 있다. Google/SAML/dev-login은 미리 등록된 이메일만 도메인 게이트 예외로 통과시키고, provider 로그인 시 기존 관리 row의 역할·코호트·승인 상태를 이어받는다. 미등록 외부 도메인 로그인은 계속 차단한다.
10차 적용(2026-06-27): 학습자 영역을 /learn 대시보드, /learn/practice 연습 대상, /learn/history 기록으로 분리했다. 홈은 최근/진행 회기를 기준으로 Live2D 아바타·감정 힌트·마지막 내담자 반응·학습자 마지막 발화·AI 코치 문장을 보여주는 세션 리캡 중심 대시보드로 바꾸고, 새 회기 시작은 학습 탭으로 낮췄다.
11차 적용(2026-06-27): 현재 /learn 화면을 다시 캡처한 뒤 UX 원칙(사용자 필요, progressive disclosure, 정보 향, adaptive layout)을 기준으로 이미지 생성 시안 3장을 만들었다. UI 지침에는 11-learner-dashboard-redesign-concept-b.png, 12-learner-dashboard-redesign-concept-b-alt.png만 채택하고, 상담실 배경으로 나온 10-learner-dashboard-redesign-concept-a.png는 폐기했다. 구현은 회기 리캡과 AI 코치/이어하기 CTA를 홈 첫 블록으로 묶고, 독립 다음 행동 카드는 제거했다.
16차 적용(2026-06-28): 생성 시안과 더 맞추기 위해 /learn 하단을 리뷰 대기, 다음 연습 추천, 최근 기록 3분할 카드로 재배치했다. AI 코치 패널에서는 진행/리뷰 카운트와 보조 링크를 제거하고, 코칭 문장·3개 체크 힌트·단일 이어하기 CTA만 남겼다. 최신 검증 캡처는 docs/design-verification/learner-home-redesign/final-*.png다.
18차 적용(2026-06-28): /learn/history는 표형 기존 회기 목록을 제거하고 전체, 진행 중, 리뷰 필요, 보관됨 상태 필터와 검색, 카드형 회기 기록 작업대로 재구성했다. 설계 지침은 docs/design-concepts/prompts/learner-history-archive-redesign-2026-06-28.md, 검증 캡처는 docs/design-verification/learner-history-redesign/history-*.png다.
22차 적용(2026-06-28): 회기 아카이브를 실제 저장 상태로 연결했다. 학습자 종료 회기는 POST /sessions/{id}/archive/restore로 보관·복원하고, app.session_archive_state는 삭제가 아니라 학습자별 보기 상태만 저장한다. 회기·턴·리뷰·공유 링크·연구/감사 증거는 유지하며, 보관된 회기는 /learn/history의 보관됨 필터와 dashboard archived_sessions에 반영되고 리뷰 대기 행동 큐에서는 제외된다.
24차 적용(2026-06-28): 운영 콘솔 /admin/usage의 DB 집계 쿼리에서 ORDER BY tokens_in + tokens_out가 PostgreSQL 원본 컬럼 참조로 해석되어 prod에서 503 fail-closed 되던 문제를 수정했다. provider/model별 정렬은 SUM(tokens_in)+SUM(tokens_out) 집계식 기준으로 바꿨고, public API 프로세스의 실제 HTTP smoke는 source=database, durable=true로 200을 반환한다.
23차 적용(2026-06-28): app.persona_voice_map을 실제 /voice/ws TTS voice 선택에 연결했다. 명시 query preset이 최우선이고, 없으면 세션의 persona_id/persona_version 또는 dev persona catalog의 voice map을 읽으며, unsupported provider는 기존 persona-code fallback으로 fail-safe 처리한다. seed materializer는 기본 OpenAI voice map row를 ON CONFLICT DO NOTHING으로 생성하고, dev 런타임 스키마 보강은 기존 DB의 persona_voice_map 누락도 함께 복구한다.
12차 적용(2026-06-27): 회기 리뷰 데스크톱 레이아웃은 sticky 요약 레일을 유지하되 트랜스크립트가 같은 컬럼을 공유하지 않도록 재배치했다. 왼쪽 요약 문장은 보조 브리핑 밀도로 낮추고, 축어록은 중앙 근거 작업대에 고정해 스크롤 중 레일이 발화 내용을 가리지 않게 했다.
13차 적용(2026-06-27): 회기 리뷰의 적절한 개입 등 평가 콜아웃은 제한 markdown을 기본 렌더링한다. effective_openness는 effective openness(유효 개방도)로 학술 용어화하고, 상담자 질문 발화는 ReviewNote.quote 인용 블록으로 분리해 카드 내부에서 시각화한다.
14차 적용(2026-06-27): 활성 상담 세션은 시작 직후 실제 session_id URL로 고정해 새로고침 후에도 같은 회기 상세를 복원한다. 전역 topbar는 몰입형 화면에서 계속 숨기되, 내부 세션바에 기록으로/학습 홈 이동을 추가했다. 종료된 세션 상세도 곧바로 리뷰로 밀어내지 않고 읽기 전용 기록 화면에 머물며, 리뷰 이동은 명시 버튼으로만 수행한다.
15차 적용(2026-06-28): 학습자·교수자·운영·페르소나 스튜디오 화면을 같은 작업형 폭 정책으로 정렬했다. 교수 콘솔은 검토 대기·위기 알림·페르소나 검수·저작실 순서가 DOM과 화면 모두 일치하고, 페르소나 스튜디오는 SSOT 첨부/RAG 생성/항목 편집/검증 큐가 한 작업면에서 이어지는 구조로 유지한다. 적용 리포트와 대표 캡처는 docs/ops/layout-research-2026-06-28/dashboard-layout-alignment-report.md에 남겼다.
래스터만 사용이미지 생성 도구 산출물은 PNG 기반 시안이다. SVG·벡터·와이어프레임·로고 시트로 해석하지 않는다.
기능 우선메인 라우트의 실제 액션과 정보 구조를 먼저 반영한다. 장식은 기능을 가리지 않는 수준에서만 쓴다.
온화하지만 임상적종이 질감, 낮은 채도, 차분한 빛은 허용하되 상담 훈련 도구의 신뢰감을 먼저 세운다.
반응형 세트각 핵심 화면은 한 장 안에 PC·태블릿·모바일을 함께 배치해 전환 규칙을 비교한다.
| 화면 | 추출한 핵심 기능 | 디자인 의도 |
|---|---|---|
| 로그인/진입 | Google OAuth, 허용 도메인 안내, 로컬 역할 선택, 교육용 비치료 고지 | 신뢰·보안이 먼저 보이는 조용한 진입 화면 |
| 학습자 홈 | 학습 요약, 진행/리뷰 가능 회기, 마지막 세션 리캡, Live2D 감정 힌트, AI 코치, 학습·기록 드릴다운 | 오늘 이어갈 회기와 학습 상태가 먼저 보이는 개인 대시보드 |
| 상담 세션 | 회기 단계, 내담자 컨텍스트, 아바타, 음성 오브, 실시간 자막, 텍스트 폴백, 안전 점검 | 화면 중심은 내담자, 피드백은 조용한 신호 |
| 회기 리뷰 | 요약, 감정 밸런스, 회기 흐름, 축어록, 기법 태그, 개선점, 오디오/PDF | 점수 폭격이 아니라 근거 기반 회고 |
| 교수 콘솔 | 리뷰 대기 큐, 코호트 현황, 페르소나 검수, 종료 회기 목록 | awareness보다 triage에 가까운 교수자 작업대 |
| 관리자 콘솔 | 운영 홈: 교육 진행·온라인 사용자·헬스 샘플 이력·AI 비용·운영 티켓 요약. 하위 메뉴: 사용자 관리, 접근 권한, 운영 티켓 처리 큐 | 상태 관측과 관리 작업을 분리한 실제 운영 콘솔 |
| 설정 | 계정, 관리자 AI 운영 설정, 테마, 음성 프리셋, 속도, 알림 | 역할별 설정만 보이는 조용한 환경 관리 |
| 이미지 요소 | 종이 질감, 상담실 책상, 노트, 식물, 부드러운 빛, 패턴, 아바타 분위기 | UI 뒤에서만 느껴지는 따뜻함과 반구상 내담자 톤 |
로그인/진입OAuth, 허용 도메인, 로컬 역할 선택, 교육용 고지를 신뢰 중심으로 정리한 진입 화면.
01-login-responsive.png
학습자 홈내담자 선택, 회기 시작, 이전 회기 이어가기, 리뷰 가능 상태를 작업대처럼 배치.
02-learner-home-responsive.png
학습자 대시보드 재설계회기 리캡, AI 코치, 이어하기 CTA를 첫 화면의 단일 결정 영역으로 묶음.
11-learner-dashboard-redesign-concept-b.png
학습자 대시보드 대안마지막 내담자 반응과 내 마지막 반응을 더 강하게 드러낸 대안 레이아웃.
12-learner-dashboard-redesign-concept-b-alt.png
라이브 상담 세션내담자 무대, 자막, 입력, 라이브 신호, 안전 상태를 몰입형 훈련 화면으로 구성.
03-session-responsive.png
회기 리뷰감정 흐름, 축어록, 기법 태그, 교수자 콜아웃을 근거 기반 회고 화면으로 묶음.
04-session-review-responsive.png
교수 콘솔리뷰 대기, 코호트 현황, 페르소나 검수, 종료 회기를 triage 중심으로 배치.
05-professor-responsive.png
관리자 콘솔운영 홈은 서비스 상태 관측에 집중하고 사용자·권한·티켓은 별도 메뉴로 분리. 티켓과 헬스 샘플은 DB 기반 1차 모델을 사용.
06-admin-responsive.png
설정계정, AI 운영, 테마, 음성, 알림을 역할별로 노출하는 차분한 설정 화면.
07-settings-responsive.png
온화한 이미지 요소종이 질감, 상담실 책상, 노트, 식물, 낮은 채도의 빛을 UI 보조 요소로 정리.
08-warm-visual-elements.png
아바타/패턴 요소반구상 내담자 분위기와 배경 패턴 방향. 실제 페르소나 아이덴티티는 별도 제작 기준을 따른다.
09-avatar-pattern-elements.png상태 보드
현재 추적 중인 작업을 카드로. 요약만 노출되고, 상세 근거·검증 로그는 카드를 펼쳐야 보인다. 필터로 "내 차례"·블로커만 추려 볼 수 있다.
한신대 PDF 정합성 · 이번 세션 발견
원천 기술분석 PDF(트웬티온스×한신대, 19쪽) 전수 정독 대조 (2026-06-27)현재
PDF가 차별 기술로 꼽은 '저항·반응 조절'(AI가 너무 착하지 않게, 실제 환자처럼)·상태머신(라포→탐색→개입→정리)·RAG(자료검색)·이론모드(인간중심/CBT)·답변과 분리된 가드레일·SSE 스트리밍·React19·피드백 JSON Schema 강제(벤더중립)가 이미 구현·정렬됨. Stanford RCT(피드백 없는 연습=역효과)도 H2 턴평가로 충족 방향.
권고
이 코어를 '교육용(비의료)' 포지션으로 유지. 평가는 교수자 검토용 보조지표로 표기.
현재
라이브 테스트에서 수련생이 내담자를 "수동적 패배자"라 비난·조롱("웃음이 나오십니까")해도 민재가 공손히 흡수 → 훈련 가치 훼손. 수정: ① L0에 무례·모욕·조롱·인신공격 시 현실적 동맹 균열(위축·방어·따지기·종결의향) 지침 ② PersonaCard.triggers(역린) 필드 + CCD 핵심상처 파생 역린 블록(상담자가 핵심상처를 조롱·확정·강요·평가절하 시 가장 강한 반응). PDF '저항·반응 조절' 핵심 차별 강화. 무회귀 77/77.
잔여
P1~P3 명시 triggers는 임상팀 정밀 저작(현재 CCD 파생 기본값으로 작동). 라이브 재현 검증.
현재
PDF(9·16·18쪽): 자해·자살 감지 시 대화 중단 + 자살예방상담 109 안내 + 지도교수 자동 알림, 안전은 LLM 밖 별도 CrisisGate. 구현: CRISIS_HOTLINE_NUMBER=109, TurnResponse.crisis_resource/conversation_stopped, REST·SSE·voice 경로의 엔진 호출 전 중단, app.safety_events detail 적재, 교수자 대시보드 안전 알림 큐.
검증
pytest app/test_session_turn_persistence.py app/test_voice_ws.py -q 20 passed, 안전 이벤트 DB insert payload 테스트 포함. pytest app/test_teacher_dashboard.py app/test_session_turn_persistence.py app/test_voice_ws.py -q 21 passed.
잔여
비밀보장 예외고지·생명유지서약 등 임상 문안, 실시간 push/메일 알림, 지역 자원 확장, 운영 정책 문구는 소유자·임상팀 확정 필요. 현재 교수자 알림은 safety_events 기반 대시보드 큐다.
현재
TeacherDashboardResponse.learner_growth를 추가해 턴별 fast-loop 평가의 appropriateness, rapport_signal, 기법 태그를 학습자별로 집계한다. 교수 콘솔은 학습자별 성장 카드, 회기별 막대 추이, 평균 라포, 변화폭, 최근 회기 점검 포인트를 표시한다. 평가가 없는 회기는 "평가 부족"으로 남겨 가짜 곡선을 만들지 않는다. 종료 회기 리뷰 대기 행은 /teach/session/{id}/review로 진입해 같은 회기 리뷰를 교수자 읽기 전용으로 열고, 워크시트는 학습자 제출물 수정 없이 검토 전용으로 표시한다.
검증
pytest app/test_teacher_dashboard.py app/test_session_turn_persistence.py app/test_voice_ws.py -q 21 passed, pytest app/test_rbac_idor.py app/test_teacher_dashboard.py -q 9 passed, npm run check:api-types, npm run typecheck, npm run build passed. npx playwright test e2e/teacher.spec.ts --project=chromium-single-run --workers=1 4 passed.
잔여
자기효능감·기술숙련도·수련만족도 사전사후(H1)와 교수자 코멘트/검수 워크플로 확장은 별도 평가설계·임상팀 문항 확정이 필요하다.
현재
교수자/관리자는 /sessions/{id}/review를 읽을 수 있고, 학습자 워크시트 저장은 learner 전용으로 유지한다. 교수자 검토 상태는 app.session_review_status에 review_status, review_note, reviewed_at로 저장되며, teacher dashboard 응답과 SessionReview가 이 값을 표시한다. PUT /teacher/sessions/{session_id}/review-status는 교수자 메모 저장과 검토 완료 처리를 담당하고, 검토 완료된 회기는 pending queue에서 제외한다.
검증
pytest app/test_teacher_dashboard.py app/test_rbac_idor.py app/test_learner_dashboard.py -q 12 passed, npm run check:api-types, npm run typecheck, npm run build, teacher.spec.ts 4 passed. 교수 콘솔 검토 큐 노출과 학습자 리뷰의 교수자 전용 빈 grid 제거는 E2E/시각 게이트로 재검증했다.
잔여
임상 루브릭·최종 검수 기준은 외부 정의 전까지 완료 처리하지 않는다.
현재
교수자 성장 집계와 중복되던 점수·라포·기법 계산을 app.services.session_metrics로 공용화했다. GET /sessions/dashboard는 학습자 본인 세션만 집계해 overview, growth, persona_progress, achievements, recent_feedback를 반환하고, LearnerHome은 누적 회기·리뷰 대기·최근 평가·라포 흐름·페르소나별 진행·최근 피드백·마지막 세션 리캡을 실제 서버 데이터로 보여준다. 성취는 공식 수료/등급이 아니라 실제 연습 milestone만 사용한다.
검증
pytest app/test_learner_dashboard.py app/test_teacher_dashboard.py app/test_rbac_idor.py -q 12 passed, npm run check:api-types, npm run typecheck, npm run build, learner.spec.ts 6 passed, session-review.spec.ts 2 passed, layout-visual-gate.spec.ts 7 passed, session-layout.spec.ts 4 passed.
잔여
UX 감사 기준으로 2차에서는 카드 격자 비중을 줄이고 게이지·small multiples·테이블 중심으로 정리해야 한다. 모바일에서 임상 요약을 단순 숨김 처리하는 부분도 접힘/요약으로 바꾸는 게 맞다.
현재
① PDF: 고성능(Claude·GPT=내담자발화·실시간평가)/저비용 한국어(Solar=단순응답·사후요약) 2단계 + 캐싱 90%절감. 현재 client AI는 claude_cli 기본 라우팅, fast/deep evaluator는 EVALUATOR_FAST_MODEL/EVALUATOR_DEEP_MODEL 설정 시 모델 override를 gateway에 전달한다. 벤더중립 인터페이스와 L0~L2 cache hint/session reuse는 있음. ② 백엔드 방향은 Node.js 우선 교체 가능성으로 정했다. 단, 현재 Python/FastAPI는 납품 핵심 경로라 전면 재작성하지 않고, 계약 경계를 먼저 고정해 갈아치울 수 있게 만든다.
권고
2-tier는 evaluator 모델 override 이후 client AI/요약 모델 정책과 semantic cache로 점진 도입. Node 전환은 engine_gateway, persona DTO/mapper, session read-model처럼 런타임 경계가 명확한 부분부터 strangler 방식으로 진행한다.
현재
이번 점검 범위인 SEO/GEO 공유 카드, 온보딩 반영 E2E, 학습자 홈, 회기 시작/종료, 리뷰 공유 버튼, 음성 성공 경로, 레이아웃 회귀는 npm run e2e 113 passed + npm run typecheck/npm run build로 닫았다. 공개 API와 Tailnet 스모크도 녹색이고, 패키징 점검에서 더미 운영 env 기준 Docker compose fresh smoke도 통과했다. 과거 focused suite와 Phase 3 evidence는 별도 행의 과거 증거로 유지하되, 이번 완료 증거와 섞어 과장하지 않는다.
다음
남은 원천문서 갭, 임상 루브릭/최종 평가설계, public Google OAuth 실제 /turn, 배포지 운영 비밀값 주입을 순서대로 닫는다.
원천문서 갭 분석
산학협력 원천문서 5종 정독 + 코드 교차조사 (2026-06-26). 근거: source-docs-gap-analysis-2026-06-26.md · critical 3 / high 4 / medium+ 6현재
doc1/4/5가 1급 산출물로 요구하는 워크시트 축(탐색 11항목·호소 5영역·인지삼제·1/2차 감정·보호/방해 4사분면·생물심리사회 목표)을 SessionReviewResponse.caseWorksheet로 노출한다. 서버는 저장된 축어록만 근거로 규칙 기반 초안을 만들고, 프론트 리뷰 화면은 근거 턴으로 점프 가능한 워크시트를 편집할 수 있다. 저장본은 PUT /sessions/{id}/review/worksheet → app.case_worksheet에 저장되고, 이후 GET /review는 saved_by_learner 워크시트를 자동 초안보다 우선 반환한다.
검증
pytest app/test_session_turn_persistence.py app/test_rbac_idor.py -q 25 passed, npm run check:api-types, npm run typecheck, npm run build passed. 로컬 API smoke: 세션 생성→워크시트 저장→GET /review가 saved_by_learner:local smoke saved worksheet 반환.
잔여
임상팀 루브릭, AI 추출/채점 고도화, 교수자 검수 플로우는 후속이다. 현재 초안/저장본은 숨은 정답키나 임상 점수 없이 학습자 편집 산출물로만 취급한다.
현재
prepare_turn→state_machine.evolve에 crisis.risk_level을 ideation_observed로 전달(위기 관측 상태머신 반영). escalate=True 시 REST·SSE·voice가 엔진 호출 전 중단하고 app.safety_events에 109 resource와 conversation_stopped를 적재한다. 교수자 대시보드는 이 레코드를 안전 알림 큐로 표시한다. 안전 이벤트 insert payload는 test_record_safety_event_writes_teacher_alert_payload로 회귀화했다.
잔여(임상팀)
비밀보장 예외고지·단계적 탐색·생명유지서약 스크립트 콘텐츠 + 실시간 교수자 push/메일 + 위기탐색 누락 회기리뷰 감점.
현재
TurnContext+prepare_turn에 theory_mode, sessions/voice가 sess.theory_mode 전달, evaluator._theory_mode가 세션 이론(학습자 선택) 우선. build_turn_messages도 THEORY_MODE_GUIDANCE를 통해 인간중심·CBT·통합 이론 프레이밍을 엔진 메시지에 넣는다. 프론트 Session.tsx 'humanistic' 하드코딩 제거→persona.theory_target 기준(CBT 페르소나는 cbt). 회귀: test_prepare_turn_threads_theory_mode_into_engine_messages 포함 focused 20 passed.
잔여(임상팀)
CBT 이론별 단계 프롬프트 체인 콘텐츠 + 이론부합 채점 루브릭 + 프론트 이론 선택 UI(현재 persona 설계 이론 자동).
현재
doc4가 20명 실험/통제군·단회기 50분·3척도 pre-post를 못박았으나 코드 0건. Phase3 KPI도 report shape만, 계산 코드 0줄. (κ/ICC·환각률은 doc4 미명시 — 평가설계 문서 확정 필요.)
권고
3척도 pre-post 폼·실험/통제군 배정·자동누적 대시보드·추이 시각화·검정 계산 코드. 평가설계는 소유자 결정.
현재
텍스트 /turn·/stream·음성 경로에서 fast-loop 턴 평가를 app.feedback_scores, app.turn_technique, app.turn_client_state, app.supervisor_comment, app.alternative_utterance로 정규화 적재 후 리뷰 조회에서 hydrate한다. 이번 패스에서 app/services/live_coach.py, data/kb/live_coaching_workbook_0615.json, data/kb/live_coaching_sources/*.json, POST /sessions/{id}/live-coach, GET /sessions/{id}/live-coach, POST /kb/live-coach/source-packs/sync, app.live_coach_events를 추가했다. 세션 UI는 코칭 모드에서 AI 코치 아바타 말풍선으로 즉시 개입하고, "근거 보기" 모달과 학습자 발화 우측 C 마커를 통해 받은 코칭 이력을 채팅 위 스크롤 오버레이로 보여준다. 저장 payload는 PII 마스킹 excerpt + 코칭 구조화 JSON이며, 공식 자료는 허가된 source pack의 version/citation/summary로 넣고 장문 원문·공식 문항을 재현하지 않는다. 같은 source pack은 관리자 sync로 evaluator 전용 RAG에 증분 색인한다.
검증
python -m compileall app -q, pytest app/test_live_coach_sources.py app/test_orchestrator_masking.py app/test_session_turn_persistence.py -q 27 passed, npm run generate:api-types, npm run check:api-types, npm run typecheck, npm run build, npm run e2e -- e2e/layout-visual-gate.spec.ts e2e/session-layout.spec.ts 15 passed. 로컬 DB smoke: source pack sync 4 sources/15 chunks embedded, 재호출 skipped_unchanged=4, official_suicide_risk_guidelines source filter 검색 성공.
잔여
임상팀 골든셋·라이브 코칭 루브릭 검수, 회기리뷰 2열 UI 고도화, 공식 지침/논문 source pack 추가와 버전 운영정책 보강이 남아 있다.
현재
teacher/admin 전용 /teach/personas를 3열 스튜디오로 추가했다. 좌측은 저작 흐름·검수 큐·공개 카탈로그, 중앙은 RAG 자료 등록과 개요/임상/저항/회기/말투/안전/프롬프트 항목형 편집 탭, 우측은 검증·생성 근거·승인/반려 결정이다. 교수 콘솔은 진입점과 triage만 맡고 저작 본체는 스튜디오가 맡는다. 2026-06-27 UI 정리에서 중복 네이티브 파일 입력을 커스텀 SSOT 첨부 드롭존으로 교체하고, 저작 스테퍼·탭별 작성 가이드·검증 dot 정렬을 보강했다. 레이아웃 근거와 생성 시안은 docs/ops/layout-research-2026-06-27/persona-dashboard-layout-guideline.md에 묶었다. POST /personas/sources는 첨부/붙여넣기 자료를 PII 마스킹 후 kb.source/document/chunk에 evaluator 전용(visible_to=['evaluator'], sensitivity=2) 근거 문서로 등록한다. POST /personas/drafts/generate는 source_id 기반 RAG 검색 결과만 엔진에 넘기고, draft source_provenance와 응답에 source id·doc/content hash·chunk id를 남긴다. 승인된 카드만 학습자 catalog에 노출되는 경계는 유지하되, P1~P7 시스템 페르소나는 DB 저작 카탈로그의 초기 부트스트랩으로 승격했다. 교수자는 공개 목록의 수정으로 승인본을 같은 persona_id의 다음 버전 draft로 복제해 편집하고, 삭제는 기존 회기 FK를 지키기 위해 같은 code family를 archived로 보관 처리한다. 기동 materializer는 누락분만 insert하고 기존 편집/archived row를 덮어쓰거나 되살리지 않는다.
검증
python -m pytest app/test_persona_review.py -q 31 passed, npm run generate:api-types, npm run check:api-types, npm run typecheck, npm run build passed. PersonaStudio 공개본 수정/삭제 E2E: npx playwright test e2e/teacher.spec.ts --project=chromium-single-run --workers=1 6 passed, layout-visual-gate.spec.ts chromium-single-run 8 passed, session-layout.spec.ts desktop/mobile 8 passed.
잔여
원문 격리본(sensitivity=3) 별도 보관, source/version 전용 마이그레이션 runner, prompt-bundle version pinning, 임상팀 최종 검수/서면 evidence, 루브릭·이론 콘텐츠 외부화는 후속이다. 임상팀이 제공하지 않은 페르소나 내용을 최종 승인본처럼 확정하지 않는다.
현재
정규식 폴백에 한국어 고위험 패턴 추가: 구체 날짜(2001.4.18→[DATE])·금액(1200원→[MONEY])·행정구역 주소(서울시 강남구 역삼동→[ADDR]). 상담 생성(generate/stream)·fast/deep 평가의 외부 LLM 호출 직후 audit.llm_call_log에 provider/model/token/cost/inference_geo/latency만 적재한다. prompt/completion 본문은 저장하지 않는다. 로컬 dev-login 실제 /turn smoke에서 audit.llm_call_log가 8→11로 3행 증가했다. 이번 패스에서 app_user에 이름·소속·학과·학년/직위·연락처·주소/수령지·닉네임·자기소개·아바타 URL·약관/개인정보 동의 시각·버전을 추가했다. 로그인 후 onboarding_completed_at이 없으면 전역 OnboardingGate가 /onboarding 외 URL(/learn, /settings, /admin, /dev/avatar-preview, /login 포함)을 모두 온보딩으로 돌리고, 온보딩 중에는 공용 셸 메뉴 없이 가입 직후 사용자 정보 입력 폼만 보여준다. learner 회기 시작도 온보딩 완료 전에는 막는다. /users/me/avatar는 PNG/JPG/WebP MIME·시그니처·3MB 제한 후 파일을 USER_UPLOAD_DIR/profile-avatars에 저장하고 URL만 보관한다. 약관·개인정보 처리방침 초안은 /users/legal-docs에서 제공한다. 관리자/교수자 권한은 온보딩에서 받지 않고 allowlist/관리자 사용자 관리로만 부여한다. 검증: pytest app/ -q 178 passed, pytest engine_gateway/ -q 11 passed, npm run check:api-types, npm run typecheck, npm run build, auth E2E 7 passed, 최종 PLAYWRIGHT_PORT=5174 npm run e2e 113 passed.
잔여
이름/기관명은 NER 필요(Presidio ko 모델·spaCy ko, 무거움 — TODO 명시). 미성년/guardian 및 법무 검토가 필요한 최종 서명 동의서·개인정보 처리방침·약관 evidence는 외부 게이트다. 공개 Google OAuth 실제 /turn proof는 별도 운영 게이트.
현재
M1: voice learner turn의 audio_ref, silence_ms, speech_rate, barge_in을 리뷰 API nonverbal 이벤트로 파생하고, 회기 리뷰 축어록에 침묵·발화 속도·끼어듦·음성 입력 칩으로 표시한다. 한숨·울음 감지와 live 마이크/STT/TTS 실측은 아직 별도다. M2: case_profile을 learner-persona 안정 case로 upsert하고, session_no를 트랜잭션 안에서 원자 증가시키며, 시작/턴/voice 경로가 직전 session_summary 기반 seed recall을 사용한다. episodic embedding writer와 case_digest/pinned_fact 실적재는 후속. M3: Google/SAML/dev-login이 AUTH_EMAIL_COHORT_MAP/AUTH_DOMAIN_COHORT_MAP 및 SAML cohort claim을 cohort_ids로 전달하고, DB app_user.external_id는 provider subject(google:/saml:/dev:) 기반으로 저장한다.
권고
M1 한숨·울음/억양 등 provider 이벤트 보존, M2 session_summary digest/pinned_fact 압축·embedding writer·case_profile trajectory 갱신, M3 운영 SAML 서명검증·기관 claim schema/test tenant·deprovisioning audit는 외부 IdP 협의 후 진행.
현재
X1: scripts/export-recursive-dataset.py와 app.services.dataset_export로 masked-text JSONL dry-run, PII scan, κ/ICC 계산, approved export 게이트를 구현했다. 기본은 technical_dry_run이고 ds.* write는 --write-dataset 명시 시에만 수행한다. X2: app.turns의 provider/model/tokens/cost를 최근 7일 기준으로 집계하는 GET /admin/usage를 추가했고, 운영 콘솔 /admin에 누적 비용·입출력 토큰·계량 커버리지·provider/model breakdown과 ADMIN_USAGE_BUDGET_USD 기반 예산 경고(ok/warn/exceeded)를 표시한다. EVALUATOR_FAST_MODEL/EVALUATOR_DEEP_MODEL 설정 시 fast/deep 평가 호출만 해당 모델 override로 gateway에 전달하고, 비워두면 기존 default 라우팅을 유지한다. DB 미가용 dev에서는 runtime store로 fallback하지만 prod에서는 fail-closed한다. L1: 소유자 결정으로 Node.js 우선 교체 가능성 방향을 채택했다. docs/decisions/backend-node-transition.md에 FastAPI 유지 사유와 strangler 전환 원칙을 기록했고, app/contracts/engine_gateway.py를 추가해 Python client와 현재 gateway가 같은 요청/응답/SSE 계약을 공유한다.
권고
X1 approved export·골든셋 승격은 steward/legal 승인, reviewer disposition, IAA 게이트(κ≥0.6/ICC≥0.75) 이후만 진행한다. X2 후속은 semantic cache·장기 비용 추이/한도 정책·운영 모델별 비용 검증이다. L1의 남은 게이트는 신청서/저작권 등재 문서에 FastAPI 유지 사유와 Node 전환 계획을 반영하는 외부 거버넌스 증거다.
즉시 착수 가능(내부 코드, 외부 합의 불요)
- C1은 저장형 워크시트까지 2차 완료. C2/C3/H2/H3은 1차 구조 완료. 후속은 임상 스크립트, CBT 체인, 2열 리뷰 UI, 페르소나 항목형 저작 UI처럼 데이터·정책·UI 고도화 영역이다.
- H4(부분): 한국어 정규식 마스킹, metadata-only LLM call audit 경로, 로컬 live row proof, learner 동의 수락/철회/회기 시작 하드게이트 골격은 완료. 남은 내부 후보는 이름/기관 NER이고, guardian/legal 서명 동의 evidence는 외부 게이트다. X1 dry-run export 1차와 X2 비용 관측·예산 경고/evaluator 모델 override 1차는 완료, X2 semantic cache는 후속. M1/M2/M3 1차는 완료, provider 기반 한숨·울음 감지와 case_digest/pinned_fact 실적재, 운영 SAML 서명검증은 후속.
소유자 결정 / 외부(임상팀·기관) 의존
- 임상팀 산출물: C1 워크시트 항목·루브릭, C3 CBT 콘텐츠·체인, C2 위기 스크립트·서약 문안, H2 골든셋 코딩.
- 소유자 평가설계: H1 실험/통제군·3척도 문항·50분 흐름, κ/ICC·환각률 목표(doc4 미명시).
- 기관(한신 IT): M3 SSO IdP·test tenant·claim 스키마·인증서, 거버넌스 증거.
- 거버넌스: L1 Node 전환 방향은 결정됨. 남은 것은 FastAPI 유지 사유와 계약 우선 전환 계획의 저작권 등재 문서화·IP 협의.
판독 한계 (정직성)
- 핵심 축어록 2단 표는 PDF 시각 판독이 1차 근거(txt 일부 누락), OCR 잔재 존재.
- doc4 κ/ICC·환각률은 신청서 본문 미명시 — 계약 확정 지표로 단정 금지.
- '현재상태'는 grep/코드 사실 기반. C1~C3·H2·H3은 직접 재확인(✓), 그 외는 착수 전 코드 1차 재확인 권고.
코드품질 · 로컬 개발 스택
리팩토링 연구 + 1-커맨드 dev 스택 (2026-06-26~27). code-quality-research-2026-06-26.md · local-development.md현재
게이트웨이(9099 claude_cli)+API(8000, DB 미가용 시 in-memory degraded)+웹(5173)을 커맨드라인 기준 정리 후 결정론적 기동(--reload 워처 불안정 회피, uvicorn 있는 python 자동 해석). Docker가 사용 가능하면 vignette-dev-db healthcheck/pg_isready/role safety를 점검하고, compose infra\.env 필수값 누락도 경고한다. -NoGateway/-NoWeb는 해당 컴포넌트 정리도 건너뛰고, API 정리는 지정 -ApiPort만 대상으로 한다. dev-login + seed 페르소나. 로그 .devlogs/(gitignore). 검증: 3포트 health OK + 실제 AI 턴 생성·회기리뷰 동작, API-only 재기동 후 8001/8010/5173/9099/20241 보존.
비고
AI 턴은 로컬 claude CLI 사용(사용량 발생). 진입점 http://localhost:5173. dev-down.ps1은 기본적으로 DB 컨테이너를 보존하고, -Db 지정 시 함께 중지한다. 기존 vignette-dev-db는 accepting connections이나 healthcheck가 없고, vignette_app은 NOBYPASSRLS로 존재한다. 이번 패키징 smoke에서 fresh compose DB는 owner/app role 분리 상태로 API healthy까지 통과했고, 기존 dev DB의 운영 role 전환은 별도 owner migration 확인 후 진행한다. 주의(무DB 한정): DB 없이 degraded면 페르소나가 source:seed_fallback·degraded:true라 프론트 isUsablePersona가 막아 "회기 시작" 버튼이 비활성 → UI 세션 시작엔 실제 Postgres(127.0.0.1:55432)가 필요.
현재
직접 WS 재현으로 근본원인 규명: 키 없으면 백엔드가 degraded+1011 즉시 close → 마이크 깜빡·녹음 미도달. 현재 로컬 /voice/health는 available:true이고, 실제 P2 회기에서 MP3 발화를 /voice/ws로 보내 STT transcript 52자 → client reply 105자 → TTS 바이너리 66 chunks/266,496 bytes를 수신했다.
부수 수정
① 미설정 시 마이크 버튼 사전 비활성+명확 안내 ② TTS 지문 제거: (고개 끄덕)·（한숨）·[침묵] 등 무대지시를 음성으로 안 읽음(speakable_text, 자막엔 유지) ③ 아바타 애니메이션: 텍스트 턴 speaking 시 입 정지(0) 버그 수정 + thinking 표현 보강 ④ 브라우저 자동재생 차단 대응: 마이크 클릭 시 AudioContext.resume()으로 unlock하고 TTS Blob을 Web Audio buffer source로 재생, 실패 시 기존 <audio> fallback. typecheck+voice테스트+voice E2E+live WS smoke PASS.
증상
라이브 회기에서 내담자(민재)가 "저는 Claude Code인데… Vignette 코드베이스… git status…"로 캐릭터를 깨고 개발 맥락 노출. 원인: ENGINE_MODE=claude_cli가 로컬 claude(=Claude Code)를 호출하는데 게이트웨이가 페르소나를 --append-system-prompt로 코딩 어시스턴트 정체성에 덧붙이고, cwd=repo라 CLAUDE.md·git status·env가 시스템프롬프트에 포함됨.
수정·검증
engine_gateway/gateway.py: --append-system-prompt→--system-prompt(페르소나만 교체 주입) + --exclude-dynamic-system-prompt-sections(cwd/env/git/메모리 섹션 제거). 라이브: 깨던 입력 그대로 → 민재 완벽 인캐릭터, 누출 0. 게이트웨이 7/7 + 전체 API 119 passed.
현재
app/turn_runtime.py를 추가해 load_owned_session, record_completed_turn, append_completed_turn, update_session_state, record_safety_event를 공통화했다. 이번 패스에서 finalize_completed_turn을 추가해 record_completed_turn + record_safety_event 호출쌍을 REST submit/stream과 voice WS 라우트에서 제거했다. stream fast-loop 평가 누락, voice 세션 recall cache, visible_to/evaluator turn 분리는 보존.
검증
pytest app/test_session_turn_persistence.py app/test_voice_ws.py engine_gateway/test_gateway_model.py app/test_phase3_artifact_checker.py app/test_dataset_export.py -q 40 passed.
잔여
더 큰 finalize_turn/SessionRepository 경계, 장기적으로는 세션 저장소 인터페이스 SSOT화가 남아 있다.
현재
apps/api/scripts/export-openapi.py와 apps/web/scripts/generate-api-types.mjs로 FastAPI OpenAPI를 apps/web/src/lib/api.gen.ts에 생성한다. npm run check:api-types가 재생성 누락을 잡는다. MeResponse, AuthConfigResponse, ConsentResponse, PersonaSummary, PersonaReviewSummary, admin/user/engine DTO, review leaf DTO, CrisisResourceResponse, teacher safety/growth leaf DTO, LearnerSessionsResponse, SessionReviewResponse, worksheet aggregate, TeacherDashboardResponse, TeacherSessionSummary, TeacherLearnerGrowth에 이어 SessionStartResponse, SessionDetailResponse, SessionDetailTurn도 ApiSchema<...> alias로 전환했다. 세션 응답 stage는 backend StageLabel enum으로 고정해 OpenAPI가 라포|탐색|개입|정리 union을 생성한다. generated optional/default 차이는 화면 form state, notification default helper, 배열 렌더링 fallback으로 흡수한다. .github/workflows/api-contract.yml은 PR/master push에서 같은 stale check를 실행해 OpenAPI type drift를 CI에서 막는다.
검증
npm run check:api-types, npm run typecheck, npm run build passed. python -m pytest app/test_session_turn_persistence.py -q 16 passed. 영향 범위 E2E: learner.spec.ts + session-review.spec.ts + teacher.spec.ts + layout-visual-gate.spec.ts 32 passed.
잔여
평가 조회·리뷰 도식·교수 콘솔 등 아직 자유 문자열로 남긴 stage-like 필드는 각 도메인 의미를 확인한 뒤 별도 축소한다.
현재
apps/web/index.html에 canonical, description, Open Graph/Twitter Card, JSON-LD(WebApplication)를 추가했고, public/robots.txt, sitemap.xml, llms.txt로 공개 사이트와 AI 검색용 설명을 정리했다. 인증 내부 경로는 robots에서 차단한다. 학습자 회기 리뷰는 종료 후 POST /sessions/{id}/share로 공개 토큰을 만들고, GET /share/session/{token}이 서버 렌더 HTML/OG/JSON-LD를 반환한다. app.session_share_link에는 토큰 해시와 sanitized preview payload만 저장하며 원문 축어록·학습자 식별자는 저장하지 않는다.
검증
pytest app/test_session_share.py app/test_session_turn_persistence.py -q 21 passed, python -m pytest app/ -q 178 passed, python -m pytest engine_gateway/ -q 11 passed, npm run check:api-types, npm run typecheck, npm run build passed.
판정
공개 제품 페이지는 색인 가능, 회기 공유 페이지는 교수자 전달용 unfurl 카드라 noindex와 API robots Disallow: /share/를 유지한다. 실제 공개 도메인 unfurl 검증은 배포 후 1회 필요하다.
현재
LogHook/log_hook(caller 0) 타입·파라미터·분기·export 제거 · 게이트웨이/엔진클라 tier dead-contract 제거(write-only, gateway는 model만 사용). 잔여(RMS 힌트·Live2D 고아 자산·파라미터객체 init_state/prepare_turn/upsert)는 docs/ops/refactor-rag-patches-2026-06-26.{md,json}에 스테이징(단계 적용).
참고
일괄 적용 대신 라이브 스택 보호 위해 그룹별 적용+pytest 검증.
현재
임베더 BGE-M3 검증+버전핀(1.4.0 dtype버그→1.2.11/transformers 4.44.2). embed_query를 asyncio.to_thread로 offload. 턴 파이프라인 배선: retrieve_persona_memory→episodic recall, search_kb→kb_behavior_cues. KB seed 3청크 적재. rag.py latent 버그 3건 수정. GraphRAG는 2차 보류.
성능 회귀 수정
최초 RAG 배선이 회기 시작/턴에 임베더 로드(~7-13s)를 동기 await해 POST /sessions가 막힘 → session-layout E2E 4건 타임아웃. 수정: 회상·KB 회수를 _warm_rag_caches 백그라운드 task로 옮기고 턴은 캐시만 읽음(비차단). 이번 동의 게이트 E2E 재검증 중 여러 세션 warm task가 BGE-M3를 동시에 지연 로드해 API health/dev-login timeout이 반복된 문제는 embedder load/encode RLock과 warm semaphore 1개로 안정화했다. 재검증: session-layout 4/4 + 핵심 E2E 27/27·11/11·아바타 4/4, 최신 layout/session 조합 11/11 통과.
시각 게이트
admin 1280 input "text-clipped-x" 1건은 폼 input 값 스크롤(설계상 정상) 오탐 — form 컨트롤을 text-clip 판정에서 제외 → 게이트 7/7(실 결함 검사 유지).
심층 상세 · 검증 로그
로드맵 단계표, 단계별 상세 작업·검증 명령 표, 이번 세션 내러티브. 기본 접힘 — 필요할 때만 펼쳐서 본다.
전체 개발 로드맵 (5단계)
Phase 0closing
기반 정렬 / 운영 안전장치
인프라, 인증 경계, fail-closed, 공개 배포, 회귀 테스트 안정화.
- 상태: 대부분 완료, 공개
/turnproof만 남음 - 검증: build + backend 84 + Playwright 72
- 운영: prod API 8001, engine 9099, tunnel 1개
Phase 1next
MVP 코어 루프
1 페르소나 상담, 실제 턴 저장, 회기말 피드백, 저항 엔진 검증.
- DoD: 로그인 → P1 상담 완주 → 피드백 수신
- 추가: 음성 왕복 1턴 PoC 포함
- 증거: cost/turn DB 적재 + openness 곡선 대조
Phase 2aplanned
3역할 / OAuth / 페르소나
학습자, 교수자, 관리자 권한 분리와 페르소나 확장.
- DoD: 타인 session 직접 접근 403
- 범위: OAuth BFF, RBAC, 교수 검수 루프
- 주의: visible_to와 인간 권한은 별도 레이어
Phase 2bplanned
음성 캐스케이드
STT → 엔진 → TTS 왕복, WSS/터널 안정성, barge-in 로깅.
- DoD: 50분 WSS 끊김 실측
- 범위: Deepgram STT, OpenAI TTS, voice preset
- 리스크: 실시간 레이턴시는 실측 전 완료 표기 금지
Phase 3planned
교육용 파일럿 / 효과성
수련생 파일럿, 사전사후 효과 측정, 재귀학습 데이터셋 산출.
- DoD: 20명 완주 + KPI 충족
- 측정: SUS, 자기효능감, κ/ICC, 환각률
- 정정: IRB 게이트가 아니라 데이터 활용동의/개인정보 게이트
정정 기준:
MASTERPLAN 원본의 IRB 신청/승인 게이트는 MASTERPLAN_REVISIONS 기준으로 제거한다. Phase 2는 2a(3역할/OAuth/페르소나)와 2b(음성 캐스케이드)로 분리하고, Phase 1 DoD에는 얇은 음성 왕복 1턴 PoC를 포함한다.단계별 상세 작업 · 검증 명령 표
Phase 0 마감 상세
지금 단계는 구현을 더 벌리는 단계가 아니라, 운영 증거를 닫고 P1 진입 조건을 고정하는 단계다.
상태: 조건부우선순위: P0블로커: public /turn
BLOCK
공개 Google OAuth 실제
/turn proof 확보로그인 가능한 계정으로 storageState를 저장한 뒤 public-auth-turn E2E를 실행한다.
산출물
apps/web/node_modules/.tmp/public-auth.json, public /turn 성공 로그
검증
E2E_PUBLIC_AUTH=1 + chromium-public-auth 1회 통과
DONE
engine config 운영값 재확인
GET /admin/engine-config로 운영값을 직접 확인했다. engine_mode=claude_cli, engine_url=http://127.0.0.1:9099, model=gateway-default, durable=true, source=database로 의도값과 일치한다.
산출물
config API 응답(durable, db source)
검증
claude_cli / http://127.0.0.1:9099 / gateway-default 의도값 대조 완료
DONE
과거 Live2D demo 자산 제거
Mao/Haru 샘플, Pixi/Cubism 런타임, 공개 /live2d/* 캐시 잔여 접근을 차단했다.
산출물
apps/web/functions/live2d/[[path]].js, P1 PSB raster avatar + SVG fallback
검증
운영 /live2d/mao/*, Cubism core 404
DONE
프로세스 난립 정리
운영 확인용 프로세스와 로컬/Tailnet 검증용 dev 프로세스를 의도적으로 분리해 유지한다.
산출물
9099 engine, 8001 prod API, 8000/8010 dev API, 5173 web, cloudflared tunnel 1개
검증
Get-NetTCPConnection에서 대상 포트별 listener 확인
GATE
한신대 공문/데이터 거버넌스 게이트 정리
SSO 클레임, 추가 축어록 수급, 미성년 원본 활용동의, 개인정보 처리방침을 P1 진입 전 외부 의존성으로 명확히 둔다. 로컬 문서 골격은 준비됐지만 한신대/데이터 steward의 written evidence는 아직 필요하다.
산출물
docs/ops/hanshin-data-governance-gate.md, 공문 질의 항목, 동의 범위 체크리스트, SSO claim mapping 표
검증
문서 artifact 작성 완료; IRB 게이트가 아니라 데이터/SSO 게이트로 외부 증거 필요 상태 유지
팀장 판정: 로컬 회귀와 공개 prod-safe 게이트는 통과했다. Cloudflare Pages production
24c90784가 현재 dirty local source dist로 배포됐고, 운영 반영 전 남은 핵심 증거는 공개 Google OAuth 실제 /turn smoke다. 런타임 mock/demo 자산은 운영 번들에서 제거하고 테스트 fixture만 남긴다.Phase 0 완료 상세 목록
이전 "완료" 카드 내용을 탭 안에서 항목별로 보존한다.
DONE
DB persona 기반 테스트
session-persistence, teacher, voice는 /api/personas에서 실제 DB persona를 가져온다.
산출물
seed persona 직접 결합 제거, 실제 persona catalog 기반 E2E
검증
persona 관련 E2E가 DB-backed persona로 통과
DONE
비개발 런타임 보호
prod/staging에서 dev login, seed fallback, OAuth 누락, 기본 secret, localhost CORS를 거부한다.
산출물
fail-closed runtime config validation
검증
backend runtime policy unittest 통과
DONE
compose OAuth 주입
ENVIRONMENT, Google OAuth vars, CORS_ORIGINS, OPENAI_BASE_URL을 API 컨테이너에 명시했다.
산출물
compose 환경 주입 정리
검증
docker compose -f infra\docker-compose.yml --env-file infra\.env.example config --quiet 더미 필수 env 세트로 통과
DONE
admin 모바일 overflow 수정
긴 readiness detail을 안정화했고, 사용자 변경은 DB 저장소가 durable할 때만 허용한다.
산출물
admin responsive layout, durable store gate, AI health copy
검증
admin manage-users desktop/mobile 2 passed
DONE
global engine config 테스트 분리
db-persistence는 전역 engine config를 바꾸므로 @single-run으로 분리했다.
산출물
Playwright single-run tagging
검증
전체 Playwright 72 passed
DONE
handoff와 문서 갱신
docs/HANDOFF.md, docs/dev_dashboard.html, apps/web/e2e/README.md를 최신 상태로 맞췄다.
산출물
handoff, dashboard, E2E README
검증
최신 커밋 기준 상태/검증/운영 포트 일치
DONE
공개 API prod 전환
cloudflared ingress를 127.0.0.1:8001 prod API로 돌렸고 public readiness gate가 통과했다.
산출물
prod API 8001, tunnel config
검증
https://api-vignette.chanpaca.net/health prod/db/engine OK
DONE
공개 런타임 재기동 스크립트
scripts/start-public-runtime.ps1와 scripts/stop-public-runtime.ps1로 API 8001과 cloudflared를 재현 가능하게 만들었다.
산출물
public runtime start/stop scripts
검증
engine 9099 + API 8001 + cloudflared only
DONE
persona catalog 인증화
/personas는 이제 비로그인 401이다. 로컬과 공개 API 모두 직접 확인했고 E2E 회귀를 추가했다.
산출물
authenticated persona catalog boundary
검증
local/public unauth GET /personas 401
DONE
public API base fallback 보강
public 웹에서 /api/auth/config가 SPA HTML로 떨어지지 않도록 public API origin fallback을 추가했다.
산출물
public API origin fallback
검증
public login screen E2E 1 passed
DONE
학습자 홈 0회 기록 상태
학습자 홈은 fake 기록 없이 실제 서버 세션 0개를 기존 회기 빈 상태와 0 카운트로 표시한다.
산출물
empty history UX, zero count, no fake stats
검증
learner screenshots: document overflow 0, empty history visible
DONE
로컬 5175 로그인 재기동 검증
127.0.0.1:5175 web, 8000 API, 9099 engine을 재기동하고 dev-login 서버 세션과 /learn redirect를 확인했다.
산출물
local dev-login flow proof
검증
desktop/mobile auth flow passed
DONE
active session dense viewport 보정
375px급 active session에서 stage 내부가 1px 넘게 잘리던 문제를 avatar/padding 조정으로 제거했다.
산출물
session layout responsive adjustment
검증
session-layout desktop/mobile 8 passed
DONE
텍스트 턴 SSE 전환
POST /sessions/{id}/stream token 이벤트로만 내담자 자막을 쌓고, HTTP 거절과 SSE error 모두 실패 턴을 transcript와 저장소에 남기지 않는다.
산출물
real SSE stream turn path, failed turn discard
검증
session layout/turn E2E passed
DONE
음성 실패 턴 미저장
음성 회기도 엔진 응답 생성 성공 후에만 learner/client turn을 저장한다. 실패한 transcript는 pending 상태에서 제거한다.
산출물
voice failure persistence guard
검증
voice + voice-success + session-layout 15 passed
DONE
비영구 상태 문구 정리
admin health와 voice degraded reason은 내부 fallback/seed 표현 대신 비영구 런타임 상태를 사용자용 문구로 표시한다.
산출물
operator-facing copy cleanup
검증
settings/admin focused E2E 통과
DONE
직접 URL persona 차단
/learn/session/:code로 직접 들어와도 DB 원본 persona가 아니면 회기 시작을 막는다.
산출물
route guard, degraded/seed fallback regression
검증
unavailable persona code E2E 통과
DONE
demo Live2D 자산 제거
Mao/Haru 샘플과 Pixi/Cubism 런타임을 공개 배포물에서 제거했다. 세션 화면은 P1 PSB raster avatar와 SVG fallback을 렌더링한다.
산출물
P1 PSB raster avatar, SVG fallback, legacy /live2d/* 404 function
검증
Mao/Haru/Cubism core routes 404, no Live2D/Pixi chunks
Phase 1 MVP 코어 루프 상세
목표는 "P1 내담자와 실제 상담 1회 완주 후 피드백을 받는 공개 시연 가능 상태"다.
우선순위: P0범위: 텍스트+음성 1턴완료보고: E2E 증거 후
CHECK
LLMEngine 정규화 계약 고정
gateway SSE token/done/error와 generate cost 계약은 회귀화했다. 이번 패스에서 app/contracts/engine_gateway.py를 추가해 FastAPI engine_client와 현재 Python gateway가 같은 GenerateRequest/GenerateResponse/Stream*Event 계약을 import한다. Node.js gateway로 갈아치울 때 보존해야 할 첫 wire contract다. claude_cli와 Messages API 폴백 동일성 검증은 라이브 키/환경 의존이라 남아 있다.
산출물
app/contracts/engine_gateway.py, engine_gateway/test_gateway_model.py shared contract + stream frame tests
검증
python -B -m py_compile app/contracts/engine_gateway.py app/engine_client.py engine_gateway/gateway.py, python -B -m pytest -p no:cacheprovider engine_gateway/test_gateway_model.py -q 11 passed.
DONE
상주
claude -p 엔진풀 실증session_id가 살아 있는 gateway session을 재사용하고 missing session은 ephemeral로 닫히는 구조를 회귀화했고, live 게이트웨이(9099)로 실측까지 마쳤다. probe-engine-gateway.py가 단일 session_id로 2회 reused stream을 돌려 TTFT 1667–4199ms, cost 누적 0.068→0.123(turns 1→2), engine=claude_p, model=opus-4-8을 측정했다.
산출물
engine_gateway/test_gateway_model.py, scripts/probe-engine-gateway.py, live probe JSON
검증
session reuse 7 tests OK; live probe 2 reused streams, TTFT/cost 실측, session_id 재사용 확인
DONE
마스킹 게이트 + LLM call audit
current turn, recall, pinned fact, recent turns가 Presidio/가명처리 후에만 engine request로 들어가게 막았다. 외부 LLM 호출은 audit.llm_call_log에 provider/model/token/cost/inference_geo/latency metadata만 남기고 prompt/completion 본문은 저장하지 않는다.
산출물
app/test_orchestrator_masking.py, app/test_evaluation_persistence.py, session_persistence.record_llm_call_audit
검증
phone/email/RRN raw 값이 generate/stream payload에 없음, 감사 payload 본문 미포함, 관련 회귀 27 passed, 전체 API 최신 130 passed, 로컬 live /turn smoke 후 audit.llm_call_log 8→11
CHECK
P1 상담 완주 플로우
통제된 UI E2E로 P1 선택, SSE 상담, 종료, 회기말 리뷰 피드백을 한 번에 통과시켰다. 실제 운영 로그인 proof는 P0 blocker와 함께 남아 있다.
산출물
e2e/session-mvp.spec.ts, turn telemetry 저장 경로
검증
chromium-single-run P1 MVP UI E2E 1 passed
DONE
저항 엔진 정량 검증
공감 발화와 조언점프 발화 5턴 세트를 상태머신 회귀 테스트와 실제 API+DB smoke로 비교했다. live smoke는 dev-login→onboarding→P1 세션 2개→각 5턴을 수행하고 app.session_state, app.turns, app.turn_client_state를 직접 조회했다. 공감 세션은 3턴부터 탐색으로 열리고 openness가 0.171까지 상승했다. 조언점프 세션은 라포와 openness 0.0을 유지했다.
산출물
app/test_state_machine_resistance.py, scripts/smoke-resistance-openness-db.py, docs/ops/resistance-openness-db-smoke-2026-06-28.json
검증
pytest app/test_state_machine_resistance.py app/test_evaluation_persistence.py -q 9 passed; live DB smoke PASS.
DONE
음성 왕복 1턴 PoC
Session UI 마이크 버튼 경로에서 synthetic getUserMedia/MediaRecorder로 실제 /voice/ws를 열고 audio_start, binary chunk, audio_end, transcript, reply, TTS 재생 상태까지 검증했다. 추가로 로컬 live API에서 실제 STT/TTS provider를 통과해 TTS 바이너리를 수신했다. 물리 마이크, 공개 WSS, 50분 양방향 실측은 별도 운영 smoke로 남아 있다.
산출물
apps/web/e2e/voice-success.spec.ts, controlled OpenAI/engine providers, Web Audio browser voice UI probe, live /voice/ws smoke
검증
npx playwright test e2e/voice-success.spec.ts --project=chromium-single-run 2 passed; live P2 WS smoke binary 66 chunks/266,496 bytes
Phase 2a 권한, OAuth, 페르소나 상세
음성과 섞지 않고 3역할, 권한격리, 페르소나 확장을 독립 트랙으로 닫는다.
주차: 9-13우선순위: P1IDOR 검증 필수
CHECK
OAuth BFF / HttpOnly 세션 완성
Auth Code + PKCE/state와 opaque HttpOnly/Secure cookie 계약을 회귀화했다. OAuth state는 HMAC 서명 토큰과 HttpOnly state cookie를 함께 검증해 API 재시작 뒤 콜백이 invalid_state로 떨어지지 않으면서도 브라우저 시작 흐름에 묶인다. Google provider error는 access_denied/provider_error로 분리하고 로그인 화면에 reason code를 표시한다. 공개 Google OAuth 실제 /turn proof는 P0 blocker로 남아 있다.
산출물
app/test_auth_providers.py, cookie-bound signed PKCE state, OAuth callback cookie path, login reason UI
검증
auth URL secret 미노출, browser token 미저장, dev/prod cookie 속성 분리, state cookie 불일치 차단, 재시작 후 signed state 콜백 복구, provider error reason 분리
DONE
학습자/교수자/관리자 권한 격리
runtime fallback에서 타 learner session 직접 접근 403과 learner list 필터를 회귀화했고, teacher/admin durable read audit insert 경로를 추가했다. live Postgres(NOBYPASSRLS vignette_app 역할)로 RLS/audit smoke를 실행해 운영 증거를 확보했다: learner 세션/턴 격리, teacher cohort 스코프, teacher/admin read_session audit insert가 실제 정책 하에서 PASS. 이번 패스에서 역할(role)과 관리자 페이지 진입권(admin_access)을 분리했고, AUTH_SUPER_ADMIN_EMAILS 슈퍼 관리자만 관리자 권한을 부여·회수할 수 있게 했다. 슈퍼 관리자는 학습자/교수자 라우트도 통과할 수 있지만, 일반 admin_access는 관리자 콘솔 진입권으로만 쓰인다.
산출물
app_user.admin_access, require_admin_access(), /admin/users 권한 위임 UI, app/test_rbac_idor.py, audit.audit_log read_session insert, scripts/check-postgres-rls-audit.py(live PASS)
검증
타인 session_id 직접 입력 403(unit), live RLS smoke 5 checks PASS, 관리자 권한 위임 회귀 app/test_auth_providers.py app/test_admin_ops.py 32 passed
DONE
visible_to와 인간 권한 레이어 분리learner detail/review와 client engine history에서 evaluator-only turn을 제외한다. live Postgres smoke가 evaluator-only DB 정책을 실제로 검사해 PASS: evaluator-only turn이 learner/client/counselor AI에는 숨겨지고 evaluator AI에만 보인다.
산출물
TurnRecord.visible_to, learner/client/evaluator filters, docs/ops/postgres-rls-audit-smoke.md
검증
evaluator-only turn 숨김 unit proof + live RLS smoke visible_to.evaluator_only_hidden PASS
DONE
페르소나 P2/P3 교수 검수 루프
approved catalog와 draft/review 교수 검수 큐를 분리하고, teacher/admin 승인·반려 mutation과 교수 콘솔 UI proof를 추가했다. 교수 콘솔의 404 raw 노출도 제거(404→정상 빈상태)했다.
산출물
/personas/review, POST /personas/review/{persona_id}, professor review panel
검증
app.test_persona_review 14 tests; teacher UI single-run E2E 1 passed; live RLS smoke PASS
CHECK
SAML SP 스캐폴드 선반영
Google OIDC와 별도 provider 상태를 /auth/config에 노출하고, Redirect-binding AuthnRequest와 dev-only unsigned fixture ACS를 backend proof 수준으로 구현했다. 서명 검증이 필요한 운영 SAML ACS는 아직 미구현이며 fingerprint 설정 시 거부한다.
산출물
AUTH_SAML_ENABLED, SAML_SP_ENTITY_ID, SAML_SSO_URL, RelayState store, /auth/saml/acs fixture endpoint
검증
AuthnRequest issuer/ACS/destination, RelayState 검증, opaque HttpOnly cookie, bad RelayState/signature-required reject unit test
Phase 2b 음성 캐스케이드 상세
음성은 "되게 보이는 UI"가 아니라, 전송, STT, EOT, 엔진, TTS, 저장까지 끊기지 않아야 한다.
주차: 13-17WSS 50분실측 전 완료 금지
CHECK
voice gateway WebSocket
/voice/ws backend contract를 fake WebSocket으로 회귀화했고, Session UI의 MediaRecorder 기반 브라우저 경로도 synthetic audio로 한 턴 통과시켰다. 실제 AudioWorklet 전환, public WSS, 50분 양방향 실측은 남아 있다.
산출물
app/test_voice_ws.py, apps/web/e2e/voice-success.spec.ts, audio_start/binary/audio_end/text_turn/ping contract
검증
5 backend tests OK; voice-success chromium-single-run 2 passed; auth guard, chunk concat, max audio cap, TTS chunk envelope
CHECK
Deepgram STT + EOT
provider-neutral EOT helper로 final transcript와 silence threshold readiness를 회귀화했다. 실제 Deepgram interim/final 스트림 연결은 남아 있다.
산출물
assess_end_of_turn, EndOfTurnDecision, EOT silence threshold
검증
final pending, empty transcript, silence threshold 케이스 unit test
DONE
OpenAI TTS voice preset 추상화
P1/P2/P3 persona voice preset, invalid preset fallback, speed clamp, instructions payload 계약을 회귀화했고, app.persona_voice_map을 live /voice/ws TTS 선택에 연결했다. 명시 preset은 DB map보다 우선하고, OpenAI가 아닌 provider row는 기존 fallback으로 안전하게 흡수한다.
산출물
resolve_voice, resolve_voice_from_map, build_tts_payload, get_session_voice_map, seed voice map row, dev runtime schema guard
검증
pytest app/test_runtime_policy.py app/test_persona_review.py app/test_voice_service.py app/test_voice_ws.py -q 75 passed; full API 175 passed + gateway 9 passed.
POC
P1 서연 무참조 synthetic voice 샘플
Higgs v3 로컬 런타임에서 실존 reference voice 없이 synthetic seed를 먼저 만들고, 그 seed만 재참조해 우울·피로·불안·라포·회복감 5개 변주를 생성했다. 개발용 VIGNETTE_VOICE_POC_SAMPLE_TTS 플래그로 /voice/ws P1 sample TTS provider에도 연결했다.
산출물
docs/voice-art/bimec-persona-voice-poc-2026-06-27.md, docs/voice-art/p1-seoyeon-higgs-v3-20260627/manifest.json, apps/api/app/services/voice.py
검증
mp3/wav 6개(seed+5) 생성, 24kHz, 7.72~11.68초. live /voice/ws text_turn smoke: provider p1-sample-poc, binary 20 chunks/78,573 bytes. 샘플 provider는 TTS override만 담당하고 마이크/STT는 OpenAI 키가 필요하다. 프로덕션 탑재는 모델 라이선스·권리정책 결정 전 금지.
CHECK
barge-in / paralinguistic logging
음성 learner turn에 audio_ref, silence_ms, speech_rate, barge_in을 nullable 메타로 저장하고, 회기 리뷰에서 침묵·발화 속도·끼어듦·음성 입력 비언어 칩으로 표시한다. 실제 장시간 WSS/마이크와 한숨·울음 감지 증거는 남아 있다.
산출물
turns nullable 확장, voice route 메타 산출, ReviewNonverbalEvent, SessionReview 칩 UI
검증
오디오 STT→엔진→TTS 더블 테스트에서 voice turn log에 메타 저장; session review E2E 1 passed; backend voice/session 17 passed
CHECK
s2s 2차 PoC 판단
캐스케이드 1차 원칙과 s2s 유지/폐기 증거 기준을 문서화했다. 채택 여부 결정은 윤찬 DECIDE로 유지한다.
산출물
docs/decisions/voice-s2s-poc.md
검증
transcript, safety, audit, latency, failure, privacy 기준 명시
Phase 3 교육용 파일럿 / 효과성 상세
IRB 승인 게이트가 아니라 교육 활용 파일럿과 데이터/개인정보 게이트로 관리한다.
주차: 18-20+표본: 20명first measure
GATE
20명 교육용 파일럿 운영
20명 파일럿을 실행하기 위한 roster, consent, session completion evidence gate를 문서화했다. checker는 CSV enum(withdrawal_state, completion_state, timepoint, withdrawal scope/status)을 검증한다. 실제 참여자 완주 증거는 아직 필요하다.
산출물
docs/phase3/pilot-runbook.md, evidence root layout, operator gates, scripts/check-phase3-artifacts.py
검증
python scripts/check-phase3-artifacts.py --help, pytest app/test_phase3_artifact_checker.py -q 5 passed. 실제 evidence root validation은 파일럿 시점에 실행.
GATE
효과성/KPI 측정
SUS, 자기효능감, κ/ICC, 환각률, 피드백 타당도 기준과 report schema를 고정했다. checker는 KPI report top-level keys와 metric 필수 필드(value/threshold/pass/method/source_files 등)를 error로 검증한다. 실제 수치 충족 여부는 파일럿 데이터 이후 판단한다.
산출물
docs/phase3/kpi-measurement-plan.md, KPI report schema, checker tests
검증
checker가 prepost_measures, sus_responses, kpi_report.json evidence와 metric shape를 요구.
DONE
재귀학습 데이터셋 1차 산출
masked-text JSONL dry-run exporter, PII scan, κ/ICC 계산, approved export 차단 게이트를 구현했다. 이번 패스에서 artifact checker도 approved manifest false-positive를 막도록 강화했다. 실제 approved export와 데이터 steward 검수는 남아 있다.
산출물
scripts/export-recursive-dataset.py, app.services.dataset_export, docs/phase3/dataset-export-manifest.md, app/test_phase3_artifact_checker.py
검증
pytest app/test_dataset_export.py app/test_phase3_artifact_checker.py -q 10 passed, DB dry-run 5 rows → technical_dry_run manifest + sha256 생성, approved manifest는 PII pass·κ/ICC·withdrawn exclusion·consent scope·file sha256을 요구.
GATE
개인정보/동의 감사
동의, 철회, privacy audit, 해외 전송 고지 evidence checklist를 만들었다. 실제 법무/개인정보 검토 서명은 파일럿 전 gate로 남아 있다.
산출물
docs/phase3/privacy-consent-audit.md, withdrawal log contract
검증
동의 철회 후 session/export 제외 evidence를 checker 입력으로 요구
운영 / 검증 상세
실제 운영 도메인에 반영됐는지, 서버가 하나로 정리됐는지, 완료라고 말할 증거가 있는지 확인하는 탭이다.
웹: 200API: prod/dev OKCompose smoke: OK
DONE
운영 웹 asset 확인
커스텀 도메인의 로그인 페이지가 최신 production build asset을 정상 응답한다. 2026-06-28 11:05 KST 기준 Cloudflare Pages production deploy는 24c90784다.
산출물
https://vignette.chanpaca.net/login, assets/index-HjXyC0JT.js, assets/index-C8JKXhNP.css
검증
Invoke-WebRequest https://vignette.chanpaca.net/login → 200 + latest assets
DONE
공개/API 런타임 health
터널은 prod API 8001을 보고, API는 DB와 engine을 모두 확인한다. 로컬 dev API 8010도 같은 엔진/DB 경로로 정상이다.
산출물
environment:"prod", environment:"dev", db:true, engine:true, engine_mode:"claude_cli"
검증
https://api-vignette.chanpaca.net/health, http://127.0.0.1:8001/health, http://127.0.0.1:8010/health 모두 OK
DONE
Tailscale Tailnet 런타임
로컬 web/api/engine을 Tailscale Serve로 묶어 같은 Tailnet PC·모바일에서 HTTPS로 접근한다. Vite proxy와 API 포트가 어긋나지 않도록 dev-up.ps1에서 VITE_API_PROXY_TARGET을 ApiPort와 동기화한다. Tailnet dev-origin에서는 공개 OAuth callback으로 세션이 섞이지 않게 dev-login을 기본 검증 경로로 둔다.
산출물
https://alpaca-home.taile93291.ts.net, scripts/start-tailscale-runtime.ps1, VITE_ALLOWED_HOSTS, vite.config.ts, auth.py
검증
/login 200, /api/auth/config 200, redirect_uri=https://api-vignette.chanpaca.net/auth/callback, dev_login_enabled:true. Vite host-header block 재현 안 됨.
DONE
Docker compose 패키징 smoke
더미 운영 env 기준 fresh compose 기동을 통과했다. API 컨테이너 import 실패, 구현 없는 RAG 사이드카, 로컬 apps/api/.env 이미지 혼입, startup owner-DDL, 빈 admin_engine_config 행 때문에 prod가 죽던 경로를 수정했다. 루트 계산은 app.paths.repo_root()로 모았고, backend requirements는 exact pin으로 고정했다.
운영 주의
패키징은 OK지만 실제 이식 전에는 배포지 infra/.env에 APP_DB_PASSWORD, OAuth client id/secret, OPENAI_API_KEY, SESSION_SECRET 등 소유자 비밀값을 채워야 한다. data/kb live-coaching source pack은 commit 또는 같은 경로 provision이 필요하다. 현재 로컬 env의 ENGINE_MODE=claude_p와 prod 금지 샘플 TTS 플래그는 운영값으로 쓰면 안 된다.
검증
docker compose -f infra/docker-compose.yml config --quiet, API/Web image build, API image .env* 미포함, prod import smoke, fresh docker compose up -d --build → /api/health 200, preflight OK requirements_pinned/live_coach_kb/env_file.
BLOCKED
공개 vnet.18ka.net 런타임
vnet.18ka.net과 api-vnet.18ka.net을 정식 공개 도메인으로 허용하도록 코드 경로는 보강했다.
산출물
FRONTEND_ORIGIN_MAP, 공개 host별 API 매핑, scripts/start-public-runtime.ps1 vnet ingress 옵션
블로커
현재 DNS 미해결, Cloudflare credential의 18ka.net zone 권한 불일치, Google OAuth redirect URI 등록 필요.
DONE
서버 정리 상태
운영 API와 로컬/Tailnet 테스트 API를 구분해 유지한다.
산출물
8001 prod API, 8000 local API, 8010 Tailnet API, 5173 web, 9099 engine, 20241 cloudflared
검증
Get-NetTCPConnection 대상 포트 확인
CHECK
재부팅 후 런타임 재기동
engine gateway, prod API, cloudflared를 health-check하고 복구하는 watchdog과 Scheduled Task installer를 추가했다. 아직 DNS가 없는 api-vnet.18ka.net은 기본 watchdog 검사에서 제외해 불필요한 restart loop를 막고, 실제 개통 후 -AdditionalPublicHealthUrls로 명시 추가한다. 실제 재부팅 후 public /turn smoke는 남아 있다.
산출물
watch-public-runtime.ps1, install-public-runtime-task.ps1, ops runbook
검증
PowerShell parser OK, check-only watchdog healthy: engine/api/web-preview/cloudflared/public-api
DONE
레이아웃 감사팀 / 전면 레이아웃 개선
서브에이전트 전담으로 1차 overflow/clipping 수리 후 2차 전면 재설계를 진행했고, 이번 라운드에서 7개 권장 너비 시각 수용까지 닫았다. 세션, 학습자 홈/리뷰, 교수 콘솔, 관리자, 설정 화면을 작업 화면 기준으로 재배치했고, 과한 빈칸·튀어나감·버튼/텍스트 잘림·모바일 테이블 사용성을 줄였다. 엄격한 시각 게이트 + 화면별 적대적 시각 재검수에서 7개 화면 모두 accept(critical/major 0, 회귀 0)를 받아 DONE으로 닫는다.
산출물
docs/ops/layout-redesign-handoff-2026-06-26.md, page-by-page redesign patches, apps/web/e2e/layout-visual-gate.spec.ts
검증
npm run typecheck OK, 엄격 시각 게이트 7 passed, layout focused E2E desktop/mobile 54 passed, 적대적 시각 재검수 7/7 accept·회귀 0.
DONE
엄격한 레이아웃 시각 게이트 구축 · 병렬 수정 · 적대적 재검수
핸드오프가 요구한 7개 권장 너비(390/720/861/900/1024/1280/1440) 시각 수용을 자동 게이트로 고정했다. 7개 재설계 화면을 각 너비에서 렌더링해 가로 overflow 0, 컨트롤 하드클립/텍스트클립 0을 강제하고 화면당 7장 총 49장 풀페이지 스크린샷을 남긴다. 화면별 1에이전트 병렬 시각 리뷰로 49장 직접 판독 → 6개 병렬 수정 에이전트(파일 비중첩)가 결함 수정 → 화면별 적대적 재검수로 해소·무회귀 확정.
산출물
apps/web/e2e/layout-visual-gate.spec.ts, node_modules/.tmp/layout-gate/*.png 49장, 2× workflow(review/verify)·6× fix agent
검증
게이트 7 passed(재스크린샷). 해소된 핵심 결함: 학습자홈 1280/1440 3열 가운데 컬럼 붕괴(critical → 2열 분기 상향 + word-break:keep-all), 교수 'API 404' raw 배너 제거, 리뷰 빈상태 위계 역전, 관리자 스켈레톤, 설정 와이드 좌측 데드존 제거, 세션 모바일 44px 터치타깃. 적대적 재검수 7/7 accept, regression 0.
DONE
레이아웃 cosmetic minor 폴리시 일괄 처리
적대적 재검수 잔여 cosmetic minor를 5개 병렬 폴리시 에이전트로 처리했다. 학습자홈 헬퍼문구 고아 글자, 세션 1024 일시정지 아이콘 정리 + 보내기 버튼 대비 강화, 설정 2x2 칩 행 높이 균일, 교수 검토 큐 카드 갭 제거, 관리자 2열 높이 동기화를 적용했다.
산출물
page-by-page polish patches(LearnerHome/Session/Settings/Professor/Admin)
검증
npm run typecheck OK, 시각 게이트 7 passed, 레이아웃 E2E desktop/mobile 54 passed, session-layout 8/8 — 회귀 0.
DONE
회기 아카이브 저장/복원 API
/learn/history의 보관됨을 실제 학습자별 저장 상태로 연결했다. 종료 회기는 POST /sessions/{id}/archive/restore로 보관·복원하고, app.session_archive_state는 보기 상태만 저장한다. 진행 중 회기는 보관하지 못하며, 보관은 transcript/review/share/audit evidence를 삭제하지 않는다.
산출물
SessionArchiveResponse, LearnerSessionSummary.archived, LearnerDashboardOverview.archived_sessions, session_archive_state RLS, LearnerHome 보관/복원 버튼
검증
python -B -m pytest app/ -q 178 passed, python -B -m pytest engine_gateway/ -q 11 passed, npm run check:api-types, npm run typecheck, npm run build, npx playwright test e2e/learner.spec.ts --project=chromium-desktop --workers=1 6 passed.
DONE
세션 종료 UX와 다크 테마 SSOT
세션 하단의 드래그형 종료 컴포넌트를 명시 확인 다이얼로그로 바꿔 모바일 오발동과 제스처 실패를 줄였다. Topbar/Settings의 theme 저장·초기화는 lib/theme.ts 단일 경로로 합치고, 저장값이 없으면 dark 기본값을 앱 부팅 전에 적용한다. API 기본 preference system은 Settings에서 light로 오해하지 않고 현재 초기 테마를 따른다. P1 실제 세션 기본 아바타는 사용자 제공 PSD 기반 seoyeon-live2d-psd-v2이며, sad 표정에서 울상 눈썹·우는 입·눈물 파츠를 합성한다. active session 스테이지 상태 배지는 아바타와 겹치지 않는 3행 구조로 정리했다.
산출물
Session.tsx, RasterBust.tsx, AvatarPreview.tsx, session.css, apps/web/public/avatar/seoyeon-live2d-psd-v2/parts/*.png, docs/avatar-art/seoyeon/live2d-psd-v2/, avatar-expression.spec.ts, session-layout.spec.ts
검증
PSD 파츠 추출 53개. preview-sad.png에서 눈물/우는 입/울상 눈썹 확인. 기존 시각 회귀 게이트는 후속 전체 검증에서 재실행한다.
DONE
잔여(비차단) — 공용 셸 단일 항목 → 처리
축소 사이드바 세로 구분선이 본문 전체 높이까지 닿지 않던 건을 components/shell/shell.css에서 처리했다. .vg-nav border-right 제거 후 .vg-shell__body 컨테이너 배경 하어라인으로 본문 그리드 전체 높이 구분선을 그리고, 그리드·구분선 폭을 --nav-cur로 동기화. learner-home 로딩 스켈레톤 밀도도 실제 카드 구조 모사로 보강했다.
판정
구현 완료. 검증: npm run typecheck PASS + vite build PASS. 전 페이지 시각 회귀 게이트는 web+api+DB 스택으로 이 워크스테이션 미실행 — 스택 가용 시 1회 시각 확인 권장.
검증 실행 상세 표
요약하지 않고 실행 범위, 명령, 결과를 행 단위로 남긴다.
| 범위 | 명령 / 확인 대상 | 결과 |
|---|---|---|
| Web typecheck | npm run typecheck | Passed |
| Full Playwright E2E | PLAYWRIGHT_PORT=5174 npm run e2e | 113 passed; desktop/mobile 병렬 + @single-run DB 영속화·음성 성공 경로까지 전체 통과. |
| API typegen SSOT | npm run check:api-types | Passed; FastAPI OpenAPI → src/lib/api.gen.ts stale check |
| Contract SSOT aggregate DTO | npm run typecheck / npm run build / session persistence / learner + session-review + teacher + layout gate | Passed; learner sessions, session review/worksheet, teacher dashboard, session start/detail DTOs now use generated ApiSchema aliases with UI fallback. Stage responses are OpenAPI enum unions. Focused E2E 32 passed. .github/workflows/api-contract.yml now runs npm run check:api-types on API/Web contract changes. |
| SEO/GEO share cards | pytest app/test_session_share.py app/test_session_turn_persistence.py -q / npm run generate:api-types / npm run typecheck | 21 passed; session share creates hashed-token public unfurl payload without raw transcript, revoked token returns 404, OpenAPI generated share DTOs, review screen share button typechecks. Static robots.txt/sitemap.xml/llms.txt added. |
| Backend pytest | python -m pytest app/ -q | 178 passed |
| X2 evaluator model routing | python -m pytest app/test_evaluator_model_routing.py app/test_runtime_policy.py -q | 23 passed; fast/deep evaluator model override and blank-default routing covered |
| C1 case worksheet | python -m pytest app/test_session_turn_persistence.py app/test_rbac_idor.py -q / npm run check:api-types / npm run typecheck / npm run build / local API smoke | 25 passed; session review exposes transcript-grounded caseWorksheet, learner-edited saved_by_learner worksheet persists through app.case_worksheet, and evaluator-only turns stay hidden. Local smoke returned saved_by_learner:local smoke saved worksheet. Stage labels are normalized at response boundaries. |
| M3 auth claim mapping | python -m pytest app/test_auth_providers.py -q | 22 passed; Google/SAML cohort maps, provider external_id, provider error reason covered |
| CrisisGate 109 | python -m pytest app/test_session_turn_persistence.py app/test_voice_ws.py -q | 20 passed; real crisis stops before engine, returns 109 resource, safety event DB insert payload covered |
| Professor review workflow | python -m pytest app/test_rbac_idor.py app/test_teacher_dashboard.py -q / npx playwright test e2e/teacher.spec.ts --project=chromium-single-run --workers=1 | 9 backend passed + 4 E2E passed; teacher dashboard exposes learner_growth/safety queues and review-pending/recent rows now open /teach/session/:id/review read-only with learner worksheet editing blocked for teachers. |
| Learner dashboard personalization | pytest app/test_learner_dashboard.py app/test_teacher_dashboard.py app/test_rbac_idor.py -q / npm run check:api-types / npm run typecheck / npm run build | 12 backend passed; GET /sessions/dashboard uses shared session_metrics and feeds LearnerHome overview/growth/persona_progress/recent_feedback/last-session recap. Focused learner/review/teacher/layout/session E2E evidence recorded in backlog. |
| Teacher review status | pytest app/test_teacher_dashboard.py app/test_rbac_idor.py app/test_learner_dashboard.py -q / npm run typecheck / npm run build / teacher.spec.ts | 12 backend passed + 4 E2E passed; app.session_review_status, teacher dashboard review_status/review_note/reviewed_at, and PUT /teacher/sessions/{session_id}/review-status are documented. 검토 큐 visible 회귀와 교수자 전용 review grid 영역도 테스트로 고정했다. |
| Persona authoring CRUD | python -m pytest app/test_persona_review.py -q | 31 passed; teacher/admin draft create/read/update/review submit, approved persona revision clone, code-family archive delete, learner blocked, approved-only catalog maintained |
| P1 cost telemetry | app.test_session_turn_persistence.SessionTurnPersistenceTest | Passed; generate/stream client AI turns store provider/model/tokens/cost |
| Engine stream contract | gateway token/done/error parsing | Passed; gateway error event does not create saved turns |
| Engine session reuse | engine_gateway.test_gateway_model | 9 tests OK; live session_id reuse and ephemeral close fixed |
| P1 masking gate | app.test_orchestrator_masking | 4 tests OK; phone/email/RRN absent from generate/stream payloads |
| P2a RBAC/audit/visibility | app.test_rbac_idor | 8 tests OK; other learner 403, read_session audit, evaluator-only hidden, teacher session review read allowed while learner worksheet write remains 403 |
| Admin access delegation | python -m pytest app/test_auth_providers.py app/test_admin_ops.py -q / npm run typecheck / npm run check:api-types | 32 backend passed; admin_access and super_admin are exposed through auth/admin DTOs. Super admins can grant/revoke admin page access; configured super admins stay protected. Frontend role switching uses canAccessRole. |
| Admin usage persistence | python -m pytest app/test_admin_ops.py app/test_runtime_policy.py -q / authenticated local public-API smoke | 26 passed; /admin/usage returns 200 with source=database, durable=true. Cloudflare blocked raw Python public smoke with 1010, so app-level HTTP was verified against 127.0.0.1:8001 using the same prod process. |
| Turn evaluation SSOP | pytest app/test_session_turn_persistence.py app/test_evaluation_persistence.py app/test_voice_ws.py | 20 tests OK; submit/stream/voice fast-loop evaluation normalized mapping + evaluator-only raw RLS + turn insert id 확인 |
| Postgres RLS/audit smoke checker | python scripts\check-postgres-rls-audit.py --help | py_compile/help/safe default OK; live DSN run still required for proof |
| OAuth/BFF cookie security | app.test_auth_providers | 20 tests OK; PKCE/state, cookie-bound signed state restart recovery, state cookie mismatch reject, opaque HttpOnly/Secure cookie, no browser tokens, SAML AuthnRequest/dev-only fixture ACS, dev/Tailnet OAuth guard, public-origin dev-login closed |
| H4 consent gate | pytest app/test_auth_providers.py app/test_session_turn_persistence.py app/test_persona_review.py app/test_voice_ws.py -q | 64 passed; learner consent accept/withdraw, non-learner/unaccepted reject, no-consent session start 403 consent_required, voice dev persona consent guard, frontend generated API contract updated |
| Persona review workflow | app.test_persona_review | 31 tests OK; approved-only catalog, teacher/admin queue, draft authoring, approved persona revision, archive audit, learner 403 |
| Voice WS contract | app.test_voice_ws | 8 tests OK; auth guard, audio_start/chunks/audio_end, text_turn, ping, max audio cap, DB persona voice map binding, explicit preset override |
| Voice preset/EOT | app.test_voice_service | 14 tests OK; TTS payload, preset fallback, DB voice-map resolver, unsupported provider fallback, P1 sample TTS, EOT readiness |
| Voice metadata | app.test_session_turn_persistence | audio_ref/silence_ms/speech_rate/barge_in persisted on learner voice turn; review nonverbal events exposed |
| P1 MVP UI E2E | npx playwright test e2e/session-mvp.spec.ts --project=chromium-single-run | 1 passed |
| Persona/session review UI E2E | npx playwright test e2e/teacher.spec.ts --project=chromium-single-run | 2 passed; teacher approves pending persona and opens pending ended-session review detail from console |
| Voice UI synthetic E2E | npx playwright test e2e/voice-success.spec.ts --project=chromium-single-run | 2 passed; direct WS cascade plus Session mic button path with synthetic browser audio and Web Audio playback under blocked media-element autoplay |
| Voice s2s decision memo | docs/decisions/voice-s2s-poc.md | criteria recorded; keep/drop decision remains owner DECIDE |
| Hanshin data/SSO gate | docs/ops/hanshin-data-governance-gate.md | artifact created; written external evidence still required |
| Resistance engine | app.test_state_machine_resistance + scripts/smoke-resistance-openness-db.py | 9 focused tests OK; live DB smoke PASS. Empathy P1 curve 0→0→0.095→0.133→0.171 and DB final stage=탐색. Advice-jump curve stayed 0 and DB final stage=라포. |
| Python compile | python -m compileall app engine_gateway | Passed |
| Phase 3 artifact gates | python scripts\check-phase3-artifacts.py --help + pytest app/test_phase3_artifact_checker.py -q | Passed; checker now enforces CSV enums, KPI metric required fields, approved export PII/agreement/consent/withdrawal/file-hash gates. Actual pilot evidence still external. |
| Web build | npm run build | Passed |
| Pages production deploy | wrangler pages deploy dist --project-name vignette --branch main --commit-dirty=true | 24c90784, dirty local source deploy |
| Custom domain assets | https://vignette.chanpaca.net/login | index-HjXyC0JT.js, index-C8JKXhNP.css |
| Legacy Live2D routes | /live2d/mao/* / /live2d/haru/* / /live2d/live2dcubismcore.min.js | 404 |
| Compose template | docker compose -f infra\docker-compose.yml config --quiet | Template path is valid with dummy required env. API build context now uses repo root; stale rag.server sidecar removed. |
| Docker image smoke | docker build -f apps/api/Dockerfile . / docker run ... python -c "import app.main" / docker build -f apps/web/Dockerfile apps/web | API/Web image build and API import smoke pass after packaging cleanup. Web build uses npm lockfile and ignores host node_modules; API image excludes local .env files. |
| Deploy preflight | python scripts\check-deploy-preflight.py --skip-db --env-file infra\.env.example --allow-placeholder-secrets | Passed: exact-pinned API requirements, live coaching data/kb source pack, env template keys. DB mode can additionally check app-role DSN with --require-app-role. |
| Fresh compose smoke | docker compose -p vignette-packaging-smoke -f infra/docker-compose.yml up -d --build + proxy /api/health | Passed with dummy production-safe env: API healthy, DB healthy, web/proxy up, http://localhost:18080/api/health 200 with db:true, engine:true, engine_mode:"claude_cli". Smoke volumes/network removed after run. |
| Actual deployment env | infra/.env owner-secret fill-in | Remaining external step: deployment target must provide real APP_DB_PASSWORD, OAuth client id/secret, OPENAI_API_KEY, SESSION_SECRET, and production-safe engine/voice flags. Current local stray values such as ENGINE_MODE=claude_p and prod sample TTS must not be copied. |
| Focused E2E | admin + db-persistence + voice-success | 10 passed |
| Admin manage-users | admin.spec.ts --grep manage real server-known users | desktop/mobile 2 passed |
| Full E2E | PLAYWRIGHT_PORT=5174 npm run e2e | 113 passed |
| Public auth discovery | E2E_PUBLIC_AUTH=1 npx playwright test --list --project=chromium-public-auth | 2 tests listed |
| Public readiness | public-auth-turn.spec.ts --grep production-safe | 1 passed |
| Persona auth boundary | GET /personas | verified local/public unauth 401 |
| Public login | auth.spec.ts --grep public login | 1 passed |
| Public runtime scripts | start/watch/install-public-runtime*.ps1 | parser OK; watchdog check-only healthy. Default public checks exclude not-yet-live api-vnet.18ka.net; add future domains explicitly with -AdditionalPublicHealthUrls. |
| Public API health | https://api-vignette.chanpaca.net/health | prod, db true, engine true |
| Public/local/Tailnet login recovery | https://vignette.chanpaca.net/login / https://api-vignette.chanpaca.net/health / https://alpaca-home.taile93291.ts.net/login | 2026-06-28 current smoke: public login 200 (assets/index-HjXyC0JT.js, assets/index-C8JKXhNP.css), public API health prod/db/engine true, unauth public /personas 401, local 8001 prod health true, local 5174 public preview 200, cloudflared tunnel running. Vite host block/Cloudflare 502 not reproduced. |
| Local 5175 login | PLAYWRIGHT_BASE_URL=http://127.0.0.1:5175 auth.spec.ts | desktop/mobile passed |
| Learner/readiness E2E | learner.spec.ts + readiness.spec.ts desktop/mobile | 14 passed |
| Learner screenshots | learn-empty-desktop.png / learn-empty-mobile-compact.png | document overflow 0, empty history visible |
| Session layout/turn | session-layout.spec.ts desktop/mobile | 8 passed |
| Session end + dark theme UX | npm run typecheck, npm run build, layout-visual-gate, session-layout, avatar-expression, settings, session-review | typecheck/build passed; Playwright 묶음 36 passed. P1 active session은 rasterArtSet="seoyeon-live2d-psd-v2"를 사용한다. sad 표정은 PSD 기반 눈물/우는 입/울상 눈썹 파츠를 렌더한다. Settings now treats API system preference as current initial theme instead of forcing light. |
| Voice/session focused | voice + voice-success + session-layout | 15 passed |
| Layout redesign handoff | docs/ops/layout-redesign-handoff-2026-06-26.md | subagent scopes, files, verification, remaining visual review recorded |
| Layout redesign focused E2E | npx playwright test e2e/learner.spec.ts e2e/session-layout.spec.ts e2e/session-review.spec.ts e2e/admin.spec.ts e2e/settings.spec.ts e2e/teacher.spec.ts --project=chromium-desktop --project=chromium-mobile | 54 passed after isolated Admin tablet flake rerun |
| Strict layout visual gate | npx playwright test e2e/layout-visual-gate.spec.ts --project=chromium-single-run | 7 passed; 7 screens × 7 widths(390/720/861/900/1024/1280/1440), horizontal overflow 0 + control clip 0, 49 full-page screenshots |
| Parallel visual quality review | workflow layout-visual-quality-review (7 agents) | 49 screenshots read; per-screen findings(critical 1, major 8+, minor) → fix verdicts |
| Parallel layout fixes | 6 agent team: learner-home/session/review/professor/admin/settings (disjoint files) | all fixes applied; npm run typecheck OK; no cross-file conflicts |
| Strict gate re-run (post-fix) | npx playwright test e2e/layout-visual-gate.spec.ts --project=chromium-single-run | 7 passed; re-screenshotted 49 |
| Layout focused E2E re-run (post-fix) | learner/session-layout/session-review/admin/settings/teacher × desktop+mobile | 54 passed; no regression |
| Adversarial visual verify | workflow layout-visual-verify (7 agents) | 7/7 accept; critical/major resolved, regression 0; minor polish backlog recorded |
| Engine config 운영값 | GET /admin/engine-config | claude_cli / http://127.0.0.1:9099 / gateway-default, durable, source=database (의도값 일치) |
| Engine gateway probe (live) | scripts/probe-engine-gateway.py --base-url http://127.0.0.1:9099 --reuse-runs 2 | claude_p / opus-4-8; 단일 session_id 2회 reused stream; TTFT 1667–4199ms; cost 누적 0.068→0.123(turns 1→2) |
| Engine gateway RSS (live) | docs/ops/engine-rss-smoke-2026-06-28.md | gateway session 1개, health.sessions=1; gateway PID 51592 RSS 16.2MB; resident claude -p child PID 51688 RSS 363.3MB / Private 628.8MB after one turn; plugin bun children RSS 178.6MB. |
| Postgres RLS/audit smoke (live) | VIGNETTE_RLS_AUDIT_DSN=…vignette_app… check-postgres-rls-audit.py --write-fixtures | 5 checks PASS: preflight, learner 세션/턴 격리, teacher cohort 스코프, visible_to evaluator-only 숨김, teacher/admin read audit insert (NOBYPASSRLS app role, fixtures 자동 정리) |
| Turn cost telemetry (live DB) | SELECT … FROM app.turns WHERE actor_kind='client_ai' | 13 client_ai turns 적재: llm_provider=claude_cli, model=gateway-default, cost_usd 실값(합 $1.22, 평균 $0.094), visible_to 배열. 토큰은 CLI 게이트웨이 특성상 0, cost는 산출 |
| Cosmetic polish re-verify | 5 polish agents → typecheck + gate + layout E2E re-run | typecheck OK; gate 7 passed; layout focused E2E 54 passed; session-layout 8/8; regression 0 |
| Dashboard layout alignment | npm run typecheck / npm run build / layout-visual-gate / session-layout / learner+teacher+admin E2E | typecheck/build passed; layout gate 7 passed; session-layout desktop/mobile 8 passed; learner+teacher+admin chromium-desktop 17 passed. 대표 캡처는 docs/ops/layout-research-2026-06-28/final-gate-*.png. |
| Learner session archive | python -B -m pytest -p no:cacheprovider app/ -q / python -B -m pytest -p no:cacheprovider engine_gateway/ -q / npm run check:api-types / npm run typecheck / npm run build / npx playwright test e2e/learner.spec.ts --project=chromium-desktop --workers=1 | 168 backend passed + 9 gateway passed; OpenAPI generated archive DTOs are current; learner history can archive/restore an ended session and keeps archived sessions out of the review queue while preserving records. |
다음 실행 명령
남은 public OAuth /turn proof 확보용 명령이다.
cd D:\workspace\vignette\apps\web npx playwright codegen https://vignette.chanpaca.net/login --save-storage=.\node_modules\.tmp\public-auth.json $env:E2E_PUBLIC_AUTH="1" $env:E2E_PUBLIC_STORAGE_STATE=".\node_modules\.tmp\public-auth.json" .\node_modules\.bin\playwright.cmd test e2e/public-auth-turn.spec.ts --project=chromium-public-auth
cd D:\workspace\vignette powershell -NoProfile -ExecutionPolicy Bypass -File scripts\start-public-runtime.ps1
닫은 항목(live 증거): ① engine config 운영값(
claude_cli / 9099 / gateway-default, durable, db). ② 상주 엔진풀 probe — 단일 session_id 2회 reused stream, TTFT 1667–4199ms, cost 누적 0.068→0.123. ③ 상주 엔진풀 RSS — gateway session 1개에서 claude -p child RSS 363.3MB, gateway RSS 16.2MB. ④ Postgres RLS/audit smoke 5 checks PASS. ⑤ turn cost telemetry — app.turns client_ai 13행에 provider/model/cost_usd 실적재(합 $1.22). ⑥ 레이아웃 시각 게이트 7/7 + 적대적 재검수 7/7 accept.환경 제약으로 이 세션에서 못 닫는 항목(정직 표기): 공개 Google OAuth 실제
/turn(실제 계정 storageState 필요) · infra/.env compose 필수값(APP_DB_PASSWORD, OAUTH_GOOGLE_CLIENT_ID, OAUTH_GOOGLE_CLIENT_SECRET) · vnet.18ka.net/api-vnet.18ka.net 공개 런타임(DNS 미해결, Cloudflare 18ka.net zone 권한 불일치, Google OAuth redirect URI 등록 필요) · 한신대 데이터/SSO 거버넌스(owner/기관 written evidence 필요) · 음성 물리 마이크·공개 WSS·50분 양방향 장시간 실측 · claude_cli↔Messages API 폴백 동일성 · 재부팅 후 watchdog smoke · Phase 3 파일럿 게이트 · decisions 6건(owner 결정). 운영 원칙상 가짜 증거로 DONE 표기하지 않는다. 전체 추적: docs/ops/backlog-2026-06-26.md(B1 폴리시 · B2 환경제약 · B3 소유자결정 · B4 거버넌스).윤찬 결정 필요 상세
람다가 단독으로 정하면 월권인 항목이다. 결정되기 전에는 "완료"가 아니라 조건부로 둔다.
결정 6개조건부 GO 사유
DECIDE
s2s 2차 PoC 채택 여부
캐스케이드 1차는 확정. voice-s2s-poc.md 기준표에 따라 비교 리포트가 나온 뒤 유지/폐기를 정한다. 선택지: 캐스케이드만 / s2s 2차 PoC 유지.
영향
음성 아키텍처, 전송 비용, 로그 보존 방식. 람다 단독 결정 금지.
DECIDE
서비스용 페르소나 음성 모델·권리 정책
Higgs v3 무참조 synthetic seed 방식으로 P1 샘플은 만들었고, 개발 플래그로 P1 sample TTS provider를 서비스에 연결했다. 하지만 실서비스는 모델 상업 라이선스와 reference voice 권리정책이 닫히기 전까지 탑재 금지다. 선택지: Higgs 라이선스 확보 / 동의 받은 ref만 사용 / 대체 TTS provider.
영향
법적 리스크, 음성 품질, 페르소나 확장 비용, 운영 GPU 요구량.
DECIDE
fast-loop 외부 API 허용 여부
로컬 상주 분류기를 기본으로 하되, 외부 Haiku/Solar API 폴백을 허용할지 정한다. 선택지: 로컬 전용 / 외부 폴백 허용.
영향
데이터주권, 레이턴시, 장애 대응
DECIDE
재귀학습 fine-tuning 범위
1차는 few-shot 자동갱신만 할지, fine-tuning까지 포함할지 결정한다. 선택지: few-shot only / fine-tuning 포함.
영향
동의서, 데이터셋 품질, 운영 리스크
DECIDE
자유연습 기본값
수정안은 기본 ON + 피드백 권장 배지 + 교수자 토글을 제안한다. 선택지: 기본 ON / 교수자 승인 후 ON.
영향
학습자 자율성, 평가 품질, 안전 정책
DECIDE
추가 축어록 수급 규모/일정
n=1 시드의 한계를 해소하려면 추가 사례 수급 규모와 일정을 정해야 한다. 선택지: N건 목표/일정 확정.
영향
평가 타당도, 페르소나 다양성, Phase 3 측정력
완료라고 말하는 기준
- 실제 로그인 기반 E2E 증거가 있어야 한다.
- DB 쿼리나 로그로 저장/권한/비용이 확인되어야 한다.
- 시각 확인만으로 기능 완료를 선언하지 않는다.
문서 기준
MASTERPLAN은 원본 보존 문서다.MASTERPLAN_REVISIONS가 Phase/IRB/음성 정정 기준이다.dev_dashboard.html은 팀장 판단용 현재판이다.
운영 원칙
- mock/demo 자산은 운영 번들에서 제거한다.
- ignored runtime 파일은 커밋하지 않는다.
- 서버는 목적별 1개씩만 유지한다.
frontenddesign스킬이 있으면 먼저 쓰고, 없으면DESIGN_CONCEPT를 SSOT로 따른다.- UX는
docs/DESIGN_CONCEPT.md를 기준으로 하고, fake 기록/통계는 금지한다. - OAuth secret은 출력하지 않고 환경 파일/인프라 설정에만 둔다.
이번 세션 내러티브 (원문 보존)
이번 세션은 seed persona 결합 제거, 비개발 fail-closed 설정, compose OAuth 주입, admin 모바일 overflow 수정, persona 인증 경계 보강, 전체 Playwright 재통과, 공개 API prod 전환까지 완료했다. 이번 이어받기에서는 내담자 AI 생성 턴의 provider/model/token/cost 텔레메트리를 /turn, SSE stream, 음성 생성 경로에서 DB app.turns까지 적재하도록 연결했고, gateway stream done/error 계약을 구조화했으며, P1 상담 시작→텍스트 stream→종료→리뷰 피드백 UI E2E와 저항 엔진 정량 회귀 테스트를 추가했다. 이어서 PII 마스킹 게이트 우회 차단, RBAC/IDOR·감사 insert 경로, 음성 paralinguistic 메타 저장, 공개 런타임 watchdog 스크립트와 runbook을 보강했다. 추가로 상주 engine session reuse, SAML provider 스캐폴드, visible_to 런타임 필터, EOT/TTS payload 계약까지 회귀화했다. 백엔드 회귀 테스트는 84개로 재검증했고, 페르소나 승인/반려 API와 교수 콘솔 검수 UI proof를 추가했다. Postgres RLS/audit live smoke checker와 s2s 2차 PoC 판단 메모도 준비했지만, live DB 실행과 s2s 채택 결정은 별도 증거가 필요하다. 이후 로컬 5175 런타임 재기동, admin 사용자 관리 E2E 안정화, 학습자 홈 0회 기록 UX, active session 실제 SSE 스트림 전환, 텍스트/음성 실패 턴 미저장, 직접 URL persona 우회 차단, Live2D demo 자산 제거, AI 운영 fail-closed 보강까지 전체 Playwright로 확인했다. 2026-06-26 15:18 KST 기준 공개 API 터널을 복구한 뒤 전체 Playwright 72개가 desktop/mobile/single-run 모두 통과했다. Cloudflare Pages production 배포 2a58ca49도 완료했고, 커스텀 도메인이 새 asset을 서빙하는 것을 확인했다. 과거 Mao/Haru Live2D demo 자산은 repo와 번들에서 제거했고, /live2d/* 운영 경로는 404로 차단했다. 현재 런타임은 prod API 8001, dev API 8000/8010, web 5173, engine gateway 9099, cloudflared tunnel 1개를 의도적으로 유지한다. 이번 라운드에서는 레이아웃 작업을 서브에이전트 전담으로 분리해 세션, 학습자 홈/리뷰, 관리자/교수자, 설정 화면을 overflow 수리 수준이 아니라 실제 작업 화면 재설계 수준으로 갱신했다. 통합 레이아웃 E2E는 desktop/mobile 54개를 최종 통과했고, 자세한 인수인계는 docs/ops/layout-redesign-handoff-2026-06-26.md에 남겼다. 이번 이어받기에서는 핸드오프가 남긴 "실기기 시각 수용"을 엄격한 자동 게이트로 닫았다. 7개 권장 너비(390/720/861/900/1024/1280/1440)에서 7개 재설계 화면의 가로 overflow 0·컨트롤 클립 0을 강제하는 layout-visual-gate.spec.ts(7 passed, 49장 스크린샷)를 만들고, 화면별 1에이전트 병렬 시각 리뷰 → 6개 병렬 수정 에이전트 → 화면별 적대적 재검수까지 돌려 7/7 accept(critical/major 0, 회귀 0)를 확정했다. 학습자홈 1280 3열 가운데 컬럼 붕괴(critical)와 교수 'API 404' raw 배너를 포함한 결함을 모두 해소했고, 레이아웃 항목을 DONE으로 닫았다. 이번 로그인 복구 라운드에서는 dev/Tailnet OAuth direct start까지 local_oauth_unavailable로 막고, public OAuth state를 HttpOnly 쿠키에 묶인 서명 토큰으로 바꿔 API 재시작 후 콜백이 invalid_state로 실패하지 않게 했으며, callback 실패 reason/status 진단 로그와 화면 메시지 분기를 추가했다. 추가로 Google provider error를 access_denied/provider_error로 분리하고 로그인 화면에 reason code를 노출했다. 이어서 C1 사례개념화 워크시트는 리뷰 API·편집 UI·app.case_worksheet 저장/재조회 경로까지 2차로 연결했다. 공개 Google OAuth 실제 /turn 증명만 storageState 캡처 후 남아 있다.