장식 배경 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:
Yun Chan 2026-10-26 05:56:27 +09:00
parent 14061d25e9
commit 8d6201e19e
7 changed files with 141 additions and 6 deletions

View file

@ -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로 실증 완료)