# KBX v36 Standard Traceability

## Business UX/AX Standard

| 표준 요구 | v36 구현 |
|---|---|
| T01~T09 표준 화면 유형 | `kbx.screen-recipes.json` + explicit `templateCode` 유지 |
| Predictable Layout | Template/Recipe/Scaffold Surface 결합 유지 |
| Exception Driven | T06 Canonical E2E `queue-recovery` 추가 |
| Explicit State | Recipe `requiredChecks`로 idle/recovery/conflict/job/network 검증 의도 고정 |
| Keyboard | T02/T03/T04/T09 Recipe 검증 범위에 keyboard/scan interaction 포함 |
| Audit by Default | T02/T03/T06 Recipe Tag/Evidence에서 Audit/DB 증적 추적 |
| Error Recovery | 모든 Recipe에 `recoveryPolicies` + `testProfile.requiredChecks` |

## Design System Standard

| 표준 요구 | v36 구현 |
|---|---|
| Template이 UX를 책임 | Recipe 검증이 Template별 필수 상호작용을 정의 |
| Component Contract Test | Recipe Verification + 기존 Component Catalog/Vitest 유지 |
| Playwright Screen Test | 모든 T01~T09가 representative Canonical E2E를 요구 |
| 기술부채 Ratchet | 131 유지 |
| Component Versioning | `KbxHomePage` 1.7.0 |

## Reference Screens

| Reference 성격 | v36 연결 |
|---|---|
| OMS 주문 조회/등록 | T01/T03 Canonical Scenario 유지 |
| ERP 품목관리 | T02 E2E recovery Scenario 추가 |
| ERP 재고 Master/Detail | T05 Context Scenario 유지 |
| WMS Queue | T06 E2E Queue Recovery 추가 |
| Excel Import | T08 Mapping/Staging/Partial Job Evidence 강화 |
| Reconcile | T07 Mismatch Recovery E2E 추가 |
| WMS Picking | T09 Scanner/Network/Idempotency E2E 유지 |

## Implementation Contract

| 구현 계약 | v36 구현 |
|---|---|
| Screen Definition 명시성 | `type + templateCode` 유지 |
| Scaffolder 표준화 | Recipe 기반 실제 KBX Component 조합 + typed test plan |
| Permission Fail-Closed | Mutating type은 `--write-permission` 필수 유지 |
| Server Truth | Test Plan도 Client business truth를 추가하지 않음 |
| Test/Governance | Scenario Contract + Recipe Verification Manifest + v36 Gate |
| Home Navigation | 권한필터 + 안전한 route resolution + newest-first attention queue |
