# Troubleshooting Guide

51124 서버 운용 중 발생한 이슈 기록의 진입점입니다.

## 스크리닝 원칙

- 첫 스크리닝에서는 `현재 해결할 문제가 남아 있는 문서`만 우선 봅니다.
- `완전 닫힘` 문서는 여기 상단 목록에 올리지 않고, 검색이나 개별 링크로만 접근합니다.
- 상태 판단은 README 라벨보다 각 문서 본문의 `열림/닫힘/재오픈/남은 작업`을 우선합니다.

## 구조와 네이밍

- 경로: `DOCS/troubleshooting/`
- 파일명: `YYMMDD_author_topic.md`
  - 예: `250723_happybell80_Slack_3초룰.md`

## 빠르게 찾는 방법

1. **최근 이슈 탐색**: `ls -t | head`로 최신 10건 확인
2. **키워드 검색**: `rg "Slack 3초" DOCS/troubleshooting` 처럼 `rg` 사용
3. **카테고리 패턴**:
   - 네트워크/인프라: `*_docker_*`, `*_nginx_*`
   - 인증/보안: `*_auth_*`, `*_JWT_*`
   - 스킬별: `skill-*` 접두사의 문서

## 인프라 문서 이관 원칙

- `23/24/NAS`, 게이트웨이, 네트워크, 배포 SSOT, 백업, 마운트, Gitea/LFS 같은 공통 인프라 사실은 `infra/DOCS`를 기준으로 봅니다.
- 이 디렉터리에 남아 있는 동일 제목 문서는 삭제가 아니라 이관 안내용 리다이렉트 문서일 수 있습니다.
- 최신 인프라 기준 문서는 `https://git.ro-being.com/ivada-infra/DOCS/src/branch/main/journey/troubleshooting/` 아래를 우선 확인합니다.

## 현재 열린 트러블슈팅 우선 문서

- [260323_companyx_grounding_라우팅_과잉진입_및_fallback_차단.md](./260323_companyx_grounding_라우팅_과잉진입_및_fallback_차단.md)
  - 상태: 열림
- [260316_임베딩_1차_로빙_Gemini2_전환_문제오픈.md](./260316_임베딩_1차_로빙_Gemini2_전환_문제오픈.md)
  - 상태: 열림 (완전 닫힘 가능)
- [260316_임베딩_2차_StarsAndI_GooseCouncil_전환_문제오픈.md](./260316_임베딩_2차_StarsAndI_GooseCouncil_전환_문제오픈.md)
  - 상태: 열림 (1차 완료 후 진행)
- [260311_naverworks_briefing_insight_preamble_leak.md](./260311_naverworks_briefing_insight_preamble_leak.md)
  - 상태: 열림
- [260311_prompt_db_partial_adoption_and_hardcoded_prompts.md](./260311_prompt_db_partial_adoption_and_hardcoded_prompts.md)
  - 상태: 열림
- [260312_rb8001_memory_chromadb_768_384_dimension_drift.md](./260312_rb8001_memory_chromadb_768_384_dimension_drift.md)
  - 상태: 열림

## 참조 문서

| 주제 | 문서 | 비고 |
|------|------|------|
| Slack 3초 룰 | `250723_happybell80_Slack_3초룰.md` | FastAPI 비동기 패턴 |
| 배포 파이프라인 | `250716_rb8001_deployment_issues.md` | Actions + docker compose |
| Storage/용량 | `250716_SSD_용량_부족_및_Docker_정리.md` | 정리 스크립트 가이드 |
| Intent 리뷰 큐 | `251116_admin_intent_review_queue_api_implementation.md` | 최신 TDD 사례 |

- [260226_51124_openclaw_gateway_상주프로세스_정리.md](./260226_51124_openclaw_gateway_상주프로세스_정리.md)
  - 51124에서 비관리 openclaw-gateway 상주 프로세스 확인 및 종료/검증 기록
- [260309_9시_네이버이메일분석_미전송_실패은닉_해결.md](./260309_9시_네이버이메일분석_미전송_실패은닉_해결.md)
  - 9시 브리핑 미전송의 직접 원인인 `skill-email` timeout과 실패 은닉 제거 기록
- [260311_naverworks_briefing_insight_preamble_leak.md](./260311_naverworks_briefing_insight_preamble_leak.md)
  - NAVER WORKS 브리핑 인사이트 앞에 `로빙입니다` 같은 서두가 노출된 문제 기록
- [260311_prompt_db_partial_adoption_and_hardcoded_prompts.md](./260311_prompt_db_partial_adoption_and_hardcoded_prompts.md)
  - 프롬프트 DB 골격은 있으나 실제 운영 프롬프트 다수가 하드코딩으로 남아 있는 상태 기록
- [260312_rb8001_memory_chromadb_768_384_dimension_drift.md](./260312_rb8001_memory_chromadb_768_384_dimension_drift.md)
  - rb8001 사용자 메모리 컬렉션에 남아 있는 768/384 차원 드리프트와 Company X RAG 검증 시 동시 관찰된 에러 기록
- [260312_companyx_rag_answer_composition_regression.md](./260312_companyx_rag_answer_composition_regression.md)
  - Company X RAG 연결은 되었지만 Slack 실응답에서 직접 답과 질문 적합 근거 선별이 깨진 회귀 기록
- [260316_임베딩_1차_로빙_Gemini2_전환_문제오픈.md](./260316_임베딩_1차_로빙_Gemini2_전환_문제오픈.md)
  - 로빙 임베딩 0_VALUE 정책 불일치, Gemini 2 전환 (완전 닫힘 가능)
- [260316_임베딩_2차_StarsAndI_GooseCouncil_전환_문제오픈.md](./260316_임베딩_2차_StarsAndI_GooseCouncil_전환_문제오픈.md)
  - StarsAndI·TheGooseCouncil 임베딩 전환 (1차 완료 후, 열어둠)
