DOCS/troubleshooting/251014_slack_lists_file_attachment.md

Slack Lists 첨부파일 업로드 구현

날짜: 2025-10-14 작성자: happybell80 관련 파일: rb8001/app/scheduler/jobs/coldmail_briefing.py 전체 시나리오: 251014_coldmail_ir_analysis_scenario.md

---

문제 상황

• coldmail_briefing.py:204: attachment 필드에 document_id 문자열 전달
• Slack Lists API는 file_id 필요 (skill-slack/tests/test_slack_lists.py:112)
• 전체 목표: IR PDF 분석 → 기업 평가 → 베이지안 확률 → Slack 보고서

---

우선 해결: 파일 영속성 문제 (2025-10-14 해결)

문제

• skill-rag-file 컨테이너가 파일을 /mnt/51123data/documents/에 저장
• SSHFS user_id=1001, 컨테이너 root (UID 0) 권한 불일치
• 컨테이너 재시작 시 파일 손실

해결

1. /etc/fuse.conf: user_allow_other 활성화
2. SSHFS 재마운트: allow_other,default_permissions 옵션 추가
3. docker-compose.yml: /mnt/51123data:/mnt/51123data:rw 볼륨 추가

결과

• ✅ 컨테이너 → 호스트 파일 동기화
• ✅ 51123 서버 HDD 영구 저장
• ✅ 재시작 후에도 파일 유지

상세: 251014_skill-rag-file_sshfs_allow_other_해결.md

---

현재 상태

skill-rag-file

• main.py:54: POST /api/upload 존재
• upload.py:108: storage_path에 파일 저장
• 다운로드 API 없음

skill-slack

• lists.py:47: POST /lists/items 존재 (slackLists.items.create)
• messages.py:19: POST /send 존재 (chat_postMessage)
• files_upload_v2 통합 없음

test_slack_lists.py (검증된 동작)

• 81-88줄: files_upload_v2(channel, file, title) → file_id 반환
• 112줄: attachment 필드에 [file_id] 전달
• 192줄: channel 파라미터 있으면 메시지 생성, 없으면 업로드만

---

해결 방안

우선순위 0: skill-rag-file 파일 영속성 (✅ 완료)

• SSHFS allow_other 설정
• docker-compose.yml 볼륨 마운트 추가
• 상세: 251014_skill-rag-file_sshfs_allow_other_해결.md

우선순위 1: skill-rag-file 다운로드 API

파일: skill-rag-file/app/api/download.py (신규)

• GET /api/download/{document_id}
• TeamDocument.query(id=document_id) → storage_path, filename 조회
• from fastapi.responses import FileResponse
• return FileResponse(path=storage_path, filename=filename)

파일: skill-rag-file/app/main.py:55

• from app.api import download
• app.include_router(download.router, prefix="/api", tags=["download"])

DB: app/models/database.py:7-28

• TeamDocument.storage_path (Text)
• TeamDocument.filename (String(255))

우선순위 2: skill-slack 파일 업로드 API

파일: skill-slack/app/api/endpoints/files.py (신규)

• POST /api/v1/files/upload (multipart/form-data)
• from slack_sdk import WebClient
• client = WebClient(token=token)
• result = client.files_upload_v2(file=file, title=title)
• return {"file_id": result['file']['id']}

참고: messages.py:17 (WebClient 초기화), test_slack_lists.py:81-88

우선순위 3: coldmail_briefing.py 통합

위치: rb8001/app/scheduler/jobs/coldmail_briefing.py:159-204

• GET {SKILL_RAG_FILE_URL}/api/download/{document_id}
• 파일 /tmp/{filename} 저장
• POST {SKILL_SLACK_URL}/api/v1/files/upload (multipart)
• 204줄: attachment: [file_id]

---

교훈

파일 영속성 검증 누락

• 컨테이너 내부에만 파일 존재, 호스트/51123 서버 저장 안됨
• SSHFS allow_other 옵션 미사용으로 권한 불일치
• 교훈: 파일 저장 시스템 구축 시 영속성 테스트 필수

테스트 파일 확인 누락

• test_slack_lists.py에 완전한 구현 예시 존재
• 문서만 보고 추측으로 작성
• 교훈: 테스트 파일 우선 확인 필수

API 스펙 미확인

• attachment 필드 타입 확인 안 함
• document_id 문자열 전달 (오류)
• 교훈: Slack API 필드 타입 사전 확인 필수

FUSE 권한 모델 이해 부족

• SSHFS 마운트는 기본적으로 마운트한 사용자만 접근
• Docker 컨테이너는 다른 UID로 실행되어 접근 불가
• 교훈: FUSE 기반 파일시스템 사용 시 allow_other 옵션 검토 필수