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

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 이중화 회귀

2.5 KiB Raw Blame History