PHASE 00완료 ✓
개발 기반
만들고 실행하고 검사할 수 있는 작업 환경.
- Next.js · TypeScript 프로젝트
- Postgres · Redis · Python / ffmpeg
- 관리자 로그인 · mock worker
- 설치 문서 · 테스트 환경
완료 근거 보기
Docker 3개 서비스 healthy 확인. 관리자 로그인 → 실제 mock worker → 샘플 JSON 반환 → 로그아웃 성공.
아이디어에서, 실제로 보는 자막까지
파이프라인 구축 완료.
다음은 팬 요청·운영.
유튜브 URL → 음성 전사 → 영어 번역 → 영상 아래 동기화 자막
현재 Phase 2(자동 자막 파이프라인) 인수 검증 완료, Phase 3 착수 준비 중입니다.
검증을 마친 단계
3 / 6 phases
Phase 0·1·2 검증 통과 (50%)
현재 상태 → Phase 2 인수 검증 완료 · Phase 3 (팬 요청 및 운영) 착수 준비
미디어 변환, Whisper 전사/GPT 번역 어댑터, 자막 QA, DB 버전 관리 및 관리자 검수/게시 파이프라인이 구축되어 Mock 및 통합 테스트를 통과했습니다.
미디어 변환, Whisper 전사/GPT 번역 어댑터, 자막 QA, DB 버전 관리 및 관리자 검수/게시 파이프라인이 구축되어 Mock 및 통합 테스트를 통과했습니다.
전체 개발 진도
●검증 완료●착수 준비○후속 / 예정
PHASE 01완료 ✓
자막 시청 플레이어
영상 바로 아래에서, 시간에 맞춰 읽는 영어 자막.
- YouTube URL 파서 · 공식 iframe
- 샘플 JSON 자막 동기화
- Play / Pause / Seek / 배속
- 극장 모드 · 글자 크기 · 타이밍
완료 근거 보기
실제 YouTube에서 1× · 1.5× · 2× 자막 전환 확인. 모바일·PC, 자막 없는 구간, 비동기 탐색 검사 통과.
PHASE 02완료 ✓
자동 자막 파이프라인
파일 한 개가 게시 가능한 영어 자막이 되는 과정.
- 권한 있는 파일 · 업로드 어댑터
- ffmpeg → 전사 → 번역 → 정렬
- 큐 · DB 저장 · 품질 검사 · 재시도
- 임시 음성 정리 · 관리자 검수 / 게시
완료 근거 보기
승인된 파일(Upload/Local) 기반 전사 → 번역 → QA → DB 버전 관리 → 검수/게시 파이프라인 완성. Vitest 61개, Python unittest 11개, Playwright UI 7개, DB/Redis/Docker ffmpeg 통합 검증 통과. (실제 유료 OpenAI 호출은 opt-in 대기)
PHASE 03착수 준비 →
팬 요청과 운영
팬이 신청하고, 운영자가 우선순위를 정하는 흐름.
- 영상 요청 폼 · 투표 · 순위
- 중복 요청 / 중복 작업 방지
- 관리자 승인 · 수동 실행
- 비용 · 처리량 대시보드
진입 / 완료 조건
Phase 2 처리 흐름 검증 완료 후 착수. 동일 URL 반복 제출 방지, video 1개 / 활성 job 1개 상태 제어.
PHASE 04예정
댓글 수요 분석
“English sub please” 신호를 운영자에게 모으기.
- 공식 Data API 채널 / 댓글 수집
- 정규식 후보 · AI 분류
- 쿼터 관리 · 중복 수집 방지
- 후보 검수 · 내부 우선순위
진입 / 완료 조건
API 키·테스트 채널·쿼터 준비 후 진행. 2개 채널의 신규 후보와 자막 요청 신호를 관리자에게 표시. 자동 홍보 댓글은 제외.
PHASE 05별도 승인
공개 서비스 준비
개인 서버 운영을 넘어 외부 공개를 준비하는 단계.
- 콘텐츠 이용 범위 · 삭제 요청
- 개인정보 · 약관 · 접근 제한
- 모니터링 · 예산 · 백업 · 성능
- SEO · 광고는 후속 선택
진입 / 완료 조건
공개 운영은 별도 승인 후 진행. 초기 광고 OFF. 개인 서버 테스트와 공개 출시를 별도 상태로 관리.
PRODUCT FLOW
사용자에게 보이는 큰 흐름
유튜브 URL→승인 / 파일 확보→전사 · 번역 · QA→저장 · 게시→영상 + 동기화 자막
초록 테두리: 현재 구현 및 검증 완료된 파이프라인 구간입니다.
현재 검증 근거
61단위 테스트
7브라우저 테스트
11Python 테스트
PASS빌드 · 타입 · 포맷
Phase 0·1·2 기준. 자동화 테스트 및 실제 브라우저 E2E 검증 통과.
INITIAL OPERATIONS
운영 환경: jerome-server (.42)
jerome-server · 192.168.0.42
로컬 인프라 및 도메인 연동 준비
Next.js 웹 (:3000)Python worker / ffmpegPostgres (:5432)Redis 작업 큐
- 웹 포함 서버용 Docker Compose 준비
- 접속 주소 · 환경 변수 · 관리자 설정
- DB 볼륨 · 백업 · 재시작 정책
- UPnP 포트포워딩 및 CNAME (ksub.goodpace.app) 연동
이 페이지는 K-SUB 전체 진행 상황을 추적하는 진도표 대시보드입니다.