영상 원본을 등록하고 번역·더빙 영상을 만들거나 롱폼을 숏폼으로 편집한 뒤, 검수·승인을 거쳐 YouTube에 예약 공개하는 파이프라인입니다.
현재 상태: Mac 로컬 서버 가동, 실제 STT·숏폼 편집과 Google 번역·ElevenLabs 더빙 샘플 검증 완료. YouTube 계정 연결과 실제 샘플 비공개 업로드·처리 완료를 확인했으며 공개 예약 검증은 남아 있습니다. 결과물별 검수·승인을 유지합니다. 최신 운영·예산 상태는 인수인계를 참고하세요.
| 문서 | 내용 |
|---|---|
| 프로젝트 범위 | 목표, MVP, 가정, 미정 사항 |
| 시스템 설계 | 구성도, 데이터 모델, 작업 상태, 실패 처리 |
| 롱폼 → 숏폼 편집 | 하이라이트 추천, 구간·세로 화면·자막 편집, 숏폼별 승인 |
| 기술 선택 | 추천 기술, 선택 이유, 공식 문서 |
| 구현 계획 | 단계별 작업과 완료 기준 |
| 오픈소스 통합·실행 | 사용한 GitHub 프로젝트, 설치·실행, 검증 및 미구현 범위 |
| 단계별 연결·설정 | 화면 사용 순서, 서버 연결, 예산·재시도·게시 복구 |
| 실제 영상 제작 경로 | 한국어 자막·원음 유지·선택형 얼굴 모자이크와 검수 |
| 자막 표시 방식·실측 | 자막 굽기/YouTube 트랙 선택, 인코딩·싱크 실제 검증 |
| Mac 운영 자동화 | 실제 서버 실행, 자동 시작·점검·백업·복원 검증 |
| 개발 환경 | 실행 방법, 저장소 구조, 검사 |
| 협업 인수인계 | 현재 진행 상황, 다음 작업, 작업 기록 |
| 공통 에이전트 지침 | Codex·Claude 공통 작업 규칙 |
| Claude 안내 | Claude가 읽을 문서와 시작 절차 |
처음 참여하는 사람이나 AI는 프로젝트 범위 → 시스템 설계 → 기술 선택 → 구현 계획 → 인수인계 순서로 읽습니다. 코드를 실행하려면 개발 환경을 봅니다.
YouTube 링크를 파일로 가져오려면 관리화면의 YouTube 링크로 가져오기를 사용하세요. 지원 범위와 한도는 사용 안내에 정리했습니다.
이미 있는 자막 파일(SRT·VTT·ASS)을 대본으로 들이려면 편집기의 자막 파일 가져오기를 사용하세요. 자막을 파일로 쓰려면 관리화면의 자막 SRT·VTT 내려받기를 사용하세요. 숏폼 편집본은 렌더 결과 줄에, 번역·더빙 작업은 작업 화면에 있습니다. 영상에 구운 자막과 같은 내용이며 시각은 출력 영상 시작이 0초입니다.
- GitHub: 코드 관리, 테스트, 배포, 수동 작업 요청.
- 관리 API와 DB: 작업·버전·승인·예약의 기준.
- 영상 저장소: 원본, 중간 산출물, 완성 영상 보관.
- 별도 워커: AI 호출과 FFmpeg 처리.
- 관리화면: 대본 수정, 미리보기, 검수·승인.
- YouTube: 승인된 결과물을 비공개 업로드한 뒤 공개 예약.
기술 선택은 구현 전 추천안이며 계정 개설·유료 서비스 사용 승인을 뜻하지 않습니다. 초기에는 관리자 1명, 채널 1개, 작업별 대상 언어 1개를 가정합니다.