자소서 검증 시스템

자소서 텍스트에서 검증 가능한 주장(Claim)을 추출하고, 즉석 후속 질문을 통해 검증하는 시스템입니다.

빠른 시작

# 환경 변수 설정
cp env.example .env.local
# .env.local 파일 편집

# 컨테이너 실행
docker compose up -d

# 헬스 체크
curl http://localhost:8000/health

# API 문서: http://localhost:8000/docs

문서

모든 문서는 docs/ 폴더에 정리되어 있습니다:

• 프로젝트 개요 및 개발 가이드 - 전체 프로젝트 설명, API 목록, 개발 환경 설정
• 배포 가이드 - AWS 배포 방법 및 GitHub Actions CI/CD
• Claim 파싱 파이프라인 - 파이프라인 상세 설명
• Colab 학습 가이드 - 모델 학습 방법
• 프롬프트 문서 - 질문 생성 프롬프트 가이드
• RoBERTa A/B 테스트 리포트 - 모델 성능 평가
• 아키텍처 다이어그램 - 시스템 아키텍처 및 시퀀스 다이어그램

프로젝트 구조

khuda-homepage-ai/
├── backend/          # FastAPI 백엔드
├── deploy/           # 배포 스크립트
├── colab/            # Colab 학습 노트북
├── data/             # 학습 및 테스트 데이터
├── docs/             # 프로젝트 문서
└── docker-compose.yml

기술 스택

• Backend: FastAPI, PostgreSQL, FAISS
• ML: BERT 계열 (Claim 파싱), LLM (질문 생성)