diff --git a/plans/000000_unresolved_items_matrix.md b/plans/000000_unresolved_items_matrix.md index 57311f4..2971eea 100644 --- a/plans/000000_unresolved_items_matrix.md +++ b/plans/000000_unresolved_items_matrix.md @@ -1,32 +1,21 @@ # 미해결 항목 매트릭스 (중요도 × 구현 난이도) ## 🔴 Quick Wins (높은 중요도 + 쉬운 구현) → 즉시 실행 -1. **rb8001→skill-email ID 불일치 핫픽스** - UUID→Slack ID 역변환 또는 토큰 조회 이원화 (2시간) [→250831](../troubleshooting/250831_happybell80_skill-email_UUID_inconsistency_URGENT.md) --> ( **solved - rb8001 수정 완료** ) -2. **skill-email GmailProvider 메서드명 불일치** - list_messages → get_recent_messages 매핑 수정 (30분) --> ( **solved** ) -3. **"처리 중..." 캐시 저장 제거/필터링** - 컨텍스트 파괴 원인 제거 (1시간) [→250831](../troubleshooting/250831_happybell80_cache_processing_placeholder_issue.md) --> ( **solved - 이미 주석 처리됨** ) -4. **시스템 메트릭 컬럼 불일치 수정** - timestamp 참조 제거, time 기준 일치화 (2시간) [→250714](../troubleshooting/250714_system_metrics_implementation.md) --> ( **solved** ) -5. **Slack 봇 설치 플로우 구현** - install 라우터 등록·스코프·bot_token 저장·프론트 버튼 (3시간) [→250901](../troubleshooting/250901_slack_bot_installation_flow_missing.md)--> ( **solved - 2025-09-19 이미 해결됨** ) -6. **Gemini CLI 타임아웃 대응** - CLI 비활성화 또는 타임아웃 연장(폴백 최소화) (2시간) [→250831](../troubleshooting/250831_rb8001_multiple_issues.md) --> ( **solved - 2025-09-19 GEMINI_USE_CLI=False 설정** ) -7. **Gateway 사용자 매핑 오류 수정** - /api/slack/mapping이 UUID 요청에 default_user 반환 문제 (2시간) [→250831](../troubleshooting/250831_rb8001_multiple_issues.md) --> ( **solved** ) -8. **네이버웍스 메일→슬랙 전달** - /mail-summary, /cold-mail-list, /daily-briefing 엔드포인트 구현 (1주) [→250919](../troubleshooting/250919_naverworks_to_slack_mail_integration.md) -9. **rb8001 EmailIntegration NaverWorks 지원** - 네이버웍스 메일 키워드 감지 및 provider 파라미터 전달 (3시간) [→250919](../troubleshooting/250919_naverworks_slack_02_daily_briefing.md) --> ( **solved - 키워드 감지 및 provider 전달 구현 완료** ) +1. **rb8001 EmailIntegration 버그 수정** - NaverWorks 토큰 조회 시 미정의 변수 `user_uuid` → `slack_id` 수정 (10분) [→250921](../troubleshooting/250921_email_integration_undefined_variable_bug.md) +2. **UUID↔Slack ID 조회 엔드포인트 통일** - gateway와 auth-server 간 `/api/slack/mapping/{identifier}` 통일 (2시간) [→250921](../troubleshooting/250921_uuid_slack_mapping_endpoint_unification.md) +3. **네이버웍스 메일→슬랙 전달** - /mail-summary, /cold-mail-list, /daily-briefing 엔드포인트 구현 (1주) [→250919](../troubleshooting/250919_naverworks_to_slack_mail_integration.md) ## 🟠 Major Projects (높은 중요도 + 어려운 구현) → 계획 수립 후 진행 -1. **skill-rag-file 핵심 엔드포인트 구현** - /upload, /search, /healthz(포트 8508), Chroma 연동 (3주) [→250915](../troubleshooting/250915_skill-rag-file_초기_구축.md) --> ( **solved - 2025-09-20 확인, 모든 엔드포인트 구현 완료 및 서비스 운영 중** ) -2. **News 시스템 DB 영속화 단계** - rb_news 등 저장 파트 구현(Phase 3) (2주) [→250906](250906_news_system_integration.md) --> ( **solved - 2025-09-20 rb_news 테이블 생성 및 저장 기능 구현 완료** ) -3. **Stats API 일원화** - 경로(/api/stats vs /stats)·스키마(robeing_id/robeing_container_id, ethics/stat_points) 통일 (1주) [→250915](../troubleshooting/250915_happybell80_rb8001_stats_api_중복_제거.md) --> ( **solved - 2025-09-20 robeing-monitor로 일원화 완료** [→구현](../troubleshooting/250920_stats_api_unification_complete.md) ) -4. **ChromaDB Collection 명명 규칙 통일** - {service}_{identifier}_{type} 형식으로 통일 (1일) --> ( **solved - 2025-09-20 rb8001, skill-rag-file 명명 규칙 통일 완료** [→구현](../troubleshooting/250920_chromadb_collection_naming_unification.md) ) -5. **사용자 식별 통합 고도화** - UUID 1차 식별자 일원화(슬랙·지메일 매핑 테이블) (2주) [→250831](250831_unified_id_system_implementation_roadmap.md), [→250827](../troubleshooting/250827_claude_conversation_log_user_mapping.md) --> ( **partially solved - 2025-09-20 skill-email UUID 지원 추가, DB 이미 UUID 사용 중** [→구현](../troubleshooting/250920_user_identification_uuid_implementation.md) ) -6. **하드코딩 URL 제거** - 15개+ 서비스 전체 환경변수화 (3-4주) [→250915](../troubleshooting/250915_hardcoded_url_removal.md) -7. **Gateway 스케일링** - 재시도/백오프/헬스체크 (1주) [→250811](../troubleshooting/250811_happybell80_Gateway필드변환문제.md) -8. **RAG 파이프라인 웹검색 통합** - 웹 RAG 서비스 구현 (3주) [→250909](../ideas/250909_RAG_file_processing_architecture.md) -9. **rb8001 리팩토링** - 모듈 구조 정리 (3주) [→250914](../ideas/250914_rb8001_리팩토링_계획.md) -10. **감정시스템 이식** - rb10508→rb8001 (2주) [→250828](../ideas/250828_rb10508_to_rb8001_migration_guide.md) --> ( **분석 완료 - 2025-09-20 실제로는 새로운 구현 필요, rb10508 없음** [→분석](../troubleshooting/250920_emotion_system_implementation_plan.md) ) -11. **네이버웍스 캘린더 연동** - OAuth2 스코프·토큰 관리, /v1/calendar/* API, skill-calendar(8503) 서비스 (2주) [→250916](../ideas/250916_네이버웍스_캘린더_API_연동_가이드.md) -12. **Slack 캔버스 통합** - canvases.* API, 스코프 추가 및 설치/권한 플로우 (2주) [→250916](../ideas/250916_슬랙_캔버스_API_활용_방안.md) -13. **감정 분석 시스템 구현** - 7클래스 모델+ONNX 추론, Temperature Scaling, emotion_readings 저장/시계열·시각화 API (3주) [→250916](../ideas/250916_로빙_감정_분석_시스템_구현_계획.md) -14. **HWP 처리 전략** - RAG 업로드용 HWP→PDF 변환(LibreOffice/클라우드API/COM 중 택1) 파이프라인 (1주) [→250916](../ideas/250916_HWP-PDF_변환_전략_분석.md) -15. **news 엔드포인트 리팩토링** - 수집/스크랩/요약 오케스트레이션을 서비스 레이어로 이전 (1주) +1. **하드코딩 URL 제거** - 15개+ 서비스 전체 환경변수화, 특히 rb8001의 auth-server URL (3-4주) [→250915](../troubleshooting/250915_hardcoded_url_removal.md) +2. **Gateway 스케일링** - 재시도/백오프/헬스체크 (1주) [→250811](../troubleshooting/250811_happybell80_Gateway필드변환문제.md) +3. **RAG 파이프라인 웹검색 통합** - 웹 RAG 서비스 구현 (3주) [→250909](../ideas/250909_RAG_file_processing_architecture.md) +4. **rb8001 리팩토링** - 모듈 구조 정리 (3주) [→250914](../ideas/250914_rb8001_리팩토링_계획.md) +5. **감정 분석 시스템 구현** - 7클래스 모델+ONNX 추론, Temperature Scaling, emotion_readings 저장/시계열·시각화 API (3주) [→250916](../ideas/250916_로빙_감정_분석_시스템_구현_계획.md) +6. **네이버웍스 캘린더 연동** - OAuth2 스코프·토큰 관리, /v1/calendar/* API, skill-calendar(8503) 서비스 (2주) [→250916](../ideas/250916_네이버웍스_캘린더_API_연동_가이드.md) +7. **Slack 캔버스 통합** - canvases.* API, 스코프 추가 및 설치/권한 플로우 (2주) [→250916](../ideas/250916_슬랙_캔버스_API_활용_방안.md) +8. **HWP 처리 전략** - RAG 업로드용 HWP→PDF 변환(LibreOffice/클라우드API/COM 중 택1) 파이프라인 (1주) [→250916](../ideas/250916_HWP-PDF_변환_전략_분석.md) +9. **news 엔드포인트 리팩토링** - 수집/스크랩/요약 오케스트레이션을 서비스 레이어로 이전 (1주) +10. **시스템 메트릭 수집 재활성화** - 테이블 생성 또는 가드 제거로 실제 동작 복구 (3시간) [→250714](../troubleshooting/250714_system_metrics_implementation.md) ## 🟡 Fill-ins (낮은 중요도 + 쉬운 구현) → 시간 날 때 1. **scheduled_tasks 테이블** - 다중 작업 관리 (3시간) [→250827](../troubleshooting/250827_frontend_backend_preferences_API_연동_완료.md) @@ -48,4 +37,4 @@ --- *평가 기준: 중요도(시스템 안정성/사용자 영향), 난이도(구현 시간/복잡도)* -*최종 업데이트: 2025-09-20* +*최종 업데이트: 2025-09-22* \ No newline at end of file diff --git a/troubleshooting/250831_rb8001_multiple_issues.md b/troubleshooting/250831_rb8001_multiple_issues.md index bb8f6c4..f59d015 100644 --- a/troubleshooting/250831_rb8001_multiple_issues.md +++ b/troubleshooting/250831_rb8001_multiple_issues.md @@ -2,26 +2,34 @@ **작성일**: 2025-08-31 **작성자**: 51123 서버 관리자 -**상태**: 🟠 부분 해결 (업데이트: 2025-09-19) +**상태**: ✅ 해결됨 (최종 업데이트: 2025-09-22) **영향**: Gmail 토큰 오류, ChromaDB 경고, Gemini 타임아웃, 감정 분석 고정 --- -## 업데이트(해결 현황) — 2025-09-19 +## 최종 해결 현황 — 2025-09-22 -- Gemini CLI 타임아웃: 완화/해결 완료 - - `rb8001/app/llm/gemini_handler.py`에 CLI 15초 타임아웃 처리 및 API 폴백 구현, 기본값으로 CLI 비사용 - - 설정: `GEMINI_USE_CLI=False` (config) -- ChromaDB Telemetry: 억제 적용 - - 환경변수 `ANONYMIZED_TELEMETRY=false` 적용 (`rb8001/docker-compose.yml`, `rb8001/app/memory/manager.py`) -- Slack 사용자 매핑: 디폴트 문자열 반환 문제 해결 - - `auth-server/app/api/slack_router.py`의 `/api/slack/mapping/{identifier}`에서 UUID/Slack ID 모두 처리, 미존재 시 400 반환 - - 기존 "default_user" 반환 경로 제거로 PostgreSQL UUID 타입 오류 방지 +### 완전 해결된 항목 +- **Gemini CLI 타임아웃**: ✅ 해결 완료 + - `rb8001/app/llm/gemini_handler.py`에 CLI 15초 타임아웃 처리 및 API 폴백 구현 + - 설정: `GEMINI_USE_CLI=False` 기본값 적용 (`rb8001/app/core/config.py:24`) -남은 과제 -- Gmail 토큰 매핑 로직의 내부 하드코딩 URL 제거 및 통일 - - `rb8001/app/skills/email_integration.py` 내 `http://192.168.219.45:9000` 하드코딩 제거 필요 -- 감정 분석 일관성 개선 (프롬프트/로직 수정) +- **ChromaDB Telemetry**: ✅ 억제 완료 + - 환경변수 `ANONYMIZED_TELEMETRY=false` 적용 + - `rb8001/docker-compose.yml`, `rb8001/app/memory/manager.py`에서 처리 + +- **Gateway 사용자 매핑**: ✅ 해결됨 + - `auth-server/app/api/slack_router.py`의 `/api/slack/mapping/{identifier}` 수정 + - UUID/Slack ID 모두 정상 처리, 미존재 시 400 반환 + - "default_user" 문자열 반환 제거로 PostgreSQL UUID 타입 오류 해결 + +### 미해결 사항 (별도 이슈로 분리) +- **하드코딩 URL 제거**: → [250915_hardcoded_url_removal.md](./250915_hardcoded_url_removal.md)로 이관 + - `rb8001/app/skills/email_integration.py:39-47`의 `http://192.168.219.45:9000` 하드코딩 + - 전체 서비스 환경변수화 프로젝트의 일부로 처리 예정 + +- **감정 분석 시스템**: → [250916_로빙_감정_분석_시스템_구현_계획.md](../ideas/250916_로빙_감정_분석_시스템_구현_계획.md)로 이관 + - 새로운 감정 분석 시스템 구현 필요 (rb10508 없음 확인) ## 1. Gmail 토큰 매핑 오류 diff --git a/troubleshooting/250901_slack_bot_installation_flow_missing.md b/troubleshooting/250901_slack_bot_installation_flow_missing.md index 4d5e1c5..38292d2 100644 --- a/troubleshooting/250901_slack_bot_installation_flow_missing.md +++ b/troubleshooting/250901_slack_bot_installation_flow_missing.md @@ -1,7 +1,7 @@ # Slack 봇 설치 플로우 미구현 문제 ## 작성일: 2025-09-01 -## 상태: ✅ 해결 (2025-09-19) +## 상태: ✅ 완전 해결됨 (최종 확인: 2025-09-22) ## 영향: 워크스페이스에 봇 설치 불가 ## 문제 @@ -9,7 +9,7 @@ - 봇 설치와 사용자 로그인 플로우 혼재 - bot_token 없어 Slack API 호출 불가 -## 해결 내역 +## 최종 해결 확인 (2025-09-22) 1. 라우터 등록 및 플로우 분리 완료 - 파일: `auth-server/app/providers/slack.py` - 엔드포인트: