CatCheck

고양이 사진을 업로드하면 AI가 **신체 충실 지수(BCS, Body Condition Score)**를 분석해주는 웹 서비스입니다.

주요 기능

• BCS 분석 — 고양이 사진을 WSAVA BCS 기준표와 비교해 1~9점 체중 상태 진단
• 사진 검증 및 보정 — 분석에 적합하지 않은 사진은 AI가 표준 자세 이미지로 변환
• 리포트 기록 — 분석 결과를 반려동물별로 저장하고 이력 조회
• 반려동물 관리 — 다수의 고양이 등록 및 관리

기술 스택 한눈에 보기

영역	기술
Frontend	React 19, TypeScript, Vite, Tailwind CSS
Backend	FastAPI, SQLAlchemy, Alembic, Python 3.12
AI	Google Gemini 2.5 Flash, OpenAI DALL-E
Storage	Cloudinary (이미지), PostgreSQL (데이터), Redis (세션)
Infra	Docker, Docker Compose

프로젝트 구조

catcheck/
├── client/               # React 프론트엔드
├── server/               # FastAPI 백엔드
├── docker-compose.dev.yml   # 개발 환경 인프라 (DB, Redis)
└── docker-compose.prod.yml  # 프로덕션 환경

세부 문서

• Frontend (client)
• Backend (server)

빠른 시작

1. .env 파일 설정 (아래 참고)
2. 인프라 실행: docker compose -f docker-compose.dev.yml up -d
3. 백엔드 실행: cd server → 서버 README 참고
4. 프론트엔드 실행: cd client → 클라이언트 README 참고

필수 환경변수 (.env)

POSTGRES_PASSWORD=your_password

DATABASE_URL=postgresql+asyncpg://catcheck:your_password@localhost:5432/catcheck
JWT_SECRET=your_jwt_secret

CLOUDINARY_CLOUD_NAME=
CLOUDINARY_API_KEY=
CLOUDINARY_API_SECRET=

GEMINI_API_KEY=

REDIS_URL=redis://localhost:6379