---
task_id: task-1964
type: plan
scope: task
created: 2026-04-19
updated: 2026-04-19
status: completed
---

# 계획서: task-1964

**task**: task-1964
**목표**: CRM 대화 자동 요약 시스템 MVP 구현 (DB + API + UI)
**승인**: 아누 2026-04-19 "설계 문서 기반 구현"
**근거**: memory/research/insuro-chat-summary-design.md (680줄 설계 문서)

---

## 목표

보험 설계사-고객 채팅의 AI 자동 요약 시스템 MVP를 구현한다:
1. conversation_summaries, summary_topics 테이블 생성
2. 요약 생성/조회/검색 API 3개 구현
3. CRM 메신저에 "상담 종료" 버튼 추가
4. 고객 상세 페이지에 요약 히스토리 탭 추가

## 범위

### 포함
- DB migration (conversation_summaries, summary_topics, RLS, 인덱스)
- POST /api/insuro/conversations/{id}/summarize (haiku AI 요약)
- GET /api/insuro/customers/{id}/summaries (히스토리 조회)
- GET /api/insuro/summaries/search (키워드 검색)
- CrmMessenger "상담 종료" 버튼
- SummaryTab 컴포넌트 (날짜 그룹핑, 태그 표시, 검색, 페이지네이션)
- CrmCustomerDetail에 "요약" 탭 추가

### 제외 (Phase 2 이후)
- 벡터 검색 (pgvector 임베딩)
- Celery/Redis 비동기 큐
- 적응형 타임아웃 / 세션 재개 감지
- Haiku/Sonnet 티어링
- 증분 업데이트 (MapReduce)
- 에이전트 보정 UI (SummaryEditor)
- summary_jobs 테이블

## 위임 계획

- DB migration: **불칸(백엔드)** — Supabase SQL migration
- API 3개: **불칸(백엔드)** — FastAPI 엔드포인트
- UI 3개: **이리스(프론트엔드)** — React 컴포넌트

## 검증 기준

- tsc: `npx tsc --noEmit` → 에러 0건
- pytest: `python3 -m pytest tests/test_main.py` → 26 passed
- API 등록: OpenAPI spec에 3개 엔드포인트 존재
- 인증: 미인증 호출 시 401 반환