diff --git a/frontend/api-specs/stock-receiving-changes-20260317.md b/frontend/api-specs/stock-receiving-changes-20260317.md index 1ef43e9..373bc0f 100644 --- a/frontend/api-specs/stock-receiving-changes-20260317.md +++ b/frontend/api-specs/stock-receiving-changes-20260317.md @@ -14,6 +14,7 @@ | 1 | 원자재로트번호 자동채번 | 입고등록 | UI 변경 | | 2 | 재고 조정 위치 이동 | 입고관리 → 재고 상세 | UI 이동 + API 연동 | | 3 | 재고 조정 모달 UI 개선 | InventoryAdjustmentDialog | UI 개선 | +| 4 | 입고 품목 검색 개선 | 입고등록 품목검색 모달 | 파라미터 변경 | --- @@ -289,6 +290,52 @@ TO-BE: --- +## 4. 입고 품목 검색 개선 + +### 현재 문제 + +1. **검색 결과 20건 제한**: 품목이 많은 테넌트에서 원하는 품목을 찾기 어려움 +2. **모든 품목 유형 표시**: 가공품, 반제품 등 입고와 무관한 품목도 검색됨 +3. **원자재 입고에 맞지 않는 결과**: 철판, 모터 등 미가공 원자재만 검색되어야 함 + +### 변경 내용 + +`searchItems()` 함수(`ReceivingManagement/actions.ts`)에서 API 호출 파라미터를 변경한다. + +```typescript +// AS-IS (현재) +url: buildApiUrl('/api/v1/items', { search: query, per_page: 50 }), + +// TO-BE (변경) +url: buildApiUrl('/api/v1/items', { + search: query, + per_page: 200, // 검색 제한 완화 (20 → 200) + item_type: 'RM,SM,CS', // 원자재(RM) + 부자재(SM) + 소모품(CS)만 +}), +``` + +### API 파라미터 설명 + +| 파라미터 | 값 | 설명 | +|---------|------|------| +| `per_page` | `200` | 검색 결과 제한 완화 | +| `item_type` | `RM,SM,CS` | 원자재/부자재/소모품만 (콤마 구분 멀티 지원) | + +> API는 `item_type` 콤마 구분 멀티 필터를 이미 지원한다. 추가 백엔드 작업 불필요. + +### 제외되는 품목 유형 + +| item_type | 한글 | 제외 이유 | +|-----------|------|----------| +| `PT` | 부품 | 가공/조립된 형태 | +| `SF` | 반제품 | 중간 가공품 | +| `FG` | 완제품 | 최종 생산품 | +| `BN` | 절곡품 | 절곡 가공품 | + +> 입고(수입검사)는 미가공 원자재(철판, 모터, 볼트 등)만 대상이므로 `RM,SM,CS`로 제한한다. + +--- + ## 작업 체크리스트 ### 입고 목록 (ReceivingList.tsx) @@ -311,6 +358,11 @@ TO-BE: - [ ] + 추가 버튼 → 입력 폼/모달 → `POST /stocks/{stockId}/adjustments` 연동 - [ ] 조정 성공 시 재고량 갱신 (기본 정보 리로드) +### 품목 검색 (actions.ts — searchItems) + +- [ ] `per_page: 50` → `per_page: 200`으로 변경 +- [ ] `item_type: 'RM,SM,CS'` 파라미터 추가 (원자재/부자재/소모품만) + ### 재고 조정 모달 (InventoryAdjustmentDialog.tsx) - [ ] 모달 너비: 풀스크린 또는 `max-width: 95vw`로 확대