32차시. 고도화된 Modular RAG

8. 실습 ⑥ — 아키텍처 문서 작성

출처: 원본 PDF 32차시_ModularRAG종합.pdf 16~17쪽 · 쪽 그림 16쪽 17쪽

시스템을 완성했으면 문서로 남깁니다. 포트폴리오에도 쓰입니다.

8-1) 남겨야 할 내용

항목	내용
구조 다이어그램	draw_mermaid_png 출력
노드 명세	각 노드의 입출력 계약 표
라우팅 규칙	분기점별 조건표
설정과 근거	config.py 값과 결정 이유
성능 지표	정답률·응답시간·비용
알려진 한계	아직 해결 못 한 문제들

📝 docs/ARCHITECTURE.md 뼈대

출력

# Modular RAG 시스템 아키텍처

## 1. 개요
- 목적: 사내 문서 기반 질의응답
- 문서: manual.pdf (12쪽, 조각 39개)
- 완성일: 2026-08-XX

## 2. 구조
(다이어그램 이미지)

## 3. 노드 명세
| 노드 | 읽는 키 | 쓰는 키 | 책임 | 실패 시 |
|------|---------|---------|------|---------|
...

## 4. 라우팅 규칙
### 4.1 classify 이후
| 순서 | 조건 | 반환값 | 다음 노드 |
...

## 5. 설정
| 항목 | 값 | 근거 |
| CHUNK_SIZE | 300 | 14차시 벤치마크 +10%p |
| TOP_K | 5 | 14차시 벤치마크 +10%p |
| MIN_SCORE | 0.47 | 9차시 실측 |
| MAX_RETRY | 2 | 27차시 실험 |
| MAX_REWRITE | 2 | 30차시 실험 |

## 6. 성능
- 정답률: 20/20 (자체 테스트 세트)
- 평균 응답: 4.6초
- 평균 LLM 호출: 2.9회

## 7. 알려진 한계
- 표 데이터 검색 정확도 낮음
- 부정문 구분 어려움 (9차시 참고)
- 여러 문서에 걸친 종합 질문 미지원

💡 "알려진 한계"를 반드시 쓰세요
완벽하다고 쓴 문서는 신뢰받지 못합니다.
· 무엇을 못 하는지 아는 것이 실력입니다
· 다음 개선 방향이 명확해집니다
· 사용자 기대를 적절히 조정합니다
40차시 프로젝트 발표에서도 이 항목이 평가됩니다.