Video Summarization Pipeline

JESUS_RENS — 영상 요약·렌더링 파이프라인

인증된 영상 작업을 큐에 적재하고 ASR, 로컬 LLM, 품질 게이트, ffmpeg 렌더링으로 처리합니다.

5 services 30 routes 225 tests Local LFM2

Snapshot

Runtime
5 services
API
30 routes
Tests
225
Boundary
Gateway

수치는 compose.yaml과 현재 코드 구조 기준입니다.

처리 흐름

  1. Gateway브라우저 요청은 인증 게이트웨이를 통과
  2. Job API업로드·YouTube 작업을 큐에 저장
  3. WorkerASR, 구간 후보, 요약 계획 생성
  4. Quality Gate근거 구간과 기준 지표를 통과해야 렌더링
  5. Renderffmpeg 렌더링 후 허용된 산출물만 제공
LLM 출력은 time_segments JSON 계약으로 제한하고, 품질 게이트 실패 시 final MP4를 생성하지 않습니다.
Public Demo

분석 시스템 데모

YouTube URL을 붙여 넣으면 최종 요약 영상을 새로 생성하고, 완료 후 MP4만 다운로드할 수 있습니다.

  • 10분 이상 2시간 이내의 개신교 계열 설교 영상을 넣어 주세요.
  • 현재 학습·검증 데이터는 이 범주의 설교 영상에 한정되어 있습니다.
  • 공개 데모는 관리자 페이지 승인 후 1시간 동안 분석 시작 또는 예약이 가능합니다.
  • 다른 IP의 데모 분석이 진행 중이면 예상 종료 시간을 확인한 뒤 예약할 수 있습니다.
  • 완료된 MP4는 생성 후 1시간 동안 다운로드할 수 있으며 이후 삭제됩니다.

샘플 원본 출처: 20260726 수서성지교회 주일 1부 예배

이번 시간-
오늘-
진행률 0% 예상 시간 -
분석 대기 중

KPI & ROI

System

  • 5개 Compose service
  • 30개 HTTP route
  • 225개 test function / 33개 test file

Quality

  • 3-case local regression: 3/3 hard gate pass
  • Updated gate debt: 0.0000
  • Final-media strict gate: 0 pass, 26 review cuts

ROI Assumption

  • 수동 180분 → 도입 후 5~10분 기준
  • 신규 편당 약 2.83~2.92h / 169,470~174,455원 절감 추정
  • 월 6 신규 + 6 재처리 기준 약 34.4~35.2h / 2,057,567~2,105,418원

* ROI는 작업 로그 확보 전 산정용 가정입니다.

근거: 기존 ROI 산식과 KOSA 2025년 적용 SW기술자 평균임금의 시간평균임금 59,813원 기준입니다. 수동/도입 후 소요 시간은 실측 로그 확보 전 시나리오 값입니다. KOSA 원문

Case Study

인증 기반 영상 요약 작업 시스템

Problem

  • 분석 컨테이너를 직접 노출하지 않는 사용자 접근 경계가 필요했습니다.
  • 긴 영상은 ASR 타임스탬프, LLM 출력, 컷 경계 품질이 쉽게 흔들립니다.

Build

  • Gateway, Auth/Admin, Job API, Worker를 분리했습니다.
  • ASR → 구간 계획 → 품질 게이트 → 렌더링 순서로 처리합니다.

Result

  • 운영 경계와 작업 큐를 갖춘 브라우저 실행 흐름을 구성했습니다.
  • 품질 검증이 부족한 final media는 통과로 주장하지 않도록 분리했습니다.
Evidence

근거

Architecture

Gateway/Auth/Admin/API/Worker 경계와 /jobs 계약은 설계 문서 기준으로 정리했습니다.

Validation

3-case hard gate pass와 final-media strict gate 미통과 상태를 분리해 표기했습니다.

Source

compose.yaml, route/test 코드 카운트, archi/docs 설계 기록을 기준으로 했습니다.