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 ba5e6326d5 평문 환경 숙의 연습 해시 보정
2026-08-09 19:38:04 +09:00

19 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이 internal 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…)는 executed lifecycle receipt로 완료됐지만, 같은 NAS SHA의 평문 origin 회기 E2E 24건 실패 때문에 UUID 수정 배포·NAS-origin 재검증 전까지 전체 상태는 runtime REVALIDATION이다. 과거 clean release/NAS의 route·asset·auth·browser 증거는 배포 존재 이력으로 보존하지만 현재 소스의 완료 증거로 재사용하지 않는다. G7 Multimodal Alliance는 내부 구현 DONE과 외부 proof GATE를 분리하며 current source 공개 배포, 운영 기본 local_whisper/melotts ready, authenticated public WSS, 명시 동의 물리 마이크·50분 soak, 독립 라벨 voice-gain benchmark와 운영 topology resource 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에서 이미 결정됨(수동 승인·미도입 고정). 자동 수정은 운영자 승인 전까지 실행하지 않는다.
  • G8 clean-head 릴리스와 NAS-origin 재검증 — explicit clean-head mode와 source-only UUID gate는 unit 30/30·UUID 6/6으로 구현됐다. 2026-08-09 execute 두 번은 각각 archive CRLF와 session E2E에서 fail-closed되어 NAS mutation 0이었다. timezone 없는 started_at의 약 9시간 오차는 UTC/KST 계약, API 전체 921 passed, KST focused DB/browser 1/1로 수정했다. 사용자 승인 아래 새 clean commit의 HEAD/tree/archive를 결속한 뒤 격리 NAS preview에 승격해 실제 평문 origin의 전체 회기 E2E·SSE→DB review·student returned-practice를 0 failure로 재검증한다. fixture-only desktop/mobile 묶음은 16:49 KST 단일 120/120 뒤 dashboard 변경분 10/10을 따로 재검증해 current tree는 불변 110 + 최신 dashboard 10의 분할 GREEN이며, clean HEAD에서 exact 120을 다시 실행한다. 어느 쪽도 NAS runtime 증거를 대신하지 않는다. release agent는 DB dump/restore를 지원하지 않으므로 매 execute 직전 fresh custom dump의 SHA/size/TOC와 DB identity를 별도 증거로 결속한다. agent 자동 rollback은 image/Compose/active-state 범위뿐이며, 적용 migration/data restore는 별도 owner 승인을 받는다. remote release root/Compose mode 0777 P1도 최소권한 preflight로 닫는다. 이때만 G8 전체 DONE이 가능하다. 첫 current clean commit 5221f79e는 HEAD/tree/archive와 fresh NAS dump를 결속했지만 candidate E2E 110/112에서 production hashed entry를 차단하지 못한 boot-diagnostic 테스트 desktop/mobile 2건으로 승격 전 중단됐다. NAS mutation 0이다. /src/main.tsx와 /assets/index-*.js를 함께 차단하는 수정은 Vite source 2/2, production preview 2/2를 통과했으며 새 clean commit으로 한 번만 재실행한다. 후속 21461ab3 candidate는 112/112를 통과했지만 실제 NAS-origin deliberate-practice 2건이 crypto.subtle.digest 부재로 실패했고 이전 이미지 rollback·health/auth/OpenAPI 검증은 완료됐다. 원문을 서버로 보내지 않는 portable SHA-256 fallback과 exact digest assertion은 secure localhost 2/2·Tailnet insecure 2/2를 통과했다. 새 clean commit을 결속한 전체 execute 0 failure가 여전히 종료조건이다.

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다. watchdog·로그온 boot의 detached-clean commit/tree/script SHA pin은 provenance 11개를 포함한 combined 22/22로 완료했지만 실제 task action은 아직 shared worktree다. watchdog 반복 실행은 필수 pin 인자 부재로 mutation 전에 exit해 LastTaskResult=1이며, 18:05 KST 복구 뒤 local/public health는 status=ok·db=true·engine=true, 공개 OpenAPI 119 paths, /voice/health OpenAI STT/TTS, local voice sidecar listener 9882/9883은 0이다. clean commit 뒤 두 task를 같은 stable release root로 재등록하기 전까지 자동복구는 fail-closed 상태다. 상세: 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 생성 음성 고지는 보존했다. 남은 범위: current source 공개 배포, local_whisper/melotts의 live interim/final과 기대값이 일치하는 authenticated public ready, 실행 직전 명시 동의 물리 마이크와 50분 양방향 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을 만들기 전에는 닫지 않는다. 2026-08-09 공개 재감사에서는 /voice/health가 OpenAI STT/TTS이고 9882/9883 listener가 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를 검증한다. 다만 아직 공개에 실행하지 않았고 현재 API는 Git metadata가 없는 냉동 release cwd라 provenance gate를 통과할 수 없다. current committed repo 기반 public runtime 정렬을 먼저 닫기 전에는 물리 마이크 50분 창을 열지 않는다. 코드 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를 만든다. runner/checker/topology 86/86, launcher/sidecar 80/80, G7 통합 166/166을 통과했다. 이제 clean source 공개 배포·rehearse 전에는 물리 마이크를 열지 않는다. 격리 NAS 프리뷰 http://100.116.83.60:8088은 전용 Compose 프로젝트·포트·네트워크·볼륨에 배포했고, 실제 브라우저 회기와 review API 저장 축어록 2턴을 확인했다. 기존 프로젝트 중단·재생성 명령은 실행하지 않았다. 매일 04:30 KST Vignette 회기 E2E 정기 검증 (automation id vignette-e2e)은 ACTIVE이며 material milestone+release gate·NAS preflight+배포 SHA 변경 때만 프리뷰를 갱신한다. 2026-08-07 SHA 6030a677af7e87cbfabc422b553d108d53414fd3c446548734a13b036d35c611은 API/Web 새 이미지, localhost candidate E2E 108/108, OpenAPI 126, auth 401, G0G8, postdeploy browser SSE→DB review와 health 3/3을 통과했다. 같은 NAS 평문 origin에서는 UUID 결함으로 24건 실패했으므로 current source 배포 증거로 재사용하지 않는다. 실제 receipt-bound rollback은 같은 프리뷰에서 별도 helper로 두 번 실행해 종료했다(런북, 기계 판독 증거). 첫 예약 실행 이력은 대기 상태다. 증거: 배포 증거, 2026-08-09 17:07 KST current baseline은 exact API/Web 52e0…8b2d/6fdb…f215, previous 79ec…4450/c530…2f28 보존, api/web/db/proxy 4개 running + unless-stopped, DB volume vignette-preview-20260807_pgdata, health 3/3·db/engine true·auth 401·OpenAPI 126 + G1G8 routes·root/JS/CSS 200, helper/listener 0이다. dump 92ed…1570f 960,970 bytes와 726982…5d41c 1,015,222 bytes도 존재한다. 브라우저 증거. 명시 동의 물리 마이크와 독립 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 task 재등록 + 재부팅 후 watchdog smoke — 사용자 승인 clean commit의 detached release root에 watchdog·로그온 boot를 함께 재등록하고 action의 commit/tree/script SHA pin과 watchdog LastTaskResult=0을 확인한 뒤, 실제 Windows 재부팅 후 엔진/API/터널 복구와 public /turn을 실측한다. 재부팅 불가로 미실행(parser·provenance 회귀는 확인). 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다.