# KBX v34 Standard Traceability

## 목적

v34 구현을 KBX Business UX/AX Standard, Design System, Reference Screens, Implementation Contract의 요구사항과 연결한다.

| Standard intent | v34 implementation | Verification |
|---|---|---|
| T01~T09 표준 Template 중심 | `kbxTemplateManifest.coreComponents` 폐쇄성 검사 | v34 validator |
| Component 상태 독립 재현 | 20개 Template core component 모두 Manifest + Catalog Scenario 보유 | v34 validator |
| Lookup F2/Enter/Esc/Focus | Lookup async guard, explicit error/empty, paging, keyboard, focus restore | unit/static gate |
| Primitive → Business Component 계층 | LookupDialog, ExceptionDrawer가 KbxDialog/KbxDrawer/KbxButton 사용 | v34 validator |
| Excel Import 공통 UX | file preflight, 1:1 mapping, required mapping, session isolation, commit confirm, partial/failure states | import guard tests + v34 gate |
| Excel 직접 DB insert 금지 | Client guard는 UX 전용이며 staging/server validation 계약 유지 | architecture contract |
| Permission UX | Exception/AI가 Permission Host 자동 소비 | v34 validator |
| Backend permission final enforcement | UI Permission은 defense-in-depth로 제한 | authorization gate |
| AI Structured Proposal | proposal validation state + permission guard | v34 validator |
| AI hallucination 방어 | Apply 전에 validated state 요구 가능, Domain validation 최종 책임 유지 | contract/static gate |
| WMS scanner duplicate UX | bounded buffer + short duplicate debounce + camera/manual/wedge source | barcode guard tests |
| WMS idempotency | Client debounce가 server idempotency를 대체하지 않음 | architecture/integration contract |
| Home actionable navigation | pinned/open 분리, invalid module filter recovery, aria-live result count | v34 validator |
| Navigation security | v31~v33 path normalization, encoded traversal/control/length rules 유지 | historical gates |
| 기술부채 ratchet | hard-coded design literal 131 baseline | design-debt gate |
| 재현성/Versioning | Foundation 34 / Contract 1.20.0 / release mode 기록 | release governance |

## Core Component Closure

v34에서 Template core component 집합은 20개이며 모두 다음 세 계층에 존재해야 한다.

```text
Template coreComponents
  ∩ Component Manifest
  ∩ Component Catalog
```

누락은 CI validation failure로 취급한다.

## 보안 경계

Frontend 보강:

- stale async lookup result 차단
- oversized barcode buffer 차단
- import mapping 중복/누락 preflight
- permissioned exception/AI action guard
- navigation/preference 입력 sanitization 유지

Backend 최종 책임:

- permission
- entity existence
- business rule
- concurrency
- database constraint
- import staging/commit
- idempotency
- AI structured proposal revalidation

## 과유불급 원칙

v34는 자체 Grid/DatePicker/Low-code runtime builder를 만들지 않는다. 기존 PrimeVue/AG Grid 기반 KBX 계층을 강화하며, 업무 화면별 특수 Rule은 Vertical Slice와 Domain에 남긴다.
