# task-2279 완료 보고서

## S - Situation
InsuRo 콘텐츠 생성 기능에서 금소법(금융소비자보호법) 검증이 "warn" 판정을 반환할 때, 수정 제안이 텍스트로만 표시되어 사용자가 직접 콘텐츠를 수정해야 했다.

## C - Complication
사용자가 금소법 위반 콘텐츠를 어떻게 수정해야 하는지 가이드가 불충분하여, warn 판정 후 이탈하거나 위반 콘텐츠를 그대로 사용하는 리스크가 있었다. 원본과 수정본 간 이력 추적도 불가했다.

## Q - Question
금소법 수정 제안을 자동 반영하여 콘텐츠를 재생성하고, 원본/수정본 이력을 추적할 수 있는가?

## A - Answer
`POST /api/insuro/revise-content` 엔드포인트 + 프론트엔드 체크박스 선택 UI + 원본/수정본 탭 전환 + 버전 체인 히스토리를 구현하여 해결. npm run build 성공 (12.38s), 서버 정상 기동, API 인증 검증 통과.

## 수정 파일별 검증 상태

| 파일 | 변경 내용 | grep 검증 | 상태 |
|------|-----------|-----------|------|
| /home/jay/projects/InsuRo/.worktrees/task-2279-dev2/supabase/migrations/20260428000000_contents_parent_id.sql | parent_id 컬럼 + 인덱스 마이그레이션 | grep "parent_id" OK | verified |
| /home/jay/projects/InsuRo/.worktrees/task-2279-dev2/src/integrations/supabase/types.ts | contents Row/Insert/Update에 parent_id 추가 | grep "parent_id" OK (5건) | verified |
| /home/jay/projects/InsuRo/.worktrees/task-2279-dev2/server/main.py | ReviseContentRequest + revise-content + content_id | grep "ReviseContentRequest" OK | verified |
| /home/jay/projects/InsuRo/.worktrees/task-2279-dev2/server/generation_queue.py | content_id 프로퍼티 추가 | grep "content_id" OK | verified |
| /home/jay/projects/InsuRo/.worktrees/task-2279-dev2/server/ai_queue.py | AIJob에 content_id 필드 추가 | grep "content_id" OK | verified |
| /home/jay/projects/InsuRo/.worktrees/task-2279-dev2/src/pages/Generate.tsx | 수정 UI + 탭 전환 + handleComplianceRevision | grep "handleComplianceRevision" OK | verified |
| /home/jay/projects/InsuRo/.worktrees/task-2279-dev2/src/components/ContentHistoryTab.tsx | 버전 체인 그룹화 + 금소법 수정 배지 | grep "groupedItems" OK | verified |

## 발견 이슈 및 해결

### 자체 해결 (3건)
1. **generate-status에 content_id 미노출** — GenerationJob에 content_id 프로퍼티 추가, AIJob dataclass에 content_id 필드 추가
2. **contents insert 후 content_id 미저장** — main.py:1424에서 job.content_id = str(content_id) 추가
3. **ContentHistoryTab 고아 자식 처리** — parent_id가 있지만 원본이 filtered에 없는 경우 독립 표시 로직 추가

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

## L1 스모크테스트 결과
- 서버 재시작: 성공 (uvicorn, port 5001)
- API 응답 확인: GET /api/status → 200 {"status": "ok"}
- API 인증 확인: POST /api/insuro/revise-content (no JWT) → 401
- 빌드 결과: 성공 (12.38s, dist/ 생성 Apr 28 16:48)
- 스크린샷: 해당없음 (API 작업 위주, 프론트 dev 서버 미기동)

## 머지 판단
- **머지 필요**: Yes
- **브랜치**: task/task-2279-dev2
- **워크트리 경로**: /home/jay/projects/InsuRo/.worktrees/task-2279-dev2
- **머지 의견**: 빌드 성공, 서버 정상 기동, API 인증 검증 통과. DB 마이그레이션은 Supabase에 별도 적용 필요.

## 모델 사용 기록
- 팀원: 토르 / 작업 내용: revise-content 백엔드 엔드포인트 + content_id / 사용 모델: sonnet / 정당성: -
- 팀원: 프레이야 / 작업 내용: 금소법 수정 UI + 탭 전환 + 히스토리 / 사용 모델: sonnet / 정당성: -