From cc4a943ad8c3422a76b834ee4e306ac1c05be62d Mon Sep 17 00:00:00 2001 From: Yun Chan Date: Sun, 25 Oct 2026 18:11:17 +0900 Subject: [PATCH] =?UTF-8?q?2026-10-24=20=EC=9A=B4=EC=98=81=20=EB=B0=B0?= =?UTF-8?q?=ED=8F=AC=EC=99=80=20=EB=B3=B4=EC=A1=B4=20=EA=B2=80=EC=A6=9D=20?= =?UTF-8?q?=EA=B2=B0=EA=B3=BC=EB=A5=BC=20=EA=B8=B0=EB=A1=9D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/TODO.md | 2 + docs/dev_dashboard.html | 7 +- docs/ops/backlog-2026-06-26.md | 2 + docs/ops/deployment-pipeline.md | 8 ++ docs/ops/evidence/release-2026-10-24.json | 111 ++++++++++++++++++++++ 5 files changed, 127 insertions(+), 3 deletions(-) create mode 100644 docs/ops/evidence/release-2026-10-24.json diff --git a/docs/TODO.md b/docs/TODO.md index bbafc82..8e910e4 100644 --- a/docs/TODO.md +++ b/docs/TODO.md @@ -2,6 +2,7 @@ > 상태·결정·검증 증거의 SSOT는 [`dev_dashboard.html`](./dev_dashboard.html)이다. 이 문서는 실행할 다음 행동의 인덱스다. > 2026-09-07 이전 완료 로그와 세부 이력은 [정리 전 TODO 원문](./archive/project-cleanup-2026-09-07/TODO-before-cleanup.md)에 보존했다. 2026-09-01 배포 당시의 근거는 [NAS 배포 증거](./ops/evidence/nas-prod-deploy-2026-09-01.json)이며, 현재 live 상태를 주장하지 않는다. +> 2026-10-24 승인 릴리스는 Forgejo `master` SHA `b0ff44a1d4d3aed19b1bb0e1bbd0aab327aef0ea`의 NAS API/web 승격과 Pages production `42eef402`를 완료했다. 라우터 7 동기 갱신 복구·딥링크 next 보존·감독 경로 강제가 포함되며 migration은 없다. [배포 영수증](./ops/evidence/release-2026-10-24.json)을 따른다. > 2026-10-20 승인 릴리스는 Forgejo `master` SHA `aeddaa6972cafabec8113745037533893db0ac34` push, Pages production, NAS API/web 승격과 migration 25 적용을 완료했다. 인증된 운영 내부 UI와 retention 실제 apply는 별도 gate다. [배포 영수증](./ops/evidence/release-2026-10-20.json)을 따른다. ## 우선 접수 제품 이슈 @@ -59,6 +60,7 @@ | MIGRATION-001 | idempotent DB migration runner 도입 여부를 결정한다. | init SQL과 runner의 역할 경계, 인프라 영향, 소유자 승인을 확정한다. | | OPS-001 | 운영 티켓 자동 분류·처리 후속을 설계한다. | 관리자 승인 뒤 이슈/PR/작업 스레드를 생성하는 범위와 audit 경계를 확정한다. | | E2E-001 | 전 기능 E2E 실패 원인 확정·수정 | 최신 full fixture는 direct spec 1264건(각 project 632)에서 1254 passed·0 failed·10 skipped·0 flaky(779.880s, exit 0)다. 10 skip 중 desktop/mobile 의도 대칭 6건은 그대로이고, returned-practice DB closed-loop G4/G5 desktop/mobile 4건은 전용 disposable engine/DB/API/Web에서 same-learner 실제 SSE·review·G4/G5 `0→1→1`과 returned desktop/mobile 4 passed·route mock 0으로 별도 수용했다. 기존 dev DB는 재사용하지 않았고 cleanup 잔여도 0이다. 최초 admin KPI·avatar 간헐 원인은 과거 관측으로 남아 있고 이번 전체 통과로 확정하지 않는다. 전체 수집 1334건의 일괄 완료 주장은 하지 않으며, 기본 Jev 설정의 전체 API 재검증·`live_verified`와 외부/운영 gate가 남아 [closeout 표](./ops/backlog-closeout-2026-10-19.md#최종-e2e-통합-수치) 기준 전체 DONE은 아니다. 2026-10-21 `d801a161`+라우터 수정본: fixture 1266건 1252 passed·10 skipped·4 failed(교수자 실엔진 4건, 정상 엔진 재기동 뒤 4 passed), 정상 엔진 single-run 70건 61 passed·4 skipped·5 failed였다. 5건 중 `persona-db-lifecycle` 1건과 `voice-success` 2건은 테스트용 API가 공유 DB `admin_engine_config` 행과 `.env`의 Jev를 상속한 격리 결함이라 락·행 교체·원복과 `legacy` 고정으로 고쳐 4 passed(파일 전체)다. `session-persistence` 코칭 이력은 08-18 버튼 추가로 낡은 선택자를 고친 뒤 live coach 근거에 `workbook_0615_case_conceptualization`이 없어 실패한다(선택자 오류에 가려져 있던 단언, 근거 선택 기대 결정 필요). 음성 비언어 메타데이터 1건은 로컬 OpenAI TTS `TTS transport error` 환경 실패이며 단언은 완화하지 않고 이벤트 원문만 남긴다. 기본 Jev 설정의 전체 API 재검증은 1267 passed·1 skipped로 닫았다. | +| DEV-DEPS-001 | dev 전용 의존성 취약점을 갱신한다. | 2026-10-24 공개 advisory로 `npm audit`가 high 2건(vite 6.4.3 dev server, knip 내부 zod)을 보고한다. `--omit=dev`는 0건이고 운영 정적 번들에는 포함되지 않는다. vite·knip 갱신 뒤 typecheck·build·E2E 무회귀로 닫는다. | | CUA-128 | 실제 배포 Computer Use 128 시나리오를 역할·승인 경계 안에서 재개한다. | 카탈로그 생성은 완료했으나 실배포 전체 검증은 미완료다. SHA `1306c524`에서 H09와 일반 학습자 로그인·교차 역할 차단·P4 추천·R09 잠금·R14 워크시트 보존을 재확인했지만, T18은 learner 브라우저만 있어 기존 RED를 종결하지 않았다. 순수 teacher·OFF 계정, 교수자 쓰기, 모바일과 독립 관찰자 공개 검증이 남아 있다. [실행 보고](./qa/production-computer-use-report-2026-09-09.md)를 따른다. | ## 임상 콘텐츠 후속 diff --git a/docs/dev_dashboard.html b/docs/dev_dashboard.html index 586f97c..f082ca6 100644 --- a/docs/dev_dashboard.html +++ b/docs/dev_dashboard.html @@ -300,8 +300,9 @@
project pulse -

지금 위치: 2026-10-20 승인 릴리스 배포 완료 — Forgejo master SHA aeddaa6972, Cloudflare Pages production과 NAS API/web·migration 25를 반영했다. 인증된 운영 내부 UI와 외부·임상 gate는 열린 상태다.

-

2026-10-21 로컬 검증(미push·미배포): 미push 커밋 d801a161(보호 경로 딥링크의 쿼리·해시를 로그인 next까지 보존, 감독 drilldown 경로의 앱 내부 경로 강제, react-router-dom 6.30→7.18.4)을 검증했다. 정적 세트는 API 기본 Jev·legacy 설정 각각 1267 passed·1 skipped, gateway 82 passed, API 타입·typecheck·build 통과, npm audit 0건이다. 전체 fixture에서 라우터 7의 기본 startTransition 위치 갱신 때문에 URL 연동 기록 검색이 타이핑 중 글자를 잃는 회귀(desktop/mobile 2건, 재실행 재현)를 찾아 <BrowserRouter useTransitions={false}>로 v6와 같은 동기 갱신을 복구했다. 수정 뒤 fixture 1266건은 1252 passed·10 skipped·4 failed였고, 4건은 엔진 장애 환경의 교수자 실엔진 테스트로 정상 엔진 재기동 뒤 4 passed다. Claude Code 세션 안에서 띄운 dev 스택은 ANTHROPIC_*·CLAUDE_* 상속으로 claude_cli가 401 재시도에 멈추므로 해당 변수를 뺀 셸에서 기동해야 한다.

+

지금 위치: 2026-10-24 승인 릴리스 배포 완료 — Forgejo master SHA b0ff44a1, Cloudflare Pages production 42eef402와 NAS API/web을 반영했다. 인증된 운영 내부 UI와 외부·임상 gate는 열린 상태다.

+

2026-10-24 릴리스: NAS API(sha256:2083c858…)·web(sha256:443928c3…) 승격과 Pages production 42eef402를 수용했다. 사전 DB dump 11,899,558 bytes·TOC 1,809줄, uploads 93개/52,973 bytes manifest 전후 동일, engine·DB 컨테이너와 compose 무변경, 행 수 차이는 배포 중 로그인 세션 1건 증가뿐이다. 공개 health 3회 200·ok·db/engine true, 무인증 /auth/me 401과 정확한 CORS, Google 로그인 시작 302, JS/CSS hash 일치, desktop/mobile 로그인 렌더·page error 0, 딥링크 쿼리·해시의 로그인 next 보존을 확인했다. API 재생성부터 healthy까지 68초라 무중단은 주장하지 않는다. dev 전용 의존성 advisory 2건은 DEV-DEPS-001로 추적한다. 배포 영수증.

+

2026-10-21 로컬 검증(2026-10-24 배포): 미push 커밋 d801a161(보호 경로 딥링크의 쿼리·해시를 로그인 next까지 보존, 감독 drilldown 경로의 앱 내부 경로 강제, react-router-dom 6.30→7.18.4)을 검증했다. 정적 세트는 API 기본 Jev·legacy 설정 각각 1267 passed·1 skipped, gateway 82 passed, API 타입·typecheck·build 통과, npm audit 0건이다. 전체 fixture에서 라우터 7의 기본 startTransition 위치 갱신 때문에 URL 연동 기록 검색이 타이핑 중 글자를 잃는 회귀(desktop/mobile 2건, 재실행 재현)를 찾아 <BrowserRouter useTransitions={false}>로 v6와 같은 동기 갱신을 복구했다. 수정 뒤 fixture 1266건은 1252 passed·10 skipped·4 failed였고, 4건은 엔진 장애 환경의 교수자 실엔진 테스트로 정상 엔진 재기동 뒤 4 passed다. Claude Code 세션 안에서 띄운 dev 스택은 ANTHROPIC_*·CLAUDE_* 상속으로 claude_cli가 401 재시도에 멈추므로 해당 변수를 뺀 셸에서 기동해야 한다.

2026-10-20 릴리스: Pages production f2039a2e와 NAS API/web 승격을 수용했다. 공개 로그인 화면 desktop/mobile 렌더, page error·import 오류 0건, 무인증 /auth/me 401, JS/CSS hash 일치, health 3회 200·ok·db/engine true, CORS와 Google 로그인 시작 302을 확인했다. DB dump 11,892,253 bytes·uploads 93개/52,973 bytes·118 테이블 전후 행 수 동일을 보존했고 migration 25와 admin-only DELETE policy를 적용했다. retention은 dry-run 삭제 0이며 실제 apply는 별도 승인이다. API 교체 중 일시 reset/empty reply 뒤 회복했으므로 무중단은 주장하지 않는다. 배포 영수증.

2026-10-19 로컬 closeout: DEVUP-DB-RACE, 관리자 affect 모바일, avatar render-mode, retention과 레이아웃 및 KB source-pack metadata·RLS 교정을 수용했다. VIGNETTE_CLIENT_AFFECT_PROVIDER=legacy 최종 API는 1263 passed·1 skipped·1 warning, gateway는 82 passed·1 warning이다. 최신 full fixture는 1254 passed·0 failed·10 skipped이고, returned-practice 전용 실DB는 same-learner SSE·review·G4/G5 0→1→1 및 desktop/mobile 4 passed를 수용했다. 당시에는 미배포·미push였고 이 범위는 2026-10-20 릴리스로 Forgejo push·Pages·NAS API/web에 반영했다.

남은 경계: 전체 수집 1336건의 일괄 완료 주장, 최초 admin KPI·avatar 간헐의 원인 확정, Jev live_verified(기본 Jev 설정 API 전체 재검증은 2026-10-21 1267 passed·1 skipped로 닫음), single-run 잔여 2건(live coach 0615 워크북 근거 미포함, 로컬 TTS 환경 실패), C-001 외부 임상, avatar 원화·인증 운영 세션 소유자 확인, retention 실제 apply의 소유자 승인이 남는다. source-pack metadata의 external_llm_ok 변경은 저장소·배포 이미지에만 반영했고 운영 KB 데이터 재동기화는 실행하지 않았다. 로컬 증거와 남은 검증을 따른다.

@@ -1052,7 +1053,7 @@
DONE
ADMIN-AFFECT-001 관리자 감정 관측 trace·그래프 운영 수용

수용: 완료 내담자 턴 trace의 공개 payload 비노출, API, 격리 PostgreSQL RLS·cascade, 성공·rollback 원자성, canonical artifact 기술 6/6, migration 23 운영 적용(RLS 2개 정책·grants·기존 행 0), API legacy baseline 1191 passed/1 skipped/0 failed와 gateway 82 passed, API 운영 health와 Pages 공개 index/AdminAffect JS/CSS·기존 사용자 bundle 200, 인증 CUA의 trace 1개·9축·5단계 분포와 새로고침 복원, NAS web build·컨테이너 교체 exit 0 및 API·engine·DB 컨테이너 유지.

산출물

Jev 결정문, 운영 영수증, /admin/emotions, /admin/affect/sessions

검증 경계

web generate/check API types, typecheck, build, design SSOT와 focused 16개를 통과했고 dark/mobile/추이/관계 캡처 및 실제 리뷰 평가도 수용했다. 실제 1턴 관계 표시는 데이터 부족이며 fixture의 5개 이상 관계 계산 검증과 구분한다. watchdog은 한 차례 반려 뒤 root marker 보완으로 고정 수용했다. 2026-09-23 당시 전체 layout-visual-gate는 15개 중 1 passed·1 failed·13 not run이었으므로 전체 GREEN을 주장하지 않았다.

DONE
ADMIN-AFFECT-V2-MOBILE 판정 표 로컬 closeout

620px 이하에서 각 판정 행을 판정 항목·판정·근거 확률·판단 확신도 순서로 세로 배치했다. semantic table의 column header와 cell 역할을 유지하고, 확률 라벨·막대·숫자가 320/390px viewport와 행 안에 들도록 확인했다.

산출물

10/19 closeout, outputs/backlog-closeout-2026-10-19/mobile-affect/

검증 경계

admin-affect.spec.ts desktop/mobile 20 passed(기존 v1 포함), typecheck·build 통과. 320/390/1440 PNG SHA-256이 테스트 원본과 일치한다. 운영 배포·전체 layout gate 완료 주장이 아니다.

DONE
RETENTION-001 운영 migration·dry-run 수용

raw 90일·daily rollup 365일 기본값과 admin-only exact policy·RLS enabled guard를 격리 DB와 2026-10-20 운영 migration 25에서 수용했다. 운영 dry-run은 applied=false·삭제 0이며 실제 apply는 실행하지 않았다.

산출물

2026-10-20 배포 영수증, migration 25

검증 경계

runtime-final stdout exit 0, retention CLI/release 38 passed, service focused 35 passed/1 warning. 실제 apply·데이터 삭제와 운영 스케줄은 별도 소유자 승인·증거가 필요하다.

-
DONE
ROUTER-V7-001 인증 딥링크 보존·라우터 7 로컬 수용

d801a161의 딥링크 쿼리·해시 보존, 감독 경로 앱 내부 강제, react-router-dom 7.18.4 업그레이드를 수용했다. v7 기본 transition이 URL 연동 제어 입력의 글자를 잃게 하는 회귀를 useTransitions={false}로 복구했다. push·배포는 하지 않았다.

산출물

apps/web/src/App.tsx, outputs/verify-2026-10-21/

검증

회귀 RED: uc-learner-practice-history "성하늘"→"늘" desktop/mobile 재현. 수정 뒤 해당 파일 32 passed, fixture 1252 passed·10 skipped·4 failed(엔진 장애 4건은 정상 엔진에서 4 passed), API 1267 passed·1 skipped(기본 Jev·legacy), gateway 82 passed, typecheck·build·API 타입 통과, npm audit 0건.

+
DONE
ROUTER-V7-001 인증 딥링크 보존·라우터 7 로컬 수용

d801a161의 딥링크 쿼리·해시 보존, 감독 경로 앱 내부 강제, react-router-dom 7.18.4 업그레이드를 수용했다. v7 기본 transition이 URL 연동 제어 입력의 글자를 잃게 하는 회귀를 useTransitions={false}로 복구했다. 2026-10-24 b0ff44a1로 Pages·NAS에 배포했고 운영 딥링크 next 보존을 확인했다.

산출물

apps/web/src/App.tsx, outputs/verify-2026-10-21/

검증

회귀 RED: uc-learner-practice-history "성하늘"→"늘" desktop/mobile 재현. 수정 뒤 해당 파일 32 passed, fixture 1252 passed·10 skipped·4 failed(엔진 장애 4건은 정상 엔진에서 4 passed), API 1267 passed·1 skipped(기본 Jev·legacy), gateway 82 passed, typecheck·build·API 타입 통과, npm audit 0건.

DONE
B1-LAYOUT-720-001 layout gate 로컬 수용

CSS 변경 없이 viewport-fixed/ordinary overflow 오탐을 정리하고 transform/internal clip 반례를 추가했다. prestart clipping은 focused fixed clip 회귀로 확인했다.

산출물

10/19 closeout, layout-final/layout-gate.json

검증 경계

2026-10-19 최종 layout gate는 15 passed·0 failed·0 skipped·0 flaky(exit 0, 131.7s), fixed clip 회귀 4건과 session-layout 10건이다. 수정 전 15개 중 1 passed·1 failed·13 not run은 역사 기록으로 보존한다. 운영 배포·전체 E2E 완료 주장이 아니다.

DONE
한신대 실사용 피드백 1차 개선팩

오류분석 자료를 컨텍스트 보존, 내담자 출력 품질, 리뷰 privacy/오류문구 UX, 교수자 설명 가능성으로 분해했고 1차 구현을 완료했다. P1은 role mapping + client-only history injection을 원자 패치로 닫았고, P2/P3/P4는 저장형 fallback 없이 빠른 UX 개선으로 배포 가능한 상태다.

산출물

gateway._split_messages(ai_role=client), guardrail.sanitize_client_reply() 품질 게이트, SSE full-response buffer, 리뷰 표시 자연어화, raw error mapper, 교수자 AI 평가 범위 패널, 계획/레드팀/대레드팀 문서

검증

engine_gateway/test_gateway_model.py app/test_orchestrator_masking.py app/test_client_reply_quality.py app/test_session_turn_persistence.py 84 passed, npm run typecheck, npm run check:api-types, session-review.spec.ts focused 8 passed, layout-visual-gate.spec.ts 12 passed, session-layout.spec.ts 8 passed.

diff --git a/docs/ops/backlog-2026-06-26.md b/docs/ops/backlog-2026-06-26.md index 821b4e3..0684bfe 100644 --- a/docs/ops/backlog-2026-06-26.md +++ b/docs/ops/backlog-2026-06-26.md @@ -3,6 +3,7 @@ > 상태와 증거의 SSOT는 [`docs/dev_dashboard.html`](../dev_dashboard.html), 실행 인덱스는 [`docs/TODO.md`](../TODO.md)다. > 2026-09-07 이전 완료 기록과 장문 이력은 [정리 전 백로그 원문](../archive/project-cleanup-2026-09-07/backlog-2026-06-26-before-cleanup.md)에 보존했다. > 2026-09-01 NAS 배포는 당시 [배포 증거](./evidence/nas-prod-deploy-2026-09-01.json)로 완료 기록을 남겼으며, 현재 live 상태 주장이나 후속 게이트 완료 선언이 아니다. +> 2026-10-24 승인 릴리스는 Forgejo `master` SHA `b0ff44a1d4d3aed19b1bb0e1bbd0aab327aef0ea`의 NAS API/web 승격과 Pages production `42eef402`를 완료했다. 라우터 7 동기 갱신 복구·딥링크 next 보존·감독 경로 강제가 포함되며 migration은 없다. [배포 영수증](./evidence/release-2026-10-24.json)을 따른다. > 2026-10-20 승인 릴리스는 Forgejo `master` SHA `aeddaa6972cafabec8113745037533893db0ac34` push, Pages production, NAS API/web 승격과 migration 25 적용을 완료했다. 인증 운영 UI와 retention 실제 apply는 완료로 선언하지 않는다. [배포 영수증](./evidence/release-2026-10-20.json)을 따른다. ## 제품 이슈 — 최신 워크북 원본과 로컬 재검증 @@ -73,6 +74,7 @@ npx playwright test e2e/uc-session-conversation.spec.ts --grep '스트림 도중 | MIGRATION-001 | idempotent DB migration runner | init SQL과 runner의 역할 경계·인프라 영향·소유자 승인 | | OPS-001 | 운영 티켓 자동 분류 | 관리자 승인·audit 경계를 갖춘 구현 패킷 | | E2E-001 | 전 기능 E2E 실패 원인 확정·수정 | 최신 full fixture는 direct spec 1264건(각 project 632)에서 1254 passed·0 failed·10 skipped·0 flaky(779.880s, exit 0)다. 10 skip 중 desktop/mobile 의도 대칭 6건은 그대로이고, returned-practice DB closed-loop G4/G5 desktop/mobile 4건은 전용 disposable engine/DB/API/Web에서 same-learner 실제 SSE·review·G4/G5 `0→1→1`과 returned desktop/mobile 4 passed·route mock 0으로 별도 수용했다. 기존 dev DB는 재사용하지 않았고 cleanup 잔여도 0이다. 최초 admin KPI·avatar 간헐 원인은 과거 관측으로 남아 있고 이번 전체 통과로 확정하지 않는다. 전체 수집 1334건의 일괄 완료 주장은 하지 않으며, 기본 Jev 설정의 전체 API 재검증·`live_verified`와 외부/운영 gate가 남아 [closeout 표](./backlog-closeout-2026-10-19.md#최종-e2e-통합-수치) 기준 전체 DONE은 아니다. 2026-10-21 `d801a161`+라우터 수정본: fixture 1266건 1252 passed·10 skipped·4 failed(교수자 실엔진 4건, 정상 엔진 재기동 뒤 4 passed), 정상 엔진 single-run 70건 61 passed·4 skipped·5 failed였다. 5건 중 `persona-db-lifecycle` 1건과 `voice-success` 2건은 테스트용 API가 공유 DB `admin_engine_config` 행과 `.env`의 Jev를 상속한 격리 결함이라 락·행 교체·원복과 `legacy` 고정으로 고쳐 4 passed(파일 전체)다. `session-persistence` 코칭 이력은 08-18 버튼 추가로 낡은 선택자를 고친 뒤 live coach 근거에 `workbook_0615_case_conceptualization`이 없어 실패한다(선택자 오류에 가려져 있던 단언, 근거 선택 기대 결정 필요). 음성 비언어 메타데이터 1건은 로컬 OpenAI TTS `TTS transport error` 환경 실패이며 단언은 완화하지 않고 이벤트 원문만 남긴다. 기본 Jev 설정의 전체 API 재검증은 1267 passed·1 skipped로 닫았다. | +| DEV-DEPS-001 | dev 전용 의존성 취약점 갱신 | vite 6.4.3·knip 내부 zod high 2건(2026-10-24 advisory, `--omit=dev` 0건) 갱신 뒤 typecheck·build·E2E 무회귀 | | CUA-128 | 실제 배포 Computer Use 재검증 | 128 시나리오 카탈로그 생성은 완료했지만 전체 실배포 검증은 미완료다. SHA `1306c524`에서 H09와 일반 학습자 로그인·교차 역할 차단·P4 추천·R09 잠금·R14 워크시트 보존을 재확인했지만, T18은 learner 브라우저만 있어 기존 RED를 종결하지 않았다. 순수 teacher·OFF 계정, 교수자 쓰기, 모바일과 독립 관찰자 공개 검증이 남아 있다. | ## 완료 기록 경계 diff --git a/docs/ops/deployment-pipeline.md b/docs/ops/deployment-pipeline.md index 650f3bc..e8cf5cd 100644 --- a/docs/ops/deployment-pipeline.md +++ b/docs/ops/deployment-pipeline.md @@ -170,6 +170,14 @@ docker compose -f docker-compose.nas.yml --env-file private/env.nas up -d --no-d - DB dump 11,892,253 bytes와 TOC, uploads 93개·52,973 bytes·manifest SHA-256 `2e7f31a28d3d7f527f62092b3adfc96bf92f5cd35769a498d242b99cbeae43d2`를 보존했다. 118개 테이블의 전후 행 수가 모두 같고, 행 수가 달라지거나 줄어든 테이블은 각각 0개다. retention dry-run은 raw 90일·rollup 365일에서 `applied=false`, 삭제 0으로 끝났으며 실제 apply는 별도 소유자 승인 대상이다. - `nginx -t`, 공개 health 3회(200, `status=ok`, `db=true`, `engine=true`), 무인증 `/auth/me` 401의 정확한 CORS origin/credentials, auth config/OpenAPI 200, Google 로그인 시작 302을 확인했다. API 단일 교체 중 curl reset/empty reply가 있었고 이후 회복했으므로 무중단 배포를 주장하지 않는다. 인증된 운영 내부 UI, Jev 품질/실제 대사, 외부·임상 gate는 열린 상태다. 구조화 증거: [`release-2026-10-20.json`](./evidence/release-2026-10-20.json). +## 5.7 승인 릴리스 배포 완료 (2026-10-24, SHA `b0ff44a1d4d3aed19b1bb0e1bbd0aab327aef0ea`) + +- 범위는 API 계약 1파일(`supervision_research.py`)과 web(라우터 7·딥링크 보존·동기 갱신 복구)이라 API·web만 `--no-deps`로 교체했다. engine·DB·proxy·cloudflared와 compose는 그대로이며 migration은 없다. +- 사전 단계: DB dump 11,899,558 bytes(SHA-256 `17811709…`)·`pg_restore -l` 1,809줄, uploads 93개·52,973 bytes manifest, 테이블 행 수, `env.nas` 사본을 `receipts/release-20261024-20261024T130800Z`에 남겼다. 소스는 git 컨테이너 clone 뒤 SHA를 대조했다. +- 교체 뒤 nginx 설정 검사 통과, uploads manifest 동일, 행 수 차이는 `app.auth_session` 1건 증가뿐이다. 공개 health 3회 200·ok, 무인증 `/auth/me` 401과 CORS, Google 로그인 시작 302, Pages `42eef402`의 JS/CSS hash 일치와 desktop/mobile 렌더, 딥링크 `next` 보존을 확인했다. +- 함정: NAS 원격 명령에서 `cat > 파일 && ... & echo`처럼 체인 전체를 백그라운드로 보내면 stdin이 끊겨 빈 스크립트가 실행된다. 업로드와 `setsid nohup` 실행을 별도 ssh 호출로 나눈다. NAS에는 `pgrep`이 없다. +- API 재생성부터 healthy까지 68초였으므로 무중단은 주장하지 않는다. 구조화 증거: [`release-2026-10-24.json`](./evidence/release-2026-10-24.json). + ## 6. 남은 구성 작업 (TODO) - [ ] Forgejo master 기준 NAS 자동배포 후크(수동 절차는 §5, §5.1로 실증 완료) diff --git a/docs/ops/evidence/release-2026-10-24.json b/docs/ops/evidence/release-2026-10-24.json new file mode 100644 index 0000000..fa132e1 --- /dev/null +++ b/docs/ops/evidence/release-2026-10-24.json @@ -0,0 +1,111 @@ +{ + "title": "2026-10-24 승인 릴리스 배포 영수증", + "captured_at": "2026-10-24", + "source": { + "canonical_branch": "master", + "forgejo_sha": "b0ff44a1d4d3aed19b1bb0e1bbd0aab327aef0ea", + "forgejo_push_completed": true, + "included_commits": [ + "d2ba8365 운영 배포와 보존 검증 결과를 기록", + "d801a161 인증 경로 보존과 의존성 보안 검증을 보강", + "b0ff44a1 라우터 7 동기 갱신 복구와 E2E 격리 수정, 검증 기록 동기화" + ], + "code_scope": "apps/api/app/contracts/supervision_research.py, apps/web(App.tsx, react-router-dom 7.18.4), e2e·테스트·문서. engine 코드·requirements·Dockerfile·infra·migration 변경 없음." + }, + "preflight": { + "api_default_jev": "1267 passed, 1 skipped, 1 warning", + "api_legacy": "1267 passed, 1 skipped, 1 warning", + "engine_gateway": "82 passed, 1 warning", + "web": ["check:api-types passed", "typecheck passed", "build passed", "dashboard SSOT checker passed"], + "fixture_e2e": "1266건 중 1252 passed, 10 skipped, 4 failed; 4건은 엔진 장애 환경의 교수자 실엔진 테스트로 정상 엔진 재기동 뒤 4 passed", + "single_run_e2e": "70건 중 61 passed, 4 skipped, 5 failed; persona-db-lifecycle·voice-success 격리 수정 뒤 해당 파일 4 passed, 잔여 2건은 live coach 0615 워크북 근거 미포함과 로컬 OpenAI TTS 환경 실패", + "router_regression": "react-router 7 기본 startTransition이 URL 연동 기록 검색의 글자를 잃게 하는 회귀를 BrowserRouter useTransitions={false}로 복구, uc-learner-practice-history 32 passed", + "npm_audit_2026_10_21": "0 vulnerabilities", + "npm_audit_2026_10_24": { + "omit_dev": "0 vulnerabilities", + "all": "2 high (dev-only): vite 6.4.3 dev server, knip 내부 zod", + "boundary": "배포물은 정적 빌드이며 두 패키지는 devDependencies라 운영 번들에 포함되지 않는다. lockfile 변경이나 audit fix는 실행하지 않았다." + } + }, + "nas_preflight": { + "receipt_path": "/volume1/docker/vignette-prod/receipts/release-20261024-20261024T130800Z", + "db_dump_bytes": 11899558, + "db_dump_sha256": "17811709c0d7f852fe29e69df2fd3f499b5d5a61a992667c484115de4e155c15", + "pg_restore_list_lines": 1809, + "uploads": { + "file_count": 93, + "total_bytes": 52973, + "manifest_sha256": "2e7f31a28d3d7f527f62092b3adfc96bf92f5cd35769a498d242b99cbeae43d2" + }, + "env_backup": "private/env.nas.before-release-20261024-20261024T130800Z", + "source_sha_verified": "b0ff44a1d4d3aed19b1bb0e1bbd0aab327aef0ea" + }, + "nas_deployment": { + "api": { + "previous_image_sha256": "sha256:309ccd2d9bd8d1d69debfd50c251d9118fe42347a5522be24810790f51afcd94", + "image_sha256": "sha256:2083c85895de5aaf0d3db6c3fbdd02ecc916caaf48bc13ddcf31942766534cc3", + "container_id": "d2d7e6271a24e8d4c6c21126b879ce014e7626cc6c03e3101fa8674a7787eea7", + "recreate_started_utc": "2026-10-24T13:32:06Z", + "healthy_utc": "2026-10-24T13:33:14Z" + }, + "web": { + "previous_image_sha256": "sha256:6ca536db9fc10be644f9108c639c25c97221a7e4e776aa31f2dba3efe07da169", + "image_sha256": "sha256:443928c319a4d42187622fc8c2214dbfe589573bff273b68957b782834069531", + "container_id": "273dac032c8c41da3c11bb65e9bea42cccf671c8e010129eb4259606c9005d89" + }, + "unchanged": { + "engine_and_db_container_identity": true, + "compose_file_sha256": true, + "migrations_applied": 0 + }, + "nginx_config_test_passed": true, + "preservation": { + "count_rows_compared": 120, + "changed_rows": ["app.auth_session 1755 -> 1756 (배포 중 로그인 1건 증가)"], + "reduced_rows": 0, + "uploads_unchanged": true + } + }, + "pages_production": { + "deployment_id": "42eef402", + "branch": "main", + "url": "https://vignette.chanpaca.net", + "preserved_previous_assets": 178, + "entry": { + "path": "/assets/index-V3qu1E6S.js", + "sha256": "6979bfd6e572d87168b416b12e7fd16b3e96c171e71b83a8bdf17fbe8793b67b" + }, + "stylesheet": { + "path": "/assets/index-CNzKarrr.css", + "sha256": "1bbaa56f4a4c6f410fcb413de6bb67c2463bc68c75ddd756a0b03df901b088cc" + }, + "js_and_css_hashes_match_dist": true + }, + "post_deploy_public_readiness": { + "health_checks": 3, + "health_http_status": 200, + "health": "status ok, db true, engine true", + "auth_me_status": 401, + "cors_exact_origin_and_credentials": true, + "auth_config_and_openapi_http_status": 200, + "google_login_start_status": 302, + "custom_domain_desktop_mobile": { + "login_rendered": true, + "reconnect_rendered": false, + "page_errors": 0, + "unexpected_console_errors": 0, + "deep_link_next_preserved": "/learn/history?q=성하늘&status=review#turn-3 → Google 로그인 요청 next에 쿼리·해시 보존 (요청은 URL만 읽고 중단)" + }, + "availability_boundary": "API 단일 교체에서 재생성 시작부터 healthy까지 68초가 걸렸다. 무중단 배포를 주장하지 않는다." + }, + "observations": [ + "vignette-prod-cloudflared-1 compose 컨테이너가 배포 전부터 Restarting 상태였다. 공개 API는 호스트 상주 cloudflared 터널로 정상 응답했고 이번 배포는 이 컨테이너를 건드리지 않았다." + ], + "open_gates": [ + "인증된 운영 내부 UI 검증", + "dev-only 의존성 취약점(vite, knip 내부 zod) 갱신", + "live coach 0615 워크북 근거 기대 결정과 로컬 TTS 환경", + "JEV-002 실제 대사 관측과 JEV 품질 승격", + "RETENTION-001 실제 apply의 별도 소유자 승인과 운영 증거" + ] +}