Add Render.com deployment configuration for online hosting

- Add render.yaml for automatic deployment
- Add download_vector_db.sh script to fetch DB from Release
- Add comprehensive DEPLOY_GUIDE.md with step-by-step instructions
- Enable public access for anyone to use the RAG system
- Free tier deployment with automatic HTTPS

DEPLOY_GUIDE.md

@@ -0,0 +1,177 @@
+# 🚀 Render.com 무료 배포 가이드
+
+## 📋 배포 개요
+
+이 가이드는 백엔드 API를 **Render.com 무료 플랜**에 배포하여 누구나 온라인에서 접근 가능하게 만드는 방법입니다.
+
+### ✨ Render.com 무료 플랜 특징
+- ✅ **완전 무료** (신용카드 불필요)
+- ✅ **자동 HTTPS** 제공
+- ✅ **GitHub 연동** 자동 배포
+- ✅ **월 750시간** 무료 (충분함!)
+- ⚠️ 15분 idle 후 sleep (첫 요청 시 10-30초 소요)
+
+---
+
+## 🔧 배포 단계
+
+### 1️⃣ GitHub에 푸시
+
+```bash
+git add .
+git commit -m "Add Render.com deployment configuration"
+git push origin main  # 또는 현재 브랜치
+```
+
+### 2️⃣ Render.com 계정 생성
+
+1. https://render.com 접속
+2. **"Get Started for Free"** 클릭
+3. **GitHub 계정으로 로그인**
+
+### 3️⃣ 새 Web Service 생성
+
+1. Dashboard에서 **"New +"** 클릭
+2. **"Web Service"** 선택
+3. **GitHub 리포지토리 연결**:
+   - `csjjin2025/Hallucination_and_Deception_for_financial_RAG` 선택
+4. 다음 설정 입력:
+
+   ```
+   Name: financial-rag-api (또는 원하는 이름)
+   Region: Singapore (가장 가까운 지역)
+   Branch: main (또는 현재 브랜치)
+   Runtime: Python 3
+   Build Command: (자동 감지됨 - render.yaml 사용)
+   Start Command: (자동 감지됨 - render.yaml 사용)
+   Instance Type: Free
+   ```
+
+### 4️⃣ 환경변수 설정
+
+**Environment** 탭에서 다음 변수 추가:
+
+```
+ANTHROPIC_API_KEY=sk-ant-api03-your-key-here
+```
+
+⚠️ **중요**: Anthropic API 키를 꼭 입력하세요!
+
+### 5️⃣ 배포 시작
+
+**"Create Web Service"** 클릭하면 자동으로 배포가 시작됩니다.
+
+배포 로그를 확인하며 대기 (약 5-10분 소요):
+- 패키지 설치
+- 벡터 DB 다운로드
+- 서버 시작
+
+### 6️⃣ 배포 완료 확인
+
+배포가 완료되면 다음과 같은 URL이 생성됩니다:
+
+```
+https://financial-rag-api-xxxx.onrender.com
+```
+
+헬스 체크 테스트:
+```bash
+curl https://your-app-name.onrender.com/health
+```
+
+성공 시:
+```json
+{
+  "status": "healthy",
+  "vector_store": {
+    "total_documents": 15,
+    ...
+  }
+}
+```
+
+---
+
+## 🌐 GitHub Pages와 연결
+
+### 방법 1: 프론트엔드에 API URL 하드코딩 (권장)
+
+GitHub Pages의 `index.html` 또는 JavaScript 파일에서:
+
+```javascript
+// 기본 API URL 설정
+const DEFAULT_API_URL = "https://your-app-name.onrender.com";
+```
+
+### 방법 2: 사용자가 직접 입력
+
+현재처럼 사용자가 API URL을 입력하도록 유지하되,
+placeholder에 기본 URL 표시:
+
+```html
+<input
+  type="text"
+  placeholder="https://your-app-name.onrender.com"
+  id="api-url-input"
+>
+```
+
+---
+
+## 🔄 자동 업데이트 설정
+
+GitHub에 코드를 푸시하면 **자동으로 재배포**됩니다:
+
+```bash
+git add .
+git commit -m "Update backend"
+git push origin main
+```
+
+Render.com이 자동으로 감지하고 재배포합니다! 🎉
+
+---
+
+## ⚠️ 주의사항
+
+### 1. Cold Start (첫 요청 지연)
+무료 플랜은 15분 idle 후 sleep 상태가 됩니다.
+첫 요청 시 10-30초 소요될 수 있습니다.
+
+**해결책**:
+- Render.com의 **Cron Job** 기능으로 5분마다 health check
+- 또는 업그레이드 ($7/월)
+
+### 2. 벡터 DB 크기 제한
+무료 플랜은 스토리지 제한이 있습니다.
+- 현재: 15개 테스트 문서 (매우 작음)
+- 전체 DB: 압축 시 ~500MB (무료 플랜 가능)
+
+### 3. API 키 보안
+- ✅ 환경변수로 설정 (안전)
+- ❌ 코드에 하드코딩 금지
+
+---
+
+## 📊 배포 후 모니터링
+
+### Render.com Dashboard에서 확인:
+- **Logs**: 실시간 로그 확인
+- **Metrics**: CPU, 메모리 사용량
+- **Events**: 배포 이력
+
+### API 엔드포인트:
+- Health Check: `GET /health`
+- API Docs: `GET /docs`
+- Query: `POST /query`
+
+---
+
+## 🎉 완료!
+
+이제 GitHub Pages에서:
+1. https://csjjin2025.github.io/Hallucination_and_Deception_for_financial_RAG/ 접속
+2. API URL 입력: `https://your-app-name.onrender.com`
+3. 질문 입력하고 테스트!
+
+**전 세계 누구나 접근 가능합니다!** 🌍

render.yaml

@@ -0,0 +1,27 @@
+services:
+  - type: web
+    name: financial-rag-api
+    runtime: python
+    buildCommand: |
+      pip install -r requirements.txt
+      chmod +x scripts/download_vector_db.sh
+      ./scripts/download_vector_db.sh
+    startCommand: uvicorn app.main:app --host 0.0.0.0 --port $PORT
+    envVars:
+      - key: ANTHROPIC_API_KEY
+        sync: false  # 수동으로 설정 필요
+      - key: EMBEDDING_MODEL
+        value: sentence-transformers
+      - key: EMBEDDING_MODEL_NAME
+        value: all-MiniLM-L6-v2
+      - key: CHROMA_PERSIST_DIRECTORY
+        value: ./data/chroma_db
+      - key: COLLECTION_NAME
+        value: financial_papers
+      - key: PDF_SOURCE_PATH
+        value: ./data/pdfs
+      - key: API_HOST
+        value: 0.0.0.0
+      - key: API_PORT
+        value: $PORT
+    healthCheckPath: /health

scripts/download_vector_db.sh

@@ -0,0 +1,34 @@
+#!/bin/bash
+# 벡터 DB 자동 다운로드 스크립트 (Render.com 배포용)
+
+set -e
+
+echo "🔍 Checking if vector DB exists..."
+
+if [ -d "./data/chroma_db" ] && [ "$(ls -A ./data/chroma_db)" ]; then
+    echo "✅ Vector DB already exists. Skipping download."
+    exit 0
+fi
+
+echo "📥 Downloading vector DB from GitHub Release..."
+
+# 디렉토리 생성
+mkdir -p ./data
+
+# GitHub Release에서 다운로드 (실패해도 계속 진행)
+curl -L -o ./data/chroma_db.tar.gz \
+    "https://github.com/csjjin2025/Hallucination_and_Deception_for_financial_RAG/releases/download/v1.0/chroma_db.tar.gz" \
+    || echo "⚠️ Failed to download from Release. Using test DB instead."
+
+# 다운로드 성공 시 압축 해제
+if [ -f "./data/chroma_db.tar.gz" ] && [ -s "./data/chroma_db.tar.gz" ]; then
+    echo "📦 Extracting vector DB..."
+    tar -xzf ./data/chroma_db.tar.gz -C ./data/
+    rm ./data/chroma_db.tar.gz
+    echo "✅ Vector DB extracted successfully!"
+else
+    echo "⚠️ Download failed or file is empty. Creating test DB..."
+    python scripts/quick_setup_test_db.py
+fi
+
+echo "✨ Vector DB setup complete!"