Files

AutonetSellCar Deploy 1f0dcb1ddb 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>

2025-12-30 13:24:39 +09:00

5.0 KiB

Raw Permalink Blame History

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 접근 권한 조건

성능점검표를 볼 수 있는 경우:

관리자 - 무조건 접근 가능
로그인 사용자 - 무료 접근 가능

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. 주의사항

CC는 차량 추천에만 사용
- 차량 정보 열람은 로그인만 하면 무료
- CC는 추천 서비스에만 사용 (1 CC = 10대 추천)
배너 차량은 완전 무료
- 비로그인 사용자도 모든 정보 열람 가능
기능 추가 시 이 문서 업데이트 필수
- 새로운 유료/무료 기능 추가 시 반드시 문서화
테스트 시나리오 확인
- 배너 차량 + 비로그인 사용자
- 일반 차량 + 비로그인 사용자
- 일반 차량 + 로그인 사용자
- CC 충전 및 추천 서비스

5.0 KiB Raw Permalink Blame History