# task-1187.1 완료 보고서
> ThreadAuto 카드뉴스 V2 1건 생성 및 업로드 (Threads + Instagram 크로스포스팅)
> 팀: dev3-team (다그다) | 작성일: 2026-03-28

---

## SCQA

**S**: ThreadAuto 카드뉴스 V2 파이프라인이 운영 중이며, 정기적으로 evergreen_topics.json에서 토픽을 선택하여 카드뉴스를 생성 및 발행한다.

**C**: 금일 스케줄에 따라 카드뉴스 1건을 자동 생성하고 Threads + Instagram 양쪽에 크로스포스팅해야 한다.

**Q**: 카드뉴스 V2 렌더러로 1건을 생성하고, fact_guard 검증을 통과한 뒤 양 플랫폼에 정상 업로드할 수 있는가?

**A**: `run_card_post.py` 실행으로 "서울대보험쌤 AI 5대 무기 상세 해설" 토픽의 카드뉴스 7장을 생성, fact_guard 1회차 통과, Threads(post_id: 18145077310492022) 및 Instagram(post_id: 18104446885903439) 양쪽 업로드 성공. 총 소요시간 약 17분 32초.

---

## 실행 결과

- **토픽 ID/제목**: "서울대보험쌤 AI 5대 무기 상세 해설" (카테고리: 정보제공)
- **카드 타입**: I (카드뉴스 V2)
- **슬라이드 수**: 7장
- **fact_guard 검증**: 1회차 통과 (재시도 없음)
- **Threads post_id**: `18145077310492022`
- **Instagram post_id**: `18104446885903439`
- **크로스포스팅**: 성공 (overall_success=True)
- **에러**: 없음 (Threads: null, Instagram: null)

### 브랜딩 확인
- Badge: "서울대보험크루" — 카드뉴스 V2 렌더러에서 자동 적용
- Watermark: "서울대보험쌤" — 카드뉴스 V2 렌더러에서 자동 적용
- Footer: "인카다이렉트 TOP사업단" — 카드뉴스 V2 렌더러에서 자동 적용

---

## 산출물

- `/home/jay/projects/ThreadAuto/output/cardnews_20260328_173835_00.png`
- `/home/jay/projects/ThreadAuto/output/cardnews_20260328_173835_01.png`
- `/home/jay/projects/ThreadAuto/output/cardnews_20260328_173835_02.png`
- `/home/jay/projects/ThreadAuto/output/cardnews_20260328_173835_03.png`
- `/home/jay/projects/ThreadAuto/output/cardnews_20260328_173835_04.png`
- `/home/jay/projects/ThreadAuto/output/cardnews_20260328_173835_05.png`
- `/home/jay/projects/ThreadAuto/output/cardnews_20260328_173835_06.png`
- `/home/jay/projects/ThreadAuto/output/cardnews_post_result_20260328_174240.json`

---

## 발견 이슈 및 해결

### 자체 해결 (0건)
해당 없음 — 스크립트 실행이 정상 완료됨.

### 범위 외 미해결 (3건)
1. **Firestore ADC 인증 미설정** — 범위 외 사유: 인프라/인증 설정은 본 작업 범위 외. 로컬 파일 폴백으로 정상 동작하여 기능에 영향 없음. 로그: `Firestore 초기화 실패, 로컬 파일 폴백으로 동작`
2. **Instagram API 일시적 500 에러** — 범위 외 사유: Facebook/Instagram 서버 측 transient 에러. 자동 재시도(1초 후)로 복구됨. 로그: `HTTP 500 응답 (attempt=0) — 1s 후 재시도`
3. **hashtags 빈 배열** — 범위 외 사유: 콘텐츠 생성 파이프라인의 해시태그 생성 로직 이슈일 수 있으나, 기능상 게시물에 영향 없음. 향후 파이프라인 점검 권장.

---

## 셀프 QC

- [x] 1. 다른 파일 영향 여부: 없음 (스크립트 실행만, 코드 변경 없음)
- [x] 2. 엣지 케이스: fact_guard 실패 시 최대 3회 재시도 → 1회차 통과
- [x] 3. 작업 지시 일치 여부: 카드뉴스 V2 사용, 크로스포스팅 완료, post_id 기록 완료
- [x] 4. 에러 처리/보안: Instagram 500 에러 자동 재시도 복구, 게시물 삭제 안 함
- [x] 5. 테스트 커버리지: 코드 변경 없음 (스크립트 실행 작업)
- [x] 6. 발견 이슈 해결: 범위 외 3건 사유 명시
- [x] 7. 코드 아키텍처: 코드 변경 없음
- [x] 8. 인터페이스 변경: 해당 없음

---

## QC 자동 검증

```
코드 변경 없는 스크립트 실행 작업 — qc_verify.py는 보고서 존재 + 데이터 무결성 검증만 수행
```