# 🧠 인슈위키 AI 마스터 사양서 (AI Master Specification)

이 문서는 인슈위키의 핵심 엔진인 'AI 인텔리전스 허브'의 비전, 기술적 구현 방안, 그리고 미래 로드맵을 집대성한 최종 명세서입니다.

---

## 1. 🌟 통합 비전 (Unified Vision)
**"상담에서 위키까지, 멈춤 없는 지식 흐름"**
인슈위키 AI는 단순한 도구가 아니라, 보험 전문가의 모든 업무 현장에서 지식을 자동으로 포착하고 정제하며 연결하는 '지능형 파트너'를 지향합니다.

### 🔄 핵심 워크플로우
1.  **경청(Hear)**: 핸드폰을 통해 상담 내용을 실시간으로 듣고 기록 (AI Whispers).
2.  **보조(Assist)**: 상담 중 우리 팀의 검증된 위키 지식만을 즉시 소환 (Internal RAG).
3.  **정제(Refine)**: 상담 종료 즉시 데일리 노트를 생성하고, 핵심 지식을 위키로 변환.
4.  **연결(Connect)**: 파워풀한 내부 검색을 통해 파편화된 지식들을 `[[ ]]` 링크로 초연결.
하여 거대한 지식 창고 구축.

---

## 🚀 2. 100대 활용 시나리오 (Grand Vision)
보험 업무의 전 영역을 혁신하기 위한 10대 카테고리, 100가지 시나리오를 수립했습니다.

| 카테고리 | 대표 시나리오 |
| :--- | :--- |
| **1. 영업상담** | 뉘앙스 파악을 통한 대응 팁 제공, 거절 처리 스크립트 추천 |
| **2. 상품분석** | 면책 조항 즉시 검색, 개정 전후 약관 차이 비교 |
| **3. 사후관리** | 해지 징후 감지 및 청구 서류 자동 안내 |
| **4. 의학/보상** | 질병 코드 자동 변환, 진단 적정성 실시간 검토 |
| **5. 지식공유** | 신입 교육 퀴즈 자동 생성, 퇴사자 지식 승계 |
| **6. 법무/규제** | 금소법 위반 자가 체크, 개인정보 자동 마스킹 |
| **7. 개인생산성** | 음성 할 일 등록, 일정 자동 캘린더 연동 |
| **8. 데이터분석** | 성공 상담 패턴 추출, 주간 영업 리포트 생성 |
| **9. 팀 협업** | 질문별 최적 전문가 매칭, 동료 위키 기여 알림 |
| **10. 미래형** | 나의 AI 분신 대리 응답, 고객 심리 분석 리포트 |

---

## 🏁 프로젝트 관리 및 검증 (Management & Verification)

- **작업 대시보드**: [task.md](file:///C:/Users/drumb/.gemini/antigravity/brain/3672bfab-a08b-4f2d-a259-4c537915d7a0/task.md)
- **실전 시연 시나리오**: [AI 지능형 허브 워크스루](../walkthroughs/260216-0300-ai-intelligence-hub-walkthrough.md)
- **최종 로드맵**: [로드맵](../specs/260216-0300-phased-ai-implementation-roadmap.md)

---

## 🗺️ 3. 4단계 구현 로드맵 (Phased Roadmap)

*   **🟢 Phase 1 (Knowledge Foundation)**: 텍스트 지능 (요약, 자동 백링크) - **[완료]**
*   **🔵 Phase 2 (Zero-Friction)**: 음성 지능 (AI Whispers, 실시간 PII 마스킹) - **[완료]**
*   **🟡 Phase 3 (Proprietary Wisdom)**: 위키 내부 지질형 검색 및 RAG (우리 팀의 지식만을 합성) - **[완료]**
*   **🟣 Phase 4 (Proactive Partner)**: 예측 지능 (실적 예측, 실시간 상담 코칭, AI 에이전트).

---

## 🏗️ 4. 기술 아키텍처 및 보안 (Deep Dive)

### 🧱 핵심 모듈
*   **Gemini 1.5 Pro**: 최신 추론 엔진을 통한 전문적 지식 분석 및 RAG 답변 생성.
*   **Gemini Live & WebRTC**: 저지연 실시간 음성 스트리밍 환경 제공.
*   **Vector DB (Firestore 기반)**: 인슈위키 내부 문서들만을 벡터화(`text-embedding-004`)하여 외부 노이즈 없는 순수 지식 검색 제공.

### 🔐 보안 및 신뢰성 (Trust & Security)
*   **BYOK (Bring Your Own Key)**: 사용자의 개인 API 키를 암호화하여 저장, 서버 비용 0원 및 프라이버시 확보.
*   **PII Masking**: 상담 기록 저장 전 주민번호 등 민감 정보 자동 필터링.
*   **Source Citation**: AI 답변 시 실제 약관 PDF의 해당 페이지 링크를 달아 환각(Hallucination) 방지.

---

### 📂 Internal-Only Strategy
*   **원칙**: 외부 검색 엔진이나 외부 저장소(G-Drive)의 문서를 섞지 않습니다. 오직 사용자가 직접 검토하고 승인한 **'인슈위키 내 지식'**만이 AI의 근거가 됩니다.

### 🔄 Seamless Handover
*   핸드폰으로 음성 기록을 진행하면서, 동시에 PC 화면에서 기록되는 내용을 실시간으로 확인하고 편집할 수 있는 **Firestore Real-time Sync** 아키텍처 적용.

---

## 🚨 6. 예외 상황 대응 (Red Team Analysis)
*   **화자 분리(Diarization)**: 설계사와 고객의 대화 내용을 명확히 구분하여 기록.
*   **하이브리드 오프라인**: 인터넷 단절 시 로컬 기기에 임시 저장 후 복구 시 자동 업로드.
*   **발열 및 배터리**: 모바일 기기는 캡처 위주로, 무거운 추론은 서버에서 처리하여 최적화.

---

> [!IMPORTANT]
> 인슈위키 AI는 **"가장 강력한 지능을 가장 안전하고 편리하게"** 제공하는 것을 원칙으로 합니다. 이 마스터 사양서는 인슈위키가 단순한 메모 앱을 넘어 전설적인 보험 전문가들의 지식 네트워크가 되는 나침반이 될 것입니다.