# 📊 InsuWiki 프로젝트 상태 대시보드

> **마지막 업데이트**: 2026-02-17 16:41
> **현재 단계**: ✅ P1 AI 음성 트리거 (6개) + 상담 녹음 (데일리 노트 연동) 완료 — 배포 진행 중

---

## 📈 진행 현황 (Overall Progress)

```mermaid
pie title Project Completion
    "작업 완료" : 100
    "진행 중" : 0
    "대기 중" : 0
```

## 🚥 시스템 상태 (System Health)

| 구분 | 상태 | 비고 |
| :--- | :---: | :--- |
| **Auth (Firebase)** | 🟢 | 정상 작동 (Google/Kakao) |
| **Storage (G-Drive)** | 🟢 | 정상 작동 (OAuth2 적용 완료) |
| **Database (Firestore)** | 🟢 | **Soft Delete & Restore 적용 완료** |
| **Backup (GCS)** | 🟢 | **Cloud Functions (04:00 KST) 자동 백업** |
| **Deployment (Vercel)** | 🟢 | 정상 작동 (master 자동 배포) |
| **음성 인식 (Web Speech API)** | 🟢 | Android Chrome / iOS Safari 14.5+ / PC Chrome·Edge |
| **상담 녹음 (MediaRecorder)** | 🟢 | 데일리 노트 전용, 구글드라이브 자동 업로드 |

---

## 🛠️ 최근 완료된 작업 (Recent Achievements)
- [x] **[FEAT]** Soft Delete & Restore 구현 (휴지통 배너, 복원 버튼)
- [x] **[FEAT]** 문서 검색/목록에서 삭제된 문서 필터링 적용
- [x] **[FEAT]** Admin Purge API (영구 삭제 기능)
- [x] **[FEAT]** DB 자동 백업 (Cloud Functions -> GCS)
- [x] **[FEAT]** Wiki Revision History & Restore 구현 (Squash 전략 적용)
- [x] **[FIX]** 개인 공간(My Private Space) 문서의 작성자 삭제 권한 허용
- [x] **[FEAT]** AI 문서 어시스턴트 MVP (요약, 구조화, BYOK)
- [x] **[FEAT]** AI Phase 1: 실시간 WikiMap & 자동 백링크 (Zero-Friction)
- [x] **[DOC]** 인슈위키 AI 마스터 사양서 (INSUWIKI-AI-MASTER-SPEC.md) 집대성
- [x] **[FEAT]** AI Phase 2: AI Whispers (실시간 음성 기록 및 분석)
- [x] **[FEAT]** AI Phase 3: Semantic Hub & RAG (지능형 검색, Internal-Only RAG)
- [x] **[UX]** 검색 UI/UX Phase 1: 설계사 맞춤 문구, AI 면책 조항, 로딩/에러 UX, 접근성(a11y)
- [x] **[REFACTOR]** 검색 UI/UX Phase 2: SearchModal 6개 컴포넌트 분리 + 디바운싱/추천 질문/마크다운 렌더링/모바일 출처 1열
- [x] **[FEAT]** 🎙️ 음성 인식 실제 구현 (Web Speech API 2-layer 아키텍처)
  - `useSpeechRecognition.ts` — 코어 STT 훅
  - `SearchInput.tsx` — 음성 검색 마이크 버튼
  - `VoiceDictation.tsx` — 플로팅 받아쓰기 FAB
  - `useVoiceCommand.ts` — 음성 명령 ("새 문서", "검색해줘", "저장")
  - `useVoiceRecorder.ts` — Mock → 실제 Web Speech API 연동
- [x] **[FEAT]** 📱 음성 인식 모바일 통합
  - `VoiceDictation` → `DocumentClient.tsx` 편집 모드 연결
  - `VoiceCommandProvider` → `layout.tsx` 전역 등록
  - 모바일 최적화: 56px 터치 타겟, safe-area, 전체 너비 패널
- [x] **[FEAT]** 🎙️ P0 음성 명령 확장 (3→25) + 동의 녹취 워크플로우
  - `useVoiceCommand.ts` — 5그룹 25개 명령 (내비/검색/에디터/문서/녹음)
  - `VoiceCommandContext.tsx` — 페이지별 명령 핸들러 등록 Context
  - `RecordingConsentModal.tsx` — 통신비밀보호법 준수 동의 녹취 모달
  - `DocumentClient.tsx` — 16개 에디터/문서/녹음 명령 콜백 연결
- [x] **[FEAT]** 🤖 P1 AI 음성 트리거 (25→31개 명령)
  - `useVoiceCommand.ts` — AI 그룹 6개 명령 추가 ("요약해줘", "정리해줘", "핵심 뽑아줘", "비교해줘", "개인정보 가려", "코칭해줘")
  - `AISidepanel.tsx` — 6 프리셋 + autoAction 음성 자동 실행
  - `route.ts` — compare/mask/coach promptType 추가
  - 커밋 `da4f121` (6 files, +522/-13)
- [x] **[FEAT]** 🎙️ 상담 녹음 기능 (데일리 노트 연동)
  - `useAudioRecorder.ts` — MediaRecorder API hook (pause/resume, 64kbps WebM/Opus, 2h+)
  - `AudioRecorderButton.tsx` — FAB 녹음 버튼 (idle/recording/paused/uploading)
  - `DocumentClient.tsx` — 녹음→구글드라이브→데일리 노트 자동 삽입
  - 데일리 노트에 `🎙️ 14:00 (1시간 47분) [📥 다운로드](링크)` 자동 삽입
  - API 비용 $0, 커밋 `9303b44` (3 files, +425)

## 🚧 진행 중인 작업 (In Progress)
- [ ] 문서 내보내기 (Export) - Phase 3 계획 수립 필요
- [ ] 주간 보고서 자동 생성 기능 도입

## 📅 향후 계획 (Upcoming)
- [ ] 서버사이드 STT (Whisper/Gemini Audio) — 장시간 녹음 자동 텍스트 변환
- [ ] 검색 UI/UX Phase 3: 하이브리드 검색, 자동완성, 대화형 AI 등
- [ ] 사용자 권한 상세 설정 UI 개선
- [ ] Phase 4: 예측 코칭 & 자동 리포트