# task-2285 완료 보고서

## SCQA

**S**: InsuRo 소식지/보험료 파일 업로드 시 Vision(이미지→텍스트) 추출에 Claude haiku 모델을 사용 중이다.

**C**: haiku 모델의 인식 정확도가 낮아 보험 용어 오인식이 다수 발생한다 (강신장→갱신형, 더핏→더블 등). 이로 인해 소식지 데이터의 신뢰성이 저하된다.

**Q**: Vision 모델을 sonnet으로 업그레이드하고, 복잡한 문서는 opus 선택이 가능하도록 개선할 수 있는가?

**A**: Vision 관련 haiku 3곳을 sonnet 기본값으로 변경하고, vision_model 파라미터를 추가하여 sonnet/opus 선택이 가능하게 구현 완료. 비-Vision 용도 haiku 5곳은 유지. npm build 성공, 서버 재시작 정상, OpenAPI 스키마에 vision_model 필드 확인 완료.

## 수정 파일 목록

| 파일 | 변경 내용 | grep 검증 | 상태 |
|------|-----------|-----------|------|
| server/main.py:155 | ParsePremiumFileRequest에 vision_model 필드 추가 | grep "vision_model" OK (13곳) | verified |
| server/main.py:3991 | _vision_extract_batch에 vision_model 파라미터 추가 | grep "vision_model" OK | verified |
| server/main.py:4020 | haiku→vision_model 변경 (단일 페이지 Vision) | grep '"--model", vision_model' OK | verified |
| server/main.py:4051 | haiku→vision_model 변경 (배치 Vision) | grep '"--model", vision_model' OK | verified |
| server/main.py:4086 | _run_vision_batches에 vision_model 파라미터 추가 | grep "vision_model" OK | verified |
| server/main.py:4166 | _smart_parse_file에 vision_model 파라미터 추가 | grep "vision_model" OK | verified |
| server/main.py:4243 | haiku→vision_model 변경 (PPTX vision) | grep '"--model", vision_model' OK | verified |
| server/main.py:4266 | _run_vision_batches 호출에 vision_model 전달 | grep "vision_model=vision_model" OK | verified |
| server/main.py:4390 | auto 모드 _run_vision_batches 호출에 vision_model 전달 | grep "vision_model=vision_model" OK | verified |
| server/main.py:4492 | parse_premium_file에서 vision_model 전달 | grep "vision_model=req.vision_model" OK | verified |
| server/main.py:4560 | upload_to_drive에 vision_model Form 파라미터 추가 | grep 'vision_model.*Form' OK | verified |
| server/main.py:4620 | upload_to_drive에서 vision_model 전달 | grep "vision_model=vision_model" OK | verified |
| src/pages/AdminNewsletters.tsx:66 | visionModel state 추가 | grep "visionModel" OK (4곳) | verified |
| src/pages/AdminNewsletters.tsx:113 | formData에 vision_model append | grep "vision_model" OK | verified |
| src/pages/AdminNewsletters.tsx:473-493 | Vision 모델 선택 UI (조건부 표시) | grep "visionModel" OK | verified |
| src/pages/AdminPremiumData.tsx:74 | visionModel state 추가 | grep "visionModel" OK (4곳) | verified |
| src/pages/AdminPremiumData.tsx:126 | formData에 vision_model append | grep "vision_model" OK | verified |
| src/pages/AdminPremiumData.tsx:175 | parse-premium-file body에 vision_model 추가 | grep "vision_model" OK | verified |
| src/pages/AdminPremiumData.tsx:518-538 | Vision 모델 선택 UI (조건부 표시) | grep "visionModel" OK | verified |

## 변경하지 않은 haiku (의도적 유지 5곳)

| 라인 | 용도 | 유지 사유 |
|------|------|-----------|
| 968 | 금소법 검증 (한국법률 MCP) | Vision 아님 — 법률 텍스트 검증 |
| 1053 | JSON 파싱 | Vision 아님 — 데이터 구조 파싱 |
| 4329 | PPTX auto 모드 처리 | Vision 아님 — 일반 텍스트 추출 (비용 절감) |
| 4428 | 메타데이터 보강 | Vision 아님 — 간단한 JSON 추출 |
| 4736 | 비-Vision 스트리밍 호출 | Vision 아님 — 텍스트 처리 |

## L1 스모크테스트 결과

- 서버 재시작: 성공 (PID 2810743, 포트 8001)
- API 응답 확인: OpenAPI 스키마 조회 성공 — ParsePremiumFileRequest.vision_model (default: sonnet) 확인, upload-to-drive vision_model 필드 확인
- 빌드 결과: npm run build 성공 (12.48s, dist 생성)
- Python 문법 검사: ast.parse PASS
- 스크린샷: 해당없음 (백엔드 중심 작업, 프론트 UI는 조건부 표시로 빌드 검증으로 대체)

## 발견 이슈 및 해결

### 자체 해결 (1건)
1. **TS 미사용 경고 (AdminPremiumData.tsx)**: visionModel/setVisionModel이 조건부 렌더링 내부에서만 사용되어 TS 정적 분석이 "declared but never read" 경고 발생 — 실제로는 JSX 내부에서 정상 사용 중이며 빌드에 영향 없음 (기존 TS 패턴과 동일)

### 범위 외 미해결 (1건)
1. **main.py:218 DeprecationWarning (on_event)** — 범위 외 사유: 기존 코드의 FastAPI deprecated API 사용. 별도 리팩토링 태스크 필요

## 모델 사용 기록

- 루(Lugh) / 백엔드 수정 (서버 Vision 모델 변경 + 파라미터 추가) / sonnet
- 브리짓(Brigid) / 프론트엔드 수정 (Vision 모델 선택 UI 추가) / sonnet

## QC 참고

- full_suite_check: pytest 2524 passed, 0 failed (94.81s)
- git 커밋: 2건 완료 (InsuRo 프로젝트 내, 69b043e, f232550)
- 빌드: npm run build 성공 (12.48s)