# [Phase 3-1] 전역 검색 (Global Search) 구현 계획

## 목표
- 프로젝트 전체에서 `Cmd + K` (또는 `Ctrl + K`) 단축키로 접근 가능한 강력한 검색 모달 구현.
- 제목(Title) 및 추출된 키워드(searchKeywords)를 활용한 지능형 검색 결과 제공.

## 설계 상세

### 1. UI/UX (Frontend)
- **SearchModal Component**: 전역 오버레이 모달.
    - 입력창: 실시간 디바운스 검색.
    - 결과창: 검색어 하이라이팅 및 문서 바로가기 리스트.
    - 단축키: `Cmd + K` (Mac), `Ctrl + K` (Windows) 전역 리스너.
- **레이아웃 통합**: `layout.tsx` 또는 공통 네비게이션에 모달 배치.

### 2. 검색 로직 (Backend/Data)
- **Firestore 쿼리**:
    - `where('searchKeywords', 'array-contains-any', [searchQuery])` 활용 (최대 10개 키워드).
    - 또는 제목 기반의 `startAt`/`endAt` 접두사 검색.
    - 클라이언트 사이드 필터링: 문서를 일부 미리 로드하거나 캐시하여 즉각적인 반응성 확보.

## 추진 단계
1.  **[MODIFY] [layout.tsx](file:///c:/Users/drumb/.gemini/antigravity/scratch/InsuWiki/nextapp/src/app/layout.tsx)**: 전역 단축키 핸들러 및 모달 상태 관리 추가.
2.  **[NEW] [SearchModal.tsx](file:///c:/Users/drumb/.gemini/antigravity/scratch/InsuWiki/nextapp/src/components/SearchModal.tsx)**: 검색 컴포넌트 개발.
3.  **[VERIFY]**: 검색 결과 정확도 및 단축키 작동 여부 테스트.

---
> [!TIP]
> **검색 성능**: Firestore는 부분 문자열 검색에 한계가 있으므로, 구현한 `searchKeywords` (토큰화된 단축어들)를 적극 활용하여 '단어 단위' 검색의 정확도를 높입니다.