트러블슈팅 문서 추가 - ChromaDB 캐시 권한, 메모리 시스템 및 다국어 임베딩, 배포 워크플로우 최적화

docs/troubleshooting/250708_happybell80_ChromaDB캐시권한문제.md

@@ -0,0 +1,43 @@
+# ChromaDB 캐시 권한 문제 해결
+
+**날짜**: 2025-07-08  
+**작업자**: happybell80 & Claude
+
+## 시간 미상
+
+### ChromaDB 캐시 권한 문제
+
+**문제**:
+- Permission denied 에러로 임베딩 모델 캐시 실패
+
+**원인**:
+- `/opt/models` 디렉터리 권한 부족
+
+**해결**:
+1. 호스트에서 모델 사전 다운로드
+2. 컨테이너에 적절한 권한 설정
+3. `sudo chown -R 999:999` 권한 조정
+
+**커밋**: `506918d`, `19ab06c`
+
+## 주요 해결 패턴 정리
+
+### Docker 관련
+- **권한 문제**: `chown -R 999:999` (컨테이너 사용자 권한)
+- **빌드 최적화**: 의존성 분리, 캐시 활용
+- **볼륨 마운트**: 데이터 영속성과 권한 관리
+
+### 배포 최적화
+- **타이밍 이슈**: 충분한 대기 시간 또는 조건부 확인
+- **환경변수**: 파일 보존으로 재생성 비용 절약
+- **명령어 최적화**: 여러 단계를 하나로 통합
+
+### Slack API 제약
+- **3초 타임아웃**: 즉시 응답 + 백그라운드 처리 패턴
+- **중복 이벤트**: 타임아웃 재시도 방지 로직
+- **롤백 전략**: 환경변수 토글로 기능 전환
+
+### ChromaDB 및 AI 모델
+- **다국어 지원**: multilingual 모델 선택
+- **캐시 관리**: 사전 다운로드 + 적절한 권한
+- **메모리 최적화**: 검색 개수와 품질의 균형

docs/troubleshooting/250709_happybell80_메모리시스템및다국어임베딩.md

@@ -0,0 +1,31 @@
+# 메모리 시스템 개선 및 다국어 임베딩 모델 전환
+
+**날짜**: 2025-07-09  
+**작업자**: happybell80 & Claude
+
+## 시간 미상
+
+### 메모리 시스템 개선
+
+**문제**:
+- 사용자 컨텍스트 인식 부족
+
+**해결**:
+- 메모리 검색 개수 2개 → 5개 증가
+- 키워드 확장
+
+**커밋**: `18d2d63`
+
+### 다국어 임베딩 모델 전환
+
+**문제**:
+- 영어 전용 임베딩 모델로 한국어 성능 저하
+
+**해결 과정**:
+1. `paraphrase-multilingual-MiniLM-L12-v2` 모델 적용
+2. 의존성 누락으로 컨테이너 빌드 실패
+3. `sentence-transformers`, `torch` 의존성 추가
+
+**최종 결과**:
+- 한국어 임베딩 성능 개선
+- 커밋: `8e7d096`, `76e01a2`

docs/troubleshooting/250710_happybell80_배포워크플로우최적화.md

@@ -0,0 +1,39 @@
+# 배포 워크플로우 최적화 및 시스템 개선
+
+**날짜**: 2025-07-10  
+**작업자**: happybell80 & Claude
+
+## 오전 시간 미상
+
+### 배포 워크플로우 최적화 (34초 → 18초)
+
+**문제**:
+- `curl: (56) Recv failure: 상대편이 연결을 끊음` 에러 발생
+- 배포 시간 과다 소요 (34초)
+
+**원인**:
+1. Health check 타이밍 이슈 - 앱 시작 전 curl 실행
+2. 불필요한 `sleep 10` 대기 시간
+3. 매번 .env 파일 재생성으로 시간 소모
+
+**해결**:
+1. Health check 제거 (Docker healthcheck로 대체)
+2. .env 파일 조건부 생성 (없을 때만 생성)
+3. `docker compose up -d --build` 한 번에 처리
+
+**결과**:
+- 배포 시간 34초 → 18초 (47% 단축)
+- 커밋: `4be30ee`, `82ea32b`
+
+### heredoc 구문 오류 해결
+
+**문제**:
+- GitHub Actions에서 bash heredoc 구문 오류
+
+**원인**:
+- YAML 내부 SSH 세션에서 heredoc 들여쓰기 문제
+
+**해결**:
+- heredoc을 echo 명령들로 변경
+
+**커밋**: `4be30ee`