image.png

---
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 설정.

#프로젝트 실행 방법

image.png

왼쪽 상단에 Terminal → New Terminal 누른다.

누르게 되면 이런 창이 나온다.

image.png

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

image.png

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

1번 터미널창에서

image.png

cd DeepFaceWeb

cd backend

python3 main.py 를 순서대로 친다.