vignette/docs/ops/backlog-closeout-2026-10-19.md
Yun Chan aeddaa6972
Some checks failed
API contract / OpenAPI type drift (push) Failing after 6m2s
운영 안정화와 화면 회귀 검증을 반영
2026-10-20 16:33:48 +09:00

18 KiB

2026-10-19 백로그 로컬 closeout

이 보고서는 root의 수용 판정과 로컬 증거만 기록한다. 운영 적용, 공개 배포, 원격 push, 외부 임상 승인은 실행하지 않았으며 완료로 주장하지 않는다.

수용된 로컬 완료

항목 수용 결과 증거
DEVUP-DB-RACE managed DB 경로의 기동 경합을 로컬 완료로 수용 모든 managed 경로 TCP pg_isready, strict API health db=true, authoritative-sequence.json socket 0/TCP 2 → TCP 0 실초기화 재현, 기존 devdb 재시작 뒤 API db=true
ADMIN-AFFECT-V2-MOBILE 620px 이하에서 판정 항목·판정·근거 확률·판단 확신도 순서의 세로 행과 semantic table 역할을 로컬 완료로 수용 e2e/admin-affect.spec.ts desktop/mobile 20 passed (53.3s), 320/390/1440 PNG SHA-256 일치
AVATAR-V3 render mode outer data-render-mode가 실제 renderer와 일치하는 계약만 로컬 완료로 수용 e2e/avatar-expression.spec.ts focused desktop/mobile 6 passed (17.2s): rig+v3 ready=linocut-v3, loading/error/no rig=svg, outer와 inner 확인
C-001 기술 사전검증 결정론적 기술 산출물과 focused 검증만 로컬 수용 결정론적 산출물 6건, focused 10 passed. 외부 임상 입력 0건
RETENTION-001 로컬 구현과 격리 DB 검증 수용 raw 90일·rollup 365일, dry-run snapshot 무변경, policy/RLS guard, 경계·반복·learner 차단·rollback·raw 366일 신규 rollup 만료
RELEASE-MIGRATIONS RELEASE-23·24·25 transactional required-payload 계약 로컬 수용 retention CLI/release 38 passed, service focused 35 passed/1 warning
B1-LAYOUT-720-001 CSS 변경 없는 viewport-fixed/ordinary overflow 오탐 수정과 clip 반례 로컬 수용 layout gate 15 passed·0 failed·0 skipped·0 flaky(exit 0, 131.7s), fixed clip 회귀 4건·session-layout 10건. overflow/containing block 예외는 CSS 2.2 visual effects, fixed containing block은 CSS Positioned Layout Level 3를 대조했고, 적용 결론은 hit-test와 회귀 결과로 확인

ADMIN-AFFECT-V2-MOBILE 실행 명령과 산출물

$env:PLAYWRIGHT_BASE_URL = 'http://localhost:5189'
$env:PLAYWRIGHT_SKIP_WEB_SERVER = '1'
npx playwright test e2e/admin-affect.spec.ts --project=chromium-desktop --project=chromium-mobile --workers=1 --output=node_modules/.tmp/admin-affect-full-5189-rerun

결과: 20 passed (53.3s).

파일 SHA-256
outputs/backlog-closeout-2026-10-19/mobile-affect/admin-affect-v2-detail-320.png 8640DFDD3C97A215BC35D5220ACE356418FE7226E78072CC30C8584CD5596887
outputs/backlog-closeout-2026-10-19/mobile-affect/admin-affect-v2-detail-390.png E934FCB23F985AD933EABEDD10F30919B53F49E3914A0EED6DB624076A01A058
outputs/backlog-closeout-2026-10-19/mobile-affect/admin-affect-v2-detail-1440.png 70C1C01CFE17A27DE69ABA48B286BAF24A146F8B47203B161AE6189B8396E534

세 파일은 테스트 원본과 복사본의 SHA-256이 각각 일치한다. 320/390에서는 확률 라벨·막대·숫자가 viewport와 해당 행 안에 있고 행끼리 겹치지 않음을 bounding box로 검사했다.

함께 수용한 웹 검증

npm run typecheck
npm run build
npx playwright test e2e/avatar-expression.spec.ts --project=chromium-desktop --project=chromium-mobile --workers=1 --grep "renders every persona|uses the v3|v3 리소스" --output=node_modules/.tmp/avatar-render-mode-final-5189

결과: typecheck tsc -b 통과, build에서 cosmetic filter safety 160개 통과·191 modules transformed·built in 2.03s, avatar focused 6 passed (17.2s).

API 최종 로컬 검증

kbsync500-rework/의 root 검토 수용 로그에서 legacy 환경을 명시한 최종 app 전체는 1263 passed·1 skipped·1 warning(18.72s, exit 0), engine gateway 전체는 82 passed·1 warning(exit 0)이다. 실행한 app 명령은 $env:VIGNETTE_CLIENT_AFFECT_PROVIDER = 'legacy' 뒤 py -3.11 -m pytest app/ -q다. KB 수정 전 1259 passed·1 skipped·1 warning과 retention 적용 전 1255 passed·1 skipped는 중간 로컬 결과와 역사 baseline으로 이 보고서에만 보존한다.

KB source-pack의 로컬 수정은 workbook의 data C/D 다섯 항목을 외부 사용 불가로 바로잡고, apps/api/app/routes/kb.py의 관리자 sync 두 경로에 RLS role/user id를 주입한 범위다. 검증 당시 현재 기본 .env를 쓴 별도 API 8014 실DB에서 unauthenticated 401·learner 403·admin 202을 확인했고, 같은 admin sync를 두 번 수행해 각각 sources=7, items=7, chunks=0, skipped_unchanged=7, embedded=false, degraded=false를 확인했다. 이후 API 8000을 최종 소스로 재시작했으며 health는 db=true·engine=true, Jev live_verified=false를 기록한다. 이 결과는 로컬이며 dev/prod 배포 기록은 아니다.

최종 검증 수용 결과 로그 또는 증거
API app 전체 1263 passed·1 skipped·1 warning, 18.72s, exit 0 $env:VIGNETTE_CLIENT_AFFECT_PROVIDER = 'legacy'; py -3.11 -m pytest app/ -q; stdout · exit
KB source-pack 실DB·멱등성 401·403·202·200 경계 1 passed·0 failed·0 skipped·0 flaky(21.634s); admin sync 2회 모두 unchanged 7 현재 기본 .env의 별도 API 8014; stdout · 멱등성
Engine gateway 전체 82 passed·1 warning, exit 0 final-checks/20261018T232629Z/
root scripts 49 passed·0 warning, exit 0 final-checks/20261018T232736Z/, -W error::pytest.PytestUnhandledThreadExceptionWarning
Web typecheck/API 동기화/build npm run typecheck exit 0, npm run check:api-types exit 0, build 통과 final-web-contracts/results.json; cosmetic filter safety 160개·191 modules transformed·2.03s
Web final static npm run typecheck, npm run check:api-types, npm run build 모두 exit 0 final-static/summary.json; 191 modules transformed·2.62s
Layout gate 15 passed·0 failed·0 skipped·0 flaky 131.7s, fixed clip 4건·session-layout 10건
Admin affect desktop/mobile 20 passed 320/390/1440 SHA-256 일치
Avatar render mode focused desktop/mobile 6 passed outer와 inner renderer 확인
Dashboard file/HTTP E2E expected 10·unexpected 0·skipped 0·flaky 0, exit 0 최신 stdout · 320/390/1440 geometry
Production lazy-chunk recovery single-run 1 passed·0 skipped·0 failed·0 flaky, exit 0 chunk-preview/chunk-recovery.json, 2.012s; 소유 preview 5196 종료
PNG v2 verify/load passed root가 verify/load 원문을 읽고 수용
Shell·settings mobile geometry 첫 70건 묶음 62 passed, 해당 geometry 통과 mobile/desktop visible role control, settings mobile 3열·44px·clipping 확인
G5 routing·learner CTA·settings 7 mode focused 6 passed root가 원문을 확인하고 수용
SDL desktop prestart sticky focused 1 passed(9.3s), exit 0 main bottom 900, action 810..872 → 788.8125..850.8125, height 62, scrollTop 154; stdout · geometry · PNG
최신 full fixture direct spec 1264건(각 project 632), 1254 passed·0 failed·10 skipped·0 flaky, 779.880s, exit 0 stats · stdout · skip 목록 · exit
returned-practice 전용 실DB same-learner browser 1 passed와 returned desktop/mobile 4 passed, route mock 0 실제 추천·브라우저 회기·SSE·review·G4/G5 0→1→1; public/NAS/active DB 접촉 0, cleanup container·volume·network·listener 0. harness 최신 graph 회귀 4 passed, runner 진단 15 passed, label/query 계약 typecheck 통과. GREEN receipt
이전 full fixture direct spec 1264건(각 project 632), 1251 passed·3 failed·10 skipped·0 flaky, 778.884s, exit 1 stats · stdout · 실패 목록
수정 전 prepared API/DB full fixture 1171 passed·81 failed·10 skipped·0 flaky 08:35:46~08:47:44 KST, 718.239s, db=true, engine=false; stdout · meta · 81건 사실 목록 · 전체 오류

최종 E2E 통합 수치

묶음 범위 결과 경계·증거
A 16 spec, 360건 당시 358 passed·2 failed·0 skipped·0 flaky, exit 1; reporter 194.452s, wall 195.887s 당시 admin-owned runtime controls desktop/mobile의 engine capabilities unavailable 2건은 gateway /ready 200, API db=true·engine=true 뒤 readiness 재검증 4 passed·0 failed·0 skipped(exit 0)로 해소했다. 360건 전체 재실행은 아니다. A stdout · readiness stdout · exit
B1 prestart sticky를 포함한 통합 112 passed·2 failed·2 skipped·0 flaky, 96.349s PII 기대 문구를 익명 내담자에서 현행 익명 인물로 맞춘 1줄 수정은 focused 2 passed(4.083s)로 수용했다.
B2 layout·breakpoint·avatar lab layout 15 passed·0 failed·0 skipped·0 flaky(139.103s), breakpoint 8 passed·0 failed·0 skipped·0 flaky(143.180s), lab 2 passed·0 failed·0 skipped·0 flaky(48.853s) root가 raw와 839px PNG를 직접 검토해 수용했다.
최신 full fixture direct spec 1264건(각 project 632) 1254 passed·0 failed·10 skipped·0 flaky, 779.880s, exit 0 이전 실행의 dashboard overflow desktop/mobile 2건과 avatar desktop 1건은 후속 focused를 거쳐 이번 전체 재실행에서 해소됐다. 최초 admin KPI·avatar 간헐의 근본원인은 과거 관측으로 남아 있으며, 이번 전체 통과로 확정하지 않는다. stats · stdout · skip 목록
returned-practice 전용 실DB same-learner browser 1 passed, returned desktop/mobile 4 passed, route mock 0 same-learner의 실제 추천·브라우저 회기·SSE·review와 G4/G5 각각 0→1→1을 확인했다. public/NAS/active DB 접촉과 cleanup 잔여는 모두 0이다. GREEN receipt

RETENTION-001과 RELEASE-MIGRATIONS 로컬 수용

root의 runtime-final stdout은 exit 0으로 통과했다. 이전 runtime stderr의 PostgreSQL internalchar 문제는 text cast로 고친 실패 기록을 보존한다. 격리 DB 검증은 default raw 90일·rollup 365일, --rollup-days 필수, admin-only exact policy와 RLS enabled guard, dry-run 전체 snapshot 무변경, 90/365 경계·반복 실행·learner 차단·rollback·raw 366일의 신규 rollup expiry를 포함한다.

RELEASE-23·24·25는 transactional required-payload 계약을 수용했다. retention CLI와 release 검증은 38 passed, service focused는 35 passed/1 warning이다. migration 25는 이 격리 proof에만 적용했고 기존 dev/prod에는 적용하지 않았으며 운영 스케줄도 등록하지 않았다.

진행 중 또는 외부 gate

  • C-001 외부 임상 검수는 입력 0건이다. 사례별 검수 30개, 청소년 답변 6개, 승인 10필드, 서명 증거와 review_complete=true가 남는다.
  • AVATAR-V3의 원화, 공개 반영, 운영 화면 소유자 확인은 이 render-mode 수용 범위 밖이며 계속 열린다.
  • RETENTION-001은 운영 migration 25 적용 뒤 dry-run/apply 승인과 실제 운영 증거가 남는다.

E2E-001 현행 경계

문제 최신 증거 남은 조건
최신 full fixture direct spec 1264건(각 project 632)의 결과는 1254 passed·0 failed·10 skipped·0 flaky(779.880s, exit 0)다. 이전 실행의 3 실패는 이번 전체 재실행에서 해소됐다. 최초 admin KPI·avatar 간헐의 근본원인은 과거 관측으로 남아 있으며, 이번 전체 통과로 확정하지 않는다.
skip 구분 최신 full fixture의 10 skipped 중 6건은 desktop/mobile 기능의도 대칭 조건이다. returned-practice DB closed-loop G4/G5 desktop/mobile 4건은 전용 disposable engine/DB/API/Web에서 별도 실행해 통과했다. 10건을 단일 환경 제약으로 뭉뚱그리지 않으며, 기존 dev DB를 재사용하지 않는다. GREEN receipt가 same-learner와 returned 4건을 소유한다.
periodic 정정 이력 3차는 stale competency graph 409로 자연 실패했다. graph 교정 뒤 4차는 same-learner와 별도 fixture를 통과했으나, G5 POST 201 뒤 query가 달린 GET을 predicate가 놓친 원인을 확인해 root가 중단했다. 최종 GREEN receipt만 현행 결론으로 쓴다. harness는 최신 graph를 다시 읽도록 교정해 회귀 4 passed, runner stdout/stderr 진단 회귀 15 passed, periodic h1·CTA 문구 및 returned GET query 계약은 typecheck를 통과했다.
교정 수용 메뉴 8건과 admin 생성 payload 2건은 81 실패 목록에서 사라졌다. uc-practice 훼손 query CTA 2건은 focused 2 passed로 수용했고 multimodal 동의 재연습은 통합 A를 통과했다. 최신 전체 fixture가 1254 passed·0 failed로 같은 결과를 확인했다.
단독 관측 admin 최종 재실행은 6 passed·0 failed·0 skipped·0 flaky(23.360s)다. 최초 mobile KPI 간헐 원인은 확정하지 않았다. KB source-pack은 metadata·RLS 수정 뒤 별도 API 8014 실DB 401·403·202·200 및 멱등 sync를 수용했다. 기본 Jev 설정의 전체 API 재검증과 live_verified는 별도 경계다.
gateway readiness gateway /ready는 200이고 API health는 db=true·engine=true다. Jev live_verified=false는 그대로이며, live 검증이나 외부 gate를 닫지 않는다.
frontend 교정 timer full 32 passed·bbox regression 2 passed·session-layout 10 passed다. 코치 카드는 최신 CSS에서 panelClient=363, scroll=363, coachBottom=407 < panelBottom=553, viewport=640과 geometry·stable PNG로 전체 노출을 수용했다. SDL desktop prestart sticky도 focused stdout 1 passed(9.3s)와 geometry·PNG로 수용했다. dashboard·avatar 이전 3 실패는 후속 focused와 최신 전체 fixture 1254 passed·0 failed에서 해소했다. 이전 after-open JPEG는 nudge 클릭 전 frame이므로 완료 근거로 쓰지 않는다.
역사 baseline API 준비 전 fixture는 1047 passed·195 failed·10 skipped·0 flaky였다. 역사 v2 분류·JSON으로만 보존하며 현행 결과로 쓰지 않는다.

수용 및 경계

root는 ADMIN-AFFECT-V2-MOBILE의 source diff와 320/390 화면을 직접 검토해 수용했다. 이 closeout은 로컬 개발 증거이며 운영 적용, 공개 배포, 원격 push를 포함하지 않는다.

최종 문서 검증은 SSOT checker 통과, Python 3.11 단위 5 passed, dashboard desktop/mobile 10 passed다. 최종 증거의 320/390/1440px 실측에서 document/body 가로 넘침은 0이며, root가 320px 화면도 확인했다. 정체된 추가 캡처 프로세스는 소유 계보를 확인해 종료하고 E2E와 같은 로딩 조건으로 재실행했다.

실DB GREEN은 격리된 detached snapshot 256ffdcd2000f84a969368ec8dd29ec78dddcfa0의 증거다. 원래 작업 브랜치의 HEAD 6e3123091a5225a05e482ccad2b5ac5d3f8c2b87와 G7 증거 이미지 두 파일은 그대로 유지했다.