47 lines
2.1 KiB
Markdown
47 lines
2.1 KiB
Markdown
# 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 |
|