Phase 0closing
기반 정렬 / 운영 안전장치
인프라, 인증 경계, fail-closed, 공개 배포, 회귀 테스트 안정화.
- 상태: 대부분 완료, 공개 `/turn` proof만 남음
- 검증: build + backend 20 + Playwright 72
- 운영: prod API 8001, engine 9099, tunnel 1개
team lead review
전체 로드맵 기준 현재 위치는 Phase 0 종료 직전이다.
이번 세션은 seed persona 결합 제거, 비개발 fail-closed 설정, compose OAuth 주입, admin 모바일 overflow 수정, persona 인증 경계 보강, 전체 Playwright 재통과, 공개 API prod 전환까지 완료했다. 이후 로컬 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 배포 `0fe8f3cc`도 완료했고, 커스텀 도메인이 새 asset을 서빙하는 것을 확인했다. 과거 Mao/Haru Live2D demo 자산은 repo와 번들에서 제거했고, `/live2d/*` 운영 경로는 404로 차단했다. 로컬 프로세스는 prod API 8001, engine gateway 9099, cloudflared tunnel 1개만 남기고 dev API와 임시 Vite preview를 내렸다. 다만 이 HTML은 지금까지 Phase 0 상태판처럼 쓰였고, 아래에 Phase 1 이후 전체 계획을 보강했다. 공개 Google OAuth 실제 `/turn` 증명만 storageState 캡처 후 남아 있다.
Full Playwright72 passed
Pages Production0fe8f3cc
Public APIprod OK
Backend unittest20 OK
RoadmapP0-P3
DecisionP0 조건부
전체 개발 로드맵
`docs/MASTERPLAN.md`와 `docs/redteam/MASTERPLAN_REVISIONS.md`를 합친 팀장 판단용 단계표
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회 통과
CHECK
engine config 운영값 재확인
E2E가 admin engine config를 만질 수 있으므로 배포 전 `mode/url/model` 값을 확인한다.
산출물
admin AI 운영 화면 캡처 또는 config API 응답
검증
`claude_cli / http://127.0.0.1:9099 / gateway-default` 의도값 대조
DONE
과거 Live2D demo 자산 제거
Mao/Haru 샘플, Pixi/Cubism 런타임, 공개 `/live2d/*` 캐시 잔여 접근을 차단했다.
산출물
`apps/web/functions/live2d/[[path]].js`, SVG-only avatar
검증
운영 `/live2d/mao/*`, Cubism core `404`
DONE
프로세스 난립 정리
임시 Vite preview와 dev API를 내리고 운영 확인용 프로세스만 유지한다.
산출물
9099 engine, 8001 prod API, cloudflared tunnel 1개
검증
`Get-NetTCPConnection`에서 8000/517x/5537 비어 있음
GATE
한신대 공문/데이터 거버넌스 게이트 정리
SSO 클레임, 추가 축어록 수급, 미성년 원본 활용동의, 개인정보 처리방침을 P1 진입 전 외부 의존성으로 명확히 둔다.
산출물
공문 질의서, 동의 범위 체크리스트, SSO claim 표
검증
IRB 게이트가 아니라 데이터/SSO 게이트로 문서 전수 정합
팀장 판정
- 로컬 회귀와 공개 prod-safe 게이트는 통과했다.
- Cloudflare Pages production `0fe8f3cc`이 `543d48c` 소스로 배포됐다.
- 운영 반영 전 남은 핵심 증거는 공개 Google OAuth 실제 `/turn` smoke다.
- 런타임 mock/demo 자산은 운영 번들에서 제거하고, 테스트 fixture만 남긴다.
제품/UX 완료
- 학습자 홈 0회 기록 상태는 fake 기록 없이 실제 서버 세션 0개로 표시한다.
- active session은 실제 SSE token 이벤트로 자막을 쌓는다.
- 텍스트/음성 실패 턴은 transcript와 저장소에 남기지 않는다.
- 375px급 active session viewport overflow를 보정했다.
- 직접 URL persona 우회는 DB 원본 persona가 아니면 차단한다.
- 세션 화면은 SVG persona avatar만 렌더링한다.
운영/테스트 완료
- seed persona 결합을 제거하고 DB persona 기반 E2E로 전환했다.
- 비개발 런타임은 dev login, seed fallback, 기본 secret, localhost CORS를 fail-closed 한다.
- compose OAuth/CORS/OpenAI base 설정을 API 컨테이너에 명시했다.
- persona catalog는 비로그인 401로 인증 경계를 가진다.
- admin 모바일 overflow, AI 운영 상태 문구, global engine config 테스트 격리를 정리했다.
- handoff, E2E README, 이 대시보드를 최신 상태로 맞췄다.
Phase 1 MVP 코어 루프 상세
목표는 “P1 내담자와 실제 상담 1회 완주 후 피드백을 받는 공개 시연 가능 상태”다.
우선순위: P0범위: 텍스트+음성 1턴완료보고: E2E 증거 후
TODO
LLMEngine 정규화 계약 고정
claude_cli와 Messages API 폴백이 같은 이벤트 스키마와 cost 규약을 반환하게 한다.
산출물
`delta.text`, `result`, `cost` 이벤트 계약과 contract test
검증
동일 입력 → 두 어댑터 정상화 출력 동일성 테스트
TODO
상주 `claude -p` 엔진풀 실증
`--input-format stream-json` 상주 프로세스를 회기당 1회 기동하는 구조로 검증한다.
산출물
TTFT p50/p95, 동시 4회기 RSS/OOM 로그
검증
실측 전 “빠름/검증됨” 표기 금지
TODO
마스킹 게이트 강제
claude_cli 경로도 Presidio/가명처리 후에만 stdin으로 들어가게 막는다.
산출물
엔진 어댑터 전단 마스킹 미들웨어, 우회 차단 테스트
검증
민감 텍스트 raw 외부 전송 경로 0개
TODO
P1 상담 완주 플로우
로그인, P1 선택, SSE 상담, 종료, 회기말 리뷰를 한 번에 통과시킨다.
산출물
turn DB 적재, session review, cost telemetry
검증
Playwright로 실제 로그인 → 상담 완주 → 피드백 수신
TODO
저항 엔진 정량 검증
공감 발화와 조언점프 발화 세트를 넣어 openness 곡선을 비교한다.
산출물
공감 5턴 vs 조언 5턴 DB 쿼리 결과
검증
공감 시 개방도 상승, 조언점프 시 하락 증거
TODO
음성 왕복 1턴 PoC
Phase 1에서 음성을 완전히 뒤로 미루지 않고, 얇은 1턴 왕복 증거를 만든다.
산출물
STT transcript, TTS audio, voice turn log
검증
실제 마이크/오디오 1턴 + 실패 시 턴 미저장
Phase 2a 권한, OAuth, 페르소나 상세
음성과 섞지 않고 3역할, 권한격리, 페르소나 확장을 독립 트랙으로 닫는다.
주차: 9-13우선순위: P1IDOR 검증 필수
TODO
OAuth BFF / HttpOnly 세션 완성
브라우저에 토큰을 저장하지 않는 BFF 세션을 역할 페이지 전체에 통일한다.
산출물
Auth Code + PKCE, stateful session, role claim mapping
검증
비로그인 401, 역할 없는 접근 403, 쿠키 보안 속성 확인
TODO
학습자/교수자/관리자 권한 격리
RBAC와 cohort 소유권 게이트를 모든 session/review/admin API에 적용한다.
산출물
권한 미들웨어, audit log, role route map
검증
타인 `session_id` 직접 입력 → 403 스크린샷
TODO
`visible_to`와 인간 권한 레이어 분리
AI 정보비대칭과 사용자 권한을 섞지 않는다. 인간 조회는 RBAC와 cohort AND 게이트다.
산출물
RLS 정책, enforcement middleware, 테스트 matrix
검증
AI-only hidden field가 인간 조회 권한을 열지 않음
TODO
페르소나 P2/P3 교수 검수 루프
P1 단일 시드에서 P2/P3로 확장하되 교수 검수 상태와 공개 가능 상태를 분리한다.
산출물
persona review workflow, versioning, approval state
검증
미승인 persona는 학습자 시작 불가
TODO
SAML SP 스캐폴드 선반영
1차는 Google OIDC로 가되 한신대 SSO 전환 지점을 Authlib provider로 남긴다.
산출물
provider abstraction, SAML placeholder config
검증
Google OIDC 경로 회귀 없이 provider 교체 가능
Phase 2b 음성 캐스케이드 상세
음성은 “되게 보이는 UI”가 아니라, 전송, STT, EOT, 엔진, TTS, 저장까지 끊기지 않아야 한다.
주차: 13-17WSS 50분실측 전 완료 금지
TODO
voice gateway WebSocket
브라우저 AudioWorklet PCM을 WSS로 보내고, TTS 오디오 청크를 내려받는다.
산출물
`voice.chanpaca.net` 또는 단일 도메인 WSS 경로
검증
50분 WSS 양방향 스트림 끊김 실측
TODO
Deepgram STT + EOT
interim/final transcript와 상담 튜닝 침묵 임계, semantic EOT를 연결한다.
산출물
transcript timestamp, silence_ms, final segment
검증
침묵/말 끊김/짧은 대답 케이스 회귀
TODO
OpenAI TTS voice preset 추상화
persona별 voice_id와 prosody instruction을 저장하고 교체 가능하게 한다.
산출물
`voice_persona_map`, provider-agnostic params
검증
P1/P2/P3 voice preset 분리, fallback 정상
TODO
barge-in / paralinguistic logging
중간 끼어들기, 침묵, 말속도 같은 음성 메타를 턴 로그와 분리 저장한다.
산출물
`turn_paralinguistic` 또는 turns nullable 확장
검증
barge-in 케이스가 audit 가능하게 남음
TODO
s2s 2차 PoC 판단
캐스케이드는 1차로 확정하고, s2s는 transcript 보존/몰입감 기준으로 별도 판단한다.
산출물
캐스케이드 vs s2s 비교 메모
검증
윤찬 결정 항목으로 기록, 람다 단독 폐기 금지
Phase 3 교육용 파일럿 / 효과성 상세
IRB 승인 게이트가 아니라 교육 활용 파일럿과 데이터/개인정보 게이트로 관리한다.
주차: 18-20+표본: 20명first measure
TODO
20명 교육용 파일럿 운영
수련생이 실제 계정으로 세션을 완주하고 사전/사후 설문을 남긴다.
산출물
참여자별 session, pre/post, consent state
검증
20명 완주율, 중도중단 사유, 세션 로그 대조
TODO
효과성/KPI 측정
SUS, 자기효능감, κ/ICC, 환각률, 피드백 타당도를 파일럿에서 처음 측정한다.
산출물
KPI report, metric query, anonymized export
검증
SUS≥80, κ≥0.6/ICC≥0.75 같은 기준 충족 여부
TODO
재귀학습 데이터셋 1차 산출
라벨링/검수/κ 누적은 영속 워크플로우로 관리하고 fine-tuning 여부는 별도 결정한다.
산출물
export_manifest, JSONL, annotation checkpoint
검증
train/test 누수 없음, 원문/가명본 경계 확인
TODO
개인정보/동의 감사
미성년 원본 활용동의, 가명처리, 해외 전송 고지, 삭제/철회 절차를 실제 운영 기준으로 점검한다.
산출물
privacy checklist, audit log, withdrawal runbook
검증
동의 철회 후 접근/학습 사용 차단 재현
운영 / 검증 상세
실제 운영 도메인에 반영됐는지, 서버가 하나로 정리됐는지, 완료라고 말할 증거가 있는지 확인하는 탭이다.
웹: 200API: prod OKLive2D: 404
DONE
운영 웹 asset 확인
커스텀 도메인이 최신 JS/CSS asset을 서빙한다.
산출물
`index-D1Z5DH5J.js`, `index-BA9-xxfn.css`
검증
`Invoke-WebRequest https://vignette.chanpaca.net/`
DONE
공개 API prod health
터널은 prod API 8001을 보고, API는 DB와 engine을 모두 확인한다.
산출물
`environment:"prod"`, `db:true`, `engine:true`
검증
`https://api-vignette.chanpaca.net/health`
DONE
서버 정리 상태
운영 확인용 프로세스만 유지하고 임시 dev server는 내린다.
산출물
8001 API, 9099 engine, 20241 cloudflared
검증
`Get-NetTCPConnection` 대상 포트 확인
WATCH
재부팅 후 런타임 재기동
Windows 재부팅/업데이트 후에는 engine gateway와 prod API, cloudflared를 같이 올려야 한다.
산출물
runbook 또는 scheduled task
검증
재기동 후 public health와 `/turn` smoke 재확인
검증 실행 결과
- Web typecheck: `npm run typecheck` passed.
- Backend unittest: `app.test_runtime_policy`, `app.test_session_turn_persistence`, `engine_gateway.test_gateway_model` 20 OK.
- Python compile: `python -m compileall app engine_gateway` passed.
- Web build: `npm run build` passed.
- Full E2E: `PLAYWRIGHT_HOST=127.0.0.1 npx playwright test` 72 passed.
- Latest focused E2E: learner + session-layout + settings + admin 37 passed.
공개 운영 증거
- Pages deploy: `0fe8f3cc`, source `543d48c`, branch `main`.
- Custom domain assets: `index-D1Z5DH5J.js`, `index-BA9-xxfn.css`.
- Public readiness: `public-auth-turn.spec.ts --grep production-safe` 1 passed.
- Public login: `auth.spec.ts --grep public login` 1 passed.
- Legacy Live2D routes: Mao/Haru/Cubism core 404.
- Persona auth boundary: local/public unauth `GET /personas` 401.
다음 실행 명령
- `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`
- `powershell -NoProfile -ExecutionPolicy Bypass -File scripts\start-public-runtime.ps1`
윤찬 결정 필요 상세
람다가 단독으로 정하면 월권인 항목이다. 결정되기 전에는 “완료”가 아니라 조건부로 둔다.
결정 5개조건부 GO 사유
DECIDE
s2s 2차 PoC 채택 여부
캐스케이드 1차는 확정. s2s는 몰입감과 transcript 보존 기준으로 유지/폐기를 정한다.
선택지
캐스케이드만 / s2s 2차 PoC 유지
영향
음성 아키텍처, 전송 비용, 로그 보존 방식
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은 출력하지 않고 환경 파일/인프라 설정에만 둔다.