114 lines
18 KiB
Markdown
114 lines
18 KiB
Markdown
# 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](https://www.w3.org/TR/CSS22/visufx.html), fixed containing block은 [CSS Positioned Layout Level 3](https://www.w3.org/TR/css-position-3/)를 대조했고, 적용 결론은 hit-test와 회귀 결과로 확인 |
|
|
|
|
### ADMIN-AFFECT-V2-MOBILE 실행 명령과 산출물
|
|
|
|
```powershell
|
|
$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로 검사했다.
|
|
|
|
### 함께 수용한 웹 검증
|
|
|
|
```powershell
|
|
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](../../outputs/backlog-closeout-2026-10-19/final-runtime/health.json)는 `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](../../outputs/backlog-closeout-2026-10-19/kbsync500-rework/app-all-legacy-bytefix-final.stdout.log) · [exit](../../outputs/backlog-closeout-2026-10-19/kbsync500-rework/app-all-legacy-bytefix-final.exitcode.txt) |
|
|
| 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](../../outputs/backlog-closeout-2026-10-19/kb-source-sync-runtime/after-rls-fix/stdout.log) · [멱등성](../../outputs/backlog-closeout-2026-10-19/kb-source-sync-runtime/after-rls-fix/idempotence-correct-api-path.json) |
|
|
| 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](../../outputs/backlog-closeout-2026-10-19/dashboard-closeout-20261019T0943Z/stdout.json) · [320/390/1440 geometry](../../outputs/backlog-closeout-2026-10-19/dashboard-closeout-20261019T0943Z/geometry.json) |
|
|
| 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](../../outputs/backlog-closeout-2026-10-19/sdl-sticky-final/focused.stdout.log) · [geometry](../../outputs/backlog-closeout-2026-10-19/sdl-sticky-final/self-directed-prestart-sticky-geometry-chromium-desktop.json) · [PNG](../../outputs/backlog-closeout-2026-10-19/sdl-sticky-final/self-directed-loop-self-directed-prestart-sticky-chromium-desktop.png) |
|
|
| 최신 full fixture | direct spec 1264건(각 project 632), 1254 passed·0 failed·10 skipped·0 flaky, 779.880s, exit 0 | [stats](../../outputs/backlog-closeout-2026-10-19/final-fixture-current/stats.json) · [stdout](../../outputs/backlog-closeout-2026-10-19/final-fixture-current/run.stdout.log) · [skip 목록](../../outputs/backlog-closeout-2026-10-19/final-fixture-current/skips.json) · [exit](../../outputs/backlog-closeout-2026-10-19/final-fixture-current/exit.json) |
|
|
| 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](../../outputs/backlog-closeout-2026-10-19/periodic-current-verified-receipt.json) |
|
|
| 이전 full fixture | direct spec 1264건(각 project 632), 1251 passed·3 failed·10 skipped·0 flaky, 778.884s, exit 1 | [stats](../../outputs/backlog-closeout-2026-10-19/final-fixture-all/stats.json) · [stdout](../../outputs/backlog-closeout-2026-10-19/final-fixture-all/run.stdout.log) · [실패 목록](../../outputs/backlog-closeout-2026-10-19/final-fixture-all/failures.json) |
|
|
| 수정 전 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](../../outputs/backlog-closeout-2026-10-19/e2e-fixture-prepared.stdout.log) · [meta](../../outputs/backlog-closeout-2026-10-19/e2e-fixture-prepared.meta.txt) · [81건 사실 목록](../../outputs/backlog-closeout-2026-10-19/e2e-fixture-prepared-failure-summary.md) · [전체 오류](../../outputs/backlog-closeout-2026-10-19/e2e-fixture-prepared-failures.json) |
|
|
|
|
### 최종 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](../../outputs/backlog-closeout-2026-10-19/final-integration-a/stdout.log) · [readiness stdout](../../outputs/backlog-closeout-2026-10-19/gateway-runtime/readiness-rerun/readiness-playwright-port.stdout.log) · [exit](../../outputs/backlog-closeout-2026-10-19/gateway-runtime/readiness-rerun/exit.json) |
|
|
| 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](../../outputs/backlog-closeout-2026-10-19/final-fixture-current/stats.json) · [stdout](../../outputs/backlog-closeout-2026-10-19/final-fixture-current/run.stdout.log) · [skip 목록](../../outputs/backlog-closeout-2026-10-19/final-fixture-current/skips.json) |
|
|
| 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](../../outputs/backlog-closeout-2026-10-19/periodic-current-verified-receipt.json) |
|
|
|
|
### 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](../../outputs/backlog-closeout-2026-10-19/periodic-current-verified-receipt.json)가 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](../../outputs/backlog-closeout-2026-10-19/session-timer-mobile-overlap/20261019T001000Z/coach-geometry-current-css/coach-geometry.json)·[stable PNG](../../outputs/backlog-closeout-2026-10-19/session-timer-mobile-overlap/20261019T001000Z/coach-geometry-current-css/full-sweep-session-full-sw-436e9-ing-immediately-when-opened-chromium-desktop/coach-1366x640-stable.png)로 전체 노출을 수용했다. SDL desktop prestart sticky도 [focused stdout](../../outputs/backlog-closeout-2026-10-19/sdl-sticky-final/focused.stdout.log) 1 passed(9.3s)와 [geometry](../../outputs/backlog-closeout-2026-10-19/sdl-sticky-final/self-directed-prestart-sticky-geometry-chromium-desktop.json)·[PNG](../../outputs/backlog-closeout-2026-10-19/sdl-sticky-final/self-directed-loop-self-directed-prestart-sticky-chromium-desktop.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 분류](../../outputs/backlog-closeout-2026-10-19/e2e-failure-families-v2.md)·[JSON](../../outputs/backlog-closeout-2026-10-19/e2e-failure-families-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다. [최종 증거](../../outputs/backlog-closeout-2026-10-19/final-verified-docs/)의 320/390/1440px 실측에서 document/body 가로 넘침은 0이며, root가 320px 화면도 확인했다. 정체된 추가 캡처 프로세스는 소유 계보를 확인해 종료하고 E2E와 같은 로딩 조건으로 재실행했다.
|
|
|
|
실DB GREEN은 격리된 detached snapshot `256ffdcd2000f84a969368ec8dd29ec78dddcfa0`의 증거다. 원래 작업 브랜치의 HEAD `6e3123091a5225a05e482ccad2b5ac5d3f8c2b87`와 G7 증거 이미지 두 파일은 그대로 유지했다.
|