ivada-infra/DOCS
3
0
Fork 0
Code Issues 1 Pull Requests 5 Actions Packages Projects Releases Wiki Activity

Update troubleshooting docs and 000000 matrix based on code audit

Browse Source 
- 000000_unresolved_items_matrix.md: 완료된 항목 제거, 미해결 항목만 유지
- 250831_rb8001_multiple_issues.md: 최종 해결 상태로 업데이트
- 250901_slack_bot_installation_flow_missing.md: 완전 해결 확인
- 250921_nginx_auth_gateway_log_analysis.md: 새로운 로그 분석 문서 추가

미해결 주요 이슈:
- rb8001 EmailIntegration 버그 (user_uuid 변수 오타)
- UUID↔Slack ID 조회 엔드포인트 불일치
- 하드코딩 URL 제거 필요 (특히 rb8001의 auth-server URL)
This commit is contained in:
happybell80 2025-09-22 00:05:44 +09:00
parent 9c11178a5e
commit d1464535d8
3 changed files with 38 additions and 41 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
plans/000000_unresolved_items_matrix.md
View File

@ -1,32 +1,21 @@
# 미해결 항목 매트릭스 (중요도 × 구현 난이도) # 미해결 항목 매트릭스 (중요도 × 구현 난이도)
## 🔴 Quick Wins (높은 중요도 + 쉬운 구현) → 즉시 실행 ## 🔴 Quick Wins (높은 중요도 + 쉬운 구현) → 즉시 실행
1. **rb8001→skill-email ID 불일치 핫픽스** - UUID→Slack ID 역변환 또는 토큰 조회 이원화 (2시간) [→250831](../troubleshooting/250831_happybell80_skill-email_UUID_inconsistency_URGENT.md) --> ( **solved - rb8001 수정 완료** ) 1. **rb8001 EmailIntegration 버그 수정** - NaverWorks 토큰 조회 시 미정의 변수 `user_uuid` → `slack_id` 수정 (10분) [→250921](../troubleshooting/250921_email_integration_undefined_variable_bug.md)
2. **skill-email GmailProvider 메서드명 불일치** - list_messages → get_recent_messages 매핑 수정 (30분) --> ( **solved** ) 2. **UUID↔Slack ID 조회 엔드포인트 통일** - gateway와 auth-server 간 `/api/slack/mapping/{identifier}` 통일 (2시간) [→250921](../troubleshooting/250921_uuid_slack_mapping_endpoint_unification.md)
3. **"처리 중..." 캐시 저장 제거/필터링** - 컨텍스트 파괴 원인 제거 (1시간) [→250831](../troubleshooting/250831_happybell80_cache_processing_placeholder_issue.md) --> ( **solved - 이미 주석 처리됨** ) 3. **네이버웍스 메일→슬랙 전달** - /mail-summary, /cold-mail-list, /daily-briefing 엔드포인트 구현 (1주) [→250919](../troubleshooting/250919_naverworks_to_slack_mail_integration.md)
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 전달 구현 완료** )
## 🟠 Major Projects (높은 중요도 + 어려운 구현) → 계획 수립 후 진행 ## 🟠 Major Projects (높은 중요도 + 어려운 구현) → 계획 수립 후 진행
1. **skill-rag-file 핵심 엔드포인트 구현** - /upload, /search, /healthz(포트 8508), Chroma 연동 (3주) [→250915](../troubleshooting/250915_skill-rag-file_초기_구축.md) --> ( **solved - 2025-09-20 확인, 모든 엔드포인트 구현 완료 및 서비스 운영 중** ) 1. **하드코딩 URL 제거** - 15개+ 서비스 전체 환경변수화, 특히 rb8001의 auth-server URL (3-4주) [→250915](../troubleshooting/250915_hardcoded_url_removal.md)
2. **News 시스템 DB 영속화 단계** - rb_news 등 저장 파트 구현(Phase 3) (2주) [→250906](250906_news_system_integration.md) --> ( **solved - 2025-09-20 rb_news 테이블 생성 및 저장 기능 구현 완료** ) 2. **Gateway 스케일링** - 재시도/백오프/헬스체크 (1주) [→250811](../troubleshooting/250811_happybell80_Gateway필드변환문제.md)
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) ) 3. **RAG 파이프라인 웹검색 통합** - 웹 RAG 서비스 구현 (3주) [→250909](../ideas/250909_RAG_file_processing_architecture.md)
4. **ChromaDB Collection 명명 규칙 통일** - {service}_{identifier}_{type} 형식으로 통일 (1일) --> ( **solved - 2025-09-20 rb8001, skill-rag-file 명명 규칙 통일 완료** [→구현](../troubleshooting/250920_chromadb_collection_naming_unification.md) ) 4. **rb8001 리팩토링** - 모듈 구조 정리 (3주) [→250914](../ideas/250914_rb8001_리팩토링_계획.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) ) 5. **감정 분석 시스템 구현** - 7클래스 모델+ONNX 추론, Temperature Scaling, emotion_readings 저장/시계열·시각화 API (3주) [→250916](../ideas/250916_로빙_감정_분석_시스템_구현_계획.md)
6. **하드코딩 URL 제거** - 15개+ 서비스 전체 환경변수화 (3-4주) [→250915](../troubleshooting/250915_hardcoded_url_removal.md) 6. **네이버웍스 캘린더 연동** - OAuth2 스코프·토큰 관리, /v1/calendar/* API, skill-calendar(8503) 서비스 (2주) [→250916](../ideas/250916_네이버웍스_캘린더_API_연동_가이드.md)
7. **Gateway 스케일링** - 재시도/백오프/헬스체크 (1주) [→250811](../troubleshooting/250811_happybell80_Gateway필드변환문제.md) 7. **Slack 캔버스 통합** - canvases.* API, 스코프 추가 및 설치/권한 플로우 (2주) [→250916](../ideas/250916_슬랙_캔버스_API_활용_방안.md)
8. **RAG 파이프라인 웹검색 통합** - 웹 RAG 서비스 구현 (3주) [→250909](../ideas/250909_RAG_file_processing_architecture.md) 8. **HWP 처리 전략** - RAG 업로드용 HWP→PDF 변환(LibreOffice/클라우드API/COM 중 택1) 파이프라인 (1주) [→250916](../ideas/250916_HWP-PDF_변환_전략_분석.md)
9. **rb8001 리팩토링** - 모듈 구조 정리 (3주) [→250914](../ideas/250914_rb8001_리팩토링_계획.md) 9. **news 엔드포인트 리팩토링** - 수집/스크랩/요약 오케스트레이션을 서비스 레이어로 이전 (1주)
10. **감정시스템 이식** - rb10508→rb8001 (2주) [→250828](../ideas/250828_rb10508_to_rb8001_migration_guide.md) --> ( **분석 완료 - 2025-09-20 실제로는 새로운 구현 필요, rb10508 없음** [→분석](../troubleshooting/250920_emotion_system_implementation_plan.md) ) 10. **시스템 메트릭 수집 재활성화** - 테이블 생성 또는 가드 제거로 실제 동작 복구 (3시간) [→250714](../troubleshooting/250714_system_metrics_implementation.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주)
## 🟡 Fill-ins (낮은 중요도 + 쉬운 구현) → 시간 날 때 ## 🟡 Fill-ins (낮은 중요도 + 쉬운 구현) → 시간 날 때
1. **scheduled_tasks 테이블** - 다중 작업 관리 (3시간) [→250827](../troubleshooting/250827_frontend_backend_preferences_API_연동_완료.md) 1. **scheduled_tasks 테이블** - 다중 작업 관리 (3시간) [→250827](../troubleshooting/250827_frontend_backend_preferences_API_연동_완료.md)
@ -48,4 +37,4 @@
--- ---
*평가 기준: 중요도(시스템 안정성/사용자 영향), 난이도(구현 시간/복잡도)* *평가 기준: 중요도(시스템 안정성/사용자 영향), 난이도(구현 시간/복잡도)*
*최종 업데이트: 2025-09-20* *최종 업데이트: 2025-09-22*

36
troubleshooting/250831_rb8001_multiple_issues.md
View File

@ -2,26 +2,34 @@
**작성일**: 2025-08-31 **작성일**: 2025-08-31
**작성자**: 51123 서버 관리자 **작성자**: 51123 서버 관리자
**상태**: 🟠 부분 해결 (업데이트: 2025-09-19) **상태**: ✅ 해결됨 (최종 업데이트: 2025-09-22)
**영향**: Gmail 토큰 오류, ChromaDB 경고, Gemini 타임아웃, 감정 분석 고정 **영향**: Gmail 토큰 오류, ChromaDB 경고, Gemini 타임아웃, 감정 분석 고정
--- ---
## 업데이트(해결 현황) — 2025-09-19 ## 최종 해결 현황 — 2025-09-22
- Gemini CLI 타임아웃: 완화/해결 완료 ### 완전 해결된 항목
- `rb8001/app/llm/gemini_handler.py`에 CLI 15초 타임아웃 처리 및 API 폴백 구현, 기본값으로 CLI 비사용 - **Gemini CLI 타임아웃**: ✅ 해결 완료
- 설정: `GEMINI_USE_CLI=False` (config) - `rb8001/app/llm/gemini_handler.py`에 CLI 15초 타임아웃 처리 및 API 폴백 구현
- ChromaDB Telemetry: 억제 적용 - 설정: `GEMINI_USE_CLI=False` 기본값 적용 (`rb8001/app/core/config.py:24`)
- 환경변수 `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 타입 오류 방지
남은 과제 - **ChromaDB Telemetry**: ✅ 억제 완료
- Gmail 토큰 매핑 로직의 내부 하드코딩 URL 제거 및 통일 - 환경변수 `ANONYMIZED_TELEMETRY=false` 적용
- `rb8001/app/skills/email_integration.py` 내 `http://192.168.219.45:9000` 하드코딩 제거 필요 - `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 토큰 매핑 오류 ## 1. Gmail 토큰 매핑 오류

4
troubleshooting/250901_slack_bot_installation_flow_missing.md
View File

@ -1,7 +1,7 @@
# Slack 봇 설치 플로우 미구현 문제 # Slack 봇 설치 플로우 미구현 문제
## 작성일: 2025-09-01 ## 작성일: 2025-09-01
## 상태: ✅ 해결 (2025-09-19) ## 상태: ✅ 완전 해결됨 (최종 확인: 2025-09-22)
## 영향: 워크스페이스에 봇 설치 불가 ## 영향: 워크스페이스에 봇 설치 불가
## 문제 ## 문제
@ -9,7 +9,7 @@
- 봇 설치와 사용자 로그인 플로우 혼재 - 봇 설치와 사용자 로그인 플로우 혼재
- bot_token 없어 Slack API 호출 불가 - bot_token 없어 Slack API 호출 불가
## 해결 내역 ## 최종 해결 확인 (2025-09-22)
1. 라우터 등록 및 플로우 분리 완료 1. 라우터 등록 및 플로우 분리 완료
- 파일: `auth-server/app/providers/slack.py` - 파일: `auth-server/app/providers/slack.py`
- 엔드포인트: - 엔드포인트: