장식 배경 WebP 반영·NAS web 갱신 결과를 기록하고 게이트 수치를 바로잡는다
Pages 0e90049c와 NAS web(sha256:8ec81318…)에 14061d25를 반영한 영수증을
남긴다. 글꼴 변경 뒤 미실행이던 레이아웃 E2E 결과(layout-visual-gate 15/15,
session-layout 10/10, auth-visual 1/1)를 기록하고, AGENTS.md와 검증 가이드의
옛 수치(7/7·8/8)를 실제 테스트 수에 맞춘다.
This commit is contained in:
parent
14061d25e9
commit
8d6201e19e
7 changed files with 141 additions and 6 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-26 후속: 장식 배경 16개를 WebP로 바꾼 `14061d25`(합계 8,504,051→968,652 bytes)를 Pages `0e90049c`와 NAS web(`sha256:8ec81318…`)에 반영했다. NAS web에는 글꼴 분할본도 함께 들어갔다. 글꼴 변경 뒤 미실행이던 레이아웃 E2E는 `layout-visual-gate` 15/15·`session-layout` 10/10(`--workers=1`)·`auth-visual` 1/1로 통과했다. 남은 것은 Cloudflare LAX 경로 지켜보기(소유자 결정)와 인증 화면 재측정이다([반영 영수증](./evidence/release-2026-10-26.json)).
|
||||
> 2026-10-25 후속: 공개 터널을 자동 재시작 compose 컨테이너로 전환했고(`8fc829fe` 복구 스크립트), 글꼴 92분할본 `5c5b66d0`을 Pages `d4a089db`에 반영했다. 남은 것은 사이드바 배경 PNG 경량화, NAS web 이미지 갱신, Cloudflare LAX 경로 관찰이다([반영 영수증](./evidence/release-2026-10-25.json)).
|
||||
> 2026-10-25 운영 점검 결함 수정은 Forgejo `master` SHA `7facf961c5c48355e1c4a2e05e2688811f49b8db`의 NAS API만 승격했다. 감독·연구 주기 제출 번호 충돌, 로그인 확인 지연(`last_seen_at` 60초 간격), `openai` 단가 누락, 음성 합성 502 기록을 고쳤고 migration은 없다. [반영 영수증](./evidence/release-2026-10-25.json)을 따른다.
|
||||
> 2026-10-24 승인 릴리스는 Forgejo `master` SHA `b0ff44a1d4d3aed19b1bb0e1bbd0aab327aef0ea`의 NAS API/web 승격과 Pages production `42eef402`를 완료했다. 라우터 7 동기 갱신 복구·딥링크 next 보존·감독 경로 강제가 포함되며 migration은 없다. [배포 영수증](./evidence/release-2026-10-24.json)을 따른다.
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
# 배포 파이프라인 (Deployment Pipeline)
|
||||
|
||||
> 작성: 2026-08-31 · 2026-10-25 현행화 · 문서 소유: docs/ops
|
||||
> 상태: 2026-10-25 Forgejo `master` SHA `7facf961c5c48355e1c4a2e05e2688811f49b8db`의 NAS API를 승격했고, 같은 날 글꼴 분할본 `5c5b66d0`을 Pages production `d4a089db`에 반영했다. NAS web 이미지는 2026-10-24 상태다. 공개 터널은 자동 재시작 compose 컨테이너다(§5.8·§5.9).
|
||||
> 상태: 2026-10-26 Forgejo `master` SHA `14061d25e9ed90b3c04d8867be78ae9208cb7f7a`(장식 배경 WebP, 글꼴 분할본 포함)를 Pages production `0e90049c`와 NAS web에 반영했다. NAS API는 2026-10-25 `7facf961` 그대로다. 공개 터널은 자동 재시작 compose 컨테이너다(§5.8~§5.10).
|
||||
|
||||
## 목표 아키텍처 (소유자 지시)
|
||||
|
||||
|
|
@ -195,6 +195,14 @@ docker compose -f docker-compose.nas.yml --env-file private/env.nas up -d --no-d
|
|||
- **NAS 정리**: 다른 프로젝트의 9일째 비밀번호 입력 대기 `createdb`와 5일 20시간 대기 Forgejo CI 작업 컨테이너를 소유자 승인으로 정리했다.
|
||||
- **남은 것**: Cloudflare가 한국 요청을 LAX 거점으로 처리해 Pages 자산이 초당 60~250KB로 내려온다(소유자 결정: 지켜보기, 실제 사용자 진단 보고 0건). 글꼴 뒤 병목은 사이드바 배경 PNG(1,168,196 bytes, 어두운 판 1,761,725 bytes)다. 구조화 증거: [`release-2026-10-25.json`](./evidence/release-2026-10-25.json)의 `followup_owner_decisions`.
|
||||
|
||||
## 5.10 장식 배경 WebP 전환과 NAS web 갱신 (2026-10-26, SHA `14061d25e9ed90b3c04d8867be78ae9208cb7f7a`)
|
||||
|
||||
- **변경**: 학습자 대시보드 장식 14개와 로그인·회기 배경 2개를 같은 이름의 WebP(품질 90, 투명도 무손실)로 바꿨다. 합계 8,504,051→968,652 bytes, 사이드바 배경 1,168,196→152,228 bytes다. 옛 PNG는 이전 세대 CSS 참조 때문에 남기고 공유 미리보기(og:image)는 PNG를 유지한다.
|
||||
- **로컬 검증**: `check:design-ssot`·typecheck·build 통과. `layout-visual-gate` 15 passed, `auth-visual` 1 passed, `session-layout` desktop+mobile `--workers=1` 10 passed. 10개 병렬 실행은 회기 시작 대기 시간 초과가 실행마다 다르게 나서(testing.md의 병렬 포화 함정) 기준에서 뺐다. 같은 화면을 WebP와 PNG로 그려 비교한 16쌍에서 배경 영역 차이는 평균 0.03/255 수준이다.
|
||||
- **Pages**: production `0e90049c`. 공개 JS/CSS SHA-256이 dist와 같고, 공개 CSS의 대상 PNG 참조는 0이다. 직전 세대 JS·CSS, 옛 PNG, 옛 전체 글꼴은 200으로 남았다. 2026-10-24 세대 entry는 보존 목록 밖이라 빠졌다. 공개 `/login` 첫 접속은 708,839 bytes(배경이 PNG였다면 약 2,319,786 bytes), page error 0이다. 경로는 여전히 LAX다.
|
||||
- **NAS web 전용 교체**: NAS에만 둔 스크립트 `/volume1/docker/vignette-prod/scripts/release-20261026-web.sh`(인자: 40자 SHA)로 Forgejo clone·SHA 대조 → `vignette-nas-web:14061d25`(`sha256:8ec81318…`) 빌드 → `env.nas` 사본 보존 뒤 pin → `up -d --no-deps web`. 재생성 46초, nginx 검사 통과, NAS CSS SHA-256이 Pages와 같다. api·engine·db·cloudflared 컨테이너와 compose 파일은 전후 동일하다. web 전용이라 DB dump는 하지 않았고, 공개 API는 api 컨테이너가 직접 받아 끊기지 않았다.
|
||||
- **남은 것**: Cloudflare LAX 경로 지켜보기(소유자 결정), 인증된 운영 화면 재순회로 화면당 시간 재측정(소유자 로그인 필요), NAS 재부팅 실증(공유 NAS). 구조화 증거: [`release-2026-10-26.json`](./evidence/release-2026-10-26.json).
|
||||
|
||||
## 6. 남은 구성 작업 (TODO)
|
||||
|
||||
- [ ] Forgejo master 기준 NAS 자동배포 후크(수동 절차는 §5, §5.1로 실증 완료)
|
||||
|
|
|
|||
123
docs/ops/evidence/release-2026-10-26.json
Normal file
123
docs/ops/evidence/release-2026-10-26.json
Normal file
|
|
@ -0,0 +1,123 @@
|
|||
{
|
||||
"title": "2026-10-26 장식 배경 WebP 전환과 NAS web 갱신 영수증",
|
||||
"captured_at": "2026-10-26",
|
||||
"trigger": "2026-10-25 후속 조치의 남은 항목(사이드바 배경 PNG 경량화, NAS web 이미지 갱신, 글꼴 변경 뒤 레이아웃 E2E 미실행)을 소유자 지시로 정리했다.",
|
||||
"source": {
|
||||
"canonical_branch": "master",
|
||||
"forgejo_sha": "14061d25e9ed90b3c04d8867be78ae9208cb7f7a",
|
||||
"forgejo_push_completed": true,
|
||||
"included_commits": [
|
||||
"14061d25 장식 배경 이미지를 WebP로 바꿔 화면 이미지 전송량을 줄인다"
|
||||
],
|
||||
"code_scope": "apps/web만: src/styles/tokens.css, src/pages/learner-home.css의 이미지 URL, e2e/layout-visual-gate.spec.ts의 자산 이름 기대값, public/design-elements의 WebP 16개. api·engine·infra·migration 변경 없음."
|
||||
},
|
||||
"change": {
|
||||
"conversion": "PIL WebP quality=90, alpha_quality=100, method=6. 투명도 손실 0.",
|
||||
"assets": "learner-dashboard 장식 14개 + clinical-paper-ambient + login-counseling-room",
|
||||
"bytes_total": "8,504,051 -> 968,652",
|
||||
"bytes_examples": {
|
||||
"background-light-sidebar": "1,168,196 -> 152,228",
|
||||
"background-dark-sidebar": "1,761,725 -> 207,038",
|
||||
"login-counseling-room": "1,719,823 -> 108,876",
|
||||
"clinical-paper-ambient": "2,342,959 -> 226,576"
|
||||
},
|
||||
"kept": "옛 PNG는 이전 세대 CSS 참조 때문에 남겼다. index.html의 공유 미리보기(og:image)는 PNG를 유지한다.",
|
||||
"note": "clinical-paper-ambient(--asset-warm-elements)는 .sx-page--prestart·.sx-page--active가 배경을 덮어써 현재 어떤 화면에서도 요청되지 않는다. 기존 구조이며 이번 변경과 무관하다."
|
||||
},
|
||||
"verification_local": {
|
||||
"static": [
|
||||
"check:design-ssot 통과",
|
||||
"typecheck 통과",
|
||||
"build 통과, dist WebP 16개, dist CSS의 대상 PNG 참조 0"
|
||||
],
|
||||
"e2e": {
|
||||
"layout-visual-gate --project=chromium-single-run": "15 passed",
|
||||
"auth-visual --project=chromium-single-run": "1 passed",
|
||||
"session-layout --project=chromium-desktop --project=chromium-mobile --workers=1": "10 passed",
|
||||
"session-layout 10 workers": "10 failed, 재실행 3 passed/7 failed(실패 집합 상이). 회기 시작 버튼·제목 대기 시간 초과로, testing.md의 전면 병렬 포화 함정과 일치. 기준으로 쓰지 않는다."
|
||||
},
|
||||
"visual_compare": {
|
||||
"method": "같은 계정·같은 화면을 WebP 그대로와 page.route로 같은 이름 PNG를 돌려준 변경 전 모습으로 두 번 그려 픽셀 비교. 로그인·학습자 홈 2탭·활성 회기 × 라이트/다크 × 1440x900/390x844 = 16쌍.",
|
||||
"login_mean_abs_error": "0.07~0.14 / 255",
|
||||
"learner_home_today_light_desktop": "사이드바 영역 평균 0.027·최대 2, 아바타 밖 평균 0.012. 전체 평균 1.14는 아바타 원 안(평균 33)에 몰려 있으며 아바타는 이번 변경 대상이 아니다.",
|
||||
"design_elements_requests": "32회 전수 200, 404 0"
|
||||
}
|
||||
},
|
||||
"pages_production": {
|
||||
"deployment_id": "0e90049c",
|
||||
"branch": "main",
|
||||
"url": "https://vignette.chanpaca.net",
|
||||
"preserved_previous_assets": 179,
|
||||
"entry": {
|
||||
"path": "/assets/index-CSQh7hyO.js",
|
||||
"sha256": "9e73152e3f3eb274f99c248aa6df37d52915813bf752ace5e977dcb8deaf090e"
|
||||
},
|
||||
"stylesheet": {
|
||||
"path": "/assets/index-ByR7eke9.css",
|
||||
"sha256": "e88c4a9a8fe058ced4c432d8876b41dc8d5b74f3c7397cf234e7e9ac6e6a4006"
|
||||
},
|
||||
"js_and_css_hashes_match_dist": true,
|
||||
"public_checks": [
|
||||
"공개 CSS의 design-elements PNG 참조 0, @font-face 92",
|
||||
"background-light-sidebar.webp 200 image/webp 152,228 bytes, login-counseling-room.webp 200 108,876 bytes",
|
||||
"직전 세대 index-D8zLr3Rf.js·index-oGqCvuGR.css, 옛 PNG, 옛 전체 글꼴 200 보존",
|
||||
"보존 대상은 현재 공개 세대와 preserve-assets.mjs의 고정 미리보기 목록이다. 2026-10-24 세대 entry index-V3qu1E6S.js는 이번 배포에서 빠졌다."
|
||||
],
|
||||
"public_login_first_visit": {
|
||||
"colo": "LAX",
|
||||
"total_bytes": 708839,
|
||||
"by_kind": {
|
||||
"doc": 17281,
|
||||
"css": 93826,
|
||||
"js": 279400,
|
||||
"woff2": 209456,
|
||||
"webp": 108876
|
||||
},
|
||||
"computed_before_png": "배경이 PNG(1,719,823 bytes)였다면 약 2,319,786 bytes",
|
||||
"load_ms": "desktop 3,717·851, mobile 893·830(2회)",
|
||||
"network_idle_ms": "2,609~5,935",
|
||||
"page_errors": 0
|
||||
}
|
||||
},
|
||||
"nas_deployment": {
|
||||
"receipt_path": "/volume1/docker/vignette-prod/receipts/release-20261026-web-20261025T204307Z",
|
||||
"script": "/volume1/docker/vignette-prod/scripts/release-20261026-web.sh",
|
||||
"source_sha_verified": "14061d25e9ed90b3c04d8867be78ae9208cb7f7a",
|
||||
"web": {
|
||||
"previous_image_sha256": "sha256:443928c319a4d42187622fc8c2214dbfe589573bff273b68957b782834069531",
|
||||
"image_sha256": "sha256:8ec81318bd39574956b515dbf2501ef657f94b029adc47bd25d2e54ad1c16b98",
|
||||
"tag": "vignette-nas-web:14061d25",
|
||||
"container_id": "ece030cfc030a0e9728f38ff69a5d5c7091983d4356b77cf3a0e4605e9c08bc7",
|
||||
"recreate_started_utc": "2026-10-25T20:53:00Z",
|
||||
"recreate_done_utc": "2026-10-25T20:53:46Z"
|
||||
},
|
||||
"env_backup": "private/env.nas.before-release-20261026-web-20261025T204307Z",
|
||||
"checks": [
|
||||
"nginx 설정 검사 통과",
|
||||
"NAS index CSS index-ByR7eke9.css SHA-256이 Pages와 동일, @font-face 92, 사이드바 WebP 참조 1, learner-dashboard PNG 참조 0, 글꼴 preload 0",
|
||||
"컨테이너 안에서 사이드바 WebP·분할 글꼴 요청 성공",
|
||||
"api·engine·db·cloudflared 컨테이너 ID·이미지와 compose 파일 SHA-256 전후 동일",
|
||||
"NAS 내부 health 전후 status ok·db true·engine true"
|
||||
],
|
||||
"unchanged": "DB·uploads를 건드리지 않는 web 전용 교체라 DB dump는 하지 않았다. 공개 API는 api 컨테이너(127.0.0.1:18080)가 직접 받으므로 web 재생성 중에도 끊기지 않는다."
|
||||
},
|
||||
"closed_from_2026_10_25": [
|
||||
"장식 배경 PNG 경량화",
|
||||
"NAS web 이미지를 글꼴 분할본 커밋으로 갱신(이번 이미지에 글꼴 분할본과 WebP가 함께 들어감)",
|
||||
"글꼴 변경 뒤 layout-visual-gate·session-layout 미실행"
|
||||
],
|
||||
"doc_corrections": [
|
||||
"AGENTS.md §2·B.10의 레이아웃 게이트 수치를 layout-visual-gate 15/15, session-layout 10/10(desktop+mobile --workers=1)으로 바로잡았다. session-layout은 613bcb60에서 v3 아바타 테스트가 추가돼 5 테스트다.",
|
||||
"docs/guides/testing.md 현재 통과 표의 session-layout을 10 / 10으로 바로잡았다."
|
||||
],
|
||||
"open_gates": [
|
||||
"Cloudflare LAX 경로 지켜보기(소유자 결정, 실제 사용자 진단 보고 발생 시 재검토)",
|
||||
"인증된 운영 화면 재순회로 화면당 시간 재측정(소유자 Google 로그인 필요, 이번에는 하지 않음)",
|
||||
"NAS 재부팅 실증(공유 NAS라 하지 않음)",
|
||||
"NAS 공유 호스트 I/O 과부하 원인 프로세스 정리(다른 프로젝트 소유자 결정)",
|
||||
"교수자 대시보드·사용자 목록 응답 크기와 지연 개선",
|
||||
"dev 전용 의존성 취약점(DEV-DEPS-001)",
|
||||
"JEV-002 실제 대사 관측과 JEV 품질 승격",
|
||||
"RETENTION-001 실제 apply의 별도 소유자 승인"
|
||||
]
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue