docs: clarify UUID-only + team mapping

journey/troubleshooting/250926_happybell80_UUID_원칙_위반_email_integration.md

@@ -50,9 +50,9 @@ else:
 ## 남은 작업
 
 ### skill-email 서비스 수정 필요
-1. **main.py**: UUID 검증 로직 추가
+1. **(완료) main.py / routers/**: `user_id`를 UUID로 강제 (비-UUID는 4xx)
-2. **db_credentials_provider.py**: Slack ID 처리 제거, UUID만 받기
+2. **(진행 필요) db_credentials_provider.py**: Slack ID 처리 제거, UUID만 받기
-3. **naverworks_provider.py**: UUID 검증 및 정규화
+3. **(완료) naverworks_provider.py**: UUID만 허용 (비-UUID는 에러)
 
 ### 영향 범위
 - rb8001: email_integration.py
@@ -79,4 +79,10 @@ else:
 
 ---
 
+## 2025-12-17 후속 업데이트
+- **skill-email**: `/messages`, `/messages/{id}`, `/attachments`의 `user_id`를 UUID로 강제 (문자열 이메일/Slack ID 입력은 차단)
+- **rb8001**: skill-email 호출부에서 `user_id(UUID)`를 전달하도록 정리 (비-UUID 입력 의존 제거)
+
+---
+
 **문서 끝**

journey/troubleshooting/251021_coldmail_list_email_column_override_and_langgraph_test.md

@@ -42,10 +42,10 @@
 - skill-slack의 `slackLists.items.list` 응답에 `columns` 메타가 제공되면 자동 식별 경로가 우선 적용되며, env는 강제 오버라이드로 동작.
 
 ## 추가 관찰(관련 이슈)
-- skill-email 목록 API 500(로그: `column "oauth_id" does not exist`) 발생 → 목록 조회는 임시로 건너뛰고 단건 상세/수동 주입으로 테스트 수행. 목록 API 스키마 정합성 수정 필요.
+- (해결) skill-email의 `user_id` 입력은 UUID로 강제하여 비-UUID 입력으로 인한 스키마/조회 오류를 차단.
+- (개선) skill-slack Lists 호출은 `X-Team-Id: <team_uuid>` 전달 시 DB(`slack_workspace`)에서 `slack_team_id`를 조회해 사용 (멀티 워크스페이스 드리프트 방지). `X-Team-Id` 미전달 시 env(`SLACK_TEAM_ID`)로 폴백.
 
 ## 다음 단계
 1. rb8001 재배포 후 운영 스케줄 실행 시에도 이메일 분리 저장이 지속되는지 모니터링.  
-2. skill-email 목록 API 스키마 오류 수정(미존재 컬럼 참조 제거) 후, 전체 플로우(목록→상세→첨부→리스트) 실메일 기반 재검증.  
+2. 전체 플로우(목록→상세→첨부→리스트) 실메일 기반 재검증 (특히 skill-email 호출부가 UUID만 전달하는지).  
 3. Slack Lists 컬럼 메타가 불규칙한 워크스페이스에서는 필요한 컬럼 ID를 `.env`나 compose 환경변수로 명시하는 운영 가이드 반영.
-