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