assets/README.md

# assets 폴더 — 레퍼런스 이미지 배치 가이드

이 폴더에 넣은 이미지는 `app.py`가 자동으로 읽어 생성에 참조합니다.

## 1. 모델 얼굴 프리셋 (필수)

```text
assets/model_face_preset.png
```

- 모든 생성에서 **얼굴 정체성(identity)** 의 기준이 됩니다. (항상 reference image 1)
- 화면에서 `업로드 얼굴`을 선택하지 않으면 이 프리셋이 쓰입니다.

## 2. 모델 체형 레퍼런스 (선택)

```text
assets/model_body_preset.png
```

- 전신 후보 생성 시 추가 레퍼런스로 들어가며, **체형/비율(키 인상, 골격, 어깨너비, 팔다리 비율, 머리-몸 비율)만** 차용합니다.
- 이 이미지의 얼굴·헤어·피부톤·의상·포즈·배경은 **무시**하도록 프롬프트에 명시돼 있습니다. (얼굴은 1번 얼굴 프리셋에서 옴)
- 이 레퍼런스가 있으면 그 비율을 그대로 맞추고, 없으면 중립 비율로 생성합니다. (`IDEALIZE_PROPORTIONS=true`로 8.2~8.5등신 강제도 가능)
- 전신 후보의 크롭·프레이밍 기준으로도 쓰입니다. (`전신_앞면_` 레퍼런스가 있으면 그쪽이 우선)
- (API에 `model_body` 업로드 필드도 열려 있어, 추후 UI에 업로드 버튼을 붙이면 프리셋 대신 그때그때 올릴 수 있습니다.)

## 3. 샷별 레퍼런스 (선택) — `assets/poses/`

각 샷 버튼은 `assets/poses/`의 레퍼런스 이미지 1장과 **1:1로 연결**됩니다.
파일명 = 샷 라벨에서 괄호를 밑줄(`_`)로 바꾼 형태이며, 확장자는 png/jpg/jpeg/webp 모두 가능합니다.

| 샷 버튼 | 파일명 | 노출 카테고리 |
| --- | --- | --- |
| 전신(앞면) | `assets/poses/전신_앞면_.*` | 상의·하의 공통 |
| 전신(측면) | `assets/poses/전신_측면_.*` | 상의·하의 공통 |
| 전신(후면) | `assets/poses/전신_후면_.*` | 상의·하의 공통 |
| 상반신(앞면) | `assets/poses/상반신_앞면_.*` | 상의·하의 공통 |
| 상반신(측면) | `assets/poses/상반신_측면_.*` | 상의·하의 공통 |
| 상반신(후면) | `assets/poses/상반신_후면_.*` | 상의 전용 |
| 상반신(클로즈업) | `assets/poses/상반신_클로즈업_.*` | 상의 전용 |
| 디테일(후면) | `assets/poses/디테일_후면_.*` | 상의 전용 |
| 하반신 | `assets/poses/하반신.*` | 하의 전용 |
| 하반신(클로즈업) | `assets/poses/하반신_클로즈업_.*` | 하의 전용 |

(카테고리 → 버튼 구성: 상의·원피스·아우터 = 상의 세트 8개, 하의·스커트 = 하의 세트 7개)

### 레퍼런스가 정하는 것 / 정하지 않는 것

- **정함**: 포즈, 카메라 각도, 정면/측면/후면 방향, 크롭·프레이밍.
- **정하지 않음**: 얼굴(=1번), 체형/비율(=2번 또는 베이스 컷), 의상(=제품 이미지·선택한 베이스 컷).

### 동작 방식

- 샷 버튼 클릭 시, 그 라벨에 정확히 일치하는 파일을 자동으로 끼워넣습니다. (옛 `full-01.png / upper-01.jpg / lower-01.jpg` 카테고리 방식은 더 이상 사용하지 않으니 삭제해도 됩니다.)
- 전신·상반신(앞/측/후)·하반신 샷은 생성 후 해당 레퍼런스의 세로 프레이밍에 맞춰 **자동 크롭**됩니다.
- 디테일(후면)·상반신(클로즈업)·하반신(클로즈업) 같은 극단적 크롭은 자동 크롭을 건너뛰고 레퍼런스+프롬프트로만 유도합니다.
- 파일이 없으면 해당 샷은 레퍼런스 없이(포즈·크롭 강제 없이) 생성됩니다.

> 한계: 포즈/각도는 ControlNet 같은 강제 조건이 아니라 **근사 참조**라 100% 동일하진 않습니다. 크롭/프레이밍은 후처리로 정확히 맞춰집니다(클로즈업·디테일 제외).