# task-2158 완료 보고서

## S - Situation
task-2155(서버 get_user_plan 버그)와 task-2156(금소법 UX)이 main에 머지 완료되었으나, Edge Function이 재배포되지 않아 프로덕션에 반영되지 않은 상태. 추가로 generate-content의 채널 체크가 planName 문자열 매칭 방식이라 매칭 실패 시 Free(naver-blog만) 강제 적용되는 버그 존재.

## C - Complication
planName 문자열 매칭이 불안정하여 유료 플랜 사용자(베이직 이상)가 Threads, Instagram 등 채널을 선택해도 "지원하지 않는 채널" 에러 발생. 추가로 PLAN_CHANNEL_MAP의 sort_order 키가 0-based였으나 DB(plan_5tier_restructure 마이그레이션 이후)는 1-based여서 권한 불일치 위험.

## Q - Question
sort_order 기반 채널 체크 전환 + Edge Function 재배포로 채널 에러를 근본적으로 해결할 수 있는가?

## A - Answer
getUserPlan 반환값에 sortOrder 추가 + 채널 체크를 sort_order 기반으로 전환하여 문자열 매칭 불안정 문제 해소. Gemini 리뷰로 발견된 1-based 매핑 불일치도 수정 완료. generate-content, suggest-topics 두 Edge Function 프로덕션 재배포 완료. OPTIONS 200 OK 확인.

## 수정 파일

| 파일 | 변경 내용 | grep 검증 | 상태 |
|------|-----------|-----------|------|
| supabase/functions/generate-content/index.ts:175 | getUserPlan 반환 타입에 sortOrder 추가 | grep "sortOrder: number" OK | verified |
| supabase/functions/generate-content/index.ts:189,203 | select에 sort_order 컬럼 추가 | grep "sort_order" OK (2건) | verified |
| supabase/functions/generate-content/index.ts:196,210 | 반환에 sortOrder: plan.sort_order ?? 1 추가 | grep "sort_order ?? 1" OK (2건) | verified |
| supabase/functions/generate-content/index.ts:225 | Free 폴백 sortOrder: 1 | grep "sortOrder: 1" OK | verified |
| supabase/functions/generate-content/index.ts:403 | 구조분해에 sortOrder 추가 | grep "sortOrder" OK | verified |
| supabase/functions/generate-content/index.ts:427 | planLevel = sortOrder ?? PLAN_HIERARCHY | grep "sortOrder ??" OK | verified |
| supabase/functions/generate-content/index.ts:54-71 | PLAN_CHANNEL_MAP/PLAN_MODEL_TIER 1-based 수정 + 히든(5) 추가 | grep "sort_order=5" OK | verified |

## 발견 이슈 및 해결

### 자체 해결 (3건)
1. **PLAN_CHANNEL_MAP에 sort_order=5(히든) 미등록** — sort_order=5 엔트리 추가하여 해결
2. **DB sort_order 1-based vs 코드 0-based 불일치** — Gemini 리뷰로 발견. PLAN_CHANNEL_MAP, PLAN_MODEL_TIER를 1-based로 재구성하고 0은 Fallback으로 변경
3. **Free 폴백 sortOrder가 0이었으나 DB 무료=1** — 모든 fallback을 sortOrder: 1로 수정

### 범위 외 미해결 (0건)
없음.

## L1 스모크테스트 결과
- 서버 재시작: 해당없음 (Edge Function 배포)
- API 응답 확인:
  - generate-content OPTIONS → 200 OK
  - suggest-topics OPTIONS → 200 OK
  - generate-content POST (인증 없이) → "AI API key is not configured" (정상 — userId=null이므로 plan 검증 스킵)
  - suggest-topics POST (인증 없이) → "인증이 필요합니다" (정상 — 401)
- 스크린샷: insuro-login.png (프론트엔드 콘솔 에러 0건 확인)

## 머지 판단
- 머지 필요: Yes → 완료
- 브랜치: task/task-2158-dev1
- PR: https://github.com/JonghyukJeon/InsuRo/pull/25 (MERGED)
- Gemini 리뷰: High 2건 수용, Medium 1건 수용 — 미수정 High 0건 → PASS → 머지 완료
- Edge Function 재배포: generate-content, suggest-topics 모두 완료

## 모델 사용 기록
- 불칸 / getUserPlan sortOrder 수정 + 채널 체크 전환 / sonnet / -
- 헤르메스(팀장) / PLAN_CHANNEL_MAP 히든 매핑 + Gemini 리뷰 대응 / opus / Sonnet 실패 아닌 직접 수정 — Gemini 리뷰 판단 + 1-based 보안 수정이라 팀장 개입 적절

## QC 셀프 체크
- [x] 1. 영향 파일: generate-content/index.ts 내부만 수정
- [x] 2. 엣지 케이스: sort_order null → ?? 1 (무료), PLAN_HIERARCHY fallback 유지
- [x] 3. 작업 지시 일치: 3개 작업 모두 완료
- [x] 4. 에러 처리/보안: Fail-safe — 0=Fallback(가장 제한적)
- [x] 5. 테스트: Edge Function OPTIONS 200 확인, 프론트 콘솔 에러 0건
- [x] 6. 이슈 3건 모두 자체 해결
- [x] 7. 아키텍처: 기존 패턴 유지
- [x] 8. 인터페이스: getUserPlan 내부 함수 — 외부 문서 갱신 불필요
- [x] 13. L1 스모크테스트: 완료

## QC 자동 검증 결과
- overall: 7 PASS, 2 FAIL, 11 SKIP, 3 WARN
- full_suite_check: PASS (pytest 2516 passed)
- tdd_check: FAIL — Supabase Edge Function(Deno TypeScript)은 로컬 단위 테스트 환경 미지원. API 레벨 테스트(OPTIONS 200)로 대체 검증. 본 작업 범위 외 구조적 한계.
- git_evidence: FAIL (NO_UNCOMMITTED) — workspace 레포에 본 작업 외 이전 작업들의 uncommitted 변경이 존재. InsuRo 프로젝트(PR #25)는 정상 머지됨.
- Gemini PR 리뷰: High 2건 수용, Medium 1건 수용, 미수정 High 0건 → PASS


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