# task-2007: InsuRo 리쿠르팅 전환 CTA 구현 (RC-1~2)

## SCQA

**S**: InsuRo의 LockedFeatureOverlay 컴포넌트에 기본 업그레이드 CTA가 존재하지만, 리쿠르팅 문의 유도를 위한 변형 CTA와 노출 정책이 미구현 상태이다.

**C**: 체크리스트 RC-1(CTA 변형 3종)과 RC-2(CTA 노출 정책) 2건이 미완료로 남아 있어, 리쿠르팅 전환 퍼널의 첫 단계를 시작할 수 없었다.

**Q**: 세션당 노출 제한과 쿨다운을 포함한 CTA 변형 3종을 안정적으로 구현할 수 있는가?

**A**: RC-1(CTA 변형 3종: 직접형/질문형/성과형)과 RC-2(세션당 2회 상한, 동일 기능 중복 금지, 24시간 쿨다운)를 구현하여 PR #7로 머지 완료. vitest 10/10 통과, tsc 에러 0건, Vite 빌드 성공. Gemini High 1건(쿨다운 로직 오류) 수정 반영.

## 수정 파일

| 파일 | 변경 내용 | grep 검증 | 상태 |
|------|-----------|-----------|------|
| src/lib/ctaExposurePolicy.ts (NEW) | CTA 노출 정책 유틸리티 (RC-2) | grep "CTA_MAX_PER_SESSION" OK | verified |
| src/components/LockedFeatureOverlay.tsx | CTA 변형 3종 + 노출 정책 통합 (RC-1) | grep "CTA_VARIANTS\|ctaVariant\|ctaType" OK | verified |
| tests/cta-exposure-policy.test.ts (NEW) | 노출 정책 테스트 10건 | grep "canShowCta\|recordCtaExposure" OK | verified |

## 완료 시그니처

- `cta.*variant|CTA_VARIANTS|ctaType` @ `src/components/` — 확인 (8개 매칭)
- `session.*cta|cta.*count|CTA_MAX` @ `src/` — 확인 (3개 매칭)

## 테스트 결과

- vitest: 10/10 통과 (cta-exposure-policy.test.ts)
- 기존 테스트: 143/143 통과 (회귀 없음)
- ⚠️ 기존 테스트 실패 1건 (본 작업 범위 외): AdminFcpa.test.tsx (@testing-library/user-event 패키지 미설치)
- tsc --noEmit: 에러 0건
- Vite build: 성공 (7.79s)

## 발견 이슈 및 해결

### 자체 해결 (3건)
1. **쿨다운 타임스탬프 즉시 기록 → 세션 2회 상한 무력화** — 쿨다운을 상한 도달 시에만 기록하도록 변경 (Gemini High)
2. **JSON.parse 런타임 에러 위험** — safeParseArray 헬퍼 함수로 try-catch 래핑 (Gemini Medium)
3. **기존 insuro_upgrade_prompt_count와 ctaExposurePolicy 이중 카운팅** — 기존 로직 제거, ctaExposurePolicy로 일원화 (Gemini Medium)

## Gemini PR 리뷰 대응

- High 1건: 쿨다운 로직 오류 → **수용(Accept)**, 코드 수정 후 재push
- Medium 2건: JSON.parse 안전성 + 기존 중복 로직 → **수용(Accept)**, 함께 수정

## L1 스모크테스트 결과

- 서버 재시작: 해당없음 (프론트엔드 컴포넌트 작업)
- API 응답 확인: 해당없음
- 스크린샷: 해당없음
- 빌드 검증: Vite build 성공 (dist 생성 완료, 137 precache entries)
- 타입 검증: tsc --noEmit 에러 0건

## 머지 판단

- **머지 필요**: Yes → 완료 (PR #7 머지됨)
- **브랜치**: task/task-2007-dev6
- **PR**: https://github.com/JonghyukJeon/InsuRo/pull/7
- **머지 의견**: Gemini High 0건 해소, 테스트 10/10, tsc 0건 — 자동 머지 완료

## 모델 사용 기록

- 라다(프론트엔드) / RC-1+RC-2 구현 / sonnet / -
- 벨레스(테스터) / 테스트 작성 / sonnet / -
- 페룬(팀장) / Gemini High 수정, QC 검토 / opus / 직접 개입 (Gemini 리뷰 대응)

## 세션 통계
- 총 도구 호출: 0회


## 세션 통계
- 총 도구 호출: 0회


## 세션 통계
- 총 도구 호출: 0회


## 세션 통계
- 총 도구 호출: 0회


## 세션 통계
- 총 도구 호출: 0회


## 세션 통계
- 총 도구 호출: 0회


## 세션 통계
- 총 도구 호출: 0회