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

**날짜:** 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