婚纱推荐API

┌──────────────┐
│   Client     │ (HTTP)
└──────┬───────┘
       │
       ↓
┌─────────────────────────────────────┐
│   API Layer (FastAPI)               │
│   └─ Routes (recommend, stats)      │
└──────┬──────────────────────────────┘
       │
       ↓
┌─────────────────────────────────────┐
│   Services Layer                    │
│   ├─ Recommender (AI Logic)         │
│   └─ Schemas (Pydantic)             │
└──────┬──────────────────────────────┘
       │
┌──────┴──────┬──────────────┐
│   Database  │   Config     │
│   Layer     │   Layer      │
├─────────────┼──────────────┤
│ • Session   │ • Settings   │
│ • Models    │ • Redis      │
│ • Repos     │              │
└─────────────┴──────────────┘
       │
       ↓
┌──────────────┐  ┌──────────────┐
│    MySQL     │  │    Redis     │
│  (L2 Cache)  │  │  (L1 Cache)  │
└──────────────┘  └──────────────┘

wedding-dress-api/
├── src/
│   ├── api/                      # FastAPI REST API
│   │   ├── main.py              # FastAPI app
│   │   └── routes/              # API routes
│   │       ├── recommend.py     # 드레스 추천 엔드포인트
│   │       └── stats.py         # 통계 엔드포인트
│   │
│   ├── services/                # 비즈니스 로직
│   │   ├── schemas.py           # Pydantic 스키마
│   │   └── recommender.py       # AI 추천 엔진
│   │
│   ├── database/                # 데이터베이스
│   │   ├── session.py           # DB 세션
│   │   ├── models.py            # SQLAlchemy 모델
│   │   └── repositories/        # Repository 패턴
│   │       └── recommendation.py
│   │
│   └── config/                  # 설정
│       ├── settings.py          # 환경 설정
│       └── redis.py             # Redis 클라이언트
│
├── scripts/                     # 유틸리티
│   └── init.sql                 # DB 초기화 스크립트
│
├── Dockerfile                   # Docker 이미지
├── docker-compose.yaml          # 로컬 개발 환경
├── requirements.txt             # Python 의존성
└── README.md

# 1. 환경 변수 설정
cp .env.example .env
# .env 파일에서 OPENAI_API_KEY와 MYSQL_PASSWORD 설정

# 2. 서비스 시작
docker-compose up -d

# 3. 로그 확인
docker-compose logs -f api

# 4. 테스트
curl http://localhost:18000/health

curl -X POST http://localhost:18000/recommend \
  -H "Content-Type: application/json" \
  -d '{
    "arm_length": "보통",
    "leg_length": "긴",
    "neck_length": "보통",
    "face_shape": "달걀"
  }'

# 1개만 추천받기
curl -X POST http://localhost:18000/recommend \
  -H "Content-Type: application/json" \
  -d '{
    "arm_length": "보통",
    "leg_length": "긴",
    "neck_length": "보통",
    "face_shape": "달걀",
    "num_recommendations": 1
  }'

# 5개 추천받기
curl -X POST http://localhost:18000/recommend \
  -H "Content-Type: application/json" \
  -d '{
    "arm_length": "보통",
    "leg_length": "긴",
    "neck_length": "보통",
    "face_shape": "달걀",
    "num_recommendations": 5
  }'

{
  "request_params": {
    "arm_length": "보통",
    "leg_length": "긴",
    "neck_length": "보통",
    "face_shape": "달걀"
  },
  "recommendations": [
    {
      "style_name": "A라인 드레스",
      "description": "상체는 슬림하게, 하체는 풍성하게...",
      "why_recommended": "긴 다리를 돋보이게 하며...",
      "styling_tips": [
        "하이힐을 신어 다리 라인을 더욱 강조",
        "심플한 목걸이로 얼굴형을 살림"
      ]
    }
  ],
  "overall_advice": "달걀형 얼굴과 긴 다리를 가진 신부님께는...",
  "cached": false,
  "source": "ai_generated"
}