From a8498783678956fd53386a49492983b8c7835671 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B9=80=EB=B3=B4=EA=B3=A4?= Date: Thu, 19 Mar 2026 08:04:19 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20[item-master]=20=ED=95=AD=EB=AA=A9=20?= =?UTF-8?q?=ED=83=AD=20=EA=B2=80=EC=83=89=20=EA=B8=B0=EB=8A=A5=20=EB=B3=80?= =?UTF-8?q?=EA=B2=BD=EC=9D=B4=EB=A0=A5=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- INDEX.md | 1 + changes/20260319_item_master_field_search.md | 65 ++++++++++++++++++++ 2 files changed, 66 insertions(+) create mode 100644 changes/20260319_item_master_field_search.md diff --git a/INDEX.md b/INDEX.md index c673b5e..5e28eb2 100644 --- a/INDEX.md +++ b/INDEX.md @@ -268,6 +268,7 @@ DB 도메인별: | [20260318_api_response_extra_fields.md](changes/20260318_api_response_extra_fields.md) | ApiResponse 에러 신호 배열 추가 필드 전달 (expected_code 등) | | [20260318_stock_production_item_add_removal.md](changes/20260318_stock_production_item_add_removal.md) | 재고생산 수정 화면 레이아웃 통일 (등록과 동일 BendingLotForm 사용) | | [20260318_rm_spec_field_restructure.md](changes/20260318_rm_spec_field_restructure.md) | 원자재(RM) 규격 필드 구조 개선 (라벨 분리, 섹션 그룹핑, 테스트 데이터 정리) | +| [20260319_item_master_field_search.md](changes/20260319_item_master_field_search.md) | 서비스 품목기준관리 항목 탭 검색 기능 추가 | --- diff --git a/changes/20260319_item_master_field_search.md b/changes/20260319_item_master_field_search.md new file mode 100644 index 0000000..654af89 --- /dev/null +++ b/changes/20260319_item_master_field_search.md @@ -0,0 +1,65 @@ +# 품목기준관리 항목 탭 검색 기능 추가 + +**날짜:** 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