
---
alwaysApply: true
---
## 프로젝트 개요
당신은 **시니어 풀스택 개발자 겸 컴퓨터 비전 엔지니어**입니다.
아래 요구사항을 모두 만족하는 **로컬 실행 가능한 전체 프로젝트 코드**를 생성하세요. (Docker 제외)
---
## 핵심 요구사항
### 기술 스택
- **Frontend**: Next.js 14, TypeScript, Tailwind CSS, Three.js (@react-three/fiber)
- **Backend**: FastAPI, PyTorch, **DeepFace(필수)**, MediaPipe, OpenCV
---
## 필수 기능
1. **이미지 업로드** → DeepFace로 얼굴 **검출/정렬/안티스푸핑**
2. **영역 추출** → MediaPipe / face-parsing 으로 **눈·코·턱·광대·입술** 세그먼트 추출
3. **부위별 슬라이더 편집** → `eyes, nose, jaw, cheek, lips (-1.0 ~ +1.0)` → **2D 국소 변형**(Thin Plate Spline / Piecewise Affine)
4. **이미지 합성** → OpenCV 기반(**경계 feathering**, **색 보정**)
5. **Three.js 미리보기** → **저해상도 실시간 프리뷰**
6. **최종 결과 다운로드** → **서버에서 고해상도 PNG** 반환
---
## API (FastAPI)
- **GET `/api/health`** → `{ cuda:bool, device:str, torch_version:str }`
- **POST `/api/facecheck`** : 이미지 업로드 → `{ ok, facial_area, spoof:bool }`
- **POST `/api/edit2d`** : `{ image, edits:{eyes,nose,jaw,cheek,lips} }` → **PNG 결과 반환**
---
## 구현 지침
### GPU 최적화
- `torch.cuda.is_available()` 로 GPU 사용 여부 확인
- `torch.inference_mode()` 로 추론 경량화
- **FP16(autocast)** 사용
### 업로드 제한
- **JPG/PNG**, **최대 5MB**
- 처리 완료 후 **임시파일 즉시 삭제**
### 파라미터 클램핑
- 슬라이더 입력값은 **-1.0 ~ +1.0** 범위로 **백엔드에서 강제(clamp)**
### 에러 처리
- 명시적 JSON 에러 코드 사용:
- 얼굴 미검출: `NO_FACE`
- 스푸핑 탐지: `SPOOF`
- 잘못된 이미지: `BAD_IMAGE`
---
## 프로젝트 구조
face-surgery/
├─ frontend/ # Next.js 앱
│ ├─ app/
│ ├─ components/ # 업로드, 슬라이더, 프리뷰
│ └─ lib/api.ts # API 호출 로직
└─ backend/ # FastAPI 서버
├─ main.py # 서버 진입점
├─ models/ # DeepFace, MediaPipe, Parsing 모델
├─ services/ # 변형/합성 로직
└─ requirements.txt
## UI 요구사항
- 반응형 레이아웃 (모바일/데스크톱)
- **좌측**: 편집 슬라이더 패널
- **중앙**: Before/After 스플리터 뷰 + 확대/축소
- **상태 표시**: 로딩/에러 토스트
- **지시사항(사용자 친화성)**: UI는 사용자 친화적으로 설계할 것(직관적 슬라이더, 명확한 피드백, 접근성 준수, 모바일 최적화).
---
## 완성 기준
- `/api/health` 가 **CUDA/torch 정보**를 정확히 반환
- **5MB 초과** 시 **프론트/백엔드** 모두 에러 처리
- DeepFace 얼굴 미검출 시 **`NO_FACE` 응답**
- **편집 결과 PNG 즉시 다운로드** 가능
- **프리뷰 반응 속도 1초 이내**
일단 rule 설정.
#프로젝트 실행 방법

왼쪽 상단에 Terminal → New Terminal 누른다.
누르게 되면 이런 창이 나온다.

오른쪽 위에 + 버튼을 누른다.

그럼 이렇게 터미널창이 2개 생성된다. (하나는 프론트엔드 하나는 백엔드를 위함.)
1번 터미널창에서

cd DeepFaceWeb
cd backend
python3 main.py 를 순서대로 친다.