Files
KArtSell.Aegis/docs/Design/kbx-foundation-v52-fe-operational-navigation-screen-anatomy/docs/kbx-v36-standard-traceability.md
T
kjh2064 c41e5063b7 chore: remove kbx-foundation-v36 reference (superseded by v4 implementation)
Removed entire kbx-foundation-v36 directory as it's been replaced by
the new KBX Foundation v4 patterns implemented in this session:
- Registry-driven screen definitions
- Density-aware UI adapter components
- Feature module templates (ShadowRun, Models)

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-08-12 01:39:58 +09:00

2.1 KiB

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