V13-FE-006: consolidate approved UI and contract hardening

2026-08-13 02:41:00 +09:00
parent d79edae546
commit 3f293d8aa8
1278 changed files with 14384 additions and 1664 deletions
@@ -0,0 +1,56 @@
+# KBX v23 Validation Report
+
+## 범위
+
+- T01~T09 Screen Template completeness
+- Home / Global Header / Side Navigation / Workspace boundary
+- Menu visibility + Permission + direct URL access boundary
+- Golden Screen component adoption
+- Component manifest/catalog consistency
+- Design Token source/code/Figma parity
+- 기존 API/Integration/Provider/Configuration/Authorization/Telemetry/Deployment governance 회귀
+
+## 최종 정적 Gate
+
+실행:
+
+```text
+node scripts/validate-kbx.mjs
+```
+
+최종 결과:
+
+```text
+Screen definitions          19 PASS
+Navigation entries          15 PASS
+Component definitions       76 PASS
+Core component APIs         34 PASS
+Component catalog entries   49 PASS
+Design tokens               95 PASS
+TypeScript/Vue script units 262 PASS
+API operations              56 PASS
+Permissions                 50 PASS
+T01~T08 Desktop Templates    8 PASS
+T09 WMS Mobile               1 PASS
+Design debt literal count   429 <= baseline 567 PASS
+Release impact              minor / declared minor PASS
+```
+
+`design-debt`는 v22 baseline 567에서 v23 429로 138건 감소했다.
+
+## 주요 변경
+
+1. T01~T08을 공통 `KbxScreenFrame` 기반으로 통합.
+2. T09 `KbxWmsMobilePage`를 Network/Touch/Sticky Action 계약과 함께 completeness Gate에 포함.
+3. `KbxWorkQueuePage`를 `KbxQueuePage` 호환 Wrapper로 축소.
+4. Home을 업무 시작 Navigation Surface로 추가.
+5. Side Navigation의 Home/Collapsed 사용성을 보강.
+6. `menuVisible:false` 화면의 Menu Search/Home/Favorite/Recent 우회 노출을 차단.
+7. 직접 URL Permission UX Guard를 추가.
+8. Design System의 누락 Primitive/Business Component를 보강.
+9. Quick Filter/Summary/Section Header를 공통화하고 Golden Screen에 적용.
+10. 새 UI 수치를 canonical `kbx.tokens.json`에 등록하여 CSS/Figma 계약 재생성 시 보존되도록 처리.
+
+## 런타임 테스트 범위
+
+업로드된 Foundation에는 `node_modules`와 실제 Web/API 실행 환경이 포함되어 있지 않다. 따라서 Vitest/Playwright 브라우저 런타임 실행은 이번 산출물에서 수행하지 않았다. 다만 기존 E2E 계약에 `/home` 진입 시나리오를 추가했고, 저장소가 제공하는 정적 TypeScript/Vue syntax 및 전체 governance gate는 모두 통과했다.