# tools/nanobanana — Gemini 이미지 생성(나노바나나) 연동 모듈

부스/인테리어/배선/조명 설계 데이터를 "시공 후 결과 사진"으로 렌더링한다.

## 준비
```bash
pip install google-genai
export GEMINI_API_KEY=발급받은_키   # https://aistudio.google.com
```

## 빠른 시작
```python
from tools.nanobanana.client import NanoBananaClient
c = NanoBananaClient()
img = c.generate_booth_photo({
    "hall": "제1전시장 3홀",
    "size_m": (6, 3),
    "booth_type": "목공부스",
    "brand_color": "#0052A5",
    "materials": ["백색 무광 목공", "우드 포인트월", "그레이 카펫"],
    "lighting": {"color_temp_k": 4000, "accents": ["로고 스포트", "쇼케이스 라인조명"]},
}, view="front", time_of_day="night")
img.save("booth_night.png")
```

## 표준 샷 세트 S1~S7 (PLANNING §6 기준, visualizer 에이전트가 관리)
| 샷 | 호출 | 용도 |
|---|---|---|
| S1 정면 주간 | `generate_booth_photo(view="front", time_of_day="day")` | 기본 시안 확인 |
| S2 정면 야간 | `generate_booth_photo(view="front", time_of_day="night")` | 조명 연출 평가 |
| S3 통로 뷰 | `generate_booth_photo(view="aisle")` | 관람객 시점 동선 평가 |
| S4 내부 뷰 | `generate_booth_photo(view="interior")` | 인테리어/집기 배치 |
| S5 Before/After | S1 결과 + `reference_image`(빈 부스 실측) 쌍 | 시공 전/후 비교 슬라이더 |
| S6 배선 오버레이 | `generate_wiring_overlay(kind="network|power|plumbing")` | 발표/설명용 보조 이미지 (시공 검증은 백엔드 래스터 합성 사용) |
| S7 홀 전경 조감 | `generate_booth_photo(view="aerial")` | 배치안 비교(SCR-04) |

## 정책
- 생성 이미지는 "AI 생성 예상 이미지 — 실제 시공 결과와 다를 수 있음" 워터마크를 붙여 서비스에 노출한다 (계약 서류 사용 금지).
- 참조 이미지(빈 부스 실측 사진)를 넣으면 실제 홀 구조를 보존한 합성이 된다 (ReRoomAI 패턴).