Initial commit: AutonetSellCar platform with deployment system

- Frontend: Next.js 14 with TypeScript
- Backend: FastAPI with SQLAlchemy
- Agent: Carmodoo sync agent
- Deployment: Docker Compose based staging/production setup
- Scripts: Automated deployment with rollback support

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

docs/BUSINESS_LOGIC.md

@@ -0,0 +1,179 @@
+# AutonetSellCar Business Logic Documentation
+
+## Overview
+
+이 문서는 AutonetSellCar 플랫폼의 핵심 비즈니스 로직을 정의합니다.
+모든 개발자는 이 문서를 참조하여 기능을 구현해야 합니다.
+
+---
+
+## 1. CC (Car Credit) 시스템
+
+### 1.1 CC란?
+- 플랫폼 내 가상 화폐
+- 차량 추천 서비스에 사용
+- 신규 가입 시 1 CC 지급 (10대 추천 가능)
+
+### 1.2 CC 사용 기준
+
+| 기능 | 비용 | 설명 |
+|------|------|------|
+| 차량 추천 | 1 CC | 10대 차량 추천 받을 수 있음 |
+
+### 1.3 CC 충전 패키지
+
+| 충전 금액 | 받는 CC | 추천 가능 차량 | 할인율 |
+|-----------|---------|----------------|--------|
+| $10 | 10 CC | 100대 | - |
+| $27 | 30 CC | 300대 | 10% |
+| $40 | 50 CC | 500대 | 20% |
+
+### 1.4 결제 수단
+- **Stripe**: Visa/Mastercard (몽골 사용자)
+- **몽골 파트너 계좌**: 수동 충전 (러시아 사용자)
+
+---
+
+## 2. 차량 정보 접근 권한
+
+### 2.1 일반 차량 (비배너)
+
+| 정보 유형 | 비로그인 | 로그인 |
+|-----------|----------|--------|
+| 기본 정보 (제조사, 모델, 연식, 가격) | O | O |
+| 대표 이미지 (1장) | O | O |
+| 전체 이미지 | X (블러) | O |
+| 딜러 연락처 | X | O |
+| 성능점검표 | X | O |
+
+> **참고**: 로그인 사용자는 모든 차량 정보를 열람할 수 있음. CC는 차량 추천 서비스에만 사용.
+
+### 2.2 배너 차량 (Hero Banner)
+
+**배너 차량이란?** 관리자가 메인 페이지 슬라이더에 등록한 프로모션 차량
+
+| 정보 유형 | 비로그인 | 로그인 |
+|-----------|----------|--------|
+| 기본 정보 | O | O |
+| 전체 이미지 | **O (무료)** | O |
+| 딜러 연락처 | **O (무료)** | O |
+| 성능점검표 | **O (무료)** | O |
+
+> **참고**: 배너 차량은 비로그인 사용자도 모든 정보 열람 가능 (프로모션)
+
+---
+
+## 3. 성능점검표 (Performance Check)
+
+### 3.1 접근 권한 조건
+
+성능점검표를 볼 수 있는 경우:
+
+1. **관리자** - 무조건 접근 가능
+2. **로그인 사용자** - 무료 접근 가능
+
+### 3.2 API 엔드포인트
+
+| 엔드포인트 | 설명 | 인증 |
+|------------|------|------|
+| `GET /api/carmodoo/car/{id}/performance-check` | 성능점검표 조회 | Required |
+| `GET /api/carmodoo/car/{id}/performance-check/pdf` | PDF 다운로드 | Required |
+
+---
+
+## 4. 배너 시스템 (Hero Banner)
+
+### 4.1 배너 차량이란?
+
+관리자가 메인 페이지 슬라이더에 등록한 프로모션 차량
+
+### 4.2 배너 차량 특권
+
+배너에 등록된 차량은 **비로그인 사용자**도 다음 정보 열람 가능:
+- 모든 차량 이미지
+- 딜러 연락처
+- 성능점검표
+- 차량 기본 정보
+
+### 4.3 관련 API
+
+| 엔드포인트 | 설명 |
+|------------|------|
+| `GET /api/hero-banners/check/{car_id}` | 배너 차량 여부 확인 |
+| `GET /api/hero-banners/active` | 활성 배너 목록 조회 |
+
+---
+
+## 5. 차량 추천 시스템 (CC 사용)
+
+### 5.1 추천 시스템 개요
+
+```
+사용자가 원하는 조건으로 차량 추천 요청:
+
+1. 사용자가 조건 입력 (예산, 연식, 제조사 등)
+2. CC 차감 (1 CC = 10대 추천)
+3. 시스템이 조건에 맞는 차량 추천
+4. 사용자가 추천 차량 열람
+
+※ 배너 차량 여부는 성능점검표 접근에 영향 없음
+```
+
+### 5.2 파일 의존성
+
+| 기능 | Backend 파일 | Frontend 파일 |
+|------|--------------|---------------|
+| 성능점검표 조회 | `app/api/carmodoo.py` | `app/cars/[id]/page.tsx` |
+| 배너 차량 확인 | `app/api/hero_banners.py` | `app/cars/[id]/page.tsx` |
+| CC 충전 | `app/api/cc.py` | `app/cc/page.tsx` |
+| 차량 추천 | `app/api/recommend.py` | `app/recommend/page.tsx` |
+
+---
+
+## 6. 현지딜러 시스템
+
+### 6.1 딜러 등급 및 수수료
+
+몽골 마진(5%)에서 딜러 수수료 지급:
+
+| 등급 | 조건 | 수수료율 |
+|------|------|----------|
+| 일반 (Standard) | 기본 | 3.0% |
+| 실버 (Silver) | 10건+ 판매 | 3.5% |
+| 골드 (Gold) | 30건+ 판매 | 4.0% |
+| 플래티넘 (Platinum) | 100건+ 판매 | 4.5% |
+
+### 6.2 레퍼럴 시스템
+
+- 딜러가 고객에게 추천 코드 제공
+- 고객이 차량 구매 시 딜러에게 수수료 지급
+- **1단계 직접 추천만 인정** (다단계 아님)
+
+---
+
+## 7. 변경 이력
+
+| 날짜 | 변경 내용 | 작성자 |
+|------|----------|--------|
+| 2024-12-23 | 최초 문서 작성 | Claude |
+| 2024-12-24 | CC 시스템 변경 (추천 서비스 기반) | Claude |
+
+---
+
+## 8. 주의사항
+
+1. **CC는 차량 추천에만 사용**
+   - 차량 정보 열람은 로그인만 하면 무료
+   - CC는 추천 서비스에만 사용 (1 CC = 10대 추천)
+
+2. **배너 차량은 완전 무료**
+   - 비로그인 사용자도 모든 정보 열람 가능
+
+3. **기능 추가 시 이 문서 업데이트 필수**
+   - 새로운 유료/무료 기능 추가 시 반드시 문서화
+
+4. **테스트 시나리오 확인**
+   - 배너 차량 + 비로그인 사용자
+   - 일반 차량 + 비로그인 사용자
+   - 일반 차량 + 로그인 사용자
+   - CC 충전 및 추천 서비스