Files
KArtSell.Aegis/docs/Design/kbx-foundation-v60-status-canonical-contract-hardening/docs/erp-reference-screens-v4.md
T
kjh2064 3f293d8aa8
deploy / deploy (push) Successful in 1m52s
deploy / notify (push) Successful in 1s
V13-FE-006: consolidate approved UI and contract hardening
2026-08-13 02:41:00 +09:00

1.4 KiB

ERP Reference Screens v4

ERP-MST-ITEM-001 품목관리

KbxMasterPage를 검증하는 기준정보 Golden Reference다.

왼쪽은 검색 가능한 품목 목록, 오른쪽은 현재 품목의 상세정보다. 신규/복사/사용중지 같은 익숙한 ERP 동작을 유지한다.

특히 삭제보다 사용중지를 기본 업무 문법으로 둔다. 이미 주문·입출고 이력이 있는 Master를 물리 삭제하는 UX는 기준 패턴으로 채택하지 않는다.

품목 복사 시 ID, 품목코드, Barcode, Version과 같은 Identity/고유속성은 복사하지 않는 것이 원칙이다.

ERP-INV-001 재고현황

KbxMasterDetailPage 기준 화면이다.

왼쪽은 품목별 요약 재고, 오른쪽은 창고·로케이션별 상세 재고를 보여준다. 사용자가 별도 창고 화면을 반복적으로 열어 현재고의 근거를 찾지 않게 한다.

Read Model은 UI가 필요한 형태로 서버에서 Projection한다. Frontend가 품목/창고/재고 API를 따로 호출해서 Join하지 않는다.

재고 수량 의미

  • 현재고(On Hand)
  • 할당(Allocated)
  • 보류(Hold)
  • 가용(Available)

를 각각 분리한다. 재고라는 숫자 하나로 모든 의미를 표현하지 않는다.

실제 제품에서는 Available 계산 Rule을 Domain/Inventory 정책에서 단일화하고 Projection은 그 결과를 반영해야 한다.