docs: 누락된 파일 추가

This commit is contained in:
Claude-51124 2025-11-17 13:25:58 +09:00
parent f7e59cb983
commit f4430d31cc
3 changed files with 74 additions and 0 deletions

View File

@ -65,6 +65,8 @@
- [아이디어 노트](./ideas/) - [아이디어 노트](./ideas/)
- [개발 계획](./plans/) - [개발 계획](./plans/)
- [아키텍처 문서](./300_architecture/) - [아키텍처 문서](./300_architecture/)
- [연구 자료](./research/README.md)
- [IR 자료](./IR/)
### 번호 체계 ### 번호 체계
- **첫 번째 자리**: Part 번호 - **첫 번째 자리**: Part 번호
@ -84,6 +86,8 @@
### 프로젝트 이해하기 ### 프로젝트 이해하기
1. [프로젝트 종합 v3](./000_프로젝트_종합_v3.md) 문서를 통해 전체 개요를 파악합니다. 1. [프로젝트 종합 v3](./000_프로젝트_종합_v3.md) 문서를 통해 전체 개요를 파악합니다.
2. 목차의 Part 1부터 순서대로 읽거나 관심 있는 주제를 선택하여 문서를 탐색합니다. 2. 목차의 Part 1부터 순서대로 읽거나 관심 있는 주제를 선택하여 문서를 탐색합니다.
3. 심층 연구는 [연구 자료](./research/README.md)에서 분야별 논문/실험을 확인합니다.
4. 장애 기록이나 해결 패턴은 [트러블슈팅 개요](./troubleshooting/README.md)를 먼저 읽고 필요한 문서를 찾습니다.
### 개발 환경 구축하기 ### 개발 환경 구축하기
- `510_3개월_MVP_개발기` 문서의 기술 스택 및 설정 부분을 참고하여 환경을 구축할 수 있습니다. - `510_3개월_MVP_개발기` 문서의 기술 스택 및 설정 부분을 참고하여 환경을 구축할 수 있습니다.

View File

@ -0,0 +1,22 @@
# Memory · Classification
Ko-SRoBERTa 기반 의미 검색과 고전적인 ML 분류(나이브 베이즈 등)를 결합해 의도/메모리 분류 정확도를 높이기 위한 연구 노트 모음입니다.
## 포함 문서
| 파일 | 요약 |
|------|------|
| `2024_bert_embedding_feature_selection.md` | BERT 임베딩에서 상위 특징을 선택해 메모리 검색 성능을 높이는 방법 |
| `2024_hybrid_llm_ml_threshold.md` | LLM Confidence + ML 임계값을 조합한 하이브리드 분류 전략 |
## 어떻게 읽나
1. `2024_hybrid_llm_ml_threshold.md` → 현재 의도 분류기의 threshold 설계 근거
2. `2024_bert_embedding_feature_selection.md` → 임베딩 후처리/축약 기법
3. 의도 분류 흐름 전체는 `DOCS/research/intent_classification/README.md`와 연결
## TODO
- PT4AL 기반 쿼리 전략 실험 결과 추가
- 의도 재학습 배치 결과 공유
- ko-SRoBERTa fine-tuning 실험 로그 업로드

48
troubleshooting/README.md Normal file
View File

@ -0,0 +1,48 @@
# Troubleshooting Guide
51124 서버 운용 중 발생한 모든 이슈는 날짜 기반 마크다운 파일(`yymmdd_작성자_주제.md`)로 저장됩니다. 이 README는 340개가 넘는 문서 중 필요한 정보를 빠르게 찾을 수 있도록 돕습니다.
## 구조와 네이밍
- 경로: `DOCS/troubleshooting/`
- 파일명: `YYMMDD_author_topic.md`
- 예: `250723_happybell80_Slack_3초룰.md`
- 각 문서는 **상황 → 원인 → 해결 → 교훈** 순서를 기본으로 하며, 교훈 섹션의 규칙은 `AGENTS.md`에 반영됩니다.
## 빠르게 찾는 방법
1. **최근 이슈 탐색**: `ls -t | head`로 최신 10건 확인
2. **키워드 검색**: `rg "Slack 3초" DOCS/troubleshooting` 처럼 `rg` 사용
3. **카테고리 패턴**:
- 네트워크/인프라: `*_docker_*`, `*_nginx_*`
- 인증/보안: `*_auth_*`, `*_JWT_*`
- 스킬별: `skill-*` 접두사의 문서
## 필수 참조 문서
| 주제 | 문서 | 비고 |
|------|------|------|
| 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 사례 |
## 문서 작성 시 체크리스트
- [ ] 문제 원인/증상 구분
- [ ] 명령어/로그는 fenced code block 사용
- [ ] 교훈 섹션에 재발 방지 규칙 명시
- [ ] 관련 문서/참고 링크를 하단에 추가
## 자주 쓰는 명령
```bash
rg "교훈" DOCS/troubleshooting -n # 교훈 섹션 검색
rg "Docker" DOCS/troubleshooting -g "*.md" # 도커 관련 문서 검색
```
## 다음 단계
- 월별 인덱스 문서 작성 (예: `2025-07.md`)
- Slack/Email/Calendar 등 서비스별 태그 파일 정리
- 교훈 섹션 자동 추출 스크립트 추가 (plans/ 디렉토리 예정)