# RAG 아키텍처 설계서 · <팀이름>

> 원본 요구 4절 산출물 2의 구조를 따릅니다. 표의 값은 **잰 값**으로 채우고, 잰 방법(명령 · 보고서 파일)을 적습니다. [05-RAG-DESIGN-GUIDE](../05-RAG-DESIGN-GUIDE.md) 참고.

## 1. 원본 문서

| 항목 | 값 |
| --- | --- |
| 대상 문서 | 데이터 API `/docs` 8개 (+ 관리자 전용 1개) + 팀 `knowledge/` <N>개 |
| 문서 형식 | 마크다운 (`#` 제목, `##` 절) |
| 문서 길이 | 글자 수 최소 · 중앙 · 최대 (`chunk_stats.py`) |
| 언어 | |
| 갱신 주기 | |
| 접근 권한 | `access_level` 값과 기준 |

## 2. 전처리 및 청킹

| 항목 | 우리 선택 | 비교한 다른 선택 | 근거 (숫자) |
| --- | --- | --- | --- |
| 청킹 단위 | | | |
| 오버랩 | | | |
| 청크 앞에 붙이는 것 | 문서 제목 · 절 제목 | | |
| 표 · 목록 처리 | | | |

청크 길이 분포:

| 방식 | 청크 수 | 길이 최소 | 중앙 | 최대 | hit@3 (질문 <N>개) |
| --- | --- | --- | --- | --- | --- |

## 3. 임베딩

| 항목 | 값 | 근거 |
| --- | --- | --- |
| 모델 | | 성능 · 다국어 · 도메인 · 비용 |
| 벡터 차원 | | |
| 거리 방식 | | |
| top_k | | 비교한 값과 결과 |
| 점수 기준 (근거로 쓰는 최소 점수) | | 정상 · 결과 없음 질문의 점수 분포 |
| 색인 비용 | 토큰 <N> · 약 $<x> (단가 출처) | |

## 4. 인덱스 및 메타데이터

| 항목 | 값 |
| --- | --- |
| 컬렉션 · 메모리 키 이름 | `tech_support_kb_v1` … (명명 규칙) |
| 버전 · 전환 방법 | |
| 메타데이터 | `doc`, `title`, `section`, `chunk`, `access_level`, `type`, `updated_at`, `source_url` |
| 검색 전 필터 | 권한 (어떻게) |
| 검색 후 처리 | 중복 청크 제거 · 점수 기준 미달 제외 |
| 파티션 | (권한별 키 등) |

## 5. 백업 · 복구 및 확장

| 항목 | 오늘 구현 · 잰 것 | 운영 설계 |
| --- | --- | --- |
| 원본 백업 | git 저장소 | |
| 색인 재생성 | `<팀>-index` 한 번에 <N>초 · 청크 <M>개 | |
| 롤백 | | |
| 부분 재처리 | | |
| 확장 (문서 ×10 · ×100) | 오늘 숫자에서 어림 | 지속형 저장소 · 배치 · 파티션 |