diff --git a/troubleshooting/250822_happybell80_Gmail통합_UUID변환_문제해결.md b/troubleshooting/250822_happybell80_Gmail통합_UUID변환_문제해결.md index 9de8212..0604609 100644 --- a/troubleshooting/250822_happybell80_Gmail통합_UUID변환_문제해결.md +++ b/troubleshooting/250822_happybell80_Gmail통합_UUID변환_문제해결.md @@ -3,12 +3,14 @@ ## 날짜: 2025-08-22 (수정: 2025-08-28) ## 작성자: happybell80 & Claude ## 관련 서비스: robeing-monitor, robeing-gateway, skill-email -## 상태: 51123 매핑 API 사용 중 (UUID5 중단됨) +## 상태: ⚠️ 부분 해결 (rb8001 미수정 - 2025-08-31) --- ## 1. 문제 상황 요약 +**⚠️ 2025-08-31 업데이트**: rb8001 → skill-email UUID 전달 문제 지속. [250831_skill-email_UUID_inconsistency_URGENT.md](./250831_happybell80_skill-email_UUID_inconsistency_URGENT.md) 참조 + ### 초기 발견 - 프론트엔드에서 Gmail 아이템 조회 시 빈 결과 반환 - robeing-monitor API 직접 호출은 정상 작동 diff --git a/troubleshooting/250825_gmail_token_slack_id_migration.md b/troubleshooting/250825_gmail_token_slack_id_migration.md index dc53915..22da93b 100644 --- a/troubleshooting/250825_gmail_token_slack_id_migration.md +++ b/troubleshooting/250825_gmail_token_slack_id_migration.md @@ -3,6 +3,8 @@ ## 개요 2025년 8월 25일, Gmail 토큰 조회 시스템을 UUID 변환 방식에서 Slack ID 직접 사용 방식으로 마이그레이션했습니다. +**⚠️ 2025-08-31 업데이트**: rb8001이 여전히 UUID를 전달하는 문제 발견. [250831_skill-email_UUID_inconsistency_URGENT.md](./250831_happybell80_skill-email_UUID_inconsistency_URGENT.md) 참조 + ## 문제 상황 ### 기존 시스템의 문제점 diff --git a/troubleshooting/250831_happybell80_skill-email_UUID_inconsistency_URGENT.md b/troubleshooting/250831_happybell80_skill-email_UUID_inconsistency_URGENT.md new file mode 100644 index 0000000..efe1156 --- /dev/null +++ b/troubleshooting/250831_happybell80_skill-email_UUID_inconsistency_URGENT.md @@ -0,0 +1,53 @@ +# skill-email UUID 불일치로 인한 500 에러 - URGENT + +## 날짜: 2025-08-31 +## 작성자: happybell80 & Claude +## 관련 서비스: rb8001, skill-email +## 상태: 진행 중 +## 긴급도: 높음 (사용자 서비스 중단) + +--- + +## 1. 문제 발견 +- **증상**: "이메일 서비스 연결에 실패했습니다" 오류 +- **원인**: skill-email 500 Internal Server Error +- **로그**: `No equipped Gmail token found for user: 1e16e9d5-59f3-54da-a661-8abeabff4230` + +## 2. 근본 원인 +rb8001이 UUID를 전달하지만 skill-email은 Slack ID 기대: +``` +rb8001 → skill-email: UUID (1e16e9d5-...) +skill-email DB 조회: Slack ID로 저장됨 (U0925SXQFDK) +결과: 토큰 조회 실패 → 500 에러 +``` + +## 3. 역사적 맥락 +- 8/22: UUID5 변환 시도 → 네임스페이스 불일치 실패 +- 8/25: UUID 포기, Slack ID 직접 사용으로 전환 +- 8/31: rb8001은 여전히 UUID 전달 중 (미수정) + +## 4. 해결 방안 + +### 단기 해결 (즉시) +rb8001의 email_integration.py 수정: +- 이메일 조회 시: UUID → Slack ID 역변환 +- slack_user_mapping 테이블 활용 + +### 장기 해결 (권장) +**모든 내부 시스템 UUID Primary Key 통일**: +1. gmail_tokens 테이블 user_id를 UUID로 마이그레이션 +2. skill-email UUID 조회 지원 +3. Slack ID는 매핑 테이블에서만 관리 + +## 5. 영향 범위 +- Gmail 관련 모든 기능 작동 불가 +- 이메일 조회, 발송, 일일 요약 등 + +## 6. 참조 문서 +- [250825_gmail_token_slack_id_migration.md](./250825_gmail_token_slack_id_migration.md) +- [250822_happybell80_Gmail통합_UUID변환_문제해결.md](./250822_happybell80_Gmail통합_UUID변환_문제해결.md) + +## 7. Action Items +- [ ] rb8001 email_integration.py UUID → Slack ID 변환 추가 +- [ ] skill-email UUID 지원 확인 +- [ ] 테스트 및 배포 \ No newline at end of file