Docs: [3.0.0] 전체 문서 업데이트 — YouTube Data API + n8n Discord 전송 구조 반영

- README: 아키텍처, 환경변수, API 응답 형식 업데이트
- n8n-setup: RSS → YouTube Data API playlistItems 전환, 노드별 상세 설정
- development: discord.py 제거 반영, API 응답 형식 추가
- operations: CI/CD 자동 배포 설명, DISCORD_WEBHOOK_URL 제거
- testing: DISCORD_WEBHOOK_URL 더미값 제거
- .env.example: DISCORD_WEBHOOK_URL 제거
- tests/test_discord.py 삭제 (모듈 삭제됨)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

docs/operations.md

@@ -2,33 +2,23 @@
 
 YouTube 뉴스 요약 봇의 배포 및 운영 가이드.
 
-**아키텍처:** n8n (RSS 트리거) → FastAPI 앱 (Docker 컨테이너) → Claude API → Discord 웹훅
+**아키텍처:** n8n (YouTube Data API로 새 영상 감지) → FastAPI 앱 (자막 추출 + Claude 요약) → JSON 응답 → n8n (Discord 웹훅 전송)
 
 ---
 
-## 배포 절차
+## 배포
 
-### 1. Docker 이미지 빌드 & Push
+### CI/CD (자동)
 
-```bash
-docker build -t nkey/news-summary-bot:latest .
-docker push nkey/news-summary-bot:latest
-```
+main 브랜치에 push하면 GitHub Actions가 자동으로:
+1. Docker 이미지 빌드
+2. Docker Hub에 push
+3. OCI 서버에서 `docker compose pull && up -d`
+4. Discord에 배포 결과 알림
 
-### 2. OCI 서버 설정
+커밋 메시지에 `[x.y.z]` 버전 태그가 있으면 해당 버전 태그로도 이미지가 push됩니다.
 
-- `docker-compose.yml`과 `.env` 파일을 서버에 준비
-- `.env`에 아래 값 설정:
-  - `ANTHROPIC_API_KEY` — Claude API 키
-  - `DISCORD_WEBHOOK_URL` — Discord 웹훅 URL
-  - `API_SECRET` — n8n에서 호출 시 인증용 시크릿
-- 컨테이너 실행:
-
-```bash
-docker compose pull && docker compose up -d
-```
-
-### 3. 업데이트 시
+### 수동 배포
 
 ```bash
 # 로컬에서
@@ -36,9 +26,16 @@ docker build -t nkey/news-summary-bot:latest .
 docker push nkey/news-summary-bot:latest
 
 # OCI 서버에서
-docker compose pull && docker compose up -d
+docker compose -p nkeys-apps -f /nkeysworld/compose.apps.yml pull news-summary-bot
+docker compose -p nkeys-apps -f /nkeysworld/compose.apps.yml up -d news-summary-bot
 ```
 
+### OCI 서버 환경변수
+
+`.env`에 아래 값 설정:
+- `ANTHROPIC_API_KEY` — Claude API 키
+- `API_SECRET` — n8n에서 호출 시 인증용 시크릿
+
 ---
 
 ## 헬스체크
@@ -63,14 +60,12 @@ docker compose logs -f news-summary-bot
 
 | 증상 | 원인 | 해결 |
 |------|------|------|
-| 자막 추출 실패 (자막 없음) | 영상에 자막 없음 | 자동생성 자막이 없는 영상은 스킵됨 |
+| 자막 추출 실패 (자막 없음) | 영상에 자막 없음 | 자동생성 자막이 없는 영상은 status: error로 반환됨 |
 | 자막 추출 실패 (봇 감지) | YouTube 쿠키 만료 | 브라우저에서 쿠키 재export 후 서버에 업로드 (아래 쿠키 갱신 참고) |
-| Discord 전송 실패 | 웹훅 URL 만료 | Discord에서 웹훅 재생성 후 `.env` 업데이트 |
 | 401 Unauthorized | API_SECRET 불일치 | n8n 헤더와 `.env` 값 확인 |
 | Claude API 오류 | API 키 만료 또는 잔액 부족 | Anthropic 콘솔에서 확인 |
-| Discord embed 글자 수 초과 | 요약이 4096자 초과 | `summarizer.py`의 `max_tokens` 줄이기 |
 
-> 에러 발생 시 FastAPI가 자동으로 Discord에 에러 상세 내용(에러 타입, 메시지, 영상 정보)을 전송합니다.
+> 에러 발생 시 FastAPI가 `status: error`로 응답하고, n8n이 Switch 노드에서 분기하여 Discord에 에러 알림을 전송합니다.
 
 ### Nginx 404 에러
 
@@ -79,13 +74,6 @@ Nginx가 `/api/news/` prefix를 strip하여 FastAPI로 전달합니다. FastAPI
 - 404가 발생하면 Nginx 설정에 `/api/news/` location 블록이 있는지 확인
 - FastAPI 라우트가 prefix 없이 `/summarize`, `/health`로 되어 있는지 확인
 
-### n8n HTTP Request 에러
-
-| 증상 | 원인 | 해결 |
-|------|------|------|
-| `JSON parameter needs to be valid JSON` | 영상 제목에 큰따옴표(`"`) 포함 시 JSON 깨짐 | Specify Body를 **Expression 모드**로 설정 (Fixed 모드 사용 금지) |
-| 404 Not Found | Nginx → FastAPI 프록시 미설정 또는 라우트 불일치 | Nginx 설정 및 FastAPI 라우트 확인 |
-
 ### Docker 쿠키 마운트 관련
 
 | 증상 | 원인 | 해결 |
@@ -109,7 +97,7 @@ YouTube는 OCI/AWS/GCP 등 **데이터센터 IP를 봇으로 감지**하여 자
 
 YouTube는 클라우드 서버 IP를 봇으로 감지하여 자막 추출을 차단합니다. 이를 우회하기 위해 브라우저 쿠키를 사용하며, 약 6개월~1년 주기로 만료됩니다.
 
-**만료 증상:** 자막 추출 시 500 에러 + 로그에 `Sign in to confirm you're not a bot` 메시지 + Discord 에러 알림
+**만료 증상:** 자막 추출 에러 + 로그에 `Sign in to confirm you're not a bot` 메시지 + Discord 에러 알림
 
 **갱신 절차:**
 
@@ -146,3 +134,4 @@ YouTube는 클라우드 서버 IP를 봇으로 감지하여 자막 추출을 차
 - **Claude Sonnet 4.6:** Input $3/MTok, Output $15/MTok
 - 일 1~2건 기준 월 ~$3 이내
 - [Anthropic 콘솔](https://console.anthropic.com/)에서 usage 확인
+- **YouTube Data API v3:** 무료 (일일 10,000 units 쿼터, 현재 사용량 ~48 units/일)