V13-FE-006: consolidate approved UI and contract hardening

2026-08-13 02:41:00 +09:00
parent d79edae546
commit 3f293d8aa8
1278 changed files with 14384 additions and 1664 deletions
@@ -0,0 +1,29 @@
+
+# KBX v8 — Process Coverage Pack
+
+v8의 목적은 KBX가 주문 조회/등록 한 종류에만 최적화된 UI kit인지, 실제 OMS·WMS·ERP 업무 흐름에도 재사용되는지를 검증하는 것이다.
+
+## 추가 Reference Screen
+
+| Screen | 유형 | 검증 목적 |
+|---|---|---|
+| OMS-CLM-001 반품·클레임 관리 | List + Workflow | 주문 이후 역방향 프로세스, 상태전이, 대량처리 |
+| ERP-PUR-001 구매등록 | Transaction | 구매 Header/Detail, 거래처/창고/품목 Lookup |
+| ERP-INV-MOVE-001 재고이동 | Transaction | 창고 간 이동과 상태 기반 수정제한 |
+| WMS-REC-001 입고 검수 | Mobile | 입고예정→상품 스캔→수량검수 |
+| WMS-PUT-001 입고 적치 | Mobile | 상품→추천 로케이션→위치검증 |
+| WMS-COUNT-001 재고실사 | Mobile | 위치→상품→실사수량→차이 예외 |
+
+## Workflow 원칙
+
+UI는 `KbxWorkflowDefinition`을 통해 상태와 허용 Action을 표현한다. Domain은 별도의 Server Workflow Guard/Domain Rule로 다시 검증한다.
+
+`UI에서 버튼이 안 보임`은 업무규칙이나 권한의 최종 방어선이 아니다.
+
+## 현장성 핵심
+
+- 입고: 예정과 실물을 비교하고 차이를 자동 확정하지 않는다.
+- 적치: 추천 위치와 다른 로케이션을 정상처리로 받아들이지 않는다.
+- 실사: 실사 차이가 발생했다고 현장에서 장부수량을 덮어쓰지 않는다. Exception/Reconcile 흐름으로 보낸다.
+- 재고이동: ERP 등록과 WMS 실행을 분리하며 `확정→이동중→입고완료` 상태를 명시한다.
+- 반품/클레임: 원 주문의 정방향 상태를 삭제·되감기보다 별도의 역방향 프로세스로 이력화한다.