DOCS/journey/troubleshooting/251013_coldmail_ir_analyzer_fix.md

콜드메일 IR 분석 시스템 오류 수정

날짜: 2025-10-13 작성자: happybell80 관련 파일: rb8001/app/services/ir_analyzer.py

---

문제 상황

테스트 실행

• 경로: rb8001/tests/test_coldmail_briefing.py --test scheduler
• 결과: 3가지 에러 발생, Slack 전송 도달 실패

성공한 부분

1. 콜드메일 필터링: 30개 중 1건 탐지 (굿베이션 투자제안서, 확률 0.7755)
2. 첨부파일 다운로드: skill-email에서 PDF 다운로드 성공
3. skill-rag-file 업로드: document_id c9c9a7a8-18d3-475a-b14e-746e14c9e55c, 14 chunks 생성

---

에러 분석

에러 1: RAG 쿼리 404 (6회 발생)

원인:

• ir_analyzer.py:28 - /api/query 호출하지만 skill-rag-file은 /api/search 제공

수정:

• ir_analyzer.py:28: /api/query → /api/search
• ir_analyzer.py:29-32: payload에 team_id 추가, document_id 제거

에러 2: LLM 연결 실패

원인:

• ir_analyzer.py:15: localhost:8080 LLM 서비스 없음
• rb8001은 app/llm/llm_service.py 사용

수정:

• ir_analyzer.py:48-74: LLMService, LLMRequest로 전체 변경

에러 3: DB 제약조건 없음

원인:

• startup_valuation.py:249: ON CONFLICT 절 사용하나 UNIQUE 제약조건 미설정

수정:

• 51123 서버 DB: startup_valuation 테이블 UNIQUE 제약조건 추가

에러 4: Slack 전송 도달 불가

원인:

• coldmail_briefing.py:140-244: for loop에 try-except 없음
• coldmail_briefing.py:166: extract_ir_metrics() 예외 발생
• coldmail_briefing.py:170: valuate_startup() 예외 발생
• 172-244줄(Slack Lists, 피드백) 실행 안됨
• 246-259줄(요약 메시지) processed_count=0으로 전송 안됨

수정:

• coldmail_briefing.py:165-171: try-except로 감싸기
• 예외 시 logger.error() 후 continue로 다음 이메일 처리

---

해결 방안

우선순위 1: coldmail_briefing.py 에러 핸들링 추가 ✅

• 165-172줄: try-except로 감싸기
• 구현 완료: 9898479 (2025-10-13)

우선순위 2: ir_analyzer.py 수정 ✅

• query_rag():17-50: team_id로 변경, /api/search 사용
• call_llm():53-83: LLMService 사용
• extract_ir_metrics():86,126: team_id 파라미터 추가
• coldmail_briefing.py:169-170: user.team_id 조회 후 전달
• 구현 완료: 81d8442, 4de0424 (2025-10-13)

우선순위 3: DB 제약조건 추가 (수동 실행 필요)

51123 서버에서 실행:

ALTER TABLE startup_valuation
ADD CONSTRAINT startup_valuation_team_startup_unique
UNIQUE (team_id, startup_name);

---

교훈

API 엔드포인트 검증 부족

• 구현 시 skill-rag-file API 스펙 미확인
• 추측으로 /api/query 사용, 실제는 /api/search
• 교훈: 스킬 통합 전 API 문서 또는 코드 직접 확인 필수

LLM 서비스 중복 구현

• ir_analyzer가 독립 LLM 서비스 가정
• rb8001은 이미 LLM 서비스 내장
• 교훈: 기존 서비스 재사용 우선, 새 의존성 추가 지양