sam-docs/changes/20260319_item_master_field_search.md

품목기준관리 항목 탭 검색 기능 추가

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

변경 개요

서비스 품목기준관리 페이지의 "항목" 탭에 실시간 검색 기능을 추가한다. 항목 수가 많아질수록 원하는 항목을 찾기 어려운 문제를 해결한다.

---

수정된 파일

파일	변경 내용
react/src/components/items/ItemMasterDataManagement/tabs/MasterFieldTab/index.tsx	검색 입력란 및 필터링 로직 추가

---

상세 변경 사항

검색 UI

• 카드 헤더 아래에 돋보기 아이콘이 포함된 검색 입력란 배치
• 검색어 입력 시 X 버튼으로 초기화 가능
• 항목이 1개 이상일 때만 검색란 표시

검색 대상 필드

필드	설명
field_name	항목명
field_type	입력타입 (텍스트, 드롭다운, 체크박스 등 한글 라벨)
category	카테고리
description	설명
id	항목 ID

필터링 방식

• useMemo로 클라이언트 사이드 실시간 필터링
• 대소문자 무시 (.toLowerCase())
• 검색 결과 건수 표시: "N건 검색됨 (전체 M건)"
• 검색 결과 없을 때 안내 메시지 표시

---

테스트 체크리스트

• 항목명으로 검색 시 정상 필터링
• 입력타입(텍스트, 드롭다운 등)으로 검색 시 정상 필터링
• 카테고리로 검색 시 정상 필터링
• ID로 검색 시 정상 필터링
• X 버튼 클릭 시 검색어 초기화 및 전체 목록 복원
• 항목 0건일 때 검색란 미표시

---

관련 문서

• docs/rules/item-policy.md — 품목 정책

---

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