GACHI-AI

GACHI 프로젝트의 AI 서버입니다. BE와 분리된 FastAPI 애플리케이션으로 운영하며, 기존 EC2 docker-compose의 ai 서비스로 배포합니다.

역할

가정통신문 원문과 날짜 후보를 기반으로 제목, 요약, 일정/마감/체크리스트 항목을 분석합니다.
AI 서버는 분석 결과 JSON만 반환하고, DB 저장은 BE가 담당합니다.
OPENAI_ENABLED=true일 때 OpenAI API를 호출하고, 기본값에서는 비용 없는 rule-based baseline으로 응답합니다.
기존 baseline API와 prompt-preview API를 유지합니다.

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

Windows PowerShell에서는 다음처럼 가상환경을 활성화합니다.

.\.venv\Scripts\Activate.ps1

GET /ai/health: 헬스체크
GET /ai/docs: Swagger UI
POST /ai/newsletters/analyze: 제목, 요약, 항목을 함께 반환하는 가정통신문 전체 분석
POST /ai/newsletters/extract-items: 날짜 후보 기반 baseline 항목 추출
POST /ai/newsletters/prompt-preview: LLM 입력용 prompt와 최종 분석 response schema 미리보기

라벨링된 가정통신문 JSON으로 baseline 또는 OpenAI adapter 결과를 평가할 수 있습니다.

python scripts/evaluate_newsletter_labels.py data/newsletter-labels --report-output reports/newsletter-eval-baseline.json

기본 모드는 비용이 발생하지 않는 baseline입니다. 실제 OpenAI 호출은 --mode openai를 명시한 경우에만 실행합니다.