DOCS/journey/troubleshooting/260205_뉴스브리핑_LangGraph_전환.md

뉴스 브리핑 LangGraph 전환 완료

날짜: 2026-02-05 작성자: happybell80 관련 파일: rb8001/app/services/skills/startup_news_skill.py:1-15, rb8001/app/services/workflows/headlines_workflow.py:1-265, rb8001/tests/test_headlines_workflow.py:1-164

---

문제 상황

• 뉴스 브리핑이 다단계 처리인데 일반 함수로만 구현되어 추적성과 복구성이 부족함
• 단계별 실패 지점을 분리 기록하기 어려움

해결 방안

• LangGraph 워크플로우로 수집→동남아 삽입→용어 추출→포맷→전송을 단계화
• 체크포인터 기반 thread_id로 실행 상태 추적
• TDD로 정상/SEA 실패/용어 스킵/Slack 실패 시나리오 검증

구현 완료

• 커밋: 91fb6ad (2026-02-05)
• 배포 확인: docker ps에서 rb8001 컨테이너 재기동 및 healthy 확인

교훈

• 다단계 처리 로직은 LangGraph로 분리해야 추적성과 복구성이 확보됨
• 워크플로우 전환 시 기존 출력 포맷을 유지하는 테스트가 필수