📚 Insurance RAG 학습 세션 2 완료 보고서

🎯 세션 개요

세션명: Insurance RAG 학습 지침 (세션2 수정완료판)
진행 방식: AI 가이드 & 멘토링 + 깊이있는 개념 설명
기준 코드: /Users/moon/Desktop/insupanda-rag/ 구조 참조
학습 원칙: 기존 코드 참조 → 개념 설명 → 실습 안내 → 완료 확인

✅ 완료된 학습 내용
1단계: 프로젝트 구조 이해
개념 학습:

RAG(Retrieval-Augmented Generation): 검색 후 답변 생성 기술

도서관 사서처럼 관련 문서를 먼저 찾고 답변 생성
외운 내용보다 실제 문서 참조로 더 정확한 답변 제공

기존 코드 분석:
📁 insupanda-rag/src/
├── config/ # 설정 관리 (logger.py, settings.py)
├── db/ # 데이터베이스 (schema.py, sql_utils.py)
├── models/ # RAG 핵심 모듈 (임베딩, 검색, 답변생성)
├── modules/ # 메인 비즈니스 로직 (handler.py, user_state.py)
├── options/ # 타입 정의 (enums.py, insu_name.py)
├── prompts/ # AI 프롬프트 템플릿 (.jinja2 파일들)
├── services/ # 비즈니스 서비스 로직
└── util/ # 유틸리티 함수들
2단계: 프로젝트 기본 구조 생성
중요한 배움 - 명령어 효율성:

❌ 잘못된 방식: mkdir -p를 개별적으로 여러 번 사용
✅ 올바른 방식: mkdir -p src/{config,db,models,modules,options,prompts,services,util} tests

개념 학습:

mkdir -p: parent directories 옵션으로 중간 폴더까지 한 번에 생성
중괄호 {} 문법: 쉘에서 여러 이름을 한 번에 나열하는 방법

실행 명령어:
bashcd /Users/moon/Desktop
mkdir insurance-rag-learning
cd insurance-rag-learning
mkdir -p src/{config,db,models,modules,options,prompts,services,util} tests
3단계: Python 패키지 초기화
개념 학습:

Python 패키지: init.py 파일로 폴더를 Python이 인식할 수 있는 패키지로 변환
import 시스템: from src.config import settings 같은 코드 import 가능

기존 코드 참조:

insupanda-rag에 총 7개의 init.py 파일 확인
모든 주요 폴더에 패키지 초기화 파일 존재

실행 명령어:
bashtouch src/init.py src/config/init.py src/db/init.py src/models/init.py src/modules/init.py src/options/init.py src/prompts/init.py src/services/init.py src/util/init.py tests/init.py
문제 해결:

불필요한 src/api/ 폴더 발견 및 삭제
rm -rf src/api 명령어로 정리

4단계: 환경변수 설정 파일 (진행 중)
개념 학습:

환경변수: 프로그램 설정값을 코드 외부에 안전하게 저장
보안성: API 키, 비밀번호 등 민감 정보를 코드에 직접 노출하지 않음
유연성: 개발/테스트/운영 환경별로 다른 설정 사용 가능

기존 코드 참조:

src/.test.env 파일 발견
내용: DB_PASSWORD, OPENAI_API_KEY, UPSTAGE_API_KEY 설정

🔧 학습한 주요 기술 개념
Python 관련

Pydantic: 데이터 검증을 쉽게 해주는 라이브러리 (설정값 타입 자동 체크)
환경변수: 운영체제에 저장된 설정값 (민감 정보 별도 보관)
로깅: 프로그램 실행 중 일어나는 일들을 기록 (에러 찾기와 디버깅에 필수)

RAG 관련

임베딩: 텍스트를 숫자 벡터로 변환 (컴퓨터가 의미 이해 가능)
벡터 검색: 의미가 비슷한 문서를 찾는 기술 (키워드 검색보다 똑똑함)
프롬프트 템플릿: AI에게 질문하는 정해진 형식

터미널 명령어

mkdir -p: 폴더 생성 (중간 폴더도 함께 생성)
touch: 빈 파일 생성
rm -rf: 폴더와 내용 완전 삭제
find: 파일 검색

📊 생성된 프로젝트 구조
최종 폴더 구조
📁 insurance-rag-learning/
├── src/
│ ├── init.py
│ ├── config/
│ │ └── init.py
│ ├── db/
│ │ └── init.py
│ ├── models/
│ │ └── init.py
│ ├── modules/
│ │ └── init.py
│ ├── options/
│ │ └── init.py
│ ├── prompts/
│ │ └── init.py
│ ├── services/
│ │ └── init.py
│ └── util/
│ └── init.py
└── tests/
└── init.py
생성된 파일 목록

총 10개의 init.py 파일
기존 insupanda-rag와 정확히 동일한 구조

🎓 중요한 학습 원칙
AI 역할

✅ 개념 설명 + 기존 코드 참조 + 실습 안내
✅ 모든 기술 용어 초보자용 설명 제공
❌ 직접 파일 생성이나 코드 작성 금지

학습자 역할

✅ 터미널 명령어 직접 실행
✅ Cursor에서 파일/코드 직접 작성
✅ 이해 안되는 개념 즉시 질문

효율성 원칙

명령어 설명 시 가장 효율적인 방법을 먼저 제시
프로 개발자가 사용하는 방식으로 바로 안내
비효율적 방법 → 수정하는 패턴 지양