---
task_id: task-2108
type: context
scope: task
created: 2026-04-22
updated: 2026-04-22
status: in-progress
---

# 맥락 노트: task-2108

**task**: task-2108

---

## 결정 근거

### 3 Step Why

1st Why: "왜 이 설계가 필요한가?"
→ 인슈위키와 메디스캔을 분석&도구 메뉴에 추가하여 히든 플랜 사용자에게 프리미엄 서비스 접근을 제공하고, 비히든 사용자에게는 업그레이드 유도 페이지를 보여줘야 함

2nd Why: "왜 이 접근이 최선인가?"
→ 기존 FeatureGate + planFeatureMap 패턴을 재사용하여 일관된 접근 제어를 적용. navigationConfig/routes 기반 메뉴 시스템에 자연스럽게 통합 가능. InsuWikiIntro 페이지가 이미 비히든 CTA를 포함

3rd Why: "왜 다른 대안보다 나은가?"
→ 새로운 접근 제어 시스템보다 기존 패턴 사용이 코드 일관성과 유지보수에 유리. PlanGuard는 free/basic/pro/max 4단계만 지원하므로, isHidden 전용 체크가 필요할 때는 FeatureGate + planFeatureMap에서 minPlan: "히든"이 더 적합

### 메뉴 순서 결정
- 지시서: 소식지분석 → 보험료/환급률 분석 → 인슈위키 → 메디스캔 → 보험사 전산정보 → 각종 계산기 → 외부 참고 사이트
- navigationConfig.ts(TopNavBar용)와 routes.ts(사이드바용) 모두 이 순서 적용

### 기존 InsuWikiIntro 페이지 재활용
- 현재 /insuwiki-intro 경로, "안내" 섹션에 위치
- → /tools/insuwiki 경로, "분석&도구" 섹션으로 이동
- 히든 플랜 사용자에게는 FeatureGate로 감싼 실제 서비스 페이지(iframe/링크) 표시
- 비히든 사용자에게는 기존 InsuWikiIntro 소개 페이지 그대로 표시 (이미 CTA 포함)

### MediScan 프로젝트
- /home/jay/projects/mediscan/ 미존재
- 소개/안내 페이지만 생성, 실제 서비스 연동은 추후

## 참조 자료

- 네비게이션 설정: `src/components/navigation/navigationConfig.ts`
- 라우트 설정: `src/config/routes.ts`
- 기능 맵: `src/config/planFeatureMap.ts`
- 접근 제어: `src/components/FeatureGate.tsx`, `src/components/PlanGuard.tsx`
- 기존 인슈위키: `src/pages/InsuWikiIntro.tsx`
- 가이드 페이지: `src/pages/HelpGuide.tsx`

## 주의사항

- InsuWikiIntro → 경로 변경 시 기존 "/insuwiki-intro" 링크 깨짐 주의
- domainTabs(TopNavBar)와 routes(사이드바) 양쪽 모두 업데이트 필요
- HelpGuide의 목차는 DB 기반이므로 SIDEBAR_MENU_URLS/SIDEBAR_SECTION_ORDER만 변경