INTERACTIVE PPT GUIDE · 난이도 B(중급) + C(전문가) 통합

우리가 만들고 싶은 것
유튜브 실시간 구독자·조회수 영상 제작 흐름

유튜브 조회/구독자 추이를 표 + 애니메이션 영상으로 만드는 전체 흐름을,
초보·전문가 모두 이해할 수 있게 정리한 실전 엔지니어링 가이드입니다.
난이도 B(중급) + C(전문가)를 한 슬라이드 덱에서 함께 담았습니다.

Step 1 · 수집 YouTube API + Supabase로 시간별 조회/구독자 스냅샷 적재
Step 2 · 정제 pg_cron + 수동 조회 스냅샷을 Remotion용 표 데이터로 가공
Step 3 · 렌더링 youtube-stats-table 템플릿과 GitHub 파이프라인으로 영상 출력
end-to-end-goal.pipeline — 3 Core Pillars
OVERVIEW
01. YouTube API + Supabase로 시간별 조회/구독자 스냅샷 적재
채널/영상 단건·배치 조회로 현재 시점 통계를 가져와 시계열 DB에 차곡차곡 쌓습니다.
Data Layer
02. 시계열 테이블을 영상 템플릿용 표 데이터로 정제
Supabase pg_cron + 수동 조회로 시간별 스냅샷을 계속 쌓으면서, Remotion이 읽기 좋은 형태로 가공합니다.
Transform
03. Remotion youtube-stats-table 템플릿으로 실시간 구독자 영상 추출
시계열을 표 데이터로 변환해 템플릿과 저장소(GitHub)를 통해 재사용 가능한 파이프라인으로 만듭니다.
Remotion MP4
SLIDE 02 · ARCHITECTURE BLUEPRINT
관제 경로: /cron-manager (조회/구독자 추이 탭) → /video-creator

전체 아키텍처 한눈에 보기

유튜브 데이터 → Supabase → Remotion → mp4 까지 한 번에 보여줍니다. 초보자는 상단 설명만, 개발자는 하단 기술 키워드를 함께 보시면 됩니다.

▶

1. YouTube

채널/영상 실시간 통계 원본

YouTube Data API v3
λ

2. Next.js API

/api/youtube-manager/trends/*

Route Handler + Supabase Client
DB

3. Supabase

시계열 스냅샷 영구 저장소

app_youtube_trends_timeseries_v1
🎬

4. /video-creator

유튜브 추이 표 템플릿 & 렌더

@remotion/player & SSR mp4
초보용 한 줄 정리
“유튜브 숫자를 엑셀처럼 저장해 두고, 그 숫자를 이용해 예쁜 영상을 만든다.”
데이터 수집·추적 대상 관리는 /cron-manager의 조회/구독자 추이 탭에서 합니다.
전문가용 키워드
Next.js Route Handler, Supabase 시계열 테이블, 배치 YouTube API 호출, Remotion 컴포지션, 서버 사이드 렌더링(SSR).
SLIDE 03 · CRON MANAGER & TRENDS TAB
엔드포인트: /api/youtube-manager/trends/tracked · /snapshots
CM

/cron-manager · 데이터 수집 관제실

크론 매니저 & TrendsTab 역할

/cron-manager의 조회/구독자 추이(TrendsTab)는
“어떤 채널/영상을 얼마나 자주 기록할지”를 관리하는 데이터 관제실입니다.
📥 Tracked 추가
• 채널/영상 URL, 채널 ID(UC…), 영상 ID(11자)를 입력
• 추가 버튼 1번으로 추적 대상 등록 + 현재 시점 스냅샷 1건 즉시 기록
📈 목록·시계열
• 채널/영상별로 시계열 스냅샷 표 조회
• “채널은 없고 영상만 있는 경우”도 채널 ID로 묶어서 한눈에 보여줌
심화 백엔드
/api/youtube-manager/trends/tracked 와 /snapshots Route Handler가 이 화면의 데이터를 제공합니다.
화면 경로/cron-manager (TrendsTab)
등록 즉시 동작대상 등록 + 첫 스냅샷 1건 Insert
그룹핑 규칙영상 단독 등록도 채널 ID 기준 묶음
app/cron-manager/components/TrendsTab.tsx
CONTROL CENTER
📥 TRACKED TARGET REGISTRATION
https://youtube.com/watch?v=n8fdEYaDtfM 또는 UCt-BApVtJGrvF5pCgbiNVeg
+ 추적 추가 & 즉시 기록
GET /api/youtube-manager/trends/tracked
지금까지 한 번이라도 기록된 채널/영상 ID 목록 반환 (채널 ID 기준 트리 그룹핑)
Tracked List
GET /api/youtube-manager/trends/snapshots?videoId=...
선택한 채널 또는 영상의 시간대별 구독자·조회수·좋아요·댓글 스냅샷 시계열 반환
Snapshots
SLIDE 04 · INPUT PARSING & TRACK API
핵심 함수: buildTrackBody() → POST /api/youtube-manager/trends/track
TR

자동 판별 분기 로직 · 400 방어 설계

입력값 → track API 플로우

초보자는 “어떤 걸 입력해도 알아서 채널/영상으로 구분해 준다”고 이해하면 충분합니다.
개발자는 아래 3단계 분기 로직을 참고하세요.
① 사용자 입력
사용자가 채널/영상 URL · 채널 ID · 영상 ID 중 하나를 입력창에 넣습니다.
② 입력값 분석
buildTrackBody()가 입력을 자동 판별합니다:
• UC로 시작 & 24자 → channelId
• 11자 영문+숫자+_- → videoId
• 나머지 문자열 → url
③ API & DB
POST /api/youtube-manager/trends/track 호출 → YouTube API 조회 → Supabase에 스냅샷 1행 Insert.
케이스 1: 채널 ID^UC[\w-]{22}$ (총 24자)
케이스 2: 영상 ID^[\w-]{11}$ (총 11자)
예외 방어 (400 Error)둘 이상 동시 입력 시 차단
buildTrackBody() → POST /api/youtube-manager/trends/track
BRANCH LOGIC
Case A. "UCt-BApVtJGrvF5pCgbiNVeg" (UC 시작 24자)
payload: { channelId: "UCt-BApVtJGrvF5pCgbiNVeg" } → 채널 전용 스냅샷 기록
channelId
Case B. "n8fdEYaDtfM" (11자 영문·숫자·_-)
payload: { videoId: "n8fdEYaDtfM" } → 영상 전용 통계 + 상위 채널 ID 매핑 기록
videoId
Case C. "https://www.youtube.com/watch?v=..." (나머지)
payload: { url: "..." } → 서버에서 URL 파싱 후 채널/영상 분기 처리
url
🛠️ 개발자 메모: 잘못된 조합은 400 Bad Request 차단
채널 전용, 영상 전용, URL 입력 세 케이스를 엄격히 분리하며, 둘 이상 동시 입력은 400 에러로 막아 둡니다.
400 Guard
SLIDE 05 · PG_CRON & BATCH COLLECTION
배치 함수: runTrendsRecord(force) · 스킵 가드: shouldRecordChannel/Video
CR

30분 주기 스케줄링 & 50개 단위 배치 호출

자동·수동 수집과 배치 로직

“30분마다 조금씩, 필요할 때는 즉시”라는 리듬으로
과하지 않게(API 쿼터 절약) 데이터를 쌓는 것이 핵심입니다.
🔁 자동 수집
Supabase pg_cron + Edge Function이 30분마다 runTrendsRecord(false)와 동일한 로직을 자동 실행합니다.
🖱️ 수동 조회
화면의 “수동 조회” 버튼은 POST /trends/record {"force": true}를 호출해, 지금 당장 전체 추적 대상을 한 번 더 기록합니다.
📦 배치 최적화
배치 수집 시 YouTube API는 ID를 50개 단위로 묶어 호출하며, 최근 30분 내 기록된 채널/영상은 shouldRecordChannel/Video로 스킵합니다.
자동 스케줄 주기Every 30 Minutes (pg_cron)
YouTube API 청크50 IDs / 1 Batch Request
중복 방지 필터최근 30분 내 기록건 Skip
POST /api/youtube-manager/trends/record — Batch Engine
QUOTA OPTIMIZED
Mode 1. 자동 수집 — runTrendsRecord(force = false)
pg_cron이 30분마다 호출 → shouldRecordChannel/Video 검사 후 30분 경과 대상만 수집
Auto Skip ON
Mode 2. 수동 조회 버튼 — POST /trends/record { "force": true }
30분 이내 기록 여부와 무관하게 즉시 전체 추적 대상을 강제 스냅샷 기록
Force Record
Batch Chunking: ID 50개 단위 묶음 호출
YouTube Data API videos.list / channels.list의 id 파라미터 최대치(50개) 활용
50 IDs / Call
SLIDE 06 · SUPABASE TIMESERIES SCHEMA
테이블명: app_youtube_trends_timeseries_v1
DB

추적 대상 목록 + 시계열 기록 통합 설계

시계열 스냅샷 테이블 구조

Supabase 단일 테이블이 “추적 대상 목록 + 시계열 기록”을 한 번에 담당합니다.
엑셀 시트에 시간별로 행을 추가해 나가는 그림을 떠올리면 이해가 쉽습니다.
채널 행 규칙
channel_id 값이 있고 video_id = NULL 로 저장됩니다. 구독자 수, 채널 총조회수, 총 영상 수를 기록합니다.
영상 행 규칙
channel_id와 함께 video_id도 함께 저장됩니다. 개별 영상 조회수, 좋아요, 댓글 수를 기록합니다.
설계 장점
별도의 마스터 테이블 조인 없이도, 단일 시계열 테이블에서 채널 전체 추이와 소속 영상 추이를 동시에 뽑아낼 수 있습니다.
채널 스냅샷 판별video_id IS NULL
영상 스냅샷 판별video_id IS NOT NULL
시간 정렬 키recorded_at (TIMESTAMPTZ)
Supabase Table — app_youtube_trends_timeseries_v1
SINGLE TABLE SCHEMA
recorded_atchannel_idvideo_idsubscribersviews / likes / comments
2026-03-11 01:00UCxxxx...NULL (채널 행)49,800채널 총조회수, 영상 수(video_count)…
2026-03-11 01:00UCxxxx...영상ID (11자)—개별 영상 조회수, 좋아요, 댓글 수…
채널 행 (Channel Row): channel_id 값 존재 & video_id = NULL
채널 단위의 거시적 성장 지표(구독자 수, 채널 누적 조회수, 업로드 영상 수) 추적
Channel
영상 행 (Video Row): channel_id + video_id 모두 저장
특정 화제 영상의 시간당 조회수·좋아요·댓글 폭발 추이를 정밀 추적
Video
SLIDE 07 · REAL DATA SAMPLE (VIDEO)
채널: 김선태 · 영상 ID: n8fdEYaDtfM
VD

실제 DB 적재 로그 · 30분 간격 시계열

수집 샘플: 영상 n8fdEYaDtfM

앞 슬라이드의 시계열 테이블에 실제로 이렇게 쌓인 모습입니다.
김선태 채널의 영상 n8fdEYaDtfM 기준 샘플입니다.
데이터 특징
2026년 3월 11일 오후 1:30부터 오후 6:00까지 정확히 30분 간격(pg_cron)으로 조회수·좋아요·댓글이 누락 없이 기록되었습니다.
추이 확인
4시간 30분 동안 조회수가 5,852,201 → 5,887,619 (+35,418회) 상승하는 흐름이 그대로 드러납니다.
파이프라인 연결
이 표가 곧 Remotion 유튜브 추이 표 템플릿으로 들어가는 원본 시계열 데이터입니다.
대상 영상 IDn8fdEYaDtfM
수집 간격30분 정각 (오후 1:30 ~ 6:00)
활용처Remotion 추이 표 원본 소스
SELECT recorded_at, views, likes, comments WHERE video_id = 'n8fdEYaDtfM'
10 SNAPSHOT ROWS
recorded_atviews (조회수)likes (좋아요)comments (댓글)
2026. 3. 11. 오후 1:30:015,852,201245,27524,868
2026. 3. 11. 오후 2:00:015,855,855245,32324,878
2026. 3. 11. 오후 2:30:015,859,580245,37024,887
2026. 3. 11. 오후 3:00:015,864,143245,43524,890
2026. 3. 11. 오후 3:30:015,867,895245,48124,899
2026. 3. 11. 오후 4:00:015,871,955245,54124,902
2026. 3. 11. 오후 4:30:015,876,060245,60124,918
2026. 3. 11. 오후 5:00:015,879,658245,67124,929
2026. 3. 11. 오후 5:30:015,882,803245,73324,940
2026. 3. 11. 오후 6:00:015,887,619245,79824,961
SLIDE 08 · REAL DATA SAMPLE (CHANNEL)
채널명: 김선태 · 채널 ID: UCt-BApVtJGrvF5pCgbiNVeg
CH

채널 단위 시계열 스냅샷 예시

수집 샘플: 채널 김선태

같은 김선태 채널(UCt-BApVtJGrvF5pCgbiNVeg)에 대해
구독자 · 채널 조회수 · 영상 수가 어떻게 스냅샷으로 쌓이는지 보여 줍니다.
기록 지표
subscribers(구독자 수 1,390,000명), channel_views(채널 누적 조회수 14,718,557회), video_count(업로드 영상 2개).
교차 분석 가치
채널 단위 스냅샷(이 슬라이드)과 영상 단위 스냅샷(이전 슬라이드)을 함께 보면, 같은 시점에 채널 전체 성장과 대표 영상 성과를 동시에 추적할 수 있습니다.
채널 IDUCt-BApVtJGrvF5pCgbiNVeg
구독자 스냅샷1,390,000명
채널 누적 조회수14,718,557회 (영상 2개)
SELECT recorded_at, subscribers, channel_views, video_count WHERE video_id IS NULL
CHANNEL SNAPSHOTS
recorded_atsubscriberschannel_viewsvideo_count
2026. 3. 11. 오후 3:00:011,390,00014,718,5572
2026. 3. 11. 오후 3:30:011,390,00014,718,5572
2026. 3. 11. 오후 4:00:011,390,00014,718,5572
2026. 3. 11. 오후 4:30:011,390,00014,718,5572
2026. 3. 11. 오후 5:00:011,390,00014,718,5572
2026. 3. 11. 오후 5:30:011,390,00014,718,5572
2026. 3. 11. 오후 6:00:011,390,00014,718,5572
채널 스냅샷(08P) + 영상 스냅샷(07P) 동시 입체 추적
단일 시계열 테이블에서 채널 전체 체급 변화와 개별 히트 영상의 화력을 한 번에 결합
Dual Tracking
SLIDE 09 · VIDEO CREATOR WEB EDITOR
상태 관리: Zustand 스토어 (Undo/Redo 50단계) · 프리뷰: @remotion/player
VC

슬라이드 툴 + 타임라인 영상 편집 웹앱

/video-creator 편집기 구조

/video-creator는 슬라이드 툴과 타임라인 편집기가 합쳐진 영상 편집 웹앱입니다.
편집기에 쓰는 표 데이터는 Supabase 시계열을 조회·가공해 넣습니다.
좌측 패널
템플릿 패널: 인트로, 슬라이드쇼, 유튜브 추이 표(youtube-stats-table) 등 템플릿을 선택해 씬을 추가합니다.
가운데 패널
미리보기: @remotion/player로 현재 선택된 씬을 실시간 재생하며 숫자 보간 애니메이션을 확인합니다.
하단/우측 패널
타임라인 & 속성: 씬 길이, 효과, 텍스트 등을 조정합니다. Zustand 스토어로 Undo/Redo 50단계를 지원합니다.
좌측 영역TemplateSelector (씬 추가)
중앙 영역@remotion/player 프리뷰
우측/하단 영역Zustand 타임라인 (Undo 50단)
app/video-creator/page.tsx — 3-Pane Studio Layout
STUDIO UI
LEFT · 템플릿 패널
인트로 템플릿
슬라이드쇼
✓ 유튜브 추이 표
youtube-stats-table
CENTER · @remotion/player 미리보기
유튜브 실시간 추이 애니메이션 재생

프레임 단위 선형 보간 프리뷰 (1080p · 30fps)

RIGHT · 속성 인스펙터
씬 길이 (duration)
행당 프레임 (90f)
Undo / Redo (50단계)
BOTTOM TIMELINE · [Scene 1: Intro (150f)] ── [Scene 2: youtube-stats-table] ── [Scene 3: Outro (300f)] 전체 워크플로우는 14P 참고
SLIDE 10 · COMPOSITION BINDING CHAIN
컴포지션 ID 일관성: id="youtube-stats-table"
ID

프론트 프리뷰와 서버 렌더링의 단일 키 체인

템플릿 → 씬 → 컴포지션 연결

하나의 템플릿 선택이 어떻게 Remotion 컴포지션까지 이어지는지,
4단계 한 줄 체인으로 정리합니다.
1️⃣ 카드 클릭
TemplateSelector에서 youtube-stats-table 템플릿 카드를 클릭합니다.
2️⃣ Scene 생성
addScene이 호출되고, 새 Scene 객체의 type에 youtube-stats-table이 들어갑니다.
3️⃣ Config 매핑
VideoPlayer는 현재 선택된 Scene의 type을 받아, 내부 getCompositionConfig()로 어떤 Remotion 컴포지션을 쓸지 결정합니다.
4️⃣ Root 등록
RemotionRoot에 등록된 id="youtube-stats-table" 컴포지션이 최종 선택됩니다.
핵심 식별자id = "youtube-stats-table"
매핑 함수getCompositionConfig(scene.type)
서버 렌더 연동project.composition 동일 ID 사용
TemplateSelector → Scene → VideoPlayer → RemotionRoot
4-STEP CHAIN
Step 1. TemplateSelector
사용자가 UI에서 youtube-stats-table 템플릿 카드 클릭
Click
Step 2. Zustand Store — addScene()
scene.type = "youtube-stats-table" 상태로 타임라인에 씬 추가
Store State
Step 3. VideoPlayer — getCompositionConfig()
현재 Scene의 type을 읽어 렌더링할 컴포지션 컴포넌트와 기본 Props 결정
Config
Step 4. RemotionRoot & Server Render API
이 체인이 정확히 맞아야 나중에 서버 렌더링 API에서도 project.composition으로 같은 id를 사용할 수 있습니다.
SSR Match
SLIDE 11 · COMPOSITION INPUT ROWS
상수 분리: RAW_ROWS & DEFAULT_YOUTUBE_STATS_ROWS
RW

한 행 = 한 시점을 나타내는 배열 구조

YoutubeStatsTableComposition

유튜브 추이 표 템플릿은 한 행 = 한 시점을 나타내는 rows 배열을 입력으로 받습니다.
6개 컬럼 구성
date(일시), subscribers(구독자), views(조회수), rate(증감/비율), likes(좋아요), comments(댓글).
상수 분리 설계
실제 구현에서는 RAW_ROWS 상수와 DEFAULT_YOUTUBE_STATS_ROWS를 분리해 사용합니다.
왜 파싱이 필요한가
이 행 값들은 "4.9만", "~ 290,000" 같은 문자열(string)이므로, 영상 애니메이션을 위해 숫자 파싱과 구간별 보간이 필요합니다 (다음 슬라이드).
원본 데이터 타입String 포맷 ("4.9만", "+1,200")
상수 관리RAW_ROWS 분리 관리
다음 단계 (12P)숫자 파싱 & 프레임 선형 보간
YoutubeStatsTableComposition.tsx — Input Row Format
RAW_ROWS FORMAT
datesubscribersviewsratelikescomments
03. 04. 01:174.9만~ 290,000+1,2003,100420
표시용 원본 문자열 유지 + 애니메이션 계산용 숫자 분리
화면 라벨이나 포맷팅에는 원본 감성을 살리고, 프레임 사이를 메우는 카운팅에는 파싱된 정수를 사용
String → Number
SLIDE 12 · PARSING & LINEAR INTERPOLATION
핵심 헬퍼: parseCount · parseRate · dateToMinutes · 선형 보간
IP

매 프레임 숫자가 부드럽게 올라가는 원리

문자열 → 숫자 파싱 & 보간

표 데이터는 "4.9만" 같은 문자열인데, 애니메이션은 프레임마다 숫자로 계산해야 하므로
먼저 1단계 파싱하고, 그다음 2단계 구간별 보간합니다.
parseCount
구독자·조회수·좋아요·댓글 문자열 → 숫자.
"4.9만" → 49000 / "~ 290,000" → 290000 / "-" 또는 "채널 개설" → 0
parseRate
구독률·증감처럼 비율/부호가 붙은 문자열 → 숫자.
"+1,200" → 1200 / "3.2%" → 3.2
dateToMinutes
날짜·시간 문자열을 “기준 시점부터 몇 분”인지 하나의 숫자로 변환.
"03. 04. 01:17" → 1,277 (분) (타임라인 위치 계산·보간용)
1단계: 파싱다양한 포맷 문자열 → Number
2단계: 보간행과 행 사이 프레임 비율 계산
시각 효과90프레임(3초) 동안 숫자 카운팅
Step 1: Parsing → Step 2: Frame-by-Frame Linear Interpolation
INTERPOLATION
2단계: 보간(Interpolation) — 구간 사이를 촘촘히 채우기
“이전 행의 숫자”와 “다음 행의 숫자” 사이를 프레임마다 비율에 맞춰 나눠 넣는 것입니다.
예: 구독자 49,000 → 50,200 사이를 90프레임(3초)에 걸쳐 선형으로 채우면 매 프레임 숫자가 올라갑니다.
90 Frames / Row
Remotion에서의 실제 계산 방식
현재 프레임(frame)과 durationPerRow(한 행당 프레임 수)로 “지금이 몇 번째 행과 다음 행 사이의 몇 % 지점인지”를 구한 뒤, 그 비율만큼 이전 행 숫자와 다음 행 숫자를 섞어(선형 보간) 표시합니다.
Lerp Formula
핵심 정리 4대 포인트
① parseCount (개수→number) · ② parseRate (증감/비율→number) · ③ dateToMinutes (경과 분 계산) · ④ 선형 보간 카운팅
Summary
SLIDE 13 · DURATION FORMULA & HELPER CODE
공식: 총 프레임 = 150(인트로) + (행 수 - 1) × durationPerRow(90) + 300(엔딩)
FN

30fps 기준 프레임 계산식 & TypeScript 구현

행 개수와 영상 길이의 관계

총 프레임 수 = 150 (인트로) + (행 수 - 1) × durationPerRow + 300 (엔딩)
기본 durationPerRow = 90 프레임 (30fps 기준 3초)
행 10개일 때
총 프레임 ≈ 150 + 9 × 90 + 300 = 1,260 프레임 → 약 42초
행 20개일 때
총 프레임 ≈ 150 + 19 × 90 + 300 = 2,160 프레임 → 약 72초
행 40개일 때
총 프레임 ≈ 150 + 39 × 90 + 300 = 3,960 프레임 → 약 132초
실서비스 팁
충분히 큰 기본 duration을 두고, 실제 행 수에 맞춰 보이는 구간만 채워 쓰는 방식을 사용할 수 있습니다.
10행 길이1,260f (약 42초)
20행 길이2,160f (약 72초)
40행 길이3,960f (약 132초)
parseCount / parseRate / dateToMinutes / minutesToDateLabel · YoutubeStatsRowParsed
TYPESCRIPT IMPLEMENTATION
/** 구독자/조회수/좋아요/댓글 숫자 파싱 (표시용 원본 유지, 보간용 숫자) */
function parseCount(s: string): number {
  if (!s || s === '-' || s === '채널 개설') return 0;
  const t = s.replace(/^~\s*/, '').trim().replace(/,/g, '');
  const man = t.match(/^([\d.]+)\s*만$/);
  if (man) return Math.round(parseFloat(man[1]) * 10000);
  const n = parseFloat(t.replace(/[^\d.]/g, ''));
  return Number.isNaN(n) ? 0 : Math.round(n);
}
/** 구독률 파싱 */
function parseRate(s: string): number {
  if (!s || s === '-') return 0;
  const n = parseFloat(s.replace('%', ''));
  return Number.isNaN(n) ? 0 : n;
}
/** 일시 문자열 → 경과 분 (03. 02. 0:00 기준) */
function dateToMinutes(dateStr: string): number {
  if (!dateStr) return 0;
  const withTime = dateStr.match(/03\.\s*(\d{1,2})\.\s*(\d{1,2}):(\d{1,2})/);
  if (withTime) {
    const day = parseInt(withTime[1], 10);
    const hour = parseInt(withTime[2], 10);
    const min = parseInt(withTime[3], 10);
    return (day - 2) * 24 * 60 + hour * 60 + min;
  }
  const dayOnly = dateStr.match(/03\.\s*(\d{1,2})\.\s*[\(\d]/);
  if (dayOnly) {
    const day = parseInt(dayOnly[1], 10);
    return (day - 2) * 24 * 60;
  }
  return 0;
}
/** 경과 분 → "03. DD. HH:mm" */
function minutesToDateLabel(totalMinutes: number): string {
  const day = 2 + Math.floor(totalMinutes / (24 * 60));
  const remainder = Math.max(0, totalMinutes % (24 * 60));
  const hour = Math.floor(remainder / 60);
  const min = Math.round(remainder % 60);
  return `03. ${String(day).padStart(2, '0')}. ${String(hour).padStart(2, '0')}:${String(min).padStart(2, '0')}`;
}
export interface YoutubeStatsRowParsed {
  date: string; minutesFromStart: number; subscribers: number; views: number; rate: number; likes: number; comments: number;
}
SLIDE 14 · END-TO-END PRACTICAL WORKFLOW
데이터 수집(3~7P) + 영상 편집(8~13P) 결합 5단계 실전 순서
WF

어떤 채널·영상이든 그대로 복붙하는 표준 절차

실제 워크플로우: 아무 채널이나 적용

앞에서 본 데이터 수집(3~7P)과 영상 편집(8~13P)을 이어서,
내가 원하는 아무 채널/영상에 그대로 적용하는 5단계 순서입니다.
1️⃣ 대상 추가
/cron-manager → 조회/구독자 추이 탭에서 원하는 채널/영상을 추가합니다.
2️⃣ 시계열 조회
30분~하루 단위로 데이터를 쌓고, 충분히 쌓이면 Supabase SQL / MCP로 시계열을 조회합니다.
3️⃣ 샘플링 생성
일정 간격(예: 1시간/하루)으로 샘플링해 date, subscribers, views, rate, likes, comments 문자열을 생성합니다.
4️⃣ 상수 교체
YoutubeStatsTableComposition의 RAW_ROWS를 이 데이터로 교체(또는 새 상수로 분리)합니다.
5️⃣ 프리뷰·렌더
/video-creator에서 youtube-stats-table 씬을 추가해 미리보기 → 필요 시 mp4/webm 렌더.
scripts/generate-youtube-trends-rows.ts — 5-Step Pipeline
REUSABLE PIPELINE
Step 1 & 2. /cron-manager 등록 → Supabase 시계열 축적
pg_cron(30분 주기)으로 스냅샷이 쌓이면 SQL 또는 MCP로 대상 채널/영상 로그 추출
Collect
Step 3 & 4. 일정 간격 샘플링 → RAW_ROWS 상수 교체
1시간/1일 간격으로 추려 YoutubeStatsTableComposition.tsx의 RAW_ROWS 배열에 주입
Inject Rows
Step 5. /video-creator 씬 추가 → 미리보기 & MP4/WebM 출력
브라우저 플레이어로 보간 애니메이션 확인 후 서버 렌더링 또는 화면 녹화로 완성
Export Video
SLIDE 15 · WHY REMOTION IS BOOMING
참고: github.com/remotion-dev/remotion (GitHub 39k+ Stars)
RM

GitHub 39k+ 스타 · “코드로 영상” 프레임워크

Remotion은 왜 이렇게 열광인가?

Remotion은 React로 프로그래밍적으로 영상을 만드는 프레임워크입니다.
GitHub 39k+ 스타, “코드로 영상”이라는 한 줄이 요약입니다.
왜 쓰나?
• CSS, Canvas, SVG, WebGL 등 웹 기술 그대로 활용
• 변수·함수·API로 반복·자동화 가능
• React 컴포넌트·패키지 생태계로 재사용·조합 용이
요즘 열광 포인트
Remotion Skills처럼 AI 에이전트(Claude Code, Cursor, Antigravity 등)와 붙으면 보고서·문서를 넘겨주기만 해도 2분 영상을 6분 만에 뽑아 주는 식의 워크플로우가 가능해졌습니다. 코딩을 몰라도 프롬프트만으로 영상 제작이 가능한 시대입니다.
본 PPT의 연결점
이 PPT에서 다루는 /api/video-creator/render는 바로 Remotion의 서버 사이드 렌더링을 호출해 mp4/webm 파일을 만드는 단계입니다.
오픈소스 인기GitHub 39,000+ Stars
AI 에이전트 결합Claude Code / Cursor + Skills
생산성 혁신2분 분량 영상을 6분 만에 생성
remotion-dev/remotion — AI Agentic Video Factory
39K+ STARS
🤖 AI Agent (Claude Code · Cursor · Antigravity) + Remotion Skills
문서·보고서·시계열 표만 넘기면 에이전트가 React 컴포넌트를 짜서 고품질 모션 그래픽 영상으로 직행
Prompt to Video
📺 참고 영상 1: Remotion Skills + Claude로 영상 만들기 (실습)
프롬프트 지시만으로 레이아웃·차트·애니메이션 씬을 자동 조립하는 실전 워크플로우
Reference
📺 참고 영상 2 & 3: 클로드 코드 + Remotion = 영상 공장 완성 (오후다섯씨)
AI 활용 300% 하는 방법 | 클로드로 영상 만들기 — 반복 제작 파이프라인 자동화 사례
Video Factory
SLIDE 16 · SERVER-SIDE RENDERING API
엔드포인트: POST /api/video-creator/render · 공식: remotion-dev/remotion
SR

편집기 애니메이션을 실제 영상 파일로 변환

Remotion 렌더링 API 흐름

편집기에서 보이는 애니메이션을 실제 영상 파일(mp4/webm)로 바꾸는 마지막 단계입니다.
렌더가 환경 문제로 되지 않을 때는 다음 슬라이드(플랜 B)를 참고하세요.
지원 포맷
mp4 (h264), webm (vp8) 두 가지 표준 비디오 코덱 포맷을 지원합니다.
품질 옵션
low (60) · medium (75) · high (90) 3단계 품질 프리셋을 선택할 수 있습니다.
클린업 처리
서버 디스크 용량이 차지 않도록 완성된 파일을 읽어 응답 스트림으로 전송한 직후 임시 파일을 디스크에서 삭제합니다.
출력 포맷 / 코덱mp4 (h264) · webm (vp8)
품질 단계 (Quality)low(60) · medium(75) · high(90)
예외 대비환경 오류 시 17P 플랜 B 활용
app/api/video-creator/render/route.ts — 5-Step Execution
SSR PIPELINE
1. POST /api/video-creator/render { project, format, quality }
클라이언트 편집기에서 프로젝트 컴포지션 정보와 포맷·화질 옵션을 담아 요청 전송
Step 1
2. bundle(entryPoint = app/video-creator/compositions/index.tsx)
Remotion 번들러가 엔트리 포인트를 기준으로 Webpack 번들 생성 (serveUrl 반환)
Step 2
3. selectComposition(serveUrl, id = project.composition)
번들에서 id="youtube-stats-table" 컴포지션 메타데이터(해상도, fps, 프레임 수) 선택
Step 3
4. renderMedia(serveUrl, composition, codec, quality, outputLocation)
헤드리스 브라우저 + FFmpeg로 프레임별 렌더링 및 인코딩 수행
Step 4
5. 완성된 파일을 읽어 응답으로 전송 후 디스크에서 삭제
브라우저 다운로드 응답 반환 및 서버 임시 파일 즉시 정리
Step 5
SLIDE 17 · PRAGMATIC BACKUP PLAN B
도구: OBS Studio · Xbox Game Bar · macOS 화면 녹화 (Shift+Cmd+5)
PB

서버 환경·권한·FFmpeg 문제 우회 전략

렌더링이 안 될 때의 현실적인 플랜 B

Remotion 서버 렌더링은 환경·권한·ffmpeg 설정에 따라 당장 안 될 수도 있습니다.
이럴 때 쓸 수 있는 실무 친화적인 백업 플랜입니다.
1단계: 화면 확대
/video-creator에서 유튜브 추이 표 씬을 전체 화면에 가깝게 키웁니다.
2단계: 녹화기 실행
OBS Studio / Windows Xbox Game Bar / macOS 화면 녹화(Shift+Cmd+5) 등을 켭니다.
3단계: 재생 캡처
1080p 30fps 기준으로 프리뷰 재생을 한 번 깔끔하게 녹화해 mp4 파일을 얻습니다.
실무적 의의
완전 자동 파이프라인은 아니지만, 디자인·보간 로직은 100% 그대로 재사용하면서 인프라 부담 없이 프로토타입 영상을 빠르게 확보할 수 있는 현실적인 방법입니다.
권장 녹화 스펙1080p · 30fps MP4
인프라/서버 부담Zero (브라우저 플레이어 직캡처)
로직 재사용성디자인 · 보간 애니메이션 100% 동일
Screen Recording Fallback Workflow — Zero-Infra MP4
PLAN B WORKFLOW
🖥️ Step 1. /video-creator 플레이어 영역 최대화
@remotion/player는 브라우저 안에서 이미 완벽한 60fps/30fps 벡터·DOM 애니메이션을 렌더링 중입니다.
Full Preview
🎥 Step 2. OBS Studio / Xbox Game Bar / Shift+Cmd+5 가동
서버리스(Vercel 등) 타임아웃이나 Chromium·FFmpeg 바이너리 충돌 없이 로컬 OS 녹화 기능 활용
OS Recorder
✅ Step 3. 1080p 30fps 재생 1회 녹화 → 즉시 편집본 확보
복잡한 렌더 팜 구축 전에도 당장 유튜브 업로드 및 시연에 쓸 수 있는 고화질 MP4 즉시 획득
Instant MP4
SLIDE 18 · DUAL LICENSE & LEGAL COMPLIANCE
상업용 라이선스 구매처: remotion.pro
LC

이중 라이선스(Dual License) 체계 완벽 정리

Remotion 라이선스 분석

Remotion은 이중 라이선스(Dual License) 체계를 채택하며,
법적 주체 유형(직원 수 3명 이하 vs 4명 이상)에 따라 무료 또는 유료가 적용됩니다.
1. 무료 라이선스
적격 사용자: 개인 사용자 / 직원 3명 이하의 영리 조직 / 비영리 조직 / 평가 중이며 아직 상업적 미사용.
허용: 영상·이미지 제작(상업 포함), 수정, 기여 · 금지: Remotion 기반 파생물 판매·임대·재라이선싱 · 보증 없음(AS IS).
2. 회사 라이선스
직원 4명 이상의 영리 조직. 무료와 동일 사용 범위 + 우선 지원. remotion.pro에서 구매.
3. 핵심 포인트
MIT/Apache가 아닌 사용자 기반 조건부(Source-Available) 라이선스입니다. Remotion 자체를 기반으로 한 파생 제품(SaaS 등) 재판매는 금지되며, 직원 수 경계 사례(계약직·프리랜서 포함 여부)는 FAQ 또는 직접 문의를 권장합니다.
4. 실무 적용 요약 — 무료 사용 가능 여부 판정표
COMPLIANCE MATRIX
구분 (법적 주체 및 활용 시나리오)무료 사용 가능 여부
개인 유튜버의 상업적 영상 제작 (유튜브 수익 창출 포함)가능 (무료)
3인 이하 스타트업의 자체 상업적 영상 제작가능 (무료)
비영리 단체의 영상 제작가능 (무료)
직원 4명 이상 기업의 영상 제작회사 라이선스 필요 (remotion.pro)
Remotion 기반 SaaS 제품 판매 (제3자에게 편집기 유료 판매·임대)불가 (파생물 판매 금지)
핵심 체크: “우리 팀이 몇 명인가?” & “영상을 파는가, 툴 자체를 재판매하는가?”
개인·3인 이하 팀이 유튜브 채널 운영 및 외주 영상 납품용으로 쓰는 것은 무료 라이선스로 상업적 허용
Dual License
SLIDE 19 · EXECUTIVE SUMMARY & TAKEAWAYS
5단계 파이프라인: 유튜브 데이터 → Supabase → 표 데이터 → Remotion 템플릿 → 영상 파일

요약: 초보 · 전문가 각각의 Takeaway

▶

1. 유튜브

채널/영상 통계 주기적 스냅샷
DB

2. Supabase

시계열 로그 pg_cron 스케줄
📋

3. 표 데이터

RAW_ROWS 데이터 구조화
🎬

4. Remotion

컴포지션 템플릿 애니메이션 보간
📼

5. 영상 파일

mp4 / webm 서버 렌더링
Beginner Takeaway
초보자용 정리

🍼 초보자용 정리

• 복잡한 코드는 신경 쓰지 말고, “데이터를 표로 쌓는다 → 그 표를 예쁜 영상으로 바꾼다”라고 이해하면 충분합니다.

• 이 흐름은 김선태 채널뿐 아니라 어떤 채널/영상에도 그대로 복붙할 수 있습니다.

Expert Takeaway
전문가용 정리

🧠 전문가용 정리

• 핵심 키워드: /trends/* API, Supabase 시계열 설계, Remotion 컴포지션 id, 서버 렌더링 API.

• 확장 아이디어: 다른 지표(수익, 시청 지속 시간), 다른 플랫폼(Twitch, TikTok), 다른 템플릿(막대 그래프, 맵 시각화)으로 응용 가능합니다.

SLIDE 20 · AI VIBE CODING STRATEGY
핵심 원칙: “한 번에 전부”가 아니라 섹션별 · 기능별로 끊어서 지시
AI

실패 없는 3단계 분할 지시 전략

AI에게 어떻게 시켜야 할까?

이 프로젝트는 AI에게 “바이브 코딩”으로 단계별로 시킨다는 전제를 갖고 있습니다.
중요한 것은 “한 번에 전부”가 아니라, 섹션별 · 기능별로 끊어서 지시하는 것입니다.
1️⃣ 기본 뼈대부터
먼저 /cron-manager, /video-creator 페이지와 상단 공통 네비게이션 레이아웃 정도만 요청해 라우팅과 타입 규칙을 잡습니다.
2️⃣ API → UI 순서
Supabase/YouTube API 레이어(트렌드 API 4종)를 먼저 만들게 한 뒤, 그 다음에 TrendsTab UI를 얹도록 단계별로 시킵니다.
3️⃣ 렌더 · 스크립트
마지막에 Remotion 컴포지션, 서버 렌더링 API, Supabase → RAW_ROWS 변환 스크립트를 각각 따로따로 요청하는 식으로 쪼갭니다.
Phase 1App Router 페이지 뼈대 & 네비게이션
Phase 2트렌드 Route Handler 4종 & Store
Phase 3TrendsTab UI + Remotion + SSR
Vibe Coding Phased Prompting Architecture
3-PHASE PROMPTING
Phase 1. 스캐폴딩 (Scaffolding)
app/cron-manager/page.tsx, app/video-creator/page.tsx + TypeScript Strict (no-any) 규칙 확립
Prompt ①
Phase 2. 백엔드 데이터 레이어 (Data & API Layer)
lib/youtube-client.ts + lib/db/youtube-trends-store.ts + track / record / tracked / snapshots 4종
Prompt ②
Phase 3. 프론트 UI + Remotion 컴포지션 + SSR 렌더 + 스크립트
TrendsTab.tsx + YoutubeStatsTableComposition.tsx + /api/video-creator/render + 변환 스크립트
Prompt ③ (다음 장 전문)
SLIDE 21 · COPY-PASTE VIBE CODING PROMPTS
각 카드 우측 상단의 [프롬프트 복사] 버튼을 누르면 클립보드에 즉시 복사됩니다

AI 바이브 코딩 지시문 템플릿 — 실전 복붙용 3단계 전문

① 기본 구조 · 메뉴 생성 (1단계)

“Next.js 16 / React 19 / App Router 기반의 새 프로젝트가 하나 있다고 가정해 주세요. 아직 주요 페이지는 거의 없는 상태이고, 여기에서 '유튜브 조회/구독자 추이 수집 + Remotion 영상 제작' 기능을 새로 추가하려고 합니다. 1) /cron-manager, 2) /video-creator 두 페이지를 새로 만들어 주세요. - /cron-manager 는 유튜브 조회/구독자 추이 수집/조회용 '크론 매니저' 화면입니다. - /video-creator 는 Remotion 기반 '비디오 크리에이터' 편집 화면입니다. 요구사항: - App Router 구조를 사용해 주세요 (app/cron-manager/page.tsx, app/video-creator/page.tsx). - 상단에 공통 네비게이션(홈, 크론 매니저, 비디오 크리에이터 링크)을 포함한 레이아웃을 만들어 주세요. - 언어는 TypeScript, any 타입은 절대 쓰지 말고 명시적인 타입/interface 를 선언해 주세요. - 함수·컴포넌트 이름은 전부 카멜케이스/파스칼케이스 규칙을 지켜 주세요. - 이 단계에서는 디자인은 대략적인 수준만 맞추고, 실제 유튜브/Supabase/Remotion 연동은 다음 단계에서 붙일 수 있도록 자리만 잡는 것이 목표입니다.”

② 트렌드 API 4종 생성 (2단계)

“이제 유튜브 조회/구독자 추이 데이터를 Supabase에 시계열로 기록하기 위한 API 레이어를 추가하고 싶습니다. 전제: - Supabase 프로젝트가 이미 있고, Next.js 서버에서 Supabase 클라이언트를 사용할 수 있다고 가정해 주세요. - Supabase 에는 app_youtube_trends_timeseries_v1 테이블이 있다고 가정합니다. - 이 테이블은 채널/영상 둘 다 저장하는 '추적 + 스냅샷' 테이블입니다. 해야 할 일: 다음 4가지 Route Handler 를 만들어 주세요. - POST /api/youtube-manager/trends/track - POST /api/youtube-manager/trends/record - GET /api/youtube-manager/trends/tracked - GET /api/youtube-manager/trends/snapshots 동작 규칙: - track 은 URL/채널 ID/영상 ID 를 받아 YouTube API 를 호출하고 Supabase 에 현재 시점 스냅샷 1행을 insert 합니다. - tracked 는 지금까지 한 번이라도 기록된 채널/영상 ID 목록을 반환합니다. - snapshots 는 특정 channelId 또는 videoId 의 시계열 스냅샷을 반환합니다. - record 는 전체 또는 일부 ID 에 대해 배치 수집을 돌리고, 30분 이내 데이터는 스킵합니다. 구조: - YouTube API 호출 로직은 lib/youtube-client.ts 파일로 분리해 주세요. - Supabase 입출력과 비즈니스 로직은 lib/db/youtube-trends-store.ts 파일로 분리해 주세요. - 모든 함수/Route Handler 는 any 대신 명시적인 타입을 사용하고, API 응답은 성공 시 { success: true, ... }, 실패 시 { success: false, error: string } 패턴을 유지해 주세요.”

③ TrendsTab UI · Remotion · 렌더 (3단계)

“이제 /cron-manager 페이지 안에 '조회/구독자 추이' 탭 UI 를 구현하고 싶습니다. - app/cron-manager/page.tsx 에 탭 구조를 만들고, 그 중 '조회/구독자 추이' 탭을 선택하면 app/cron-manager/components/TrendsTab.tsx 를 렌더링해 주세요. - TrendsTab 는 2.2~2.4절 요구사항(추가/조회/수동 조회/표 구조)을 그대로 구현해 주세요. 또한 /video-creator 에서 사용할 Remotion 컴포지션을 추가하고 싶습니다. - app/video-creator/compositions/templates/YoutubeStatsTableComposition.tsx 를 만들고, RAW_ROWS / DEFAULT_YOUTUBE_STATS_ROWS / 파싱·보간 로직을 설계 문서대로 구현해 주세요. - app/video-creator/compositions/index.tsx 에 id="youtube-stats-table" 로 컴포지션을 등록하고, VideoPlayer 의 getCompositionConfig 에서 이 id 를 처리해 주세요. 마지막으로 Remotion 서버 렌더링과 데이터 스크립트를 추가해 주세요. - /api/video-creator/render 에서 Remotion 서버 렌더링을 구현해 주세요. format/quality 별 codec/quality 값은 설계 문서 3.6절을 따릅니다. - Supabase 시계열을 읽어 RAW_ROWS TypeScript 파일을 생성하는 스크립트를 scripts/generate-youtube-trends-rows.ts 에 만들어 주세요.”

전체 슬라이드 목차 (21 Slides)