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

4.7 KiB
Raw Permalink Blame History

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/ 아래를 우선 확인합니다.

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

참조 문서

주제 문서 비고
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 사례