# task-2114: InsuRo AI 키워드 분석 — 3문서 vs 실제 구현 갭 분석

## ★ 코드 수정 아님. 분석/보고서 작업만 수행.
## ★ 프로젝트: `/home/jay/projects/InsuRo/`

## 목적
AI 마케팅 → AI 키워드 분석 기능의 인슈로 3문서(plan.md, context-notes.md, checklist.md)에 정의된 설계/요구사항과 실제 구현 코드 간 차이를 상세하고 심층적/체계적으로 분석.

## 분석 범위

### 1. 3문서에서 AI 키워드 분석 관련 내용 전수 추출
- plan.md: 키워드 분석 관련 목표, 범위, 기능 정의
- checklist.md: 키워드 관련 체크 항목 (DA-*, BUX-20~22 등)
- context-notes.md: 키워드 관련 결정 사항, 설계 근거

### 2. 실제 구현 코드 전수 분석
- `src/pages/KeywordAnalysis.tsx` — 5탭 구조, 각 탭별 기능 동작 여부
- `src/pages/InfoKeyword.tsx` — 인포키워드 기능
- `server/main.py` — 네이버 검색량, 구글 트렌드, 인포키워드 API 엔드포인트
- `src/config/api.ts` — API 기본 URL
- `src/config/planFeatureMap.ts` — 기능 접근 제어
- `src/pages/AdminSubscriptions.tsx` — 관리자 접근 토글

### 3. 각 서브탭별 갭 분석

#### 탭 1: 검색량 조회 (네이버)
- 3문서 설계: 어떻게 정의되어 있나?
- 실제 구현: search_type="keyword", SearchAd API 연동 (task-2101)
- 동작 여부: 실제로 작동하는지 (API 키, 엔드포인트 연결 상태)
- 갭: 설계 대비 누락/초과 구현 항목

#### 탭 2: 구글 트렌드
- 3문서 설계 vs 실제 구현 (pytrends, task-2107)
- 동작 여부

#### 탭 3: 정보성 키워드 (인포키워드)
- 3문서 설계 vs 실제 구현 (task-2110)
- InfoKeyword Worker API 연동 상태
- 관리자 토글 존재 여부 (task-2113 진행 중)
- /info-keyword 별도 페이지 vs 탭 인라인 (task-2112 진행 중)

#### 탭 4: 상위노출 분석
- 3문서에 정의된 기능 vs 실제 구현 상태
- 동작하는 기능인지, 스텁인지

#### 탭 5: 메인 노출분석
- 3문서에 정의된 기능 vs 실제 구현 상태
- 동작하는 기능인지, 스텁인지

### 4. 출력 형식

각 탭/기능에 대해:
```
[기능명] (3문서 참조 위치)
- 3문서 설계: [설계 내용 요약]
- 실제 구현: [코드 위치 + 구현 내용 요약]
- 동작 여부: ✅ 정상 / ⚠️ 부분 동작 / ❌ 미동작 / 🚫 미구현
- 갭 상세: [구체적 차이점]
- 우선순위: critical / high / medium / low
```

## ★ 먼저 읽을 파일
- `/home/jay/workspace/memory/plans/insuro-system/plan.md` — AI 키워드 분석 섹션
- `/home/jay/workspace/memory/plans/insuro-system/checklist.md` — DA-*, BUX-20~22 항목
- `/home/jay/workspace/memory/plans/insuro-system/context-notes.md` — 키워드 관련 결정
- `/home/jay/projects/InsuRo/src/pages/KeywordAnalysis.tsx`
- `/home/jay/projects/InsuRo/src/pages/InfoKeyword.tsx`
- `/home/jay/projects/InsuRo/server/main.py` — 키워드 관련 엔드포인트

## 완료 시그니처
- 5탭 전체 갭 분석 완료
- 각 탭별 동작 여부 명확
- 우선순위 분류된 갭 목록
- 보고서: `memory/reports/task-2114.md`

## 레벨
- critical

## 프로젝트
- insuro