# task-192.1 완료 보고서: 유튜브 자동 요약 파이프라인 - 감지 스크립트 구현

**작업팀**: dev3-team (팀장: 라, 실행: GLM-5)
**소요시간**: 12분 6초
**완료일**: 2026-03-03

---

## 작업 개요

유튜브 크롤링(6시간 주기) 완료 후 자동으로 요약 대기 영상을 감지하는 Python 스크립트 구현.
Firestore `youtube_summary_queue`에서 `pending` 영상을 감지하고, 전문을 로컬에 저장하는 파이프라인의 1~2단계 구현.

---

## 구현 결과

### 1단계: 감지 스크립트 (Haiku용)

**파일**: `/home/jay/workspace/scripts/youtube-check-new-transcripts.py`

- Firestore `youtube_summary_queue`에서 `status='pending'` 영상 목록 조회
- 특정 영상의 전문(transcript) 조회 (`--with-transcript --video-id`)
- 전문을 로컬 파일로 저장 (`--save-transcript`)
- JSON/text 출력 포맷 지원
- TypeScript 스크립트를 subprocess로 호출하여 Firebase 인증 재사용

**사용법**:
```bash
# 대기 영상 목록 조회
python3 /home/jay/workspace/scripts/youtube-check-new-transcripts.py

# 전문 조회 + 저장
python3 /home/jay/workspace/scripts/youtube-check-new-transcripts.py \
  --with-transcript --video-id <videoId> --save-transcript
```

### 신규 생성: youtube-get-pending.ts

**파일**: `/home/jay/projects/insuwiki/scripts/youtube-get-pending.ts`

- Firestore `youtube_summary_queue`에서 pending 문서 조회
- `youtube_knowledge`에서 영상 상세 정보 (제목, 채널명, 자막 여부) 조회
- `--with-transcript --videoId` 모드: `youtube_transcripts` 컬렉션에서 청크 조합하여 전문 반환
- Firebase Admin SDK 사용 (기존 Service Account 키 재활용)

---

## 파이프라인 구조

```
[자동 크롤링] 00/06/12/18시 KST
    ↓ Drive에 전문(_전문.md) 업로드
[youtube-check-new-transcripts.py] (Haiku용, cron 실행)
    ↓ 새 전문 발견 시 JSON 출력
[Sonnet 요약 지시] (미구현 - 후속 태스크)
    ↓ 요약본 작성
[youtube-upload-summary.ts] (task-190.1 기존 구현)
    ↓ Drive 업로드 + Firestore summaryStatus → 'done'
```

---

## 생성/수정 파일 목록

| 파일 | 상태 | 크기 |
|------|------|------|
| `/home/jay/workspace/scripts/youtube-check-new-transcripts.py` | 신규 | 7,366 bytes |
| `/home/jay/projects/insuwiki/scripts/youtube-get-pending.ts` | 신규 | 7,537 bytes |
| `/home/jay/workspace/projects/insuwiki/tests/youtube/test_youtube_check_transcripts.py` | 신규 | 8,047 bytes |

---

## 테스트 결과

**21개 테스트 모두 통과** ✅

- 스크립트 존재/실행권한/문법 검증 (4개)
- 도움말 출력 (1개)
- 인자 검증 (1개)
- 전문 저장 로직 (2개)
- JSON 출력 구조 (3개)
- 전문 조회 구조 (2개)
- 모듈 import (4개)
- 에러 처리 (2개)
- 통합 테스트 (2개)

※ Firebase 실제 연동 테스트는 환경 제약(firebase-admin pip 설치 불가)으로 TypeScript 호출 방식으로 우회.
실제 Firebase 연동은 기존 TypeScript 스크립트가 담당하므로 기능적으로 정상.

---

## GLM 결과 평가

**긍정적**:
- 파이썬 스크립트가 깔끔하게 설계됨 (단일 책임 원칙)
- 에러 처리 완비 (TimeoutExpired, JSON decode error, subprocess 실패)
- TypeScript 스크립트 호출 방식으로 Firebase 인증 재사용 - 합리적 설계

**미완료 사항**:
- **4단계 cron 스케줄 등록 미완료** - openclaw가 "후속 작업 필요"로 처리
- 2-3단계 완전한 자동화 파이프라인(요약 지시 → 업로드)은 감지 스크립트와 별도 구현 필요

---

## 셀프 QC 결과

1. **다른 파일 영향**: 없음 (신규 파일만 생성, 기존 코드 수정 없음)
2. **엣지 케이스**: pending 없음/TS 실패/JSON 파싱 실패/videoId 없음 모두 처리됨
3. **작업 지시 일치**: 1-2단계 구현, 4단계 cron 등록 미완
4. **에러 처리/보안**: Firebase 인증 기존 방식 재사용, subprocess 에러 처리 완비
5. **테스트 커버리지**: 21개 통과, Firebase 실 연동만 모킹 대체

---

## 재시도 여부

없음 (1차 시도 성공)

---

## 아누에게 전달 사항

- **4단계 cron 등록 미완**: `15 0,6,12,18 * * *` 시각에 `youtube-check-new-transcripts.py` 실행 cron 등록 필요
- **2-3단계 자동화**: 감지 후 Sonnet에게 요약 지시 → Drive 업로드 연결하는 파이프라인은 별도 태스크로 구현 요청 필요
- 현재 구현으로도 수동 실행으로 pending 영상 목록 확인 가능