2026-10-24 운영 배포와 보존 검증 결과를 기록
This commit is contained in:
parent
b0ff44a1d4
commit
cc4a943ad8
5 changed files with 127 additions and 3 deletions
|
|
@ -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 계정, 교수자 쓰기, 모바일과 독립 관찰자 공개 검증이 남아 있다. |
|
||||
|
||||
## 완료 기록 경계
|
||||
|
|
|
|||
|
|
@ -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로 실증 완료)
|
||||
|
|
|
|||
111
docs/ops/evidence/release-2026-10-24.json
Normal file
111
docs/ops/evidence/release-2026-10-24.json
Normal file
|
|
@ -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의 별도 소유자 승인과 운영 증거"
|
||||
]
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue