HealthSync_Motivator/README.md

HealthSync Motivator Batch Service

AI 기반 미션 독려 메시지 생성 배치 서비스

🎯 서비스 개요

사용자가 완료하지 않은 건강 미션을 조회하여 Claude AI를 통해 개인화된 독려 메시지를 생성하고, 채팅 DB에 저장하는 배치 서비스입니다.

🏗️ 아키텍처

📁 motivator-batch-service/
├── app/
│   ├── batch_runner.py          # 메인 실행파일 (크론탭용)
│   ├── config/                  # 환경설정
│   ├── models/                  # 데이터 모델
│   ├── services/                # 비즈니스 로직
│   ├── repositories/            # 데이터베이스 쿼리
│   └── utils/                   # 유틸리티

🔄 배치 처리 플로우

1. 활성 사용자 조회: 최근 30일 내 로그인한 사용자
2. 미완료 미션 조회: 오늘 완료되지 않은 미션 목록
3. 독려 메시지 생성: Claude AI를 통한 개인화된 메시지 생성
4. 채팅 DB 저장: intelligence_service.chat_message 테이블에 저장

🚀 실행 방법

로컬 실행

# 환경설정 파일 생성
cp .env.example .env
# .env 파일 수정 (API 키, DB 정보 등)

# 의존성 설치
pip install -r requirements.txt

# 배치 실행
python app/batch_runner.py