docs: [frontend] 입고 품목검색 개선 요청 추가

- per_page 200으로 확대 (20건 제한 해소)
- item_type: RM,SM,CS 필터 추가 (원자재/부자재/소모품만)
- 가공품/반제품/완제품 제외
This commit is contained in:
김보곤
2026-03-17 21:47:14 +09:00
parent a3f6b04a70
commit 137d5be2ad

View File

@@ -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`로 확대