# task-2102: InsuRo 3문서 업데이트 — 베타 UX 개선 31건 전체 반영

## ★ 코드 수정 아님. 3문서(plan.md, context-notes.md, checklist.md) 업데이트만 수행.

## 3문서 위치
- 계획서: `/home/jay/workspace/memory/plans/insuro-system/plan.md`
- 맥락노트: `/home/jay/workspace/memory/plans/insuro-system/context-notes.md`
- 체크리스트: `/home/jay/workspace/memory/plans/insuro-system/checklist.md`

## 업데이트 내용

### 아래 31건을 3문서에 빠짐없이 반영할 것.

---

## 가이드 페이지 (4건)

**#1 [완료] 가이드 목차 — 카테고리 제목 디자인 모던화** (task-2092)
- HelpGuide.tsx L189: font-mono 10px → 13px 세미볼드 + primary 컬러 + accent 바
- 완료일: 2026-04-22

**#2 [완료] 가이드 본문 — 카테고리 배지 누락 + 디자인 개선** (task-2093)
- tag 없으면 소속 카테고리 label을 fallback으로 사용
- SectionLabel 모던 pill 형태로 교체
- 완료일: 2026-04-22

**#3 [완료] 가이드 본문 — 스텝 표시 불통일 (①②③ vs →) 통일** (task-2093)
- bullets 렌더링에 ArrowRight 대신 StepBadge로 ①②③ 방식 통일
- 완료일: 2026-04-22

**#31 [미착수] 시작가이드 — API 키 등록 스텝 제거 → 개인설정 유도로 교체**
- 시작가이드 팝업에서 "API 키 등록하기" 스텝 제거
- 대신 "안내&설정 → 개인설정" 입력 유도 스텝으로 교체 (프로필, CPA 등)

---

## 마이페이지 (5건)

**#4 [완료] 플랜 비교에 현재 플랜 하이라이트** (task-2098 확인)
- renderCtaButton()에 이미 구현 (isCurrent/isHigher 분기)
- bg-primary/5 + "현재" Badge
- 확인일: 2026-04-22

**#5 [완료 확인] 디지털 명함 — 링크복사 + 설정 진입 UX** (task-2096)
- 코드에 Copy 버튼 이미 존재 (clipboard.writeText + toast)
- task-2096에서 "명함 설정" 버튼 추가 (→ /settings 이동)
- 완료일: 2026-04-22

**#6 [완료] 마이페이지 — 상단/사용량/플랜비교 정보 중복 정리** (task-2096)
- Hero Card 미니스탯 4개 삭제 (사용량 섹션과 중복)
- 플랜 비교 테이블 삭제 (/plan으로 이동)
- 완료일: 2026-04-22

**#7 [완료] 마이페이지 — 섹션 배치 재구성** (task-2096)
- 최종 구조: Hero(간소화) → 사용량 → 명함 → 최근활동
- 84줄 삭제 + 9줄 추가
- brainstorming 결과 대안 C 확정
- 완료일: 2026-04-22

**#30 [미착수] 시작가이드 팝업 — "오늘은 이만보기" 기능 추가**
- localStorage에 날짜 저장, 당일 재표시 안 함

---

## 개인설정 (4건)

**#8 [완료] 프로필 기본정보에 전화번호/이메일 추가** (task-2094)
- profiles 테이블에 phone_number/email 컬럼 추가
- Settings.tsx 기본정보 섹션에 입력 필드 추가
- 완료일: 2026-04-22

**#9 [완료] 콘텐츠 설정 — CPA/프롬프트 적용 예시 미리보기** (task-2095)
- 콘텐츠 설정 탭 하단에 실시간 적용 예시 프리뷰 영역 추가
- CPA 링크/프롬프트가 콘텐츠에 어떻게 반영되는지 시각화
- 완료일: 2026-04-22

**#10 [완료] 콘텐츠 설정 — CPA placeholder 변경** (task-2095)
- "예: 네이버예약" → "예: 카톡상담하기"
- URL: "서울대보험쌤 오픈카톡 - https://open.kakao.com/o/sE1y0tPh"
- 완료일: 2026-04-22

**#11 [완료] 개인설정 — '구독' 서브탭 삭제** (task-2094)
- settings 페이지의 구독 탭 제거 (플랜&구독 페이지가 별도 존재)
- 완료일: 2026-04-22

---

## 플랜&구독 (8건)

**#12 [완료] 이벤트 배너 좌우 배치 + 글자 확대** (task-2097)
- 할인 배너 + 잔여석 카운터를 1개 카드로 통합
- flex-col md:flex-row 반응형 + text-xs → text-sm
- 완료일: 2026-04-22

**#13 [완료] 73석 동적 숫자 확인** (task-2098)
- useRemainingSeats() 훅 → Supabase 서버사이드 검증 확인
- 폴백 하드코딩(73석) → 0으로 수정, API 실패 시 카운터 숨김
- 완료일: 2026-04-22

**#14 [완료] 현재 플랜 동적 하이라이트 + 업그레이드 CTA** (task-2097 확인)
- renderCtaButton() 이미 구현: isCurrent → "현재 플랜", isHigher → "시작하기"
- 완료일: 2026-04-22

**#15 [미착수] 결제 UI/플로우 구현 (Phase 3)**
- Agent 미팅 합의: CTA 클릭 시 "결제 시스템 준비 중" 모달 (카드 입력 폼 X)
- 결제사 계약(토스/포트원) 후 실제 연동
- 보안: 카드 정보 입력 폼 생성 금지 (로키 DA 반론 반영)

**#16 [완료] FAQ 보강 (4개 → 9개)** (task-2097)
- 세금계산서, 팀구매, 데이터보안(RLS+AES-256), AI 저작권, 결제수단 추가
- 기존 4개 답변도 풍성하게 보강
- 완료일: 2026-04-22

**#17 [완료] 세부내용 폰트 50% 확대** (task-2097)
- 기능비교 테이블 13곳 text-xs → text-sm
- 완료일: 2026-04-22

**#18 [완료] AI 토큰 항목 코드 검증** (task-2098)
- 결과: 데이터 파이프라인 완전 연결, 수정 불필요
- DB seed: 무료=100, 베이직=500, 프로=2000, 맥스/히든=무제한
- 완료일: 2026-04-22

**#19 [완료] AI 모델 등급 동적 연동** (task-2098)
- 결과: AdminSubscriptions → plan_ai_models → Pricing 파이프라인 정상
- DB seed: 무료=haiku(기본AI), 베이직/프로=sonnet(고급AI), 맥스/히든=opus(최고급AI)
- 완료일: 2026-04-22

---

## AI 마케팅 — AI 키워드 분석 (3건)

**#20 [미착수] 서브세션 재구성 + 구글 트렌드 분리**
- 현재: 검색량조회/정보성키워드/상위노출 3탭 + 구글 트렌드가 페이지 하단에 붙어있음
- 수정: 5개 서브세션으로 분리
  - 키워드 (네이버 검색량조회)
  - 키워드 (구글 트렌드) — 별도 탭, 실제 기능 활성화
  - 정보성 키워드 (인포키워드)
  - 상위노출 분석
  - 메인 노출분석

**#21 [진행중] 네이버 검색량 조회 기능 오류** (task-2101)
- 키워드 검색 시 에러 메시지, 진행 불가
- 대시보드 네이버블로그탭 키워드분석 기능을 그대로 활용 (API 동일)

**#22 [미착수] 정보성 키워드(인포키워드) 구현**
- 아누 시스템의 인포키워드 기능 그대로 활용
- 관리자 메뉴 → 구독 플랜 관리 → 키워드 분석 아래 접근관리 토글 추가 (동적 연동)
- 접근 불가 플랜 → 기능 안내 페이지 (인슈로 3문서 참고)
- 인슈로 인포키워드 = 인포키워드 단독 서비스와 동일 sync

---

## AI 마케팅 — AI 콘텐츠 작성 (5건)

**#23 [미착수] 면책 안내 디자인 개선**
- 현재: 주황 경고 박스 + 긴 텍스트 + 체크박스 → 밋밋함
- 더 깔끔하고 프로페셔널한 디자인으로 개선

**#24 [미착수] AI 모델 선택 레이아웃 — 상하→좌우 + 플랜별 동적 차별화**
- 현재: Gemini Flash / Gemini Pro / Claude Sonnet 상하 나열
- 수정: 좌우 카드형 배치
- 플랜별 사용 가능 모델 동적 연동 (Hidden 플랜에만 Claude Sonnet 등)

**#25 [진행중] AI 주제 추천 실패** (task-2100)
- 클릭 시 실패 메시지 → 실제 작동하도록 코드 재분석

**#26 [진행중] 콘텐츠 생성 실패 (failed to fetch)** (task-2099)
- "생성 실패 (failed to fetch)" 에러 → API 연결 수정

**#27 [미착수] "콘텐츠 유형 빠른 선택" vs "채널+주제+생성" UX 혼란**
- 두 영역의 차이 불명확
- 인슈로 3문서 확인하여 원래 설계 의도 파악 후 UX 재검토

---

## 분석&도구 (2건)

**#28 [미착수] 인슈위키 + 메디스캔 메뉴 추가**
- 분석&도구 좌측 메뉴에 추가
- 순서: 소식지분석 → 보험료/환급률 → 인슈위키 → 메디스캔 → 보험사 전산정보 → 각종 계산기 → 외부 참고 사이트
- 가이드 목차에서 인슈위키/메디스캔 위치를 "설정&기타" → "분석&도구"로 이동
- 히든 플랜 전용: 관리자모드에서 on/off → 동적 연동
- 접근 불가 플랜 → 기능 안내 페이지 표시

**#29 [미착수] 메디스캔 페이지 초기 구현**
- 프로젝트-메디스캔 확인하여 기능 설명 파악
- 안내/소개 페이지 생성
- 관리자모드 플랜 관리에서 on/off 동적 연동

---

## 3문서 반영 가이드

### plan.md에 반영할 것
- 위 31건을 "베타 UX 개선 Phase" 섹션으로 추가
- 각 항목의 상태(완료/진행중/미착수) 명시
- Phase 분류: Phase 1(완료 17건), Phase 2(진행중 3건), Phase 3(미착수 11건)

### context-notes.md에 반영할 것
- Agent 미팅 결과 (마이페이지 대안 C, 플랜&구독 Phase 분리)
- brainstorming 결과 (분리 유지 + 중복 제거 원칙)
- 주요 결정 근거: 결제 UI는 "준비 중" 모달, 잔여석 서버사이드 검증, AI 토큰/모델 정상 확인

### checklist.md에 반영할 것
- 31건 각각 체크박스 항목으로 추가
- 완료 항목 [x], 미착수 [ ] 표시
- 완료율 계산

## 완료 시그니처
- plan.md에 31건 전체 섹션 존재
- checklist.md에 31개 체크박스 존재
- context-notes.md에 Agent 미팅/brainstorming 결정 근거 기록
- 누락 항목 0건

## 레벨
- critical

## 프로젝트
- insuro