docs: skill-email UUID 불일치 문제 문서화 및 기존 문서 업데이트

- 새 문서: 250831_skill-email_UUID_inconsistency_URGENT.md
- rb8001이 UUID 전달, skill-email이 Slack ID 기대하는 문제
- 기존 문서들에 경고 메시지 추가
- UUID Primary Key 통일 방안 제시
This commit is contained in:
Claude-51124 2025-08-31 21:49:07 +09:00
parent a0ead913f3
commit 45da54962b
3 changed files with 58 additions and 1 deletions

View File

@ -3,12 +3,14 @@
## 날짜: 2025-08-22 (수정: 2025-08-28) ## 날짜: 2025-08-22 (수정: 2025-08-28)
## 작성자: happybell80 & Claude ## 작성자: happybell80 & Claude
## 관련 서비스: robeing-monitor, robeing-gateway, skill-email ## 관련 서비스: robeing-monitor, robeing-gateway, skill-email
## 상태: 51123 매핑 API 사용 중 (UUID5 중단됨) ## 상태: ⚠️ 부분 해결 (rb8001 미수정 - 2025-08-31)
--- ---
## 1. 문제 상황 요약 ## 1. 문제 상황 요약
**⚠️ 2025-08-31 업데이트**: rb8001 → skill-email UUID 전달 문제 지속. [250831_skill-email_UUID_inconsistency_URGENT.md](./250831_happybell80_skill-email_UUID_inconsistency_URGENT.md) 참조
### 초기 발견 ### 초기 발견
- 프론트엔드에서 Gmail 아이템 조회 시 빈 결과 반환 - 프론트엔드에서 Gmail 아이템 조회 시 빈 결과 반환
- robeing-monitor API 직접 호출은 정상 작동 - robeing-monitor API 직접 호출은 정상 작동

View File

@ -3,6 +3,8 @@
## 개요 ## 개요
2025년 8월 25일, Gmail 토큰 조회 시스템을 UUID 변환 방식에서 Slack ID 직접 사용 방식으로 마이그레이션했습니다. 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) 참조
## 문제 상황 ## 문제 상황
### 기존 시스템의 문제점 ### 기존 시스템의 문제점

View File

@ -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 지원 확인
- [ ] 테스트 및 배포