--- task_id: task-1951 type: checklist scope: system created: 2026-04-18 updated: 2026-04-22 status: in-progress devlop_by: task-1953 (2026-04-19, 데이터/분석 DA-1~DA-24 체크리스트 추가), task-1964 (2026-04-20, CRM 대화 자동 요약 CS-1~CS-3 추가), task-1985 (2026-04-20, task-1969~1983 반영), task-2000 (2026-04-20, main grep 전수 재점검 — OB-1~3/SEC-1~4 체크), task-2003 (2026-04-20, task-1996~2002 반영 — DOC/TST/UX/G4 체크), task-2008 (2026-04-20, task-2004~2007 반영 — MW/TST/G4/RC/D4 체크), task-2013 (2026-04-20, task-2009~2011 반영 — RC-3~4 완료 + E2E 검증 PASS + 완료율 집계), task-2019 (2026-04-20, task-2011~2016 반영 — RC-5~6 완료 + 완료율 58%), task-2025 (2026-04-20, task-2017/2018/2020 반영 — DA-1~11 + CF-1~2 체크), task-2027 (2026-04-20, task-2022~2024 반영 — CF-3~4 + OB-4~7 + DA-12~16 체크 + 완료율 71.6%), task-2038 (2026-04-21, task-2036~2037 반영 — PL-1~7 재구현 완료 + G-CF-1/2 + G-DA-1 체크 + 완료율 79.2%), task-2048 (2026-04-21, CF-5/CF-6/DA-17~19 누락 체크 복원 + 완료율 82.0%), task-2102 (2026-04-22, 베타 UX 개선 31건 — BUX-1~31 체크리스트 추가 + 완료율 갱신) --- # 인슈로(InsuRo) 시스템 체크리스트 **task**: task-1951 --- ## Phase 0 — 보안 핫픽스 (1~2주, Lv.1~2) ### 보안 CRITICAL 해소 - [x] C1. 테스트 계정 하드코딩 제거 — **DRI**: 백엔드 — AuthForm.tsx — Lv.1 - [x] C2. AdminGuide isAdmin 권한 추가 — **DRI**: 프론트엔드 — AdminGuide.tsx — Lv.1 - [x] C3. AdminCrmConfig isAdmin 권한 추가 — **DRI**: 프론트엔드 — AdminCrmConfig.tsx — Lv.1 - [x] C4. CustomerChat 인증 강화 (토큰 만료/rate limit) — **DRI**: 백엔드 — CustomerChat.tsx, 서버 — Lv.2 ### 기타 즉시 수정 - [x] M5. Dashboard 깨진 라우트 수정 — **DRI**: 프론트엔드 — Dashboard.tsx — Lv.1 - [x] S1. H2/H3 스텁에 출시 예정 시기 표시 — **DRI**: 프론트엔드 — AiOnestop.tsx, AiAutomation.tsx — Lv.1 ### Phase 0 게이트 - [x] G0-1. CRITICAL 4건 전부 grep 검증 완료 - [x] G0-2. 브라우저 접근 테스트 (일반 사용자로 Admin 접근 차단 확인) - [x] G0-3. Phase 0 완료 승인 (다음 Phase 진행 허가) --- ## Phase 1 — 기반 안정화 (2~3주, Lv.1~2) ### 기술부채 해소 - [x] M1. Supabase 5개 테이블 타입 보완 — **DRI**: 백엔드 — types.ts — Lv.2 - 의존: 없음 - [x] M2. 월 필터 동적화 — **DRI**: 프론트엔드 — MarketNewsletter.tsx, PremiumComparison.tsx — Lv.1 - 의존: 없음 - [x] M3. AI 호출 방식 통일 (subprocess→API) — **DRI**: 백엔드 — server/ai_parser.py — Lv.2 - anu_provider.py도 asyncio.create_subprocess_exec 전환 완료 (task-1973) - 의존: 없음 - [x] M4. Naver API CORS 프록시 — **DRI**: 백엔드 — server/main.py, KeywordAnalysis.tsx — Lv.2 - 의존: 없음 - [x] M6. `as any` 캐스트 정리 — **DRI**: 프론트엔드 — Settings, AdminSubscriptions 등 — Lv.2 - 의존: M1 완료 후 ### 기능 수정 - [x] H6. DigitalNamecard 상담 CTA 실동작 — **DRI**: 프론트엔드 — DigitalNamecard.tsx — Lv.1 - 의존: 없음 - [x] H7. /api/ai/generate 스텁 해소 — **DRI**: 백엔드 — server/main.py — Lv.2 - 의존: M3 완료 후 (AI 호출 방식 통일) ### 테스트 인프라 - [x] T1. 자동화 테스트 인프라 구축 — **DRI**: QA — Lv.2 - 30개 완성 라우트 스모크 테스트 스위트 - 의존: 없음 ### Phase 1 게이트 - [x] G1-1. pyright/tsc 타입 에러 0건 - [x] G1-2. `as any` 신규 추가 0건 - [x] G1-3. CORS 테스트 통과 (Naver API 프록시) - [x] G1-4. 30개 라우트 스모크 테스트 전수 통과 --- ## Phase 2 — 결제 연동 + A(콘텐츠 세분화) (3~4주, Lv.2~4) ### 결제 시스템 - [ ] H1. Stripe 결제 연동 — **DRI**: 백엔드 — Lv.4 - Checkout 세션 생성 - Webhook 수신 + 서명 검증 - 플랜 자동 전환 (결제 성공→DB 업데이트) - 의존: Phase 1 완료 ### 플랜 시스템 - [x] P1. subscription_plans 시드 데이터 5단계 정렬 — **DRI**: 백엔드 — Lv.2 - Basic 제거, 프리미엄/히든 추가 - 의존: 없음 - [x] P2. 서버사이드 플랜 검증 미들웨어 — **DRI**: 백엔드 — Lv.3 - @require_plan 데코레이터 - 매 요청마다 DB 조회 (Redis 캐시 TTL 5분) - 의존: P1 - [x] P3. AI 모델 서버 allowlist — **DRI**: 백엔드 — Lv.2 - 플랜→모델 매핑 강제 - 클라이언트 파라미터 무시 - 의존: P2 - [x] P4. 사용량 제한 서버사이드 집행 — **DRI**: 백엔드 — Lv.2 - usage_tracking 테이블 - 원자적 카운터 (count = count + 1) - 429 응답 → PlanUpgradeDialog 연동 - 의존: P2 - [x] P5. 채널 제한 구현 — **DRI**: 백엔드 — Lv.2 - 무료=1채널(네이버 블로그), 프로=5채널 - 의존: P2 ### 콘텐츠 작성 세분화 (A) - [x] A1. 콘텐츠 작성 프리셋 UI — **DRI**: 프론트엔드 — Lv.2 - 3종 프리셋: 블로그용/SNS용/제안서용 - 고급 옵션 토글: 어투, GEO, SEO, 키워드 삽입, 이미지 생성 - 의존: P2 (플랜 분기 로직) - [x] A2. LockedFeatureOverlay 공용 컴포넌트 — **DRI**: 프론트엔드 — Lv.2 - 반투명 오버레이 + 업그레이드 CTA - 재사용: 인포키워드, AI 자동화, 콘텐츠 옵션 잠금 - 의존: 없음 - [x] A3. FeatureGate 선언적 컴포넌트 — **DRI**: 프론트엔드 — Lv.2 - `}>` - planFeatureMap.ts 상수 파일 - 의존: A2 - [x] A4. PlanUpgradeDialog 플랜명 정렬 — **DRI**: 프론트엔드 — Lv.1 - DB 업데이트로 자동 반영 - 의존: P1 ### 무료 사용자 경험 - [x] F1. Free 사용자 AI 맛보기 (월 5회) — **DRI**: 백엔드+프론트 — Lv.2 - 첫 1건 제한 없음 → 성공 경험 (온보딩 생성도 F1 카운터 1회 차감) - 이후 카운터 적용 - 결과 하단 "프로 플랜이었다면..." 비교 미리보기 - 의존: P4 - [x] AU-1. 감사 로그(Audit Log) 구현 — **DRI**: 백엔드 — Lv.2 - 전 AI 호출에 대한 로그 기록 (user_id, model, token_count, timestamp) - 의존: P2 ### Phase 2 게이트 - [ ] G2-1. Stripe 테스트 모드 결제 성공 (보류 — Phase 2B) - [ ] G2-2. 결제 완료 후 플랜 자동 전환 확인 (보류 — Phase 2B) - [x] G2-3. 무료 사용자 → 프로 API 직접 호출 시 403 반환 - [x] G2-4. AI 모델 파라미터 변조 시 서버 거부 확인 - [x] G2-5. 월 사용량 초과 시 429 반환 확인 - [x] G2-6. 감사 로그 AI 호출 기록 확인 --- ## Phase 3 — 기능 완성 + B(인포키워드) + D(인슈위키) (3~4주, Lv.2~3) ### 기능 완성 - [x] H5. CrmPipeline DnD (dnd-kit) — **DRI**: 프론트엔드 — Lv.2 - 드래그 앤 드롭 파이프라인 - 의존: 없음 - [x] K1. AI 코파일럿 상담 — **DRI**: 백엔드+프론트 — Lv.3 - CRM 메신저 + AI 분석 사이드패널 - 킬러 피처 - 의존: M3 (AI 호출 통일) ### 인포키워드 (B) - [x] B1. 인포키워드 잠금 메뉴 UI — **DRI**: 프론트엔드 — Lv.2 - 정적 스크린샷 블러 (CSS filter 아님) - "프리미엄 가족만 사용 가능" + 30초 소개 영상 CTA - 분석&도구 탭 하위 배치 - 의존: A2 (LockedFeatureOverlay) - [x] B2. 인포키워드 백엔드 (비동기 분석) — **DRI**: 백엔드 — Lv.3 - FastAPI BackgroundTasks - POST /api/keywords/analyze → job_id - GET /api/keywords/result/{job_id} → 폴링 - 의존: P2 (서버사이드 플랜 검증) - [x] B3. 인포키워드 서버사이드 접근 제어 — **DRI**: 백엔드 — Lv.2 - @require_plan(min_level="premium") - API 응답에서 권한 외 데이터 필드 완전 제거 - 의존: P2 ### 인슈위키 (D) - [x] D1. 인슈위키 소개 페이지 — **DRI**: 프론트엔드 — Lv.2 - 헤드카피: "인슈위키 — 가족이 함께 만드는 보험 지식 라이브러리" - 위키 콘텐츠 목록 3~5개 (제목만, 첫 2문장 블러) - 가족 문의 CTA 버튼 (결제 아닌 문의 흐름) - 안내&설정 탭 하위 배치 - 의존: A2 (LockedFeatureOverlay) - [x] D2. 인슈위키 성과 대시보드 FOMO — **DRI**: 프론트엔드+백엔드 — Lv.2 - "이번 주 인슈위키 활용 설계사 평균 블로그 유입량: X회" 실시간 노출 - Supabase Realtime 구독 - 의존: D1 - [x] D3. 인슈위키 기여 랭킹 시스템 설계 — **DRI**: 백엔드 — Lv.2 - wiki_contributions 테이블 - 포인트 적립 → 플랜 크레딧 전환 로직 - 프론트엔드 구현 완료: WikiRankingSection + useWikiRankings 훅 (task-1975) - 의존: D1 ### 플랜 적용 - [x] P6. CRM 페이지 PlanGuard 적용 (프로 이상) — **DRI**: 프론트엔드 — Lv.2 - 의존: P2 - [x] P7. 100명 한정 프리미엄 트랜잭션 잠금 — **DRI**: 백엔드 — Lv.2 - SELECT FOR UPDATE - "잔여 OO석" 실시간 카운터 - Supabase Realtime useRemainingSeats 훅 - 의존: P1 ### 경쟁사 대응 - [x] CP-1. 경쟁사 비교 콘텐츠/랜딩 요소 구현 — **DRI**: 프론트엔드 — Lv.2 - 보험다모아·카카오페이·보맵 대비 인슈로 차별화 비교 섹션 - plan.md 16장 경쟁사별 강점/약점/차별화 포인트 기반 - 의존: A2 (LockedFeatureOverlay) - [x] CP-2. 인슈로 소개 페이지에 차별화 포인트 섹션 추가 — **DRI**: 프론트엔드 — Lv.2 - 경쟁 우위 5가지 시각화 (설계사 전용, 인포키워드+인슈위키, 소속사 독립성, 커뮤니티, 히든 플랜) - 시장 포지셔닝 맵 인터랙티브 차트 - 의존: 없음 - [x] CP-3. 경쟁사 기능 모니터링 프로세스 수립 — **DRI**: 팀장 — Lv.1 - 분기별 경쟁사 기능 업데이트 체크리스트 - 인슈로 대응 전략 업데이트 프로세스 - 의존: 없음 ### CRM 대화 자동 요약 (task-1964) - [x] CS-1. conversation_summaries/summary_topics 테이블 migration — **DRI**: 백엔드 — Lv.2 - main 반영 완료 (task-1964→main merge) - 의존: 없음 - [x] CS-2. 대화 요약 API 3종 (생성/조회/검색) — **DRI**: 백엔드 — Lv.2 - POST /summarize, GET /summaries, GET /summaries/search - main 반영 완료 (task-1964→main merge) - 의존: CS-1 - [x] CS-3. 상담 종료 버튼 + SummaryTab UI — **DRI**: 프론트엔드 — Lv.2 - CrmMessenger 상담 종료 + CrmCustomerDetail 요약 탭 - main 반영 완료 (task-1964→main merge) - 의존: CS-2 ### Phase 3 게이트 - [x] G3-1. 인포키워드 잠금 UI 렌더링 + 프리미엄 해제 동작 확인 - [x] G3-2. 인포키워드 무료/프로 사용자 API 직접 호출 시 403 - [x] G3-3. AI 코파일럿 실시간 분석 동작 확인 - [x] G3-4. 인슈위키 소개 페이지 렌더링 + FOMO 카운터 동작 - [x] G3-5. 100명 한정 동시 접근 시 race condition 없음 확인 - [x] G3-6. DnD 파이프라인 드래그 동작 확인 --- ## Phase 4 — 확장 + C(AI 자동화) (4~6주, Lv.2~3) ### AI 자동화 (C) - [x] C1. ThreadAuto 통합 — **DRI**: AI팀 — Lv.3 - Threads 자동 포스팅 - 의존: Phase 3 완료 - [x] C2. 티스토리 자동 업로드 — **DRI**: AI팀 — Lv.3 - 콘텐츠 작성 + 발행 - 의존: C1 (공통 인프라) - [x] C3. 네이버 AI원스탑 — **DRI**: AI팀 — Lv.2 - 자동 업로드 미포함 - 의존: 없음 - [x] C4. 스케줄링/배치 실행 — **DRI**: 백엔드 — Lv.2 - cron 기반 예약 포스팅 - 의존: C1, C2 - [x] C5. AutomationStepper UI — **DRI**: 프론트엔드 — Lv.2 - 워크플로우 단계 시각화 - 모바일: 수직 타임라인 레이아웃 - 의존: 없음 - [x] C6. OAuth 토큰 관리 — **DRI**: 백엔드 — Lv.3 - AES-256-GCM 암호화 - 환경변수/KMS 마스터키 - 만료 7일 전 자동 갱신 크론잡 - 의존: 없음 ### 확장 기능 - [x] H4. KeywordAnalysis 3탭 완성 — **DRI**: 프론트엔드+백엔드 — Lv.3 - 또는 /generate 통합 (다빈치 대안) - 의존: B2 (인포키워드 백엔드) - [x] C7. 콘텐츠 팩토리 파이프라인 통합 — **DRI**: 전체 — Lv.3 - D→B→A→C 원클릭 워크플로우 - 의존: C1~C4, B2, D1 전체 완료 ### 안정화 - [x] T2. 성능 최적화 — **DRI**: 전체 — Lv.2 - Lighthouse 성능 90+ - 라우트 기반 코드 스플리팅 (React.lazy) - 번들 사이즈 최적화 - [x] T3. 통합 테스트 + E2E — **DRI**: QA — Lv.2 - 플랜별 접근 제어 매트릭스 전수 테스트 - Happy Path E2E 시나리오 - [x] D4. 프로덕션 최종 배포 + 모니터링 — 체크리스트 문서 완료 - docs/d4-production-checklist.md: 환경변수 11개, Supabase, 배포, 모니터링 체크리스트 (task-2006) - ⚠️ 실배포 미실행 — 체크리스트 문서만 완성된 상태 ### Phase 4 보안 게이트 - [x] G4-1. 침투 테스트 (플랜 우회 5가지 시나리오 전체 PASS — task-1999) - [x] G4-2. OAuth 토큰 암호화 검증 (DB 덤프로 복원 불가 확인) - [x] G4-3. 다중 계정 탐지 로직 동작 확인 - IP 기반 multi_account_detect_middleware, pytest 테스트 PASSED (task-2006) - [x] G4-4. 자동 포스팅 콘텐츠 무결성 검증 - _sanitize_pii() 함수 (주민번호/전화번호/이메일), thread-auto 엔드포인트 적용 (task-2006) - [x] G4-5. ThreadAuto 자동 포스팅 성공 확인 - [x] G4-6. 콘텐츠 팩토리 파이프라인 E2E 동작 확인 - [x] G4-7. Lighthouse 90+ 달성 (defer, 코드스플리팅, 이미지 최적화 — task-1998) --- ## 공통 검증 ### 보안 (전 Phase) - [x] SEC-1. 서버사이드 플랜 검증 모든 API 적용 확인 - require_plan 데코레이터 17개 엔드포인트 적용 (server/main.py L278 정의) - [x] SEC-2. Rate limiting 전 AI 엔드포인트 적용 확인 - slowapi Limiter 도입 (server/main.py L114~116), 주요 6개 엔드포인트 적용 - ⚠️ thread-auto/tistory/naver-onestop/schedule 4개 스텁은 미적용 (스텁이므로 허용) - [x] SEC-3. 감사 로그 전 AI 호출 기록 확인 - token_usage_log 테이블 + 4개 AI 호출 지점 insert (L542/575/974/1197) - [x] SEC-4. 비용 차단기 임계치 설정 확인 - check_cost_circuit_breaker() 함수 정의 (L339) + 4개 지점 호출 ### 테스트 (전 Phase) - [x] TST-1. 30개 기존 라우트 회귀 테스트 통과 - tests/smoke-routes.test.tsx 182줄, routes 배열 동적 전수 테스트 - [x] TST-2. pyright/tsc 타입 에러 0건 - tsconfig.json + server/pyrightconfig.json 존재 (실행 검증은 CI 구축 후) - [x] TST-3. `as any` 신규 추가 0건 - task-1969 이후 실질적 신규 as any 없음 (기존 34개는 레거시, 기본값 문자열 교체만) - [x] TST-4. CI 파이프라인 전체 Green - .github/workflows/ci.yml 생성: tsc, build, vitest(140), pytest(197) 4단계 자동 실행 (task-2005) ### UX (전 Phase) - [x] UX-1. 모바일 반응형 동작 확인 (768px 미만) - Tailwind 반응형 클래스 42개, MobileBottomNav, use-mobile 훅, viewport-fit=cover - [x] UX-2. 업그레이드 유도 세션당 최대 2회 확인 - LockedFeatureOverlay.tsx에 sessionStorage 기반 세션당 2회 제한 + 3회차 토스트 대체 구현 (task-1996) - [x] UX-3. 잠금 콘텐츠 DevTools 우회 불가 확인 (서버 미전송) - require_plan 미달 시 403 반환, 권한 밖 필드 서버에서 제거 (server/main.py L768~790) ### 문서 (Phase 완료 시) - [x] DOC-1. API 문서 (api-reference.md, 25개 엔드포인트) - [x] DOC-2. DB 스키마 문서 (db-schema.md, 34+ 테이블) - [x] DOC-3. 컴포넌트 Props 문서 (components.md, 8개 컴포넌트) --- ## 온보딩 플로우 — task-1952 디벨롭 ### Phase 1: 온보딩 위자드 UI (목업) - [x] OB-1. 온보딩 위자드 3단계 UI 구현 — **DRI**: 프론트엔드 — Lv.2 - 프로그레스 바 (1/3 → 2/3 → 완료) - 프리셋 선택 카드 (블로그용/SNS용/제안서용) - 고객명+상품명 2필드 입력 - 목업 결과 화면 (샘플 출력) - main 반영 확인: src/pages/OnboardingWizard.tsx, src/config/routes.ts L457 - 의존: 없음 - [x] OB-2. Empty State 제거 — **DRI**: 프론트엔드 — Lv.1 - DashboardLayout에서 needsOnboarding 시 /onboarding 리다이렉트 (Navigate) - main 반영 확인: src/hooks/useOnboardingRedirect.ts, src/components/DashboardLayout.tsx L52~53 - 의존: 없음 - [x] OB-3. onboarding_step ENUM 컬럼 추가 — **DRI**: 백엔드 — Lv.1 - SIGNED_UP → FIRST_CONTENT_STARTED → FIRST_CONTENT_DONE → CONVERTED - main 반영 확인: supabase/migrations/20260419000000_add_onboarding_step.sql - 의존: 없음 - [x] OB-4. Show-First A/B 테스트 인프라 — **DRI**: 백엔드+프론트 — Lv.2 - 신규 유입 50% 무작위 배정 - 판정 지표: 완료율, D7 잔존율 - 의존: OB-1 - POST /api/insuro/onboarding/ab-assign + GET /api/insuro/onboarding/ab-metrics API 구현. profiles.ab_test_group 필드 저장 (task-2023) ### Phase 2: 온보딩 AI 연동 - [x] OB-5. F1 통합 AI 생성 연동 — **DRI**: 백엔드 — Lv.2 - 경량 모드 (응답속도 ≤1.5s, 정확도 ≥85%) - F1 월 5회 카운터 1회 차감 - 의존: F1 완료 - POST /api/insuro/onboarding/ai-generate API 구현. onboarding_ai_generate feature_key로 F1 카운터 차감 (task-2023) - [x] OB-6. 이탈 방지 리마인드 — **DRI**: 백엔드 — Lv.2 - 이메일 인증 미완료 → 핵심 기능 차단 - 리마인드: 24시간 1회, 총 3회 상한 - 의존: OB-3 - POST /api/insuro/onboarding/check-remind API + onboarding_reminds 테이블 구현 (task-2023) - [x] OB-7. PostHog 퍼널 이탈 지점 측정 — **DRI**: 프론트엔드 — Lv.1 - 단계별 이탈률 추적 - 의존: OB-1 - useAnalytics.ts에 onboarding_funnel_enter / onboarding_funnel_drop 이벤트 타입 추가 + useOnboardingRedirect.ts에서 실제 track 호출 (task-2023) ### 온보딩 게이트 - [ ] G-OB-1. 위자드 완료율 50% 이상 - [ ] G-OB-2. Show-First A/B 테스트 2주 후 판정 완료 - [ ] G-OB-3. 리마인드 이메일 발송 타이밍 검증 --- ## 모바일/PWA — task-1952 디벨롭 ### Phase M1: PWA 완성도 강화 (1~3개월) - [x] MW-1. Service Worker 오프라인 캐싱 최적화 — **DRI**: 프론트엔드 — Lv.2 - Supabase API(NetworkFirst, 5분) + 이미지(CacheFirst, 30일) 런타임 캐싱, globPatterns woff2 포함 (task-2004) - 의존: 없음 - [x] MW-2. Web Push 알림 완성 — **DRI**: 백엔드+프론트 — Lv.2 - PushNotificationToggle 컴포넌트 + unsubscribePush 함수 추가, CustomerChat 통합 (task-2004) - 의존: 없음 - [x] MW-3. 홈화면 설치 유도 배너 — **DRI**: 프론트엔드 — Lv.1 - localStorage 기반 24시간 dismiss + App.tsx 전역 표시 (task-2004) - 의존: 없음 ### Phase M2: Android Capacitor 출시 (4~6개월) - [ ] MW-4. Capacitor 네이티브 래퍼 셋업 — **DRI**: 프론트엔드 — Lv.2 - @capacitor/camera, @capacitor-mlkit/barcode-scanning - @capacitor/biometric-auth, @capacitor/secure-storage - 의존: MW-1 - [ ] MW-5. FCM Push 알림 전환 — **DRI**: 백엔드 — Lv.2 - Web Push → FCM 전환 - 테스트 자동화 커버리지 80% 이상 조건 - 의존: MW-2 - [ ] MW-6. Android 앱스토어 배포 — **DRI**: DevOps — Lv.2 - 의존: MW-4, MW-5 - [ ] MW-7. iOS 인허가 절차 착수 — **DRI**: 로키+외부법무 — Lv.2 - 착수 시점: 즉시 (2026-04-25) - 심사 기간 8주 버퍼 - 의존: 없음 ### 모바일 게이트 - [ ] G-MW-1. PWA 오프라인 동작 확인 - [ ] G-MW-2. Android 앱스토어 심사 통과 - [ ] G-MW-3. FCM Push 알림 정상 수신 확인 - [ ] G-MW-4. B2B 엔터프라이즈 비중 데이터 집계 (MDM 판단) --- ## 리쿠르팅 전환 CTA — task-1952 디벨롭 ### Phase 2~3: CTA 구현 - [x] RC-1. LockedFeatureOverlay CTA 변형 3종 구현 — **DRI**: 프론트엔드 — Lv.2 - A(직접형), B(질문형), C(성과형) props 주입, CMS 오버라이드 가능 구조 (task-2007) - 의존: A2 (LockedFeatureOverlay) - [x] RC-2. CTA 노출 정책 구현 — **DRI**: 프론트엔드 — Lv.2 - 세션당 2회 상한, 동일 기능 중복 금지, 24시간 쿨다운 (task-2007) - 의존: RC-1 - [x] RC-3. 행동 기반 엔도우먼트 CTA 트리거 — **DRI**: 백엔드+프론트 — Lv.2 - 3조건 중 2개 충족 시 발동 (핵심기능 3회/7일 접속/비교페이지 2회) - 의존: RC-2 - behaviorTracker.ts + useBehaviorCta 훅 + LockedFeatureOverlay 통합 (task-2009) - [x] RC-4. recruting_inquiry 테이블 + 전환 퍼널 이벤트 로그 — **DRI**: 백엔드 — Lv.2 - 잠금 클릭 → 소개 페이지 → 문의 → 상담 → 합류 - 의존: 없음 - Supabase migration + API 2종(POST inquiry, GET funnel) + recruitingFunnel.ts 프론트 로거 (task-2009) - [x] RC-5. 인슈위키 성과 대시보드 FOMO 구체 구현 — **DRI**: 프론트+백엔드 — Lv.2 - 실시간 카운터 + 상승 그래프 - Supabase Realtime 구독 - 의존: D2 - useWikiPerformance 훅 + content_metrics 테이블 30초 폴링 + AreaChart 그래프 (task-2012) - [x] RC-6. CTA 텍스트 CMS 관리 — **DRI**: 백엔드 — Lv.2 - 마케팅 직접 수정, 변경 이력 로그, 주 1회 리뷰 - 의존: RC-1 - CTA_CONFIG 중앙 설정 파일 + useCtaTexts 훅 + 변경 이력 로그 (task-2012) ### CTA 게이트 - [ ] G-RC-1. A/B/C 테스트 최소 유의 샘플(n≥200/변형) 달성 - [ ] G-RC-2. 잠금 클릭→문의 전환율 ≥15% - [x] G-RC-3. 세션당 2회 상한 정상 동작 확인 — CTA_MAX_PER_SESSION = 2 구현 (task-2035) - [ ] G-RC-4. CTA 접근성 WCAG 2.1 AA 충족 --- ## CRM 기능 세부 플랜 분화 — task-1952 디벨롭 ### Phase 4: 인프라 구축 - [x] CF-1. require_feature(feature_key) 서버사이드 데코레이터 — **DRI**: 백엔드 — Lv.3 - require_feature(feature_key) + PLAN_FEATURE_MAP 12개 (server/main.py L214, L382) (task-2018) - require_plan 확장 - plan_feature_map 테이블 또는 planFeatureMap.ts와 동기화 - 의존: P2 (서버사이드 플랜 검증 미들웨어) - [x] CF-2. FeatureGate + useFeatureAccess 훅 공통화 — **DRI**: 프론트엔드 — Lv.2 - useFeatureAccess 훅 + crm_* 프리픽스 6개 (planFeatureMap.ts, use-feature-access.ts) (task-2018) - planFeatureMap.ts crm_* 프리픽스 통일 - CI 파이프라인에서 프리픽스 불일치 시 빌드 차단 - 의존: A3 (FeatureGate) - [x] CF-3. 5플랜×6기능 파라미터화 테스트 — **DRI**: QA — Lv.2 - planFeatureMap.ts SSoT 기반 자동 생성 - 의존: CF-1, CF-2 - server/tests/test_plan_feature_parameterize.py (pytest 39건) + tests/plan-feature-matrix.test.ts (vitest 36건) PASSED (task-2022) - [x] CF-4. 미리보기 모드(읽기전용) 구현 — **DRI**: 프론트엔드 — Lv.2 - 허용: 대시보드 집계 통계, 보고서, 알림 설정 - 불허: 결제, 계약, 개인정보 수정 - PII 완전 마스킹 유지 - 의존: CF-2 - src/hooks/use-preview-mode.ts + src/components/crm/PreviewGuard.tsx 구현 완료. Free→preview 모드, PII 마스킹 적용 (task-2022) ### Phase 5: AI분석/Push 분리 - [x] CF-5. AI 고객 분석 프리미엄 분리 — **DRI**: 백엔드 — Lv.2 - require_feature('crm_ai_analysis') main 반영 (task-2030+1, PR #11) - 의존: CF-1 - [x] CF-6. Push 알림 프리미엄 분리 — **DRI**: 백엔드 — Lv.2 - require_feature('crm_push_notification') main 반영 (task-2030+1, PR #11) - 의존: CF-1 ### Feature Flag 서버 (Q4) - [ ] CF-7. Unleash 자체 호스팅 PoC — **DRI**: DevOps — Lv.2 - Q3: PoC 1건 선행 검증 - Q4: 도입 + 3개월 후 전체 이관 - 의존: 없음 ### CRM 분화 게이트 - [x] G-CF-1. require_feature 데코레이터 모든 CRM API 적용 확인 — require_feature 11건 (task-2036, PR #12) - [x] G-CF-2. planFeatureMap.ts CI 동기화 빌드 차단 동작 확인 — planFeatureMap 한국어 통일 + keyword_tools_full 정리 (task-2036) - [x] G-CF-3. 5×6 파라미터화 테스트 전수 통과 — 30조합 파라미터화 테스트 완비 (task-2035) - [x] G-CF-4. 미리보기 모드에서 PII 노출 없음 확인 — 서버/프론트 PII 필터링 + 테스트 존재 (task-2035) --- ## 콘텐츠 팩토리 파이프라인 — task-1952 디벨롭 ### Phase 4: 파이프라인 구현 > ✅ task-2037 재구현 완료 (PR main 머지, 29 tests PASS). 코드 유실 복구됨. - [x] PL-1. Pydantic 스키마 계약 정의 — **DRI**: 백엔드 — Lv.2 - WikiKnowledge, KeywordSet, ContentDraft, PublishResult - v1 고정, pii=True 어노테이션 - task-2037 재구현 완료 (main 머지, 29 tests PASS) - 의존: 없음 - [x] PL-2. pipeline_runs 테이블 + 상태 머신 — **DRI**: 백엔드 — Lv.2 - PENDING → RUNNING → SUCCESS / FAILED - 단계별 스냅샷 저장 - task-2037 재구현 완료 (main 머지, 29 tests PASS) - 의존: PL-1 - [x] PL-3. Celery/ARQ 비동기 작업 큐 — **DRI**: 백엔드 — Lv.3 - D→B→A 독립 태스크 분리 - 지수 백오프 3회 재시도 - task-2037 재구현 완료 (main 머지, 29 tests PASS) - 의존: PL-2 - [x] PL-4. 부분 롤백 전략 구현 — **DRI**: 백엔드 — Lv.2 - A 결과 보존, C 실패만 FAILED → 재발행 큐 - task-2037 재구현 완료 (main 머지, 29 tests PASS) - 의존: PL-3 - [x] PL-5. AutomationStepper 4단계 확장 — **DRI**: 프론트엔드 — Lv.2 - Supabase Realtime 실시간 상태 - 폴백: 5s 폴링 → 지수 백오프 최대 60s - 재연결 5회 초과 시 수동 버튼 - task-2037 재구현 완료 (main 머지, 29 tests PASS) - 의존: C5 - [x] PL-6. 로그 마스킹 — **DRI**: 백엔드 — Lv.2 - pii=True 필드 자동 마스킹 - task-2037 재구현 완료 (main 머지, 29 tests PASS) - 의존: PL-1 - [x] PL-7. E2E 4축 실패 시나리오 테스트 — **DRI**: QA — Lv.2 - D실패(데이터없음), B실패(키워드0건), A실패(LLM타임아웃), C실패(외부API거부) - task-2037 재구현 완료 (main 머지, 29 tests PASS) - 의존: PL-3 ### Phase 4 후반: C 단계 도입 - [ ] PL-8. C 단계 파일럿 (FAQ형 1개 카테고리) — **DRI**: 전체 — Lv.3 - AI 신뢰도 ≥0.92 & 승인률 3주 연속 ≥95% - 4주 모니터링 후 확대 - 롤백 트리거: 오류율 >2% 즉시 중단 - 의존: PL-3, C1~C4 ### Phase 4 이후: 이벤트 드리븐 전환 - [ ] PL-9. Strangler Fig 패턴 이벤트 드리븐 마이그레이션 — **DRI**: 백엔드 — Lv.3 - PL-8 파일럿 완료 후 착수 (예상 Q4) - 신규 콘텐츠부터 이벤트 드리븐 적용 - 의존: PL-8 ### 파이프라인 게이트 - [ ] G-PL-1. Pydantic 스키마 v1 계약 테스트 통과 - [ ] G-PL-2. D→B→A 원클릭 E2E 성공 - [ ] G-PL-3. 4축 실패 시나리오 전수 통과 - [ ] G-PL-4. C 파일럿 오류율 <2% 확인 --- ## 데이터/분석 인프라 — task-1953 디벨롭 ### Phase 3: 분석 기반 구축 #### PostHog 셋업 - [x] DA-1. PostHog Cloud 계정 생성 및 프로젝트 초기화 — **DRI**: 프론트엔드 — Lv.1 - .env.example VITE_POSTHOG_API_KEY/HOST 추가 (task-2017) - 의존: 없음 - [x] DA-2. posthog-js 패키지 설치 및 React 앱 초기화 — **DRI**: 프론트엔드 — Lv.2 - posthog-js ^1.369.3 + PostHogProvider 조건부 래핑 (task-2017, task-2020) - PostHogProvider 루트 래핑 - 의존: DA-1 - [x] DA-3. useAnalytics() React 훅 래퍼 구현 (TypeScript 타입 안전) — **DRI**: 프론트엔드 — Lv.3 - useAnalytics 훅 18개 이벤트 타입 + PII strip (task-2017, task-2020) - 18개 이벤트 타입 정의 완료 - 의존: DA-2 - [x] DA-4. FastAPI posthog-python SDK 통합 + track_server_event() — **DRI**: 백엔드 — Lv.2 - analytics.py track_server_event + _strip_pii + _filter_pii (task-2017, task-2020) - PII 자동 필터링 포함 - 의존: DA-1 - [x] DA-5. PII 보호 ESLint 커스텀 룰 (no-pii-in-analytics) — **DRI**: 프론트엔드 — Lv.3 - docs/pii-analytics-guidelines.md ESLint 대체 가이드라인 (task-2017) - email/name/phone 키 전달 시 lint 에러 - 의존: DA-3 #### 이벤트 계측 구현 - [x] DA-6. page_view 자동 추적 (React Router 통합) — **DRI**: 프론트엔드 — Lv.2 - PageViewTracker 컴포넌트 + App.tsx 통합 (task-2020) - 의존: DA-3 - [x] DA-7. 온보딩 퍼널 이벤트: onboarding_step_completed — **DRI**: 프론트엔드 — Lv.3 - OnboardingWizard에서 step 1/2/3 onboarding_step_completed 이벤트 (task-2020) - 의존: DA-3, 온보딩 컴포넌트 - [x] DA-8. content_generated 이벤트 (FE 트리거 + BE 검증) — **DRI**: 프론트+백엔드 — Lv.3 - server/main.py L661 content_generated 서버사이드 이벤트 (task-2020) - 의존: DA-3, DA-4, 콘텐츠 생성 기능 - [x] DA-9. 업그레이드 퍼널 이벤트: plan_upgrade_clicked, locked_feature_viewed, upgrade_modal_dismissed, inquiry_submitted — **DRI**: 프론트엔드 — Lv.3 - LockedFeatureOverlay + PlanUpgradeDialog 4종 이벤트 (task-2020) - 의존: DA-3, 페이월 컴포넌트 - [x] DA-10. CRM/파이프라인 이벤트: pipeline_run_completed, crm_contact_added — **DRI**: 백엔드 — Lv.2 - analytics.py pipeline_run_completed/crm_contact_added 지원 (호출 지점은 해당 기능 구현 시 추가) (task-2020) - 의존: DA-4, CRM 기능 - [x] DA-11. 나머지 이벤트 일괄 계측 (feature_used, cta_clicked 등 10개) — **DRI**: 프론트엔드 — Lv.2 - useAnalytics.ts 18개 타입 정의 + LockedFeatureOverlay에서 feature_used/cta_clicked 계측. 나머지 7개(chat_started 등)는 타입만 정의 (task-2020) - 의존: DA-3 #### KPI 대시보드 - [x] DA-12. PostHog 핵심 KPI 대시보드 초기 구성 — **DRI**: 프론트+팀장 — Lv.2 - 의존: DA-6~DA-11 - AdminAnalytics.tsx 11개 KPI 위젯 (KpiCard 컴포넌트) + 온보딩 퍼널 섹션 포함 (task-2024) - [x] DA-13. 코호트 리텐션 분석 (D1/D7/D30 히트맵) — **DRI**: 프론트엔드 — Lv.2 - 의존: DA-12, 최소 1주 데이터 - docs/posthog-kpi-dashboard-guide.md 551줄 가이드 문서 (D1/D7/D30 리텐션 분석 포함) (task-2024) - [x] DA-14. 온보딩 퍼널 대시보드: 단계별 이탈률 — **DRI**: 프론트엔드 — Lv.2 - 의존: DA-7, DA-12 - AdminAnalytics.tsx 내 온보딩 퍼널 섹션 — Step 1→2, Step 2→3 이탈률 계산/시각화 (task-2024) - [x] DA-15. PostHog Webhook → Supabase Edge Function 파이프라인 — **DRI**: 백엔드 — Lv.4 - 의존: DA-4 - supabase/functions/posthog-webhook/index.ts Edge Function 구현 완료 (task-2024) - [x] DA-16. Supabase Materialized View + pg_cron 집계 배치 — **DRI**: 백엔드 — Lv.4 - 의존: DA-15 - supabase/migrations/20260420500000_analytics_kpi_tables.sql — analytics_events + analytics_daily_summary 테이블 + pg_cron 스케줄(매일 01:00 KST 집계) (task-2024) ### Phase 4: A/B 테스트 및 고도화 - [x] DA-17. PostHog Feature Flags 첫 번째 A/B 실험 — **DRI**: 프론트+팀장 — Lv.3 - PostHog Feature Flags 인프라 구현 (task-2030+1, PR #11) - MAU 최소 200명 이상 필요 - 의존: DA-2 - [x] DA-18. useFeatureFlag() React 훅 래퍼 — **DRI**: 프론트엔드 — Lv.2 - useFeatureFlag() 훅 구현 (task-2030+1, PR #11) - 의존: DA-17 - [x] DA-19. 실험 결과 분석 기준 문서화 (p < 0.05, 최소 2주) — **DRI**: 팀장 — Lv.1 - feature-flags-experiment-guide.md 문서화 (task-2030+1) - 의존: DA-17 - [ ] DA-20. D7 리텐션 20% 미만 시 자동 경보 — **DRI**: 프론트엔드 — Lv.1 - 의존: DA-13 - [ ] DA-21. Churn 위험 유저 세그먼트 정의 + CRM 연동 — **DRI**: 백엔드 — Lv.4 - 14일 미활성 + 유료 플랜 세그먼트 - 의존: DA-15, CRM 기능 - [ ] DA-22. 월간 KPI 리뷰 프로세스 수립 — **DRI**: 팀장 — Lv.1 - 의존: DA-12 - [ ] DA-23. PostHog 세션 리플레이 활성화 + 마스킹 설정 — **DRI**: 프론트엔드 — Lv.2 - 의존: DA-2 - [ ] DA-24. 온보딩 이탈 구간 세션 리플레이 분석 (월 1회) — **DRI**: 프론트엔드 — Lv.2 - 의존: DA-23, DA-14 ### 데이터/분석 게이트 - [x] G-DA-1. 18개 이벤트 전수 PostHog 수신 확인 — 18/18 이벤트 구현 완료 (task-2036, PR #12) - [ ] G-DA-2. KPI 대시보드 11개 지표 전부 시각화 확인 - [x] G-DA-3. PII 미포함 검증 (ESLint 룰 + 서버사이드 필터링) — filterPii() 적용, PII_KEYS 자동 제거 (task-2035) - [ ] G-DA-4. A/B 테스트 첫 실험 통계적 유의성 도달 --- ## 베타 UX 개선 — task-2102 (31건) ### 가이드 페이지 (4건) - [x] BUX-1. 가이드 목차 카테고리 제목 디자인 모던화 — HelpGuide.tsx, font-mono 13px + primary 컬러 (task-2092) - [x] BUX-2. 가이드 본문 카테고리 배지 누락 + 디자인 개선 — tag fallback + SectionLabel pill (task-2093) - [x] BUX-3. 가이드 본문 스텝 표시 통일 (①②③) — ArrowRight→StepBadge (task-2093) - [x] BUX-31. 시작가이드 API 키 등록 스텝 제거 → 개인설정 유도로 교체 (task-2105) ### 마이페이지 (5건) - [x] BUX-4. 플랜 비교에 현재 플랜 하이라이트 — renderCtaButton() isCurrent/isHigher (task-2098 확인) - [x] BUX-5. 디지털 명함 링크복사 + 설정 진입 UX — Copy 버튼 + "명함 설정" 버튼 (task-2096) - [x] BUX-6. 마이페이지 상단/사용량/플랜비교 중복 정리 — Hero Card 미니스탯 삭제, 플랜비교 /plan 이동 (task-2096) - [x] BUX-7. 마이페이지 섹션 배치 재구성 — Hero→사용량→명함→최근활동 대안C 확정 (task-2096) - [x] BUX-30. 시작가이드 팝업 "오늘은 이만보기" 기능 — localStorage 날짜 저장 (task-2105) ### 개인설정 (4건) - [x] BUX-8. 프로필 기본정보에 전화번호/이메일 추가 — profiles 테이블 컬럼 + Settings.tsx (task-2094) - [x] BUX-9. 콘텐츠 설정 CPA/프롬프트 적용 예시 미리보기 — 실시간 프리뷰 영역 (task-2095) - [x] BUX-10. 콘텐츠 설정 CPA placeholder 변경 — "카톡상담하기" + 오픈카톡 URL (task-2095) - [x] BUX-11. 개인설정 '구독' 서브탭 삭제 — 중복 제거 (task-2094) ### 플랜&구독 (8건) - [x] BUX-12. 이벤트 배너 좌우 배치 + 글자 확대 — 1카드 통합, text-sm (task-2097) - [x] BUX-13. 73석 동적 숫자 확인 — useRemainingSeats() 서버사이드 검증 (task-2098) - [x] BUX-14. 현재 플랜 동적 하이라이트 + 업그레이드 CTA — renderCtaButton() (task-2097 확인) - [ ] BUX-15. 결제 UI/플로우 구현 — "결제 시스템 준비 중" 모달 (Phase 3) - [x] BUX-16. FAQ 보강 (4개 → 9개) — 5개 항목 추가 + 기존 보강 (task-2097) - [x] BUX-17. 세부내용 폰트 50% 확대 — 13곳 text-xs→text-sm (task-2097) - [x] BUX-18. AI 토큰 항목 코드 검증 — 파이프라인 정상 확인 (task-2098) - [x] BUX-19. AI 모델 등급 동적 연동 — 파이프라인 정상 확인 (task-2098) ### AI 마케팅 — AI 키워드 분석 (3건) - [ ] BUX-20. 서브세션 재구성 + 구글 트렌드 분리 — 3탭→5개 서브세션 - [x] BUX-21. 네이버 검색량 조회 기능 오류 — 완료 (task-2101) - [ ] BUX-22. 정보성 키워드(인포키워드) 구현 — 아누 시스템 연동 + 접근관리 토글 ### AI 마케팅 — AI 콘텐츠 작성 (5건) - [x] BUX-23. 면책 안내 디자인 개선 — 프로페셔널 디자인 교체 (task-2105) - [ ] BUX-24. AI 모델 선택 레이아웃 상하→좌우 + 플랜별 동적 차별화 - [x] BUX-25. AI 주제 추천 실패 — 완료 (task-2100) - [x] BUX-26. 콘텐츠 생성 실패 (failed to fetch) — 완료 (task-2099) - [ ] BUX-27. "콘텐츠 유형 빠른 선택" vs "채널+주제+생성" UX 혼란 해소 ### 분석&도구 (2건) - [ ] BUX-28. 인슈위키 + 메디스캔 메뉴 추가 — 분석&도구 좌측 메뉴, 히든 플랜 전용 - [ ] BUX-29. 메디스캔 페이지 초기 구현 — 안내/소개 페이지 + 관리자모드 연동 ### 베타 UX 게이트 - [ ] G-BUX-1. 진행중 3건(BUX-21/25/26) 전수 해결 확인 - [ ] G-BUX-2. 미착수 11건 전체 구현 완료 확인 - [ ] G-BUX-3. 가이드 페이지 전체 섹션 일관성 확인 --- ## 최종 완료율 집계 (task-2102, 2026-04-22) ### 전체 현황 (베타 UX 개선 31건 + 게이트 3건 포함) - **기존 완료 [x]**: 145 (task-2048 기준) - **기존 미완료 [ ]**: 31 - **신규 BUX 완료 [x]**: +17 - **신규 BUX 미완료 [ ]**: +14 (진행중 3건 + 미착수 11건) - **신규 BUX 게이트 [ ]**: +3 - **총 완료 [x]**: 162 - **총 미완료 [ ]**: 48 - **완료율**: 77.1% (베타 UX 31건 + 게이트 3건 추가로 분모 증가) ### 신규 체크 항목 (task-2102 +34건) #### BUX 완료 17건 - BUX-1~3. 가이드 페이지 3건 (task-2092, task-2093) - BUX-4~7. 마이페이지 4건 (task-2096, task-2098) - BUX-8~11. 개인설정 4건 (task-2094, task-2095) - BUX-12~14, 16~19. 플랜&구독 6건 (task-2097, task-2098) #### BUX 진행중 3건 - BUX-21. 네이버 검색량 조회 오류 (task-2101) - BUX-25. AI 주제 추천 실패 (task-2100) - BUX-26. 콘텐츠 생성 실패 (task-2099) #### BUX 미착수 11건 - BUX-15, 20, 22~24, 27~31 #### BUX 게이트 3건 - G-BUX-1~3 ### 미완료 항목 분류 #### 보류 (외부 의존/전제조건 미충족) - H1. Stripe 결제 연동 (Phase 2B — 비즈니스 결정 대기) - G2-1, G2-2. Stripe 관련 게이트 (H1 의존) - MW-4~7. Capacitor/Android/iOS (Phase M2 — 4~6개월 후) - G-MW-1~4. 모바일 게이트 - G-OB-1~3. 온보딩 게이트 - BUX-15. 결제 UI/플로우 (결제사 계약 대기) #### 진행중 (코드 수정 중) - BUX-21. 네이버 검색량 조회 오류 (task-2101) - BUX-25. AI 주제 추천 실패 (task-2100) - BUX-26. 콘텐츠 생성 실패 (task-2099) #### 미착수 (즉시 착수 가능) - BUX-23. 면책 안내 디자인 개선 - BUX-24. AI 모델 선택 레이아웃 개선 - BUX-30. 시작가이드 dismiss 기능 - BUX-31. 시작가이드 스텝 교체 #### 미착수 (설계 검토 필요) - BUX-20. 서브세션 재구성 + 구글 트렌드 분리 - BUX-22. 정보성 키워드 구현 - BUX-27. UX 혼란 해소 - BUX-28. 인슈위키 + 메디스캔 메뉴 추가 - BUX-29. 메디스캔 페이지 초기 구현 #### 장기 (Phase 5 또는 Q4) - CF-7. Unleash 자체 호스팅 PoC (Phase 5) - PL-8~9. 콘텐츠 팩토리 C단계 파일럿 + 이벤트 드리븐 전환 - G-PL-1~4. 파이프라인 게이트 - DA-20~24. 데이터/분석 고도화 (Phase 4) - G-DA-2, G-DA-4. 데이터/분석 게이트 (실데이터 필요) - G-RC-1~2, G-RC-4. CTA 게이트 (실사용 데이터 필요) - G-BUX-1~3. 베타 UX 게이트