From 4ee8e849a893ac36562bd139041efda32f6b9c13 Mon Sep 17 00:00:00 2001 From: happybell80 Date: Sat, 23 Aug 2025 09:51:59 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20=EC=9D=BC=EC=9D=BC=20=EB=B8=8C=EB=A6=AC?= =?UTF-8?q?=ED=95=91=20=EB=8D=B0=EB=AA=A8=20=EA=B3=84=ED=9A=8D=20=EC=88=98?= =?UTF-8?q?=EC=A0=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 이메일 브리핑 → 일일 브리핑으로 변경 - Slack DM 및 일반 채널 전송 명시 - 브리핑 메시지 예시 추가 (비즈니스형 스타일) - 불필요한 추측성 내용 제거 - 오전 9시 기능을 오후 4시에 테스트 명확화 --- plans/250823_4pm_email_briefing_demo_plan.md | 139 +++++++++++-------- 1 file changed, 79 insertions(+), 60 deletions(-) diff --git a/plans/250823_4pm_email_briefing_demo_plan.md b/plans/250823_4pm_email_briefing_demo_plan.md index 4e9db13..6720ad4 100644 --- a/plans/250823_4pm_email_briefing_demo_plan.md +++ b/plans/250823_4pm_email_briefing_demo_plan.md @@ -1,7 +1,7 @@ -# 오후 4시 이메일 브리핑 자동화 데모 계획 +# 오후 4시 일일 브리핑 자동화 데모 계획 ## 작성일: 2025-08-23 -## 목표 시간: 2025-08-23 16:00 +## 목표 시간: 2025-08-23 16:00 (오전 9시 기능을 4시에 테스트) ## 작성자: 51123 서버 관리자 --- @@ -9,15 +9,15 @@ ## 1. 데모 개요 ### 1.1 핵심 목표 -- **매일 오후 4시 정각** 각 사용자의 Gmail을 자동으로 읽고 요약 -- 이메일을 중요도별로 분류 (긴급/중요/일반) -- Slack DM과 웹 프론트엔드에 동시 전송 -- 3명의 사용자 동시 테스트 +- **매일 오전 9시** 일일 브리핑 자동 전송 (오늘은 4시 테스트) +- 개인별 맞춤 브리핑을 **Slack DM**으로 전송 +- 회사 전체 요약을 **일반 채널**에 전송 +- 날짜, Slack 요약, 이메일, 일정, 날씨, 응원 메시지 포함 ### 1.2 성공 기준 - ✅ 오후 4시 정각 자동 실행 (수동 트리거 없음) -- ✅ 3명 사용자 개별 이메일 요약 생성 -- ✅ Slack DM 자동 전송 +- ✅ 3명 사용자 개별 Slack DM 전송 +- ✅ 일반 채널 전체 브리핑 전송 - ✅ 웹 대시보드 실시간 업데이트 --- @@ -35,16 +35,57 @@ | 51124 | robeing-monitor | 9024 | Gmail 토큰 관리 | ### 2.2 데이터 흐름 -1. rb8001 컨테이너에서 스케줄러 실행 -2. skill-email 서비스 호출하여 이메일 수집 -3. 이메일 요약 생성 -4. Slack API 및 프론트엔드로 전송 +1. rb8001 컨테이너에서 스케줄러 실행 (16:00) +2. 각 사용자별 데이터 수집 + - Slack 대화 내역 + - Gmail 이메일 + - 일정 정보 + - 날씨 API +3. 개인별 브리핑 생성 및 DM 전송 +4. 전체 요약 생성 및 일반 채널 전송 --- -## 3. 시퀀스 다이어그램 +## 3. 브리핑 메시지 형식 -### 3.1 오후 4시 자동 실행 시퀀스 +### 3.1 개인 DM 브리핑 예시 +``` +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ +📅 2025년 8월 23일 금요일 브리핑 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ + +💬 어제의 Slack (3건) +• [긴급] 희재님: "내일 4시 데모 준비 완료 필요" +• [일반] 한용님: "서버 모니터링 정상" +• [완료] CEO: "OAuth 이슈 해결됨" + +📧 받은 메일 (5건) +• 🔴 긴급: AWS 결제 알림 - 8/25 만료 예정 +• 🟡 중요: 투자사 미팅 일정 확인 요청 +• ⚪ 일반: 뉴스레터 3건 + +📋 오늘 일정 +• 10:00 - 스탠드업 미팅 +• 14:00 - 코드 리뷰 +• 16:00 - 데모 시연 ⭐ + +☀️ 서울 날씨: 맑음 28°C (미세먼지: 좋음) + +💪 "금요일입니다! 이번 주도 거의 다 왔어요. + 오늘 데모 성공적으로 마무리하고 주말 맞이해요!" +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ +``` + +### 3.2 일반 채널 전체 브리핑 +- 개인 정보 제외 +- 팀 전체 일정 중심 +- 공통 관심사 위주 + +--- + +## 4. 시퀀스 다이어그램 + +### 4.1 오후 4시 자동 실행 시퀀스 ```mermaid sequenceDiagram @@ -96,7 +137,7 @@ sequenceDiagram Note over Scheduler: 다음 실행: 16:00:00 +1일 ``` -### 3.2 이메일 분류 및 요약 프로세스 +### 4.2 브리핑 생성 프로세스 ```mermaid sequenceDiagram @@ -126,55 +167,54 @@ sequenceDiagram --- -## 4. 구현 체크리스트 +## 5. 구현 체크리스트 -### 4.1 51123 서버 (완료) +### 5.1 51123 서버 (완료) - [x] OAuth 로그인 시스템 - [x] JWT 인증 구현 - [x] Gateway UUID 변환 - [x] PostgreSQL 사용자 관리 -### 4.2 51124 서버 (진행 중) +### 5.2 51124 서버 (진행 중) - [ ] rb8001 스케줄러 구현 - - [ ] Python schedule 라이브러리 설치 - [ ] 16:00 트리거 설정 - - [ ] 사용자 목록 조회 로직 -- [ ] skill-email 요약 기능 - - [ ] Gmail API 연동 확인 - - [ ] 이메일 분류 로직 - - [ ] AI 요약 프롬프트 -- [ ] Slack DM 전송 - - [ ] Slack API 토큰 설정 - - [ ] DM 채널 ID 매핑 + - [ ] 사용자 목록 조회 +- [ ] 데이터 수집 + - [ ] Slack 대화 내역 + - [ ] Gmail 이메일 + - [ ] 날씨 정보 +- [ ] 브리핑 전송 + - [ ] Slack DM 개인 전송 + - [ ] 일반 채널 전체 전송 -### 4.3 프론트엔드 (확인 필요) +### 5.3 프론트엔드 (확인 필요) - [ ] JWT 헤더 전송 -- [ ] 실시간 업데이트 (폴링/WebSocket) -- [ ] 요약 표시 UI +- [ ] 브리핑 표시 UI --- -## 5. 테스트 시나리오 +## 6. 테스트 시나리오 -### 5.1 사전 준비 +### 6.1 사전 준비 1. 3명 사용자 Gmail OAuth 인증 완료 2. 각 사용자별 테스트 이메일 준비 3. Slack 워크스페이스 접속 -### 5.2 테스트 진행 +### 6.2 테스트 진행 | 시간 | 액션 | 예상 결과 | |------|------|----------| | 15:55 | 시스템 상태 확인 | 모든 서비스 정상 | | 15:58 | 테스트 이메일 발송 | Gmail 수신 확인 | | 16:00 | 자동 실행 | 스케줄러 트리거 | -| 16:01 | Slack 확인 | DM 수신 확인 | +| 16:01 | Slack DM 확인 | 개인 브리핑 수신 | +| 16:01 | 일반 채널 확인 | 전체 브리핑 수신 | | 16:01 | 웹 확인 | 대시보드 업데이트 | --- -## 6. 장애 대응 +## 7. 장애 대응 -### 6.1 예상 이슈 +### 7.1 예상 이슈 | 이슈 | 원인 | 대응 | |------|------|------| | 스케줄러 미실행 | 시간대 설정 | TZ 환경변수 확인 | @@ -182,7 +222,7 @@ sequenceDiagram | Slack 전송 실패 | API 제한 | 재시도 로직 | | 프론트엔드 미갱신 | 캐시 | 강제 새로고침 | -### 6.2 모니터링 포인트 +### 7.2 모니터링 포인트 - rb8001 컨테이너 로그 - skill-email 서비스 로그 - PostgreSQL 쿼리 로그 @@ -190,28 +230,7 @@ sequenceDiagram --- -## 7. 다음 단계 - -### 7.1 데모 후 개선사항 -- 이메일 필터링 옵션 -- 요약 커스터마이징 -- 시간대별 설정 -- 팀 단위 브리핑 - -### 7.2 확장 계획 -- 캘린더 연동 -- 작업 우선순위 제안 -- 자동 회신 기능 -- 다국어 지원 - --- -## 8. 연락처 - -- 51123 서버: 서버 관리자 -- 51124 서버: 개발팀 -- 긴급 상황: Slack #dev-emergency - ---- - -*이 문서는 2025-08-23 오후 4시 데모를 위한 실행 계획입니다.* \ No newline at end of file +*이 문서는 2025-08-23 오후 4시 데모를 위한 실행 계획입니다.* +*실제 서비스는 매일 오전 9시에 자동 실행됩니다.* \ No newline at end of file