Deploy Musician Pipeline

YouTube @musician-parksy + parksy.kr + Google Drive 한방 배포 파이프라인.

최종 갱신: 2026-02-23

파이프라인 다이어그램

video.mp4
  │
  ├─[1] youtube-studio.js upload ──→ YouTube @musician-parksy
  │     └─→ video.mp4.youtube.json (사이드카)
  │
  ├─[2] update-musician-manifest.js ──→ parksy.kr/data/youtube/musician-videos.json
  │
  ├─[3] git add + commit + push ──→ GitHub Pages (parksy.kr 자동 배포)
  │
  └─[4] gdrive-sync.sh youtube ──→ Google Drive (선택)

파일 경로

parksy-audio (이 레포)

	`tools/deploy-musician.sh`	한방 배포 오케스트레이터
	파일	역할
	`tools/update-musician-manifest.js`	.youtube.json → 매니페스트 업데이트
	`tools/youtube/youtube-studio.js`	YouTube API CLI (업로드/관리)
	`tools/gdrive-sync.sh`	Google Drive rclone 동기화
	`docs/DEPLOY-MUSICIAN-PIPELINE.md`	이 문서

parksy.kr (별도 레포)

	`data/youtube/musician-videos.json`	비디오 매니페스트 (배포 대상)
	파일	역할
	`category/Musician-Parksy/index.html`	뮤지션 페이지 (매니페스트 읽어서 렌더링)

매니페스트 스키마 — musician-videos.json

{
  "collection": "musician-videos",
  "version": "1.0.0",
  "channelId": "@musician-parksy",
  "lastUpdated": "2026-02-23T10:00:00.000Z",
  "count": 1,
  "items": [
    {
      "videoId": "dQw4w9WgXcQ",
      "title": "Parksy Piano Minimal #001",
      "program": "P2",
      "playlist": "박씨 오디오",
      "style": "piano-minimal",
      "composer": "Chopin",
      "work": "Nocturne Op.9 No.1",
      "ambient": "rain",
      "duration": 260,
      "privacy": "private",
      "uploadedAt": "2026-02-23T10:00:00.000Z",
      "sourceFile": "video.mp4"
    }
  ]
}

Item 필드

`videoId`	string	O	YouTube 비디오 ID
필드	타입	필수	설명
`title`	string	O	영상 제목
`program`	string	O	P2/P3/P4/P5
`playlist`	string	-	플레이리스트 이름
`style`	string	-	piano-minimal, dark-funeral 등
`composer`	string	-	작곡가
`work`	string	-	곡명
`ambient`	string	-	rain/wind/fire
`duration`	number	-	길이 (초)
`privacy`	string	-	private/unlisted/public
`uploadedAt`	string	O	ISO 8601
`sourceFile`	string	-	원본 파일명

스크립트 사용법

deploy-musician.sh (오케스트레이터)

# 기본 — 업로드 + 매니페스트 + push
./tools/deploy-musician.sh video.mp4 \
  --program P2 --composer "Chopin" --work "Nocturne Op.9 No.1" \
  --ambient rain --style piano-minimal

# Drive 포함
./tools/deploy-musician.sh video.mp4 --program P2 --drive

# 이미 업로드된 영상 (사이드카 있음)
./tools/deploy-musician.sh video.mp4 --skip-upload --program P2

# 뭐 할지만 확인
./tools/deploy-musician.sh video.mp4 --dry-run --program P2

옵션

`--program`	P2	프로그램 (P2/P3/P4/P5)
플래그	기본값	설명
`--composer`	-	작곡가
`--work`	-	곡명
`--ambient`	-	앰비언트 타입
`--style`	piano-minimal	스타일
`--playlist`	박씨 오디오	플레이리스트
`--privacy`	private	YouTube 공개 설정
`--duration`	-	길이 (초)
`--drive`	off	Google Drive 동기화 포함
`--dry-run`	off	계획만 출력
`--skip-upload`	off	업로드 건너뜀

Exit 코드

	0	성공 (Drive 실패도 0)
	코드	의미
	1	YouTube 업로드 실패
	2	사용법 에러
	3	parksy.kr 경로 없음 또는 매니페스트 실패

update-musician-manifest.js

node tools/update-musician-manifest.js --help    # 사용법

node tools/update-musician-manifest.js \
  --sidecar video.mp4.youtube.json \
  --parksy-kr ~/parksy.kr \
  --program P2 --composer "Chopin" --work "Nocturne Op.9 No.1" \
  --ambient rain --style piano-minimal

parksy.kr 경로 탐색 순서

두 스크립트 모두 동일한 순서로 parksy.kr을 찾음:

1. $PARKSY_KR_PATH 환경변수

2. 형제 디렉토리 ../parksy.kr (parksy-audio 기준)

3. ~/parksy.kr (Termux)

4. /d/PARKSY/parksy.kr (PC)

기존 시스템 연결

youtube-studio.js (업로드)

`instructions/YOUTUBE-AGENT.md` 규칙 적용

categoryId: **10 (Music)**

사이드카 생성: `{file}.youtube.json`

프라이버시: 기본 private → 24시간 후 예약 공개

gdrive-sync.sh (Drive 동기화)

`tools/gdrive-sync.sh youtube` — YouTube 디렉토리만 동기화

rclone 미설치 시 경고만 (exit 0)

queue 시스템 (PC 렌더링)

queue/job-NNN.json (status: pending)
  → PC에서 처리 → status: ready
  → deploy-musician.sh로 배포

미완성 섹션 (스켈레톤 vs 완성)

완성

[x] musician-videos.json 매니페스트 구조

[x] update-musician-manifest.js (중복 체크, 항목 추가)

[x] deploy-musician.sh (4단계, dry-run, skip-upload)

[x] Musician-Parksy/index.html (탭 필터, lazy embed, 빈 상태)

[x] categoryId 22→10 수정

스켈레톤 — 콘텐츠 준비 후 마무리

[ ] 실제 YouTube 업로드 테스트 (token.json 필요)

[ ] 썸네일 자동 생성 (YOUTUBE-AGENT.md §2 FFmpeg 명령)

[ ] 플레이리스트 자동 추가 (youtube-studio.js playlist add)

[ ] 예약 공개 자동화 (+24h scheduling)

[ ] 카운터 자동 증가 (counter.txt)

[ ] parksy.kr 페이지에 썸네일 표시 (현재 play 아이콘만)

[ ] P3/P4/P5 프로그램별 커스텀 메타데이터

Built by Claude Code — 2026-02-23