DOCS/journey/troubleshooting/250919_naverworks_slack_02_daily_briefing.md

NAVER WORKS → Slack 연동 [2/3] 일일 브리핑

날짜: 2025-09-19 (구현: 2025-09-23)

작성자: Claude / happybell80

관련 서비스: rb8001, skill-email, skill-slack

상태: 구현 완료, 테스트 진행 중

---

1. 일일 브리핑 개요

목적

회사 대표메일 중요사항을 매일 아침 자동으로 요약하여 Slack 지정 채널에 브리핑

핵심 기능

• 최근 24시간 메일 전체 요약 (10개 제한 제거)
• AI 요약 생성
• 우선순위별 정렬
• Slack 지정 채널 자동 포스팅

---

2. 구현 방식

2.1 트리거 방식

• 매일 09:00 KST 자동 실행
• APScheduler 사용 (mon-fri 형식 권장)

2.2 처리 흐름

1. 09:00 스케줄러 트리거
2. DB에서 info@company-x.partners 계정 UUID 조회
3. skill-email /messages 호출 (provider=naverworks), 응답을 24시간(receivedTime) 기준 클라이언트 필터
4. 중요 메일 필터링 (긴급/계약/결제/공지)
5. Gemini 요약 생성
6. SlackFormatter.briefing()으로 포맷팅
7. skill-slack /api/v1/send로 채널 전송 (C09C98KK2TT)

---

3. 구현 파일 구조

첫 구현 (최소)

• app/scheduler/jobs/naverworks_briefing.py: register(scheduler) 함수와 로깅 래퍼
• app/skills/naverworks_briefing.py: 실제 브리핑 로직
• main.py: 2줄 추가 (import + register 호출)

나중 확장

• app/formatters/slack_formatter.py: 다른 스킬과 공유 시
• app/scheduler/registry.py: 스케줄 2개 이상일 때

---

4. 구현 체크리스트

4.1 최소 구현

• app/scheduler/jobs/ 디렉토리 생성
• naverworks_briefing.py 파일 (등록 + 래퍼)
• main.py 2줄 추가

4.2 브리핑 로직

• app/skills/naverworks_briefing.py 생성
• register() 함수: 환경변수 읽기, 스케줄 등록
• 래퍼 함수: 로그 추가 ("Running job" 이슈 해결)
• DB 조회: info@company-x.partners UUID
• 중요 메일 필터: 긴급/계약/결제/공지
• 통합: skill-email, Gemini, skill-slack

---

5. 구현 원칙

• 최소 변경: main.py 2줄만, 기존 코드 유지
• 단순 구조: register(scheduler) 하나, 환경변수는 함수 내부
• 로그 해결: 래퍼 함수로 "Running job" 추가
• 점진 확장: 작동 확인 후 registry, formatter 추가

6. 구현 준비도 (90%)

확인된 사항

• skill-email: NaverWorksProvider 구현 완료, 토큰 갱신 로직 존재
• skill-slack: /api/v1/send 엔드포인트 구현 완료 (API 키 인증 없음)
• DB 접근: DATABASE_URL 환경변수, asyncpg 사용
• DB 데이터: naverworks_token 테이블에 user_id, account_id 저장됨
• NAVER WORKS API: /mail/mailfolders/0/children 엔드포인트 확인
• 24시간 필터: 목록 API는 날짜 파라미터 미지원 → 클라이언트(receivedTime) 기준 필터 필요
• LLM 서비스: process_request() 메서드, model="gemini-2.5-flash-lite", 필수 필드: message, user_id, robeing_id
• skill-slack: X-API-Key 헤더로 SERVICE_API_KEY 필요

필요 환경변수 (서버 설정)

• NAVERWORKS_BRIEFING_ENABLED=true
• NAVERWORKS_BRIEFING_CHANNEL_ID=C09C98KK2TT # _ID 붙여야 함!
• NAVERWORKS_BRIEFING_SCHEDULE="0 9 * * mon-fri" # 1-5 아님!
• COMPANYX_SLACK_BOT_TOKEN (Company-X 봇 토큰)
• SERVICE_API_KEY (skill-slack 인증용)

7. 참고

• DB 기반 스케줄러 관리
• 기본 구성 완료
• NAVER WORKS API 이슈 해결

8. 구현 내역 (2025-09-23)

생성 파일

• app/scheduler/jobs/naverworks_briefing.py: 스케줄러 등록 및 래퍼 함수
• app/skills/naverworks_briefing.py: 브리핑 비즈니스 로직
• app/state/database.py: get_naverworks_user_uuid() 추가
• test_naverworks_briefing.py: 테스트 스크립트
• main.py: 2줄 추가 (import + register)

주요 결정사항

• naverworks_token 테이블 직접 사용 (email_accounts 테이블 없음)
• DB 접근 로직은 database.py에 위치
• 하드코딩 없이 에러 발생으로 처리
• Company-X 봇 토큰 사용 (COMPANYX_SLACK_BOT_TOKEN)
• from 필드: NAVER WORKS API가 반환하는 {name, email} 객체 그대로 사용

⚠️ 치명적 실수 방지

• skill-email API: response.json().get("emails", []) (messages 아님!)
• Slack 마크다운: Gemini 응답의 ** → * 변환 필수
• 중요 메일 없을 때: 전체 메일 중 10개 사용 (return 하지 말 것)

테스트 명령

# 24서버에서 실행
python test_naverworks_briefing.py --test all