# LangGraph 1.0 업그레이드 계획

**날짜**: 2025-12-18
**작성자**: admin
**관련 파일**: `rb8001/app/services/workflows/coldmail_workflow.py`, `rb8001/requirements.txt`

---

## 현재 상황

- **현재 버전**: `langgraph==0.6.10`
- **사용 위치**: 콜드메일 워크플로우 (`coldmail_workflow.py`)
- **체크포인터**: `AsyncSqliteSaver` 사용 (수동 설정)

## LangGraph 1.0 주요 변경사항

1. **지속적인 상태 관리 (Durable State)**: 서버 재시작/중단 시 자동 재개
2. **내장된 지속성**: 워크플로우 저장/재개 기능 강화
3. **휴먼 인 더 루프 (HITL) 패턴**: 실행 일시 중지 후 인간 승인 API 제공
4. **그래프 기반 실행 모델 개선**: 결정론적/에이전트 컴포넌트 혼합 제어 강화

## Phase 1: 콜드메일 워크플로우 HITL 패턴 적용

**파일**: `rb8001/app/services/workflows/coldmail_workflow.py`
- `process_node`에서 HITL 패턴으로 일시 중지 → 사용자 승인 대기 → 재개
- "이 기업을 분석해 드릴까요?" 버튼을 워크플로우 내부에서 처리

## Phase 2: 프론트엔드 IR 평가 워크플로우화

**파일**: `rb8001/app/router/ir_deck.py`
- 프론트엔드 요청을 LangGraph 워크플로우로 처리
- 신규 워크플로우 생성 (HITL 없음)
- 공통 함수: `extract_ir_metrics()`, `evaluate_ir_deck()`, `save_evaluation()`

## Phase 3: 자동 상태 복구

**파일**: `rb8001/app/services/workflows/coldmail_workflow.py`
- LangGraph 1.0 자동 상태 관리 활용
- 체크포인터 수동 설정 제거

## 필요 작업

1. `requirements.txt`: `langgraph==0.6.10` → `langgraph>=1.0.0`
2. `coldmail_workflow.py` API 호환성 테스트
3. HITL 패턴 적용 (콜드메일 "분석할까요?" 버튼)
4. 프론트엔드 IR 평가 워크플로우화
5. 체크포인트 데이터 마이그레이션 스크립트 작성


## 참고

- LangGraph 공식 문서: https://github.com/langchain-ai/langgraph
- 현재 구현: `rb8001/app/services/workflows/coldmail_workflow.py`
- 관련 문서: `troubleshooting/251015_claude_coldmail_workflow_langgraph_test.md`