sam-docs/dev/changes/20260318_receiving_item_search_fix.md

입고등록 품목 검색 필터/페이징 수정

날짜: 2026-03-18 작업자: Claude Code

---

변경 개요

입고등록 화면의 품목 검색에서 전체 품목이 표시되고 20건 제한이 풀리지 않는 문제를 수정했다.

근본 원인

React와 API 간 파라미터 이름 불일치:

문제	React 전송	API 수신	결과
페이징	per_page=50	size (기본 20)	per_page 무시 → 20건
품목유형	itemType (camelCase)	type / item_type	itemType 무시 → 전체 품목

---

수정된 파일

프로젝트	파일	변경 내용
API	app/Http/Controllers/Api/V1/ItemsController.php	per_page, itemType 파라미터 수용 추가
React	src/components/material/ReceivingManagement/ReceivingDetail.tsx	ItemSearchModal에 itemType="RM,SM,CS" prop 추가

---

상세 변경 사항

1. API — ItemsController::index()

// AS-IS
'size' => $request->input('size', 20),
'item_type' => $request->input('type') ?? $request->input('item_type'),

// TO-BE
'size' => $request->input('size') ?? $request->input('per_page', 20),
'item_type' => $request->input('type') ?? $request->input('item_type') ?? $request->input('itemType'),

• per_page 파라미터도 size로 매핑 (React 호환)
• itemType (camelCase) 파라미터도 item_type으로 매핑

2. React — ReceivingDetail.tsx

<ItemSearchModal
  ...
  itemType="RM,SM,CS"  // 원자재(RM) + 부자재(SM) + 소모품(CS)만
/>

• 입고 대상인 원자재 성격의 품목만 검색되도록 필터 적용
• FG(완제품), PT(부품), SF(반제품), BN(절곡품) 제외

---

영향 범위

• GET /api/v1/items 엔드포인트: 기존 size/type/item_type 파라미터 동작 변경 없음 (하위호환)
• per_page, itemType 파라미터가 추가로 수용됨 (React fetchItems() 호환)

---

관련 문서

• stock-receiving-changes-20260317.md — 섹션 4 체크리스트 업데이트

---

최종 업데이트: 2026-03-18