# task-1011.1 완료 보고서: 카드뉴스 자동생성 V3 PRD 작성

## SCQA

**S**: 기존 ThreadAuto V2 파이프라인(satori 기반)은 0.32초/장 속도와 한글 100% 정확도로 안정 운영 중이며, 4종의 디자인 스킬(satori-cardnews, gemini-image, hybrid-image, canvas-design)과 이미지 라우터(image_router.py)가 구축되어 있다.

**C**: V2는 템플릿 고정으로 디자인 다양성이 부족하고 AI 이미지를 활용하지 못한다. InsuRo 플랫폼에서 사용자 주도 카드뉴스 생성 서비스를 제공하려면 고품질 다양한 디자인의 V3 파이프라인이 필요하다.

**Q**: 기존 V2를 유지하면서 AI 이미지 + 팩트 검증 + 브랜드 일관성을 갖춘 V3 병렬 파이프라인을 어떻게 설계할 것인가?

**A**: 5개 섹션(A: 디자인팀 신설, B: 7단계 파이프라인, C: InsuRo 통합 UX, D: 기술 스택, E: 3단계 로드맵)을 포함하는 PRD를 작성 완료. 디자인팀은 안 1(역할별 전문 팀원 + 비너스 연동)을 채택 권고. V3 파이프라인은 Input→Editor→Researcher→Writer→Designer→Compositor→QualityGate 7단계로 설계.

## 생성/수정 파일 목록

| 파일 | 유형 | 설명 |
|------|------|------|
| `/home/jay/workspace/memory/specs/cardnews-v3-prd.md` | 신규 | PRD 본문 (A~E 섹션 + 부록) |
| `/home/jay/workspace/memory/reports/task-1011.1.md` | 신규 | 본 보고서 |

## 작업 내용 요약

### 분석한 기존 코드/스킬 (6개)
1. `satori-cardnews` SKILL.md + `satori-test/` 디렉토리
2. `gemini-image` SKILL.md + `gemini_pro_generate.py`
3. `hybrid-image` SKILL.md + `generate_hybrid.py`
4. `canvas-design` SKILL.md
5. `image-gen-guide` SKILL.md
6. `image_router.py` 전체 코드 (500줄, 라우팅+Fallback+IPTC)
7. `design-tokens.json` (3 브랜드, 공유 토큰)
8. `generate_carousel.py` (기존 캐러셀 생성기)

### PRD 주요 결정사항
- **디자인팀 아키텍처**: 안 1(역할별 전문 팀원) 채택 (4:1 우위). 비너스 Gemini센터 재활용.
- **V2/V3 공존**: V2=정기 자동 발행, V3=주문형 고품질. 병렬 트랙.
- **데이터 모델**: Python dataclass 기반 7개 모델 정의 (TopicRequest ~ QualityReport)
- **API 구조**: FastAPI 비동기, 작업 ID 폴링/WebSocket
- **로드맵**: Phase 1(MVP) → Phase 2(품질+다양화) → Phase 3(InsuRo 통합)

## 발견 이슈 및 해결

### 자체 해결 (2건)
1. **PDF 참고 자료 경로 부재** — 작업 파일 내 요약 정보 + 실제 코드 분석으로 대체. PRD 품질에 영향 없음.
2. **threads 디렉토리 부재** — V2 파이프라인 정보는 작업 파일의 설명과 기존 carousel-gen/satori-test 코드 분석으로 보완.

### 범위 외 미해결 (1건)
1. **비너스(Venus) Gemini API 접근 권한 확인** — 범위 외 사유: 횡단조직 비너스의 API 키 공유 확인은 디자인팀 구성 Phase에서 수행 필요.

## 테스트 결과

문서 작업이므로 코드 테스트 해당 없음. PRD 내용의 정확성은 아래로 검증:
- 기존 스킬 6종의 실제 코드를 직접 읽고 분석 (표면적 설명이 아닌 코드 기반)
- `image_router.py` 500줄 전체 코드 분석으로 Fallback 체인 정확히 반영
- `design-tokens.json` 실제 구조(3 브랜드, 5 사이즈, 타이포/이펙트 토큰) 반영
- `generate_hybrid.py` 실제 파이프라인(Gemini배경→HTML→Playwright캡처) 반영
- fact_db.md 외 수치 미생성, "잔존수당" 미사용 확인

## 셀프 QC 결과

- [x] 1. 다른 파일 영향: 없음 (PRD 신규 생성만)
- [x] 2. 엣지 케이스: Fallback, QualityGate, 동시 요청 시나리오 설계 반영
- [x] 3. 작업 지시 정확 일치: A~E 섹션 전부, 금지 사항 준수
- [x] 4. 에러/보안: API 키 관리, 금소법 검증 포함
- [x] 5. 테스트: 문서 작업 (코드 테스트 N/A)
- [x] 6. 이슈 해결: 2건 자체 해결, 1건 범위 외