---
status: completed
task_id: task-2298
title: "InsuRo × 인포키워드 Phase 2: 프론트엔드 UI + 플랜별 차등"
type: plan
scope: "server/main.py, src/pages/InfoKeyword.tsx"
level: 3
created_at: 2026-04-29
---

# Phase 2 구현 계획

## 목표
InsuRo 정보성키워드 페이지를 인포키워드 연동 UI로 전면 개편하고, 서버 API에서 플랜별 응답 차등 처리를 구현한다.

## 서브태스크 분해

### MT-1: 서버 API 플랜별 응답 차등 (백엔드 - 토르)
- server/main.py의 infokeyword_status 엔드포인트에서 히든 플랜은 전체 steps 반환, 맥스 플랜은 steps 제거 + fail_count/total_steps만 반환
- infokeyword_history 엔드포인트에도 동일 로직 적용
- 월 사용량 조회 API 추가 (/api/insuro/infokeyword/usage)

### MT-2: InfoKeyword.tsx 전면 개편 (프론트엔드 - 프레이야)
- 무료/베이직/프로: 궁금증 유발 + 업그레이드 유도 화면 (서울대보험쌤 브랜딩, 샘플 블러, CTA)
- 맥스: 키워드 생성 → 선택 → 분석 → 결과 (fail_count 기반) + 컨설팅 안내
- 히든: 맥스 동일 플로우 + 7단계 상세 전부 표시
- 히스토리 조회, 월 사용량 표시

### MT-3: KeywordAnalysis.tsx 탭 연동 업데이트 (프론트엔드 - 프레이야)
- info-keyword 탭에서 새로운 InfoKeyword 컴포넌트 사용
- 플랜별 적절한 fallback 표시

## 의존 관계
- MT-2, MT-3는 MT-1의 API 변경에 의존 → MT-1 우선 구현
- MT-2, MT-3는 동일 작업자가 순차 수행

## 위험 요소
- 인포키워드 서버(8100)가 기동 중이어야 E2E 테스트 가능
- 대형 파일(server/main.py) Edit 실패 가능성 → offset/limit으로 정확한 위치 확인 후 수정