# 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는 모두 통과했다.
