# task-2067 완료 보고서: InsuRo 이용 가이드 안내 문구 전수조사 + 메뉴 구조 sync

**팀**: dev2-team (오딘)
**작업일**: 2026-04-22
**레벨**: critical
**프로젝트**: insuro

---

## SCQA

**S**: InsuRo의 메뉴 구조가 1차원(좌측 메뉴만)에서 2차원(상단 메뉴 4개 + 좌측 섹션)으로 변경되었으며, guide_sections 테이블에 25개 섹션의 이용 가이드가 저장되어 있다.

**C**: 25개 섹션 중 7개 섹션의 steps 안내 문구가 이전 1차원 구조("좌측 메뉴에서...", "좌측 메뉴 유용한도구 →")로 작성되어 있어 사용자가 실제 UI에서 기능을 찾을 수 없다.

**Q**: 25개 guide_sections의 steps를 현재 2차원 메뉴 구조와 동기화하여 불일치 0건을 달성할 수 있는가?

**A**: navigationConfig.ts 기준 메뉴 매핑을 수행하고, 불일치 7개 섹션(총 8개 step)의 DB 업데이트를 완료. 잔여 1차원 표현 0건 확인. 코드 수정 없이 Supabase DB만 업데이트하여 즉시 반영.

---

## 작업 내역

### 1. 메뉴 구조 매핑 (25개 전수)

상단 메뉴 4개와 각 좌측 섹션 매핑 완료 (navigationConfig.ts 기준):
- **고객관리**: 대시보드, 고객 목록, 파이프라인, 메신저, 디지털 명함
- **AI 마케팅**: AI 키워드 분석, AI 콘텐츠 작성, 콘텐츠 관리, AI 원스탑 포스팅, AI 포스팅 자동화
- **분석 & 도구**: 소식지분석, 보험료/환급률 분석, 보험사 전산정보, 각종 계산기, 외부 참고 사이트
- **안내 & 설정**: 인슈로 소개, 이용방법/가이드, API키, 금소법, 공지/커뮤니티, 마이페이지, 개인 설정, 플랜 & 구독

### 2. 25개 섹션별 상태

**수정됨 (7개, 8 steps):**
- AI 키워드 분석: step[0] `좌측 메뉴 "AI 키워드 분석"` → `상단 'AI 마케팅' 메뉴 > 좌측 'AI 키워드 분석'`
- 매월 소식지분석 AI: step[0] `좌측 메뉴 "매월 소식지분석 AI"` → `상단 '분석 & 도구' 메뉴 > 좌측 '소식지분석'`
- 보험사 전산정보: step[0] `좌측 메뉴 유용한도구 → "보험사 전산정보"` → `상단 '분석 & 도구' 메뉴 > 좌측 '보험사 전산정보'`
- 보험료/환급률 분석 AI: step[0] `좌측 메뉴 "보험료/환급률 분석 AI"` → `상단 '분석 & 도구' 메뉴 > 좌측 '보험료/환급률 분석'`
- API 키 등록: step[0] + step[2] 수정 (2개 step)
- AI 콘텐츠 작성: step[0] `좌측 메뉴 "AI 콘텐츠 작성"` → `상단 'AI 마케팅' 메뉴 > 좌측 'AI 콘텐츠 작성'`
- 외부 참고 사이트: step[0] `좌측 메뉴 유용한도구 → "외부 참고 사이트"` → `상단 '분석 & 도구' 메뉴 > 좌측 '외부 참고 사이트'`

**일치 (이미 올바름, 10개):**
- 시작하기, 고객 목록, AI 카드뉴스, 메신저, 상담 녹음, AI 고객 분석, 인슈위키, 정보성 키워드 분석, 요금제 안내, 콘텐츠 캘린더

**steps 빈 배열 (8개, 수정 불필요):**
- CRM 대시보드, 금소법 가이드, 각종 계산기, 공지/커뮤니티, 영업 파이프라인, 마이페이지, 콘텐츠 관리, 디지털 명함

---

## 수정 파일별 검증 상태

이 작업은 코드 수정이 아닌 Supabase DB 업데이트이므로 파일 검증 대신 DB 검증을 수행.

| 섹션 | ID | 수정 step | DB 검증 | 상태 |
|------|-----|-----------|---------|------|
| AI 키워드 분석 | e3fc34f2 | step[0] | "상단" 포함 확인 | verified |
| 매월 소식지분석 AI | 35cb604b | step[0] | "상단" 포함 확인 | verified |
| 보험사 전산정보 | 410469e7 | step[0] | "상단" 포함 확인 | verified |
| 보험료/환급률 분석 AI | 21c2f530 | step[0] | "상단" 포함 확인 | verified |
| API 키 등록 | 1471f422 | step[0], step[2] | "상단" 포함 확인 | verified |
| AI 콘텐츠 작성 | 6503c4a9 | step[0] | "상단" 포함 확인 | verified |
| 외부 참고 사이트 | d359c80e | step[0] | "상단" 포함 확인 | verified |

---

## L1 스모크테스트 결과

- 서버 재시작: 해당없음 (코드 수정 없음, DB만 업데이트)
- API 응답 확인: Supabase DB 직접 조회로 7개 섹션 전체 수정 반영 확인. 잔여 1차원 표현 0건.
- 스크린샷: 해당없음 (insuro.biz/guide 페이지는 로그인 필요, DB 직접 검증으로 대체)

---

## 발견 이슈 및 해결

### 자체 해결 (3건)

1. **API 키 등록 섹션 step[2]도 수정 필요** — step[0]뿐 아니라 step[2]에도 "개인 설정"이 메뉴 경로 없이 참조됨. 동시 수정 완료.
2. **매월 소식지분석 AI의 UI 표시명 불일치** — DB 제목은 "매월 소식지분석 AI"이나 UI 메뉴는 "소식지분석". step에는 UI 표시명("소식지분석")을 사용하여 정합성 확보.
3. **steps 데이터 타입 처리** — steps 배열 요소가 단순 string 타입으로 저장되어 있어 dict 처리 로직에서 오류 발생. str/dict 양쪽 모두 처리하도록 스크립트 수정.

### 범위 외 미해결 (1건)

1. **steps가 빈 8개 섹션의 콘텐츠 미작성** — 범위 외 사유: 별도 콘텐츠 기획 작업 필요. CRM 대시보드, 금소법, 각종 계산기, 공지/커뮤니티, 파이프라인, 마이페이지, 콘텐츠 관리, 디지털 명함.

---

## 게이트 검증 결과

- G1 설계 게이트: Codex 게이트 체크 PASS (마아트 폴백)
- G1 3 Step Why: A→B→C 논리적 일관성 확인 (context-notes.md 기록 완료)
- 3문서 업데이트: plan.md/context-notes.md/checklist.md 모두 completed

---

## 머지 판단

- **머지 필요**: No (코드 수정 없음, DB 업데이트만 수행)
- **워크트리**: 생성하지 않음 (코드 수정 없음)

---

## 모델 사용 기록

- 팀원: 토르(백엔드) / 작업 내용: guide_sections DB 업데이트 스크립트 작성 및 실행 / 사용 모델: sonnet / 정당성: -

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


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


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


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


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