운영 배포와 보존 검증 결과를 기록
This commit is contained in:
parent
aeddaa6972
commit
d2ba836565
5 changed files with 161 additions and 16 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-20 승인 릴리스는 Forgejo `master` SHA `aeddaa6972cafabec8113745037533893db0ac34` push, Pages production, NAS API/web 승격과 migration 25 적용을 완료했다. 인증 운영 UI와 retention 실제 apply는 완료로 선언하지 않는다. [배포 영수증](./evidence/release-2026-10-20.json)을 따른다.
|
||||
|
||||
## 제품 이슈 — 최신 워크북 원본과 로컬 재검증
|
||||
|
||||
|
|
@ -31,6 +32,7 @@ npx playwright test e2e/uc-session-conversation.spec.ts --grep '스트림 도중
|
|||
| ID | 다음 행동 | 완료 조건 | 차단 / 경계 |
|
||||
|---|---|---|---|
|
||||
| AVATAR-001 | fail-closed 후보의 API/Web/브라우저 검증 | source union·DB reference 보존, decode-valid 응답, public fallback, digest receipt, 승인 배포 | Docker·API·DB avatar URL·upload root 변경은 승인 전 금지 |
|
||||
| AVATAR-V3 | P2~P7 리노컷 자산의 운영 세션 시각 수용 | Pages production 자산 반영은 완료했다. 인증된 운영 세션에서 소유자가 표현·레이어·fallback을 직접 확인하고, 임상 gate를 별도로 통과한다. | 무인증 로그인 렌더는 자산 반영 증거일 뿐 운영 세션·임상 수용 근거가 아니다. |
|
||||
| REQ-008 | NAS 재부팅 자동복구 smoke | 실제 재부팅 뒤 health·로그인·데이터·이미지·SHA 확인 | Windows 개발 task는 legacy 참조이며 NAS 운영 증거가 아님 |
|
||||
| BACKUP-001 | 백업 실패 알림·off-host 복제·restore drill | 실패 경보, 암호화 복제, 복원 주기·보존 정책의 운영 evidence | 첫 일일 sidecar 실행은 당시 성공 기록일 뿐 |
|
||||
| G8-EXTERNAL | 실DB/public 사람 게이트 | 승인·보류·반려와 append-only effect의 실제 public proof | local fixture와 route E2E는 대체 불가 |
|
||||
|
|
@ -38,9 +40,9 @@ npx playwright test e2e/uc-session-conversation.spec.ts --grep '스트림 도중
|
|||
| ANTHROPIC-001 | provider live 동일성 비교 | 승인 주입한 기관 키로 응답·계량·오류 표면화 비교 | credential 취급·주입은 소유자 경계 |
|
||||
| ADMIN-OPENROUTER-001 | 새 사용자 OAuth finish 성공 관측 | API/web 복구·실제 PostgreSQL rollback·배포/보존 census·공개 관리자 UI를 수용 | OpenRouter UI는 미연결, health Jev `live_verified=false`는 live 검증이 아님. 상세는 [운영 영수증](./evidence/admin-openrouter-recovery-2026-09-22.json)을 따른다. |
|
||||
| JEV-001 | 한국어 독립 평가와 전체 지연 반복 비교 | 운영 API·공개 JS·CORS preflight, 합성·인증 브라우저 3턴 runtime과 DB 감정 영속화를 수용했다. 2026-10-19 retention 적용 이전 API legacy baseline 1255 passed·1 skipped와 gateway 82 passed·1 warning은 구현 회귀 증거다. 감정·사실 품질과 지연을 평가한다. | 구현 수용·품질 승격 보류. 상세 수용/반려·최종 probe는 [Jev 결정문](../decisions/jev-client-affect.md)을 따른다. |
|
||||
| JEV-002 | 운영 배포와 실제 대사 관측 | migration 24 운영 선적용 → API·web 배포 → 인증 회기에서 속마음 공개·관리자 v2 trace·대사 반영 관찰 | 소유자 확인 뒤 오케스트레이터 직접 수행. 로컬 `claude_cli` 시간 초과로 로컬 대사 관측 불가 |
|
||||
| JEV-002 | 실제 대사 관측 | migration 24 선적용과 2026-10-20 API·web 운영 배포까지 완료했다. 인증 회기에서 속마음 공개·관리자 v2 trace·대사 반영을 관찰한다. | 로컬 `claude_cli` 시간 초과로 로컬 대사 관측 불가. 한국어 판정 정확도·전문가 보정은 별도 gate |
|
||||
| JEV-002-CAL | 판정 문구 전문가 보정 | `a_understood` 공감 반영 오판 1건과 `a_sore_spot` 과다 선택 여부를 대화 실측으로 확인한 뒤 문구 조정 | 1건 표본으로 바꾸지 않음. [v2 프로토콜](../decisions/jev-client-affect-v2.md) §12 |
|
||||
| RELEASE-MIGRATIONS | 릴리스 에이전트 migration 목록 | RELEASE-23·24·25의 transactional required-payload 계약은 로컬 수용했다. 운영 적용 전 최종 테스트와 승인 경계를 유지한다. | release·retention CLI 38 passed는 로컬 증거다. migration 25는 격리 proof에만 적용했고 기존 dev/prod에는 미적용이며 운영 스케줄도 등록하지 않았다. |
|
||||
| RELEASE-MIGRATIONS | 릴리스 에이전트 migration 목록 | RELEASE-23·24·25의 transactional required-payload 계약을 수용했고 migration 25는 2026-10-20 운영에 트랜잭션으로 적용했다. | retention 실제 apply와 운영 스케줄은 등록하지 않았다. |
|
||||
| USER-LATENCY (JEV-001) | text display·voice onset·완료 준비의 실제 경로 분리 측정 | 안전 검사를 유지한 최적화 뒤 반복 비교 | 소수 CUA 관측상한·audit은 사용자 체감 속도 개선 증거가 아님 |
|
||||
| G6-PRODUCER-CONFLICT | 기존 submission id/content hash 읽기 전용 대조 | 동일 id 재실행 idempotency 충돌을 해소하고 해당 테스트와 실제 cycle 성공을 확인 | 기존 background producer 충돌 관측; Jev·세션 경로와 분리, 이번 배포 회귀로 단정하지 않음 |
|
||||
| VNET-001 | vnet 공개 전환 | DNS·Cloudflare zone 권한·Google redirect URI와 live 검증 | 현재 NAS ingress를 넓히지 않음 |
|
||||
|
|
@ -65,7 +67,7 @@ npx playwright test e2e/uc-session-conversation.spec.ts --grep '스트림 도중
|
|||
| VOICE-001 | s2s 2차 PoC | 20턴 비교 보고서와 채택/폐기 판단 |
|
||||
| FASTLOOP-001 | 외부 fallback | 동의·전송 가드·관측을 포함한 테스트 |
|
||||
| FINETUNE-001 | 재귀학습 fine-tuning pipeline | 동의·데이터셋 gate 뒤 pipeline과 few-shot 자동갱신 범위 검증 |
|
||||
| RETENTION-001 | health retention의 운영 적용·검증 | 로컬 구현·격리 DB 검증은 수용했다. raw 90일/rollup 365일, admin-only exact policy·RLS enabled guard를 유지하며, 운영 migration 25 적용·dry-run/apply 승인·실제 증거가 남는다. |
|
||||
| RETENTION-001 | health retention 실제 apply 승인 | migration 25 운영 적용과 raw 90일/rollup 365일 dry-run(`applied=false`, 삭제 0)을 수용했다. admin-only exact policy·RLS enabled guard를 유지한다. | 실제 apply·데이터 삭제는 별도 소유자 승인과 운영 증거가 필요하다. |
|
||||
| EVALHOOK-001 | fast-loop `eval_hook` 사용 정책 | hook 활성화 조건과 관측 경계의 소유자 결정 |
|
||||
| NODE-001 | Node gateway 전환 후보 | endpoint conformance, `TurnEvaluationPayload` adapter, admin mapper의 작업 패킷과 회귀 |
|
||||
| MIGRATION-001 | idempotent DB migration runner | init SQL과 runner의 역할 경계·인프라 영향·소유자 승인 |
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
# 배포 파이프라인 (Deployment Pipeline)
|
||||
|
||||
> 작성: 2026-08-31 · 2026-09-12 현행화 · 문서 소유: docs/ops
|
||||
> 상태: **2026-09-12 UX SHA `e8b770e4d9023238bf210b412de75dcb98bfc08e`의 Cloudflare Pages와 NAS web 전용 배포는 완료**했다. 운영 인증 세션이 401로 만료돼 내부 UI 검증은 마지막 열린 게이트이며, 이를 전체 운영 검증 완료로 선언하지 않는다.
|
||||
> 작성: 2026-08-31 · 2026-10-20 현행화 · 문서 소유: docs/ops
|
||||
> 상태: Forgejo `master` SHA `aeddaa6972cafabec8113745037533893db0ac34` push, Cloudflare Pages production(`f2039a2e`), NAS API/web 배포와 migration 25 적용을 완료했다. 인증된 운영 내부 UI는 이번 세션에서 검증하지 않았으므로 전체 운영 검증 완료를 선언하지 않는다.
|
||||
|
||||
## 목표 아키텍처 (소유자 지시)
|
||||
|
||||
|
|
@ -161,6 +161,15 @@ docker compose -f docker-compose.nas.yml --env-file private/env.nas up -d --no-d
|
|||
- **앱 증상 연결**: `apps/web/src/lib/auth.tsx`의 `restoreCurrentUser`는 `GET /auth/me`를 3회 재시도(지연 0/400/1000ms, 각 5초 abort) 후 실패하면 `restoreState="failed"`가 되고, `apps/web/src/App.tsx:113-135`의 "서버 연결 진단" 화면이 뜬다. 401만 정상 로그아웃으로 처리되며 530을 포함한 나머지 실패는 모두 이 화면으로 떨어진다.
|
||||
- **미해결**: 부팅 시 cloudflared 자동 시작 등록은 아직 없다(REQ-008 계열 열린 게이트). 등록 방식은 미정이다.
|
||||
|
||||
## 5.6 승인 릴리스 배포 완료 (2026-10-20, SHA `aeddaa6972cafabec8113745037533893db0ac34`)
|
||||
|
||||
- Forgejo `master` push는 완료했고 Cloudflare Pages production `f2039a2e`를 `main` 브랜치에 배포했다. 공개 `https://vignette.chanpaca.net`에서 desktop/mobile 로그인 화면은 정상 렌더, page error·import 오류는 각각 0건, 무인증 `/auth/me`는 401이었다. 이 검증은 인증된 내부 화면 검증이 아니다.
|
||||
- Pages entry `/assets/index-BAtV-qxp.js`와 stylesheet `/assets/index-CNzKarrr.css`의 공개 SHA-256은 로컬 산출물과 일치했고 이전 세대 자산 179개를 보존했다. `pages.dev` 주소는 API CORS 비허용으로 재연결 화면을 보여 로그인 정상 판정 근거에서 제외했다.
|
||||
- 사전 검증은 API legacy 1263 passed·1 skipped·1 warning, engine gateway 82 passed·1 warning, harness 68 passed, API types/typecheck/build/SSOT checker 통과다. 처음 desktop/mobile focused 실행의 10개 실패는 API 미기동 환경 원인이었고, 스택 기동 뒤 desktop 9 passed·mobile 9 passed와 별도 `single-run` 15 passed를 재확인했다.
|
||||
- NAS API(`sha256:309ccd2d…`)와 web(`sha256:6ca536db…`)을 교체하고 migration 25를 트랜잭션으로 적용했다. admin-only DELETE policy `app.current_role_name() = 'admin'`를 실증했다. engine·DB 컨테이너 ID/이미지/volume source와 runtime compose는 그대로 보존했다.
|
||||
- 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).
|
||||
|
||||
## 6. 남은 구성 작업 (TODO)
|
||||
|
||||
- [ ] Forgejo master 기준 NAS 자동배포 후크(수동 절차는 §5, §5.1로 실증 완료)
|
||||
|
|
|
|||
132
docs/ops/evidence/release-2026-10-20.json
Normal file
132
docs/ops/evidence/release-2026-10-20.json
Normal file
|
|
@ -0,0 +1,132 @@
|
|||
{
|
||||
"title": "2026-10-20 승인 릴리스 배포 영수증",
|
||||
"captured_at": "2026-10-20",
|
||||
"source": {
|
||||
"canonical_branch": "master",
|
||||
"forgejo_sha": "aeddaa6972cafabec8113745037533893db0ac34",
|
||||
"forgejo_push_completed": true
|
||||
},
|
||||
"preflight": {
|
||||
"api_legacy": "1263 passed, 1 skipped, 1 warning",
|
||||
"engine_gateway": "82 passed, 1 warning",
|
||||
"release_harness": "68 passed",
|
||||
"web": [
|
||||
"check:api-types passed",
|
||||
"typecheck passed",
|
||||
"build passed",
|
||||
"dashboard SSOT checker passed"
|
||||
],
|
||||
"layout": {
|
||||
"initial_desktop_mobile_result": "40 passed, 10 failed; API 미기동 환경 원인",
|
||||
"stack_rerun": "desktop 9 passed, mobile 9 passed",
|
||||
"single_run": "15 passed"
|
||||
},
|
||||
"preserved_local_files": {
|
||||
"excluded_count": 1675,
|
||||
"unchanged": 1675,
|
||||
"changed": 0,
|
||||
"missing": 0
|
||||
}
|
||||
},
|
||||
"pages_production": {
|
||||
"deployment_id": "f2039a2e",
|
||||
"branch": "main",
|
||||
"url": "https://vignette.chanpaca.net",
|
||||
"preserved_previous_assets": 179,
|
||||
"entry": {
|
||||
"path": "/assets/index-BAtV-qxp.js",
|
||||
"sha256": "c6e42a3846809196c6277a47aa0fb9b1bd11e455d586372eb708bda8ed8d2c59"
|
||||
},
|
||||
"stylesheet": {
|
||||
"path": "/assets/index-CNzKarrr.css",
|
||||
"sha256": "1bbaa56f4a4c6f410fcb413de6bb67c2463bc68c75ddd756a0b03df901b088cc"
|
||||
},
|
||||
"unauthenticated_check": {
|
||||
"desktop_and_mobile_login_rendered": true,
|
||||
"page_errors": 0,
|
||||
"import_errors": 0,
|
||||
"auth_me_status": 401
|
||||
},
|
||||
"boundary": "pages.dev 배포 주소는 API CORS 비허용으로 재연결 화면을 보였으므로 로그인 정상 판정 근거로 사용하지 않았다. 인증된 운영 내부 UI는 이번 세션에서 검증하지 않았다."
|
||||
},
|
||||
"nas_preflight": {
|
||||
"receipt_path": "/volume1/docker/vignette-prod/receipts/release-20261020-20261020T073056Z",
|
||||
"db_dump_bytes": 11892253,
|
||||
"pg_restore_list_passed": true,
|
||||
"uploads": {
|
||||
"file_count": 93,
|
||||
"total_bytes": 52973,
|
||||
"manifest_sha256": "2e7f31a28d3d7f527f62092b3adfc96bf92f5cd35769a498d242b99cbeae43d2"
|
||||
},
|
||||
"promotion_status": "completed",
|
||||
"build_status": "API and web image builds completed before promotion."
|
||||
},
|
||||
"nas_deployment": {
|
||||
"api": {
|
||||
"image_sha256": "sha256:309ccd2d9bd8d1d69debfd50c251d9118fe42347a5522be24810790f51afcd94",
|
||||
"container_id": "53ab25a7a59cd8e3040a8cf13d0af9530574419ffe3b41c3037d4d7b3162c7e6"
|
||||
},
|
||||
"web": {
|
||||
"image_sha256": "sha256:6ca536db9fc10be644f9108c639c25c97221a7e4e776aa31f2dba3efe07da169",
|
||||
"container_id": "347e9c225f8bcdac4dea49f14f5ce77f6e124bce0f20322394a8c832dd4794f7"
|
||||
},
|
||||
"unchanged_dependencies": {
|
||||
"engine_container_prefix": "48d95f9b2ab7",
|
||||
"db_container_prefix": "5bb41175e0d8",
|
||||
"container_ids_images_and_volume_sources_unchanged": true,
|
||||
"runtime_compose_preserved": true
|
||||
},
|
||||
"migration_25": {
|
||||
"transaction_applied": true,
|
||||
"admin_delete_policy_verified": "app.current_role_name() = 'admin'"
|
||||
},
|
||||
"retention_dry_run": {
|
||||
"applied": false,
|
||||
"rollup_days": 7,
|
||||
"raw_retention_days": 90,
|
||||
"rollup_retention_days": 365,
|
||||
"rollup_event_count": 14160,
|
||||
"buckets": 335,
|
||||
"prunable_events": 3945,
|
||||
"deleted_events": 0,
|
||||
"prunable_rollup": 0,
|
||||
"deleted_rollup": 0
|
||||
},
|
||||
"preservation": {
|
||||
"tables_compared": 118,
|
||||
"tables_with_changed_row_counts": 0,
|
||||
"tables_with_reduced_row_counts": 0,
|
||||
"uploads_unchanged": true
|
||||
},
|
||||
"nginx_config_test_passed": 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,
|
||||
"failed_requests": 0,
|
||||
"import_errors": 0,
|
||||
"js_and_css_hashes_match_dist": true
|
||||
},
|
||||
"availability_boundary": "API 단일 교체 중 curl reset과 empty reply가 있었고 이후 회복했다. 무중단 배포를 주장하지 않는다."
|
||||
},
|
||||
"limitations": [
|
||||
"NAS web npm ci가 11 vulnerabilities (moderate 3, high 8)를 보고했다. 이번 릴리스 범위에서는 exploitability와 production dependency 여부를 조사하지 않았고, lockfile 변경이나 자동 fix를 실행하지 않았다.",
|
||||
"source-pack metadata의 external_llm_ok 변경은 저장소와 배포 이미지에만 반영했다. 운영 KB 데이터 재동기화 명령은 실행하지 않았으므로 운영 KB 행 갱신을 주장하지 않는다."
|
||||
],
|
||||
"open_gates": [
|
||||
"인증된 운영 내부 UI 검증",
|
||||
"JEV-002 실제 대사 관측과 JEV 품질 승격",
|
||||
"RETENTION-001 실제 apply의 별도 소유자 승인과 운영 증거",
|
||||
"P2~P7 운영 세션의 소유자 시각 확인 및 임상 gate"
|
||||
]
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue