# TheRoad Scene Lab - 개발 로그

## 2026-03-15: Phase 3 완료 — 이미지 생성 + 리뷰 워크플로 + PDF 출력

### Phase 3a: 이미지 생성 모듈

- `e90f174` — DB 모델 (ImageAsset, WorldGuide, WebbookPackage), Gemini 이미지 클라이언트, 참조/씬 이미지 생성 모듈
- `b9a1509` — 이미지 서비스, REST API (8 엔드포인트), 테스트
  - **모듈**: gemini_image_client v1.0.0, reference_image_generator v1.0.0, scene_image_generator v1.0.0, world_guide_generator v1.0.0, image_service v1.0.0
  - **프롬프트 연동**: prototype_prompts/v5 (entity_reference_ko, scene_image_ko, world_guide)
  - 특수 캐릭터 가드레일 (DR.NEX, 한치호, 은성, 서현, 오리엔티스)
  - 리뷰 워크플로 (approved/needs_fix/regenerate)

### Phase 3b: 웹북 생성 + PDF 렌더링

- `f1987f4` — 웹북 생성기, PDF 렌더러, 내보내기 서비스
- `12fe35e` — 내보내기 API, i18n, 테스트
  - **모듈**: webbook_generator v1.0.0, pdf_renderer v1.0.0
  - **프롬프트 연동**: prototype_prompts/v5 (webbook_package)
  - fpdf2 기반 long-page PDF (399.685pt 폭)

### Phase 3c: 프론트엔드

- `1b4861b` — 이미지 리뷰 페이지, 내보내기 스튜디오
  - 이미지 그리드 + 타입/상태 필터
  - 리뷰 모달 (승인/수정 필요 + 메모)
  - 줌 모달
  - 수정 필요 일괄 재생성
  - 웹북 생성 폼 + PDF 렌더링 + 다운로드
  - 사이드바에 이미지 리뷰/내보내기 메뉴 추가

---

## 2026-03-15: Phase 2 완료 — 에피소드 관리 + 엔티티 분석 + LLM 모듈

### Phase 2a: 에피소드 관리 + PDF 업로드

- `d4d923c` — 에피소드 CRUD API, PDF 업로드, 텍스트 추출, 언어 감지
  - **모듈**: pdf_parser v1.0.0
  - 프로젝트 DB 스키마 확장 (8테이블)

### Phase 2b: LLM 분석 모듈

- `965ae2b` — LLM 클라이언트, 엔티티 추출, 씬 스틸 추출, 분석 서비스
- `0ae1cd0` — 엔티티 추출기 chunk 프롬프트 수정
  - **모듈**: entity_extractor v1.0.0, scene_still_extractor v1.0.0, analysis_service v1.0.0
  - **프롬프트 연동**: entity_extraction/v5, scene_stills/v2

### Phase 2c: 프론트엔드

- `f7458b9` — 에피소드/엔티티 UI (업로드, 분석, 브라우저)

---

## 2026-03-14: Phase 1 완료 — 인증 + 사용자 관리 + 프로젝트 CRUD + 활동 로그 + 프론트엔드

- `af4f80d` ~ `e41a527` — 백엔드 기반 (FastAPI, i18n, 모델, security, 스키마)
- `9c36366` ~ `17d8a1e` — 인증/사용자/프로젝트 서비스 + API
- `65d0370` ~ `dc40571` — React 프론트엔드 (로그인, 대시보드, 프로젝트 상세, Admin)
- `79190dc` — API trailing slash 수정

---

## 모듈 버전 (현재)

| 모듈 | 버전 | 프롬프트 의존성 |
|------|------|----------------|
| auth_service | 1.0.0 | 없음 |
| user_service | 1.0.0 | 없음 |
| project_service | 1.0.0 | 없음 |
| activity_logger | 1.0.0 | 없음 |
| pdf_parser | 1.0.0 | 없음 |
| entity_extractor | 1.0.0 | entity_extraction/v5 |
| scene_still_extractor | 1.0.0 | scene_stills/v2 |
| analysis_service | 1.0.0 | 없음 |
| gemini_image_client | 1.0.0 | 없음 |
| reference_image_generator | 1.0.0 | prototype_prompts/v5 (entity_reference) |
| scene_image_generator | 1.0.0 | prototype_prompts/v5 (scene_image) |
| world_guide_generator | 1.0.0 | prototype_prompts/v5 (world_guide) |
| image_service | 1.0.0 | 없음 |
| webbook_generator | 1.0.0 | prototype_prompts/v5 (webbook_package) |
| pdf_renderer | 1.0.0 | 없음 |

## 테스트

- 백엔드: 70개 테스트 전부 통과
- 프론트엔드: 빌드 성공