yunchan/vignette
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
vignette/docs/ops/backlog-2026-06-26.md
Yun Chan 4cd354881f 주기 회기 검증 격리 보강
2026-08-10 01:25:45 +09:00

17 KiB
Raw Blame History

Vignette 백로그 — 열린 항목만 (현행본)

SSOT는 docs/dev_dashboard.html이다. 상태·검증 증거·결정·로드맵의 권위 기준은 대시보드다. 이 파일은 대시보드와 일치하는 아직 열린 작업(외부/환경 게이트) 만 얇게 유지한다. 완료된 작업의 변경 로그·검증 기록(구 "최신 동기화 추가"·"이번 세션에 닫은 것"·B1~B3 [x] 상세)은 docs/archive/ops/backlog-2026-06-26-full-history.md로 냉동 보관했다. 필요할 때만 이력용으로 본다.

운영 원칙: 가짜 증거로 DONE 표기 금지. 실증 불가·외부 의존·소유자 결정 항목만 여기서 추적한다. 분류: B1 비차단 폴리시 · B2 환경 제약(증거 생산 불가) · B3 소유자 결정 · B4 외부 거버넌스

B0. 원천문서 갭 — 한신대 산학협력 원천문서 갭(critical/high/medium)은 SSOT 대시보드 "원천문서 갭 분석" 섹션과 상세 근거 docs/ops/source-docs-gap-analysis-2026-06-26.md에서 추적한다. C1~C3/H·M 구조는 코드로 선제 구축했고, 임상 문안·평가기준·골든셋 콘텐츠는 임상팀(구훈정·어유경) 외부 정의로 받는다.

Outcome & Alliance OS — 2026-08-06 정식 전략 실행 트랙으로 승격했다. G0 Measurement Truth, G1 현재 소스·실행 증거 재감사에서는 G0G6과 G8이 DONE이다. G1 승격 prompt 1.2+read-skew/JSON 복구는 24/24 ready·방향 9/9·오류 0을 재확인했고, G0 census 29/29·위반 0, G4/G5 실제 API/DB/브라우저 폐루프, G6 safety metadata-only 최우선 runtime을 disposable clone에서 확인했다. G8은 실제 receipt-bound image rollback 2회(nas-g8-723eeef2…/nas-g8-2738846c…)에 더해 source HEAD 61a41d1f…6af·tree 87dec55d…3b77·archive 4d15d055…119d4d의 candidate 112/112와 실제 NAS 평문 origin 112/112를 통과했다. 과거 6030a677…c611의 UUID 24건 실패와 후속 SHA 결함 rollback은 이력으로 보존하며 현재 완료 증거로 재사용하지 않는다. G7 Multimodal Alliance는 내부 구현 DONE과 외부 proof GATE를 분리한다. detached-clean public b34623f3…·OpenAPI 126·local_whisper/melotts ready·authenticated WSS 무마이크 rehearsal까지 완료했고, 명시 동의 물리 마이크 3,120초·독립 라벨 voice-gain benchmark·동시 topology high-water를 추적한다. 외부 Deepgram/OpenAI adapter는 fallback으로 보존한다. G0G8과 AOS-001~012는 docs/TODO.md I절에서 전건 추적하고, 상태는 SSOT 대시보드의 9개 계획 카드가 소유한다. 이 얇은 백로그에는 그중 외부·환경 증거가 필요한 항목만 기존 B2/B4/Phase 3 게이트와 합쳐 유지한다.

B1. 비차단 코스메틱/후속 폴리시

  • 운영 티켓 자동 분류·처리 후속 — Claude Recipe headless 자동 수정 후보, 관리자 승인 후 이슈 등록·PR/작업 스레드 생성, 처리 결과 audit trail 확장은 아직 설계/승인 필요. 담당 그룹 자동 배정·우선순위 escalation·raw/rollup 보존기간 같은 운영 정책은 B3에서 이미 결정됨(수동 승인·미도입 고정). 자동 수정은 운영자 승인 전까지 실행하지 않는다.

B1 완료 항목(학생 리뷰 1~5 척도 320px 반응형 재배치, 셸 구분선, 세션 종료 UX/다크테마, 아바타 SVG 리그 복귀와 래스터 비활성화, SEO/공유 카드, 레이아웃 정렬, 권한 위임, 메일링, 아카이브 API, TTS voice map, 빈상태 레이아웃, 평가 실패 복구 UX, SSE 저장, live-coach 표면화, 음성 메타, 위기 게이트 UI, 운영 티켓/헬스 샘플러 등)의 상세·검증 로그는 아카이브 full-history 참조.

B2. 환경 제약 — 이 워크스테이션에서 증거 생산 불가

  • 공개 DB 계정·회기 복구 안정화 — 2026-08-07 18:26 KST owner 승인으로 recovered named volume을 vignette-dev-db:55432에 전환했다. cutover owner 집계 users 84, sessions 30, turns 705, Google 계정 16, Google 소유 회기 30, orphan 0이며 health·engine·OAuth·watchdog가 정상이다. 기존 인증 세션은 복사하지 않아 사용자는 Google 재로그인이 필요하다. current dump·old-original dump·전환 직전 rollback container를 모두 보존하며, 실제 사용자의 소유 회기 확인과 자동 백업 운영화 전에는 제거하지 않는다. 2026-08-09 Docker Desktop 중단과 18:02:55 KST Docker Desktop UI의 active DB 직접 stop으로 db=false가 재발했지만 동일 recovered container/volume만 재기동했다. 현재 owner read-only 집계 users 356/sessions 193/ turns 726, Google users 16/Google-owned sessions 31이고 public db/engine true다. 2026-08-09 fresh dump vignette-dev-db-vignette-20260809-122235Z.dump SHA f1fd569c…5f64를 보존했다. 공개 API/cloudflared는 detached-clean b34623f3…·tree 32cc85c7…로 승격했고 OpenAPI 126·local voice exact·receipt 9f8d1941…a21bf passed를 확인했다. watchdog·로그온 boot도 같은 stable root의 commit/tree/script SHA에 pin해 명시 실행 결과 0·Ready를 확인했다. 실제 Windows 재부팅 후 자동복구 smoke는 남아 있다. 상세: docs/ops/public-db-recovery-rehearsal-2026-08-07.md.
  • DB 백업 운영화 — 검증형 one-shot custom dump와 실제 일회용 restore drill은 통과했다. 예약 실행, 실패 알림, NAS/off-host 암호화 복제, restore drill 주기와 보존 정책을 운영 게이트로 남긴다.
  • vnet.18ka.net 공개 live 전환 — 코드/스크립트는 vnet.18ka.net·api-vnet.18ka.net 허용까지 갱신됨. 남은 블로커: (1) vnet.18ka.net/api-vnet.18ka.net DNS A record 부재, (2) cloudflared 현재 인증 컨텍스트가 18ka.net zone이 아니라 chanpaca.net zone에 route dns 생성, (3) Google Console redirect URI https://api-vnet.18ka.net/auth/callback 등록 필요. 현재 prod API 8001은 db:true/engine:true로 건강. 상세: docs/ops/tailscale-vnet-runtime-2026-06-27.md.
  • Compose 패키징용 infra/.env owner-secret fill-in — 현재 production direct-runtime은 서로 다른 G3~G8 내부 토큰 6개, 필수 운영키, DB current_user=vignette non-owner app-role preflight와 공개 health를 통과했다. 향후 Compose 패키징 전환 시 APP_DB_PASSWORD 등 패키징 비밀과 prod-safe engine/voice flags를 별도 주입하고 compose profile preflight를 다시 닫는다.
  • 공개 Google OAuth 실제 /turn proof — 로그인 가능한 계정으로 storageState 캡처 후 E2E_PUBLIC_AUTH=1
    • chromium-public-auth 1회 통과 필요. (소유자 지시로 보류 중.) 실행 명령은 대시보드 "다음 실행 명령" 참조.
  • 음성 캐스케이드 live — 공개 G7 API route와 TLS 1.3 WSS handshake, 비인증 1008 차단, 로컬 synthetic short soak는 통과했다. Deepgram/OpenAI fallback adapter와 운영 기본 local_whisper/melotts의 interim/final/word timestamp, HMAC word pseudonym, streaming 중 1초 동의 재검사, 공통 consent transaction lock, bounded queue/10MiB cap, 텍스트 보존·음성 재연결 UX, ready provider/model 계약은 code/internal 완료다. actual-Postgres 동시 철회는 writer 대기→커밋 뒤 차단과 timeline row 0, synthetic gold benchmark는 text-only 1-MAE 0.9533→multimodal 0.9673을 확인했다. public runner의 preflight는 auth cookie·소유 회기로 WSS ready/ping과 기대 STT/TTS provider/model 네 값을 마이크 열거·캡처 없이 검사한다. full soak는 --confirm-physical-capture 없이는 장치를 열기 전에 exit 3이다. Session 첫 음성 사용은 30일·원음 미보존 서버 동의 원장을 먼저 기록하며, 성공 전 getUserMedia와 voice WebSocket은 0회다. public runner v4의 turn별 interim/speech-final/latency, 관리자 single-worker runtime high-water, exact image/container/cgroup/proc/Docker/TCP topology sampler, held-out 30명 외 calibration split 참가자를 포함한 총 최소 31명/held-out 50회기/150축 독립 blind human-held-out voice-gain evaluator와 이를 같은 public host·동시 50분 시간창으로 묶는 canonical checker까지 code/internal 준비를 마쳤다. 운영 TTS는 MeloTTS Korean(MIT) loopback으로 전환했고 외부 OpenAI adapter와 회기 전·중 AI 생성 음성 고지는 보존했다. clean public runtime·local_whisper/melotts exact ready·authenticated WSS의 30초 무마이크 rehearsal은 voice/runtime/topology 각 7 samples로 통과했다. 남은 범위: 실행 직전 장치 선택·명시 동의 물리 마이크와 3,120초 양방향 soak, 독립 라벨 held-out/pilot voice-gain benchmark, 같은 실행의 실제 worker·Uvicorn·OS·Cloudflare edge RSS/CPU/queue high-water. 네 artifact가 scripts/check-g7-external-proof.py exit 0을 만들기 전에는 닫지 않는다. current source의 start-public-runtime.ps1는 sidecar-before-API lifecycle, exact local_whisper/small/cpu-int8·melotts/melotts-korean readiness, provider env, Uvicorn --ws websockets --ws-max-queue 4를 fail-closed로 연결했다(launcher/sidecar 80/80, API voice 71/71). 공개 topology용 Windows host mode도 PID/start/exe·command SHA/cwd, RSS/CPU/handles/threads, listener owner/conflict와 TCP high-water를 검증한다. 공개 runtime은 detached-clean b34623f3…에서 receipt-bound로 실행 중이고 task source pin도 result 0이다. 물리 마이크 창은 사용자 장치 선택·명시 동의 전에는 열지 않는다. 코드 P0는 완료됐다. runner exit는 canonical checker exit 0/gate_closed=true에 결속되고, browser Origin은 API/WSS/admin/topology host·scheme과 분리 검증되며, 실제 capture 최소 3,120초와 세 artifact 공통 overlap ≥3000s를 강제한다. Windows topology는 detached-clean HEAD/tree, runner/collector/checker SHA와 exact psutil==6.1.1까지 pin한다. fresh launcher는 legacy API/exact-config cloudflared를 bounded 교체해 새 PID/start/exe/command SHA/cwd safe receipt를 만든다. current six-suite 87/87과 runtime sampler 4/4를 통과했다. 무마이크 rehearsal은 완료됐지만 물리 마이크·human pack을 대체하지 않는다. 격리 NAS 프리뷰 http://100.116.83.60:8088은 전용 Compose 프로젝트·포트·네트워크·볼륨에 배포했고, 실제 브라우저 회기와 review API 저장 축어록 2턴을 확인했다. 기존 프로젝트 중단·재생성 명령은 실행하지 않았다. 매시간 Vignette 앱 상태·회기 E2E 정기 검증 heartbeat(automation id vignette-e2e)는 ACTIVE이며 공개/NAS 화면·health는 읽기 전용으로 보여주고, material milestone에서만 전용 disposable 회기 E2E를 실행한다. NAS 112건은 실 API/DB 22와 route fixture 90으로 영수증에서 분리한다. 동일 학습자 SSE→review→G4/G5 actual 폐루프 runner의 clean HEAD/tree·보호 포트 거부·sentinel·exact cleanup과 unit 12/12는 완료됐다. 최초 세 full run은 하네스 결함, 4차는 reload ledger hydration 제품 결함을 fail-closed했다. 5차 핵심 폐루프는 SSE·review·G4/G5 0→1→1을 처음 통과했지만 같은 fixture를 재사용한 후속 회귀가 2/4 실패해 전체 receipt는 FAILED다. 다섯 번 모두 public/NAS/active DB 접촉 0·자원 잔여 0이다. runner는 핵심 폐루프와 후속 회귀에 별도 zero-state fixture를 준비하도록 수정했지만 다음 clean single run의 전체 GREEN receipt가 남았다. release gate·NAS preflight·배포 SHA 변경 때만 프리뷰를 갱신한다. 2026-08-07 SHA 6030a677af7e87cbfabc422b553d108d53414fd3c446548734a13b036d35c611의 localhost 108/108과 평문 origin UUID 24건 실패는 역사 기준선으로 보존한다. 실제 receipt-bound rollback은 같은 프리뷰에서 별도 helper로 두 번 실행해 종료했다(런북, 기계 판독 증거). 현재는 source HEAD/tree 61a41d1f…6af/87dec55d…3b77의 active archive 4d15d055…119d4d, exact API/Web d5021950…e4b1/9796c092…4b36이 실행 중이다. candidate 112/112와 실제 NAS-origin 112/112, health ok·db/engine true·auth 401·OpenAPI 126을 통과했고 fresh dump 36ec8748…24db8 1,097,100 bytes·TOC 1,738/TABLE DATA 129와 previous 6030a677…c611을 보존했다. 증거: 배포 증거, 브라우저 증거. 명시 동의 물리 마이크와 독립 human voice-gain 증거는 아직 없으므로 G7은 external GATE로 유지한다.
  • claude_cli ↔ Anthropic API live 동일성 — provider 라우팅·Anthropic /v1/models 탐색·지원 추론 강도·관리자 fail-closed 저장 경로는 구현 완료. 남은 범위는 연구팀/기관 ANTHROPIC_API_KEY를 게이트웨이 호스트에 주입한 live 응답·계량·오류 표면화 비교다. Claude CLI·Codex CLI(Terra/Medium)·Agy CLI(Gemini 3.6 Flash/High)는 로컬 live probe를 통과했다.
  • stable-source 재부팅 후 watchdog smoke — watchdog·로그온 boot는 detached-clean b34623f3… stable root와 exact commit/tree/script SHA에 재등록했고 명시 실행 결과 0·Ready를 확인했다. 남은 것은 실제 Windows 재부팅 후 엔진/API/터널 복구와 public /turn 실측이다. DNS 개통 후 api-vnet.18ka.net은 -AdditionalPublicHealthUrls로 명시 추가. 상세: docs/ops/public-runtime-watchdog.md.

B3. 소유자(윤찬) 결정 — 전건 확정(2026-06-30)

7건(평가설계 H1 κ/ICC·환각률, s2s 2차 PoC 채택, 페르소나 음성 모델·권리, fast-loop 외부 API 허용, 재귀학습 fine-tuning 범위, 운영 보존기간·에스컬레이션, 추가 축어록 수급 20건/1개월)은 전건 확정됐다. 결정 상세는 대시보드 "윤찬 결정 상세" 탭, ADR은 docs/decisions/(voice-s2s-poc.md, backend-node-transition.md)에 있다. 각 결정의 구현·실측은 후속 build/GATE로 남는다.

B3-신규 (2026-07-27 전수 E2E 순회에서 제기 → 2026-07-27 소유자 전건 결정 완료)

소유자(윤찬)가 질문 도구로 7건 전건 결정(2026-07-27). 결정 내용과 구현 상태:

  • 설정 화면 아바타 변경 UI — 결정: 설정에 추가. 구현 완료(RED→GREEN, 대시보드 144차).
  • 동의 관리·철회 UI와 재동의 흐름 — 결정: 전체 흐름 구현(설정 동의 섹션 + 철회 + 재동의 경로). 구현 완료(RED→GREEN, 대시보드 144차).
  • 신규 학습자 첫 추천 난도 — 결정: 기초 우선 추천(회기 기록 없는 신규 학습자는 기초 난도 페르소나를 첫 추천으로). 구현 완료(RED→GREEN, 대시보드 144차).
  • 학생 분석 테이블 — 결정: 지금 가상화 도입. 구현 완료(RED→GREEN, 대시보드 144차).
  • 저작 모드 좌측 레일 잔존 마크업 — 결정: 정리(저작 모드에서 레일 미렌더). 구현 완료(RED→GREEN, 대시보드 144차).
  • dev-login 재로그인 자동 재승인 — 결정: 현행 유지(dev/E2E 편의 의도 확정). 코드 변경 없음.
  • 감정 밸런스 타임라인 차트(결함 로그 #21) — 결정: 지금 구현(평가 데이터 생산→저장→ 리드모델→차트 연결). 구현 완료(RED→GREEN, 대시보드 144차).

근거·상세: docs/ops/e2e-full-sweep-2026-07-27.md 발견 결함 로그 #2·#4·#6·#14·#15·#16·#21.

B4. 외부 거버넌스 — 한신대/데이터 steward 서면 증거

  • 한신대 데이터/SSO 거버넌스 게이트 — SSO claim mapping, 추가 축어록 수급, 미성년 원본 활용동의, 개인정보 처리방침. 로컬 골격 docs/ops/hanshin-data-governance-gate.md 준비됨, 외부 서면 증거 필요. (소유자 보류 중.)
  • L1 스택 정합성·저작권 등재 문서 반영 — 백엔드는 Node.js 교체 가능성 우선으로 결정됐지만, 신청서/저작권 등재 문서에는 현재 FastAPI 유지 사유와 계약 우선 전환 계획을 반영해야 한다. 로컬 결정 기록은 docs/decisions/backend-node-transition.md; 외부 제출/등재 증거 필요.

Phase 3 파일럿 게이트 (실참여자 필요)

  • 20명 교육용 파일럿 운영 / 효과성·KPI 측정(SUS·자기효능감·κ/ICC·환각률) / 재귀학습 데이터셋 approved 산출 / 개인정보·동의 감사. 문서·checker·dry-run exporter는 준비됨(docs/phase3/*, scripts/check-phase3-artifacts.py, scripts/export-recursive-dataset.py, scripts/export-phase3-kpi.py). 공식 문항 확정, 통계 검정, 실험/통제군 배정, 실제 approved evidence는 파일럿·steward/legal 검수·IAA 통과 시점의 GATE다.