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

31 lines
1.4 KiB
Markdown

# 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은 그 결과를 반영해야 한다.