Files
sam-docs/changes/20260319_item_master_field_search.md

66 lines
1.7 KiB
Markdown

# 품목기준관리 항목 탭 검색 기능 추가
**날짜:** 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