diff --git a/docs/TODO.md b/docs/TODO.md index 9305cce..7da5dd5 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-25 후속: 공개 터널을 자동 재시작 compose 컨테이너로 전환했고(`8fc829fe` 복구 스크립트), 글꼴 92분할본 `5c5b66d0`을 Pages `d4a089db`에 반영했다. 남은 것은 사이드바 배경 PNG 경량화, NAS web 이미지 갱신, Cloudflare LAX 경로 관찰이다([반영 영수증](./ops/evidence/release-2026-10-25.json)). > 2026-10-25 운영 점검 결함 수정은 Forgejo `master` SHA `7facf961c5c48355e1c4a2e05e2688811f49b8db`의 NAS API만 승격했다. 감독·연구 주기 제출 번호 충돌, 로그인 확인 지연(`last_seen_at` 60초 간격), `openai` 단가 누락, 음성 합성 502 기록을 고쳤고 migration은 없다. [반영 영수증](./ops/evidence/release-2026-10-25.json)을 따른다. > 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)을 따른다. diff --git a/docs/dev_dashboard.html b/docs/dev_dashboard.html index 8390ae1..9e2b5f4 100644 --- a/docs/dev_dashboard.html +++ b/docs/dev_dashboard.html @@ -300,7 +300,8 @@
project pulse -

지금 위치: 2026-10-25 운영 점검 결함 수정 반영 — Forgejo master SHA 7facf961의 NAS API를 승격했다. web·Pages 42eef402는 그대로다. 소유자 관리자 계정으로 인증된 운영 화면 46개와 실제 상담 연습 1회를 확인했고, 교수자 전용·OFF 계정 검증과 외부·임상 gate는 열린 상태다.

+

지금 위치: 2026-10-25 운영 점검 결함 수정과 후속 조치 반영 — NAS API 7facf961, Pages d4a089db(글꼴 분할본 5c5b66d0), 공개 터널은 자동 재시작 compose 컨테이너다. 소유자 관리자 계정으로 인증된 운영 화면 46개와 실제 상담 연습 1회를 확인했고, 교수자 전용·OFF 계정 검증과 외부·임상 gate는 열린 상태다.

+

2026-10-25 소유자 결정 후속: 공개 터널을 compose 컨테이너로 전환했다(9월 실패 원인: config 640·빈 비밀 볼륨). 호스트 터널을 끈 상태 공개 health 10/10, 복구 스크립트 8fc829fe로 컨테이너 재기동 확인. 글꼴은 2MB preload를 없애고 92분할본으로 바꿔 첫 접속 글꼴 전송을 2,057,688→209,456 bytes로 줄였다(Pages d4a089db, 화면 그림 실패 15→0). Cloudflare가 한국 요청을 LAX로 처리해 Pages 자산이 초당 60~250KB라 화면당 중앙값은 여전히 약 9초이며, 다음 병목은 1.17MB 사이드바 배경 PNG다. 다른 프로젝트의 멈춘 createdb와 Forgejo CI 작업은 소유자 승인으로 정리했다. NAS web 이미지는 다음 릴리스 때 갱신한다.

2026-10-25 운영 점검·수정: 소유자 관리자 계정으로 23개 경로 × desktop/mobile 46화면을 쓰기 차단 순회하고 실제 상담 연습 1회(2턴·음성 200·종료·리뷰)를 확인했다. 결함 4건을 고쳐 API(sha256:13d59af7…)만 교체했다: 감독·연구 생성 주기의 제출 번호 충돌(2026-09-09 링크 변경 뒤 매시 실패, 마지막 성공 08-30), NAS 동기 쓰기 지연(4KB당 약 0.35초)으로 /auth/me가 1~4초가 되어 모바일 재연결 화면이 뜬 문제(last_seen_at 60초 간격 갱신), openai 공급자 단가 누락으로 9월부터 $0이던 관리자 AI 비용, 원인 기록 없는 음성 합성 502. 반영 뒤 감독 주기 새 스냅샷 저장, /auth/me NAS 내부 0.012~0.034초·공개 0.58~0.89초, 재순회 재연결 화면·page error·끊긴 요청 0건이다. DB dump 12,062,700 bytes·행 수 차이 0·uploads 동일, API 공백 69초. 재시작만 반복하던 컨테이너 2개는 정지했다(삭제 안 함). NAS 공유 호스트 과부하와 재부팅 시 호스트 터널 자동 시작 부재는 남은 위험이다. 반영 영수증.

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 재시도에 멈추므로 해당 변수를 뺀 셸에서 기동해야 한다.

diff --git a/docs/ops/backlog-2026-06-26.md b/docs/ops/backlog-2026-06-26.md index b965b12..a4fef36 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-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)을 따른다. > 2026-10-20 승인 릴리스는 Forgejo `master` SHA `aeddaa6972cafabec8113745037533893db0ac34` push, Pages production, NAS API/web 승격과 migration 25 적용을 완료했다. 인증 운영 UI와 retention 실제 apply는 완료로 선언하지 않는다. [배포 영수증](./evidence/release-2026-10-20.json)을 따른다. diff --git a/docs/ops/deployment-pipeline.md b/docs/ops/deployment-pipeline.md index a3f287e..d4de421 100644 --- a/docs/ops/deployment-pipeline.md +++ b/docs/ops/deployment-pipeline.md @@ -1,7 +1,7 @@ # 배포 파이프라인 (Deployment Pipeline) > 작성: 2026-08-31 · 2026-10-25 현행화 · 문서 소유: docs/ops -> 상태: 2026-10-25 Forgejo `master` SHA `7facf961c5c48355e1c4a2e05e2688811f49b8db`의 NAS API를 승격했다. web·engine·DB·Pages(`42eef402`)는 2026-10-24 상태 그대로다. 소유자 관리자 계정으로 인증된 운영 내부 화면 46개와 실제 상담 연습 1회를 확인했다(§5.8). +> 상태: 2026-10-25 Forgejo `master` SHA `7facf961c5c48355e1c4a2e05e2688811f49b8db`의 NAS API를 승격했고, 같은 날 글꼴 분할본 `5c5b66d0`을 Pages production `d4a089db`에 반영했다. NAS web 이미지는 2026-10-24 상태다. 공개 터널은 자동 재시작 compose 컨테이너다(§5.8·§5.9). ## 목표 아키텍처 (소유자 지시) @@ -159,7 +159,7 @@ docker compose -f docker-compose.nas.yml --env-file private/env.nas up -d --no-d - **함정**: `yunchan` 계정은 `/var/run/docker.sock`(root:root 660)에 접근 권한이 없어 `docker`·`docker compose` 명령이 전부 `permission denied`다. `sudo`는 비밀번호를 요구한다. 따라서 compose 기반 복구 명령은 현재 SSH 계정으로 실행할 수 없다. - **오진 기록**: 이 절은 원래 "cloudflared가 compose의 `profiles: [public-cutover-gate]` 게이트라 `--profile` 없이 `up -d` 하면 터널이 빠져 530이 재발한다"고 진단했으나, 이는 **오진이었다.** 근거: (1) 호스트 로그가 재부팅 직전(KST 03:09:06)까지 정상 갱신되고 있어 애초에 compose 컨테이너가 아닌 호스트 프로세스가 떠 있었다. (2) 재부팅 후 관측은 호스트 프로세스 부재(`ps -ef`)와 터널 엣지(`:7844`)로 나가는 연결 0건이었지 compose 프로파일 문제의 증상이 아니었다. (3) 이 판단은 §6의 "현재 `api-vignette`는 NAS 호스트 상주 cloudflared 터널 경유다" 기술과도 모순됐다. 이력을 지우지 않고 오진이었음을 남긴다. - **앱 증상 연결**: `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 계열 열린 게이트). 등록 방식은 미정이다. +- **해결(2026-10-25)**: 공개 터널을 restart `unless-stopped` compose 컨테이너로 전환해 재부팅 자동 기동을 도커에 맡겼다. 위 호스트 상주 복구 절차는 대체 경로로만 남는다(§5.9). ## 5.6 승인 릴리스 배포 완료 (2026-10-20, SHA `aeddaa6972cafabec8113745037533893db0ac34`) @@ -187,6 +187,14 @@ docker compose -f docker-compose.nas.yml --env-file private/env.nas up -d --no-d - 서버 정리: 재시작만 반복하던 `vignette-prod-cloudflared-1`(설정 권한 거부, 45,869회)과 2026-08 미리보기 `vignette-db-1`(45,664회)을 재시작 정책 `no`로 바꾸고 정지했다. 삭제하지 않았다. 공개 터널은 호스트 상주 cloudflared가 계속 맡는다. - 남은 위험: NAS 공유 호스트 과부하(부하 평균 13~17, 교체 공간 소진, 다른 프로젝트 소유 프로세스)와 재부팅 시 호스트 터널 자동 시작 부재. 구조화 증거: [`release-2026-10-25.json`](./evidence/release-2026-10-25.json). +## 5.9 소유자 결정 후속 조치 (2026-10-25, 글꼴 `5c5b66d0`·복구 스크립트 `8fc829fe`) + +- **터널 컨테이너 전환**: 2026-09 전환 실패 원인은 `cloudflared/config.yml` 640(컨테이너 계정 65532가 못 읽음)과 빈 비밀 볼륨 `vignette-prod-cloudflared-secrets-20260830`이었다. config를 644로(상위 폴더 750 유지), 인증 파일을 볼륨에 65532 소유 400으로 복사한 뒤 `--profile public-cutover-gate up -d --no-deps --force-recreate cloudflared`로 띄웠다. 연결 4개(icn06/icn07, quic)가 등록됐고, 호스트 상주 cloudflared를 끈 상태에서 공개 health 10/10 200을 확인했다. 지금 공개 터널은 컨테이너 단독이다. +- **복구 스크립트**: NAS 계정의 `ps`에는 컨테이너 프로세스가 보이지 않아 기존 중복 판정이 컨테이너를 놓쳤다. [`scripts/nas-recover-prod.sh`](../../scripts/nas-recover-prod.sh)는 `docker inspect`로 컨테이너를 먼저 판정·기동하고 실패할 때만 호스트 상주 터널을 띄운다. 컨테이너를 멈추고 실행해 재기동과 `RECOVER_DONE`을 확인했다. NAS 재부팅 자체는 공유 호스트라 실증하지 않았다. +- **글꼴**: 첫 접속 때 최우선으로 받던 `PretendardVariable.woff2`(2,057,688 bytes) preload를 없애고 공식 92분할본(unicode-range)을 자체 호스팅했다. 공개 `/login` 첫 접속 글꼴 전송은 8요청 209,456 bytes이고, 변경 전후 로컬 화면 그림은 SHA-256까지 같다. 옛 전체 글꼴 파일은 이전 세대 CSS가 참조해 남겼다. web만 바뀌어 Pages(`d4a089db`)만 반영했고 NAS web 이미지는 다음 릴리스 때 갱신한다. +- **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`. + ## 6. 남은 구성 작업 (TODO) - [ ] Forgejo master 기준 NAS 자동배포 후크(수동 절차는 §5, §5.1로 실증 완료) diff --git a/docs/ops/evidence/release-2026-10-25.json b/docs/ops/evidence/release-2026-10-25.json index 4a08963..3fd6681 100644 --- a/docs/ops/evidence/release-2026-10-25.json +++ b/docs/ops/evidence/release-2026-10-25.json @@ -50,7 +50,9 @@ "preflight": { "api": "1279 passed, 1 skipped, 1 warning", "engine_gateway": "82 passed, 1 warning", - "web": ["check:api-types passed"] + "web": [ + "check:api-types passed" + ] }, "nas_preflight": { "receipt_path": "/volume1/docker/vignette-prod/receipts/release-20261025-20261025T103250Z", @@ -106,11 +108,57 @@ "같은 소유자 계정에 열린 오래된 회기가 여러 건 남아 있다(예: P4)." ], "open_gates": [ - "NAS 재부팅 시 호스트 cloudflared 자동 시작 등록", "NAS 공유 호스트 I/O 과부하 원인 프로세스 정리(다른 프로젝트 소유자 결정)", "교수자 대시보드·사용자 목록 응답 크기와 지연 개선", "dev 전용 의존성 취약점(DEV-DEPS-001)", "JEV-002 실제 대사 관측과 JEV 품질 승격", - "RETENTION-001 실제 apply의 별도 소유자 승인" - ] + "RETENTION-001 실제 apply의 별도 소유자 승인", + "장식 배경 PNG 경량화(background-light-sidebar 1,168,196 bytes·dark 1,761,725 bytes)", + "NAS web 이미지를 글꼴 분할본 커밋으로 갱신", + "Cloudflare LAX 경로 지켜보기(실제 사용자 진단 보고 발생 시 재검토)" + ], + "followup_owner_decisions": { + "decided_at": "2026-10-25", + "decisions": { + "tunnel": "컨테이너로 전환", + "font": "지금 진행", + "nas_stuck_jobs": "둘 다 정리", + "cloudflare_route": "지켜보기" + }, + "recheck_before_decisions": { + "captured_utc": "2026-10-25T13:33Z", + "server": "반영 뒤 약 3시간 요청 569건 200·5xx 0·Traceback 0, 감독·연구 주기 실패 0(수정 전 매시 1건)", + "auth_me": "NAS 내부 0.022~0.040초, 브라우저 0.40~0.71초, 공개 curl 0.83~1.71초", + "route_sweep": "46화면 page error 0·오류 문구 0, API 오류는 종료 회기 409 2건. 화면당 중앙값 8,980ms·최대 20,272ms, 모바일 15화면은 글꼴 로딩 대기로 화면 그림 실패, 앱 진단 보고 시도 15건(차단).", + "cause": "vignette.chanpaca.net·api-vignette.chanpaca.net은 cdn-cgi/trace colo=LAX, speed.cloudflare.com은 colo=ICN. Pages 자산 초당 60~250KB(같은 시각 ICN 속도 측정 초당 11~28MB). 실제 사용자 진단 보고는 2026-10-24T13:33Z 이후 0건.", + "nas": "부하 평균 24.43, 동기 쓰기 20×4KB 17.55초" + }, + "nas_stuck_jobs": { + "createdb": "haramlog_lifecycle_audit_lab_20261011 컨테이너 안 createdb -U supabase_admin -T postgres meta_ads_gate_20261016(9일째 비밀번호 입력 대기)를 종료. 데이터베이스는 생성되지 않았다.", + "forgejo_ci": "FORGEJO-ACTIONS-TASK-4475_WORKFLOW-CI_JOB-node-static(2026-10-19T17:05Z 시작, 5일 20시간 대기)을 정지. 자동 삭제 설정이라 정지와 함께 정리됐다." + }, + "tunnel_container": { + "root_causes_of_2026_09_failure": [ + "cloudflared/config.yml 권한 640이라 컨테이너 계정 65532가 읽지 못함", + "비밀 볼륨 vignette-prod-cloudflared-secrets-20260830이 비어 있음" + ], + "fix": "config.yml을 644로(상위 폴더 750 유지), 인증 파일을 비밀 볼륨에 65532 소유 400으로 복사(원본과 SHA-256 앞 16자리 일치), --profile public-cutover-gate up -d --no-deps --force-recreate cloudflared. 같은 터널 번호·같은 연결 대상(127.0.0.1:18080)·network_mode host.", + "verified": "연결 4개 등록(icn06/icn07, quic), restart unless-stopped, 계정 65532:65532. 호스트 상주 cloudflared를 끈 뒤 공개 health 10/10 200과 /auth/me 401·CORS. 컨테이너를 멈추고 수정한 scripts/nas-recover-prod.sh 실행 → 컨테이너 재기동·RECOVER_DONE, 다시 단독 health 8/8.", + "final_state": "공개 터널은 compose 컨테이너 단독. 호스트 상주 프로세스는 정지. 재부팅 실증은 하지 않았다(공유 NAS)." + }, + "font_subset": { + "commit": "5c5b66d0", + "pages_deployment": "d4a089db", + "change": "PretendardVariable.woff2(2,057,688 bytes) preload 제거, 공식 Pretendard Variable 92분할본(unicode-range) 자체 호스팅. 글꼴 이름·굵기·font-display 불변, 옛 전체 글꼴 파일은 이전 세대 CSS 참조 때문에 유지.", + "verified": [ + "typecheck·build 통과, dist 분할 woff2 92개·@font-face 92개·글꼴 preload 0개", + "로컬 미리보기 /login 변경 전후 화면 그림 SHA-256 동일", + "공개 index-D8zLr3Rf.js·index-oGqCvuGR.css SHA-256이 dist와 일치, 옛 index-V3qu1E6S.js·옛 글꼴 200 보존", + "공개 /login 첫 접속 desktop·mobile 글꼴 8요청 209,456 bytes, Pretendard 적용, page error 0" + ], + "route_sweep_after": "46화면 page error 0·오류 문구 0·화면 그림 실패 0(이전 15), API 오류는 종료 회기 409 2건. 화면당 중앙값 9,492ms·최대 18,152ms로 전체 시간은 줄지 않았다: 측정 시각 LAX 경로가 더 느렸고 병목이 1,168,196 bytes 사이드바 배경 PNG로 옮겨 갔다(한 번 192초).", + "not_run": "layout-visual-gate·session-layout E2E는 web+API+DB 스택이 필요해 실행하지 않았다.", + "nas_web_image": "NAS web 컨테이너는 2026-10-24 이미지 그대로다. 다음 릴리스 때 함께 갱신한다." + } + } }