# TheRoad Scene Lab — 개선 제안 체크리스트

> 번호를 알려주시면 적용 여부를 반영합니다.
> Y = 적용 / N = 보류 / 빈칸 = 미결정

---

## 1. AI 분석 품질

| # | 제안 | Effort | Impact | 적용 |
|---|------|--------|--------|------|
| 1 | 씬 타입 분류 (몽타주/회상/꿈/V.O.) → 타입별 T2I 전략 | S | high | |
| 2 | 씬 분석 피드백 루프 — GPT 교차 검증 (visible_entities vs 아웃룩 매핑) | M | high | |
| 3 | 참조 이미지 간 일관성 검증 — "같은 인물인가?" GPT Vision 확인 | L | high | |
| 4 | 프롬프트 번역 역번역 검증 — 한→영→한 의미 비교 | M | medium | |
| 5 | adaptive 씬 변형 수 — 단순 씬 2개, 액션 씬 5개 동적 조정 | M | medium | |
| 6 | 다중 에피소드 학습 — 이전 에피소드 확정 요소 정보 컨텍스트 전달 | M | high | |
| 7 | 엔티티 설명 잘림 40자→150자 확대 | S | medium | |
| 8 | WorldGuide `style_rules` 필드 추가 — 씬 가드레일 실제 적용 | M | high | |
| 9 | GPT 엔티티 리뷰(Turn 1.5) 결과 실제 활용 or 제거 | S | medium | |
| 10 | 씬 의존성 텍스트 미리보기 200→400~600자 확대 | S | medium | |

---

## 2. 이미지 생성 품질

| # | 제안 | Effort | Impact | 적용 |
|---|------|--------|--------|------|
| 11 | T2I 변형 구도 다양성 강제 — 변형마다 camera_angle_hint 필수 | M | high | |
| 12 | 첫 등장 장소에 location 참조 이미지 포함 | M | high | |
| 13 | 씬 간 캐릭터 외모 일관성 교차 검증 + 불일치 시 재생성 | L | high | |
| 14 | composite 아웃룩 이미지 — 구조화 프롬프트 빌더 경유 | M | high | |
| 15 | 다중 신호 이미지 랭킹 — 검증 점수+연속성+커버리지 복합 스코어 | M | high | |
| 16 | 이미지 검증 pass threshold 엔티티 타입별 커스텀 (60 고정→조정) | S | medium | |
| 17 | next_ref(뒤쪽 연관 씬) 저장 + 양방향 연속성 참조 | S | medium | |
| 18 | 토너먼트 선택 프롬프트 외부화 (인라인 한국어→버전 관리 파일) | S | low | |

---

## 3. 성능 최적화

| # | 제안 | Effort | Impact | 적용 |
|---|------|--------|--------|------|
| 19 | DB 인덱스 추가 — 핵심 10개 쿼리 컬럼 | S | critical | |
| 20 | N+1 쿼리 제거 — list_stills 275개→IN 1개 | M | high | |
| 21 | DB 커넥션 풀 설정 (pool_size=10, max_overflow=20) | S | high | |
| 22 | Episode.fulltext lazy loading (defer) | S | medium | |
| 23 | 씬 변형 내부 병렬 생성 — 씬당 3개 동시 T2I → ~2배 단축 | M | high | |
| 24 | 엔티티 워커 스태거 적응형 (2초 고정→0.5초+429 backoff) | S | medium | |
| 25 | progress 5개 쿼리 → IN 1개로 통합 | S | medium | |
| 26 | 참조 이미지 바이트 lazy loading (resume 모드 디스크 I/O 절감) | S | low | |

---

## 4. 프론트엔드 UX

| # | 제안 | Effort | Impact | 적용 |
|---|------|--------|--------|------|
| 27 | 글로벌 토스트/에러 시스템 — 모든 API 에러 표시 | M | critical | |
| 28 | EpisodeDetail 2패널 레이아웃 — 좌측 씬 목록 + 우측 상세 | L | high | |
| 29 | SceneVariationCard 아코디언 — 콘텐츠/프롬프트/이미지 3단 접기 | M | high | |
| 30 | 이미지 리뷰 키보드 단축키 — ←→ A R S | M | high | |
| 31 | 배치 승인/거부 — 체크박스 다중선택 + 일괄 액션 | M | high | |
| 32 | 이미지 나란히 비교 뷰 — 2~3컬럼 변형 비교 | M | high | |
| 33 | SSE 실시간 업데이트 — 3초 폴링 대체 | L | high | |
| 34 | WorldGuide 구조화 폼 에디터 — JSON→필드별 입력 | M | high | |
| 35 | 씬 점프 네비게이션 — "씬 #" 입력 + G 단축키 | S | high | |
| 36 | 엔티티 텍스트 검색 | S | high | |
| 37 | 스켈레톤 로더 — "로딩 중..." 텍스트 대체 | S | medium | |
| 38 | 세그먼테이션 슬라이더 디바운스 400ms | S | medium | |
| 39 | 에피소드 번호 자동 증가 | S | low | |
| 40 | 이미지 리뷰 필터 카운트 뱃지 — "수정 필요 (12)" | S | low | |
| 41 | 이미지 리뷰 카드에 씬 컨텍스트 표시 | S | medium | |
| 42 | Export 설정 툴팁 + 에피소드 라벨 | S | low | |

---

## 5. 아키텍처 & 코드 품질

| # | 제안 | Effort | Impact | 적용 |
|---|------|--------|--------|------|
| 43 | AnalysisService God Method 분할 (400줄→3개 메서드) | M | medium | |
| 44 | ImageService 분할 (3,500줄→4개 서비스) | L | medium | |
| 45 | 백그라운드 태스크 레지스트리 — stale running 상태 자동 복구 | M | high | |
| 46 | Alembic 마이그레이션 도입 — timestamp TIMESTAMPTZ 전환 | M | medium | |
| 47 | 구조화 로깅 (structlog) — project_id/episode_id 바인딩 | M | medium | |
| 48 | 헬스체크 엔드포인트 (DB+키+모델 상태) | S | medium | |
| 49 | LLMCallLog 커버리지 확대 — 직접 urllib GPT 호출 4건 교체 | M | medium | |
| 50 | 데이터 정규화 — visible_entities JSON→별도 테이블 | L | critical | |
| 51 | 재분석 시 고아 ImageAsset 정리 | S | medium | |
| 52 | 순차 모드(v3) 데드코드 120줄 제거 | S | low | |

---

## 6. 보안 & 운영

| # | 제안 | Effort | Impact | 적용 |
|---|------|--------|--------|------|
| 53 | 기본 비밀번호 제거 — .env 필수 + 시작 시 검증 | S | critical | |
| 54 | 세션 쿠키 Secure 플래그 추가 | S | high | |
| 55 | LLMCallLog 프롬프트 자르기 10K자 + 30일 보존 정책 | S | medium | |
| 56 | PostgreSQL 통합 테스트 환경 (docker-compose.test.yml) | M | high | |

---

## 7. 전략적 대규모 개선 (Codex)

| # | 제안 | Effort | Impact | 적용 |
|---|------|--------|--------|------|
| 57 | 내구성 작업 큐 (Celery/ARQ) — 프로세스 재시작 안전 | XL | critical | |
| 58 | 증분 파이프라인 — content hash 기반 변경 단계만 재실행 | XL | critical | |
| 59 | 씬 플래닝 아티팩트 — n-way 분할 + 사용자 승인 후 실행 | M | high | |
| 60 | WorldGuide 버전 관리 — 소스 해시 + 부분 갱신 | M | high | |
| 61 | 다중 사용자 작업 잠금 — 에피소드 단위 exclusive lease | M | high | |
| 62 | 운영 대시보드 — correlation ID + 비용 메트릭 + traces UI | M | high | |
| 63 | 프론트엔드 데이터 레이어 업그레이드 — typed query + cache | M | medium | |
| 64 | E2E 파이프라인 테스트 — fixture LLM 응답으로 전체 흐름 검증 | M | medium | |

---

**총 64건. 번호로 Y/N 알려주세요.**

예시: `19,20,21,27,35,36,53,54 적용` 또는 `1~10 중 1,6,7,8 적용, 나머지 보류`