# 260215-17.30-project-spec-gap-analysis

> **일시**: 2026-02-15 17:30
> **참석자**: PM, Backend, Frontend, QA, Legal, UX Expert Agents
> **안건**: `PROJECT_SPEC.md` 기획안 대비 현재 구현 상태 점검 및 미구현 기능 식별

---

## 1. 개요
프로젝트 초기 기획서(`PROJECT_SPEC.md`)의 20개 섹션을 기준으로 현재 코드베이스를 전수 조사한 결과, 핵심 기능(Phase 1~3 수준)은 안정적으로 구현되었으나 고도화 기능 및 품질 관리 자동화 영역에서 공백이 확인되었습니다.

## 2. 전문가별 분석 결과

### 🔑 [PM/Planner] 전체 로드맵 점검
*   **완료**: Phase 1(로그인), Phase 2(에디터), Phase 3(위키 코어) 수준의 핵심 기능 완료.
*   **미구현**: 
    *   **Phase 4 (고도화)**: BYOK 기반 AI 기능 연동이 아직 프롬프트 레벨에 머물러 있으며, 실제 서비스 기능(요약, 에이전트 협업 UI)으로 노출되지 않음.
    *   **Phase 5 (플러그인)**: "Core + Plugins" 형태의 모듈화 아키텍처가 아직 미비함.

### 💻 [Backend/Data] 데이터 및 인증
*   **완료**: Firebase Auth, Firestore 스키마, Google Drive API (OAuth2) 연동.
*   **미구현**: 
    *   **White-list 시스템**: 특정 도메인 자동 승인 기능이 기획에는 있으니 현재는 수동 승인 위주.
    *   **Payment Module**: 기획상의 결제 모듈화 구조 설계 미착수.

### 🎨 [Frontend/UX] UI 및 사용자 경험
*   **완료**: Tiptap 기반 에디터, 목차(TOC) 사이드바, 카카오 공유.
*   **미구현**: 
    *   **사용자 온보딩**: 첫 방문 시 튜토리얼 모달, 마크다운 치트시트 도움말 모달 부재.
    *   **그래프 뷰 (Visualization)**: 문서 간 연결 상태를 시각화하는 지식 그래프 뷰 미구현.

### 🛡️ [QA/Legal] 품질 및 법적 준수
*   **완료**: 기본 에러 핸들링 및 로깅 강화.
*   **미구현**: 
    *   **CI/CD 자동화**: `.github/workflows`를 통한 자동 테스트 및 빌드 파이프라인 부재.
    *   **법적 문서**: 개인정보 처리방침, 서비스 이용약관, 면책조항(Disclaimer) 페이지 부재 (기획 섹션 13).

---

## 3. 우선순위 기반 향후 과제
1.  **[High] CI/CD 구축**: 코드 품질 일관성을 위해 GitHub Actions 연동 필수.
2.  **[High] 사용자 온보딩**: 신규 사용자 진입 장벽 완화를 위한 튜토리얼 및 치트시트 추가.
3.  **[Medium] AI 기능 실체화 (BYOK)**: 에디터 내 AI 도구 툴바 구현.
4.  **[Medium] 법적 문서 페이지 생성**: 런칭 준비를 위한 약관 페이지 추가.

## 4. 결론
현재 인슈위키는 **MVP(최소 기능 제품) 이상의 안정성**을 확보했으나, **'완성된 서비스'**로 가기 위한 마무리(온보딩, 자동화, 법률) 단계가 필요함. 다음 스프린트에서 CI/CD와 온보딩 기능을 우선적으로 다룰 것을 제안함.