---
task_id: task-2235
type: plan
scope: task
created: 2026-04-27
updated: 2026-04-27
status: completed
---

# 계획서: task-2235

**task**: task-2235
**목표**: InsuRo 고객 증권분석 기능 Phase 1 — 증권 PDF 업로드 → AI 분석 → 구조화 JSON/CSV 내보내기
**승인**: 헤르메스(개발1팀장) 2026-04-27

---

## 목표

보험 설계사가 고객 증권 PDF를 업로드하면, Claude AI가 표준 담보 리스트(v3.7)에 매핑하여 구조화된 분석 결과를 제공. 구글시트 양식 호환 JSON/CSV 내보내기 지원.

## 범위

### 포함
- CRM 사이드바에 "고객 증권분석" 메뉴 추가 (파이프라인과 메신저 사이)
- 증권분석 페이지 (고객정보 입력, PDF 업로드, 분석 결과 표시, 내보내기)
- 서버 엔드포인트 (analyze-policy, status, export-csv, export-json, policy-settings)
- 기본 담보 리스트 (7개 카테고리 ~50종)

### 제외 (다음 페이즈 이후)
- 담보 세팅 커스텀 UI (모달/페이지)
- PDF 보고서 생성
- Google Drive 연동
- Supabase 마이그레이션 (테이블 생성은 별도 관리)

## 위임 계획

- 백엔드: **불칸** — policy_analyzer.py + main.py 엔드포인트
- 프론트엔드: **이리스** — PolicyAnalysis.tsx + 네비게이션/라우트
- 통합/검증: **헤르메스** — lint 수정, 빌드 검증, L1 테스트

## 검증 기준

- npm run build → 성공 (12.55s)
- 서버 시작 → /api/status 200 OK
- 새 엔드포인트 → 401 (JWT 미인증 시 보호 확인)