DOCS/journey/plans/archive/260121_naverworks_briefing_ux_개선.md

NAVER WORKS 일일 브리핑 UX 개선

날짜: 2026-01-21 작성자: Claude (51124 서버 전담) 관련 파일: rb8001/app/services/skills/naverworks_briefing.py

---

1. 현재 문제점

• "중요 메일 (0건)" + "중요 메일이 없습니다" 섹션이 대부분 0건으로 노출
• "중요 메일 0건, 전체 6건" 하단 요약이 헤더와 중복
• 사용자가 직접 메일 목록을 읽고 액션 아이템 판단 필요

2. 개선 목표

• 중요 메일 섹션 전체 제거 (키워드 기반 분류 신뢰도 낮음)
• 하단 요약 문구 제거 (헤더에 이미 건수 존재)
• LLM 1줄 인사이트 추가 ("회신 필요 1건, 안내/공지 5건" 형태)

3. 변경 사항

3.1 삭제 대상

위치	내용	이유
naverworks_briefing.py:59-61	_filter_important_emails() 호출	중요 메일 분류 제거
naverworks_briefing.py:64	중요 메일 요약 생성	불필요
naverworks_briefing.py:146-176	_filter_important_emails() 메서드	미사용
naverworks_briefing.py:285-291	Slack 블록 중요 메일 섹션	제거
naverworks_briefing.py:303-310	하단 요약 context 블록	헤더와 중복

3.2 추가 대상

위치	내용
naverworks_briefing.py:_generate_summary() 전	_generate_insight() 메서드 추가
naverworks_briefing.py:_format_slack_message()	인사이트 1줄 블록 추가 (헤더 바로 아래)

3.3 인사이트 프롬프트

역할: 비서
입력: 메일 목록 (발신자 + 제목)
출력 형식: "회신 필요 N건, 결제/청구 N건, 안내/공지 N건"
조건: 긴급 액션이 있으면 강조, 1줄로 요약
예시: "오후 2시까지 회신 필요 1건, 결제 안내 1건, 일반 공지 4건"

4. 변경 후 메시지 구조

NAVER WORKS 일일 브리핑
2026년 01월 21일 | info@company-x.partners
────────────────────────────
오후 2시까지 회신 필요 1건, 결제 안내 1건, 공지 4건  ← 인사이트 1줄
────────────────────────────
전체 메일 (6건)

• 피큐레잇 송석규: 2026년 새해 인사 및 소식 전달
• 태일회계법인: 검증보고서 확정 완료...
• (이하 생략)

5. 구현 순서

1. _filter_important_emails() 호출 및 메서드 삭제
2. _generate_insight() 메서드 추가 (발신자+제목만 전달)
3. _format_slack_message() 수정 (중요 메일 블록 제거, 인사이트 블록 추가)
4. pytest 테스트 작성 및 E2E 검증

6. 테스트 계획

6.1 pytest 자동 테스트 (필수)

파일	테스트 항목
tests/test_naverworks_briefing.py	_generate_insight() 출력 형식 검증
tests/test_naverworks_briefing.py	_format_slack_message() 블록 구조 검증

6.2 E2E 검증 (배포 후)

# 컨테이너 내부 pytest 실행
docker exec rb8001 pytest tests/test_naverworks_briefing.py -v

# 실제 Slack 전송 확인 (수동)
docker exec rb8001 python scripts/show_briefing.py

6.3 검증 항목

• 중요 메일 섹션 미노출
• 하단 요약 문구 미노출
• 인사이트 1줄 노출
• 전체 메일 목록 정상 노출