# KBX v23 Screen Template Completeness

## 목적

v22까지는 Screen Type과 컴포넌트 이름은 존재했지만 일부 Template이 slot container 수준에 머물러 있었다. v23은 T01~T08 Desktop Template의 공통 골격을 `KbxScreenFrame`으로 고정하여, 화면 개발자가 Template을 선택하는 순간 Page Header, Command 위치, Breadcrumb/상태, Sticky Command, 본문 간격이 기본 완성되도록 한다.

## 공통 Frame

```text
KbxScreenFrame
 ├ Page Header
 │  ├ Breadcrumb
 │  ├ Screen Title / Description
 │  ├ Transaction Status / Dirty
 │  └ Utility
 ├ Command Bar (sticky)
 ├ Notice
 └ Template-specific workspace
```

`KbxScreenFrame`은 내부 조립 컴포넌트이며 Vertical Slice가 직접 사용하기보다 T01~T08 Template을 통해 소비한다.

## Template별 고정 구조

- T01 `KbxListPage`: Search → Quick Filter → Contextual Bulk → Grid → Summary → Detail Drawer
- T02 `KbxMasterPage`: Master List → Detail Form → Footer/Audit
- T03 `KbxTransactionPage`: Validation → Header Form → Detail Grid → Workflow → Sticky Summary → Audit
- T04 `KbxFastEntryPage`: Compact command → Fast Grid → Validation → Summary
- T05 `KbxMasterDetailPage`: Search → Master/Detail Workspace → Bottom Evidence/History → Summary
- T06 `KbxQueuePage`: Search → Work Summary → Exceptions → Contextual Action → Queue → Detail
- T07 `KbxReconcilePage`: Criteria → Reconcile Summary → Filters → Comparison Grid → Resolution Footer
- T08 `KbxImportPage`: Import Header/Command → Step Navigation → Import Workspace → Footer
- T09 `KbxWmsMobilePage`: Network 상태 → 작업 진행 → Scanner/Touch Workspace → Sticky Action, Touch Token 및 자동 Gate 포함

## 중복 제거

`KbxWorkQueuePage`는 v23부터 새 Template이 아니라 `KbxQueuePage`의 호환 Wrapper다. 신규 화면은 `KbxQueuePage`를 직접 사용한다.

## 보조 컴포넌트 보강

v23 신규 공개 API:

- Primitive: `KbxCheckbox`, `KbxRadio`, `KbxTextarea`, `KbxTabs`, `KbxBadge`, `KbxTooltip`
- Business: `KbxBarcodeField`, `KbxSectionHeader`, `KbxQuickFilterBar`, `KbxSummaryBar`

Golden Screen에서 raw HTML 입력/버튼을 조립하지 않고 위 API를 소비하도록 전환한다.

## 자동 검증

`validate-template-completeness.mjs`가 다음을 CI에서 차단한다.

- T01~T08이 `KbxScreenFrame`을 우회
- Home/권한 거부 Shell 누락
- 핵심 신규 Component Public API 누락
- Golden Screen의 raw button/input/select 회귀
- Queue Template 이중화 회귀
