# 전역 검색 (Global Search) 구현 보고서

보험 지식 공유 플랫폼 인슈위키의 파편화된 지식들을 연결하고 빠르게 찾아내기 위한 **전역 검색 시스템**이 구축되었습니다.

## 🌟 주요 기능
1.  **전역 단축키 지원**: `Cmd + K` (Mac) 또는 `Ctrl + K` (Windows)를 통해 어느 페이지에서든 즉각적으로 검색 모달을 호출할 수 있습니다.
2.  **지능형 검색어 매칭**: 
    - 이전에 구축한 `searchKeywords` (토크나이징된 본문 키워드)를 활용하여, 제목뿐만 아니라 **본문의 핵심 내용**으로도 문서를 찾아냅니다.
    - Firestore의 `array-contains` 쿼리를 사용해 빠른 검색 속도를 확보했습니다.
3.  **Reflect 스타일 UI/UX**:
    - **실시간 반응**: 타이핑 즉시 결과가 노출됩니다 (Debounce 적용).
    - **키보드 네비게이션**: 마우스 없이 방향키(`↑↓`)와 `Enter`키 만으로 문서를 선택하고 이동할 수 있습니다.
    - **콘텐츠 미리보기**: 검색된 문서의 본문 일부를 미리 보여주어 검색 정확도를 높였습니다.

## 🛠 적용된 구성 요소
- [SearchModal.tsx](file:///c:/Users/drumb/.gemini/antigravity/scratch/InsuWiki/nextapp/src/components/SearchModal.tsx): 검색 인터페이스 및 Firestore 연동 로직.
- [layout.tsx](file:///c:/Users/drumb/.gemini/antigravity/scratch/InsuWiki/nextapp/src/app/layout.tsx): 전역 모달 통합.

## 💡 다음 단계
- [ ] 검색어 하이라이팅: 결과 리스트 내 검색어 강조 표시 보강.
- [ ] 검색 성능 최적화: 검색 결과 캐싱 및 정렬 로직 고도화.

---
🤖 Generated with [Claude Code](https://claude.com/claude-code)
