80~82일차 단위 프로젝트 수강생 안내 (안내서 · 일정 · 환경 · 시나리오 · 구조 · RAG · 안정성 · 시험 · 제출 · 에이전트 · FAQ · 주제 정하기, 템플릿 6)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Lecture/80-82-Project/student/templates/RAG-ARCHITECTURE-TEMPLATE.md

@@ -0,0 +1,60 @@
+# 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) | 오늘 숫자에서 어림 | 지속형 저장소 · 배치 · 파티션 |