# task-434.1 보고서: Remotion 딥리서치 + ThreadAuto 영상 퀄리티 개선 계획

**작성일:** 2026-03-10
**작성팀:** dev1 (헤르메스 팀장)
**작업 타입:** research (코드 변경 없음)
**레벨:** Lv.2

---

## 작업 내용

ThreadAuto 프로젝트의 영상/카드뉴스 퀄리티 향상을 위해 Remotion 프레임워크에 대한 딥리서치를 수행하고, 마이그레이션 계획을 수립했습니다.

### 리서치 범위

1. **Remotion 핵심 개념**: React 기반 프레임 렌더링, Composition/Sequence/Still API, useCurrentFrame()/spring() 애니메이션
2. **ThreadAuto 적용 가능성**: 카드뉴스(renderStill) + 영상(renderMedia), Threads/Reels 규격 지원, headless Linux 렌더링
3. **기술 스택 비교**: Pillow+MoviePy vs Remotion — 퀄리티/속도/비용/유지보수성
4. **Remotion 생태계**: @remotion/player, @remotion/lambda, @remotion/renderer, Lottie, Google Fonts
5. **환경 제약사항**: Ubuntu 서버, Node.js v24, 하루 20개 콘텐츠 처리, 메모리 요구사항

### 팀원 역할

- **불칸(백엔드)**: Python↔Node.js 브릿지 기술, 서버사이드 렌더링, Lambda 비용 분석, 성능 벤치마크
- **이리스(프론트엔드)**: Remotion API 상세, 코드 예제, 보험 콘텐츠 템플릿 설계, 프로젝트 구조
- **아테나(UX/UI)**: Pillow vs Remotion 시각적 퀄리티 비교, 보험 디자인 패턴, 고급 효과 가능성
- **아르고스(테스터)**: 기존 코드 분석, 파이프라인 연결점, JSON props 매핑, 마이그레이션 리스크

---

## 핵심 결론

### Remotion 도입 추천 (조건부)

dev2팀의 이전 리서치(task-342.1)에서는 MoviePy를 1순위로 추천했으나, 본 딥리서치 결과 **장기적으로 Remotion 전환이 유리**하다고 판단합니다.

**추천 근거:**
- 시각적 퀄리티 격차 압도적 (Pillow 40/100 vs Remotion 90/100)
- React 역량 보유 (InsuWiki, InsuRo 프로젝트)
- 라이선스 무료 (3인 이하 영리 조직)
- Node.js v24 + Ubuntu 환경 호환
- content_generator_v2 출력 JSON을 거의 그대로 Remotion inputProps로 전달 가능
- 카드뉴스(renderStill) + 영상(renderMedia) 동일 프레임워크 통합

**조건:**
- 서버 RAM 최소 4GB (8GB 권장)
- 점진적 전환 (POC → 카드뉴스 → 영상)
- 기존 Pillow/MoviePy 병행 운영으로 리스크 최소화

### 마이그레이션 개요

- **Phase 0**: 환경 셋업 (1~2일)
- **Phase 1**: POC - 카드뉴스 cover 1종 (1~2주)
- **Phase 2**: 카드뉴스 전체 전환 (3~4주)
- **Phase 3**: 영상 파이프라인 전환 (3~4주)
- **Phase 4**: 최적화 + 고급 효과 (2~3주)
- **총 예상 기간**: 10~14주

---

## 생성/수정 파일 목록

| 파일 | 액션 | 내용 |
|------|------|------|
| `/home/jay/workspace/memory/research/remotion-deep-dive.md` | 생성 | Remotion 딥다이브 리서치 보고서 |
| `/home/jay/workspace/memory/plans/threadauto-remotion/migration-draft.md` | 생성 | 마이그레이션 초안 (Phase별 계획, 템플릿 구조, 연결점) |
| `/home/jay/workspace/memory/todo.json` | 수정 | issue-007을 Remotion 기반으로 업데이트 (priority: high, 9개 sub_items) |
| `/home/jay/workspace/memory/reports/task-434.1.md` | 생성 | 본 보고서 |

## 테스트 결과

- 리서치 작업이므로 코드 테스트 해당 없음
- 기존 코드 분석: 파이프라인 구조, JSON props 매핑, 출력 규격 확인 완료

## 버그 유무

- 없음 (코드 변경 없는 리서치 작업)

## 비고

- dev2팀 선행 리서치(task-342.1, remotion-video-automation.md)를 기반으로 Remotion 전용 딥다이브 수행
- 이전 리서치와의 차별점: Remotion API 코드 예제, ThreadAuto 기존 코드 연결점 상세 분석, HTTP API 브릿지 설계, 보험 콘텐츠 특화 템플릿 구조
- 후속 작업: Phase 0 환경 셋업 → Phase 1 POC (issue-007 sub_items 순서대로 진행)