# 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 검증 (배포 후)

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

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

### 6.3 검증 항목

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