---
task_id: task-2110
type: plan
scope: task
created: 2026-04-22
updated: 2026-04-22
status: completed
---

# 계획서: task-2110

**task**: task-2110
**목표**: InsuRo 정보성 키워드(인포키워드) 기능 구현 — Worker API 연동 + 관리자 토글 + 접근 불가 안내
**승인**: 헤르메스(팀장) 2026-04-22 "Codex 게이트 리스크 대응 완료 후 구현 진행"
**근거**: task-2110.md + Codex gate review

---

## 목표

1. InfoKeyword.tsx에서 실제 키워드 분석 동작 (Worker API 연동)
2. 관리자에서 infokeyword_access 토글 가능
3. 접근 불가 플랜 → 안내 페이지 + 블러 미리보기 표시
4. `npm run build` 성공

## 범위

### 포함
- InsuRo 백엔드 → InfoKeyword Worker 프록시 연동
- infokeyword_access feature_definitions + plan JSONB 마이그레이션
- InfoKeyword.tsx 분석 UI 완성 (API 호출 + 폴링 + 결과 표시)
- KeywordAnalysis.tsx "정보성 키워드" 탭 → 전용 페이지 안내
- planFeatureMap featureKey 업데이트

### 제외 (다음 페이즈 이후)
- InfoKeyword Worker 자체 개선
- 상위노출 분석 / 메인 노출분석 탭 구현
- 분석 결과 캐싱/히스토리

## 위임 계획

- MT-1 (백엔드 Worker 연동): **불칸** — httpx 프록시 구현
- MT-2 (프론트 분석 UI): **이리스** — API 호출 + 폴링 + 결과 표시
- MT-3 (탭 리다이렉트): **이리스** — KeywordAnalysis.tsx 수정
- MT-4 (feature key 추가): **불칸** — migration + 서버 권한 변경
- MT-5 (planFeatureMap 업데이트): **이리스** — featureKey 변경

## 검증 기준

- 빌드 성공: `npm run build` → 0 errors
- 인포키워드 페이지 로드: `/info-keyword` → FeatureGate 적용
- 백엔드 API: `POST /api/insuro/keywords/analyze` → Worker 호출
- feature key: `infokeyword_access` in PLAN_FEATURE_MAP