# 블로그 이미지 품질 개선: Satori 인포그래픽 안정화 + 디자인 QA 적용

## Lv.3 작업

## 현재 문제 (스크린샷 기반)
- `/home/jay/.cokacdir/workspace/autoset/photo_AQAD6AxrG_il2FZ-.jpg`
- 5개 이미지 중 3개 "infographic 및 satori 모두 실패" 에러
- 생성 성공한 1개도 글자 크기 작음, 줄바꿈 부적절, 디자인 일관성 부족
- task-1654.1에서 Satori 인포그래픽 레이아웃 4종 추가했으나 실제 동작 안 됨

## 근본 원인 분석 (필수)

### 1. Satori 실패 원인 파악
- satori_cli.js에 추가된 4종 레이아웃(process_flow/comparison_table/checklist/infographic)이 실제로 호출되는지 확인
- 에러 로그 확인: `/tmp/` 또는 stderr 출력
- Node.js 실행 환경 문제인지, 프롬프트 파싱 문제인지 구분
- **실제 프롬프트 1개를 직접 satori_cli.js에 넣어서 테스트**

### 2. 광고 배너 QA 노하우 적용
제이회장님 피드백: "광고 배너작업 노하우 활용해야 함. QA적용 등 고도화작업이 학습된 상황"

기존 광고 배너 시스템에서 검증된 패턴 확인:
- 배너 QC 게이트: `/home/jay/workspace/` 하위 배너 관련 검증 로직 확인
- ad-banner-specs.md: `/home/jay/workspace/dashboard/data/ad-banner-specs.md`
- 배너 디자인 기준: 최소 폰트 크기, 여백, 컬러 대비 등

### 3. 이미지 품질 기준 정립
블로그 이미지에 적용할 품질 기준:
- **최소 폰트 크기**: 제목 24px+, 본문 14px+ (현재 너무 작음)
- **줄바꿈**: 단어 단위 줄바꿈, 한글 조사 분리 방지
- **여백**: 패딩 최소 20px, 요소 간 간격 12px+
- **색상 대비**: WCAG AA 기준 (4.5:1+)
- **디자인 일관성**: 동일 블로그 글 내 이미지들의 색상 팔레트/스타일 통일

## 구현 내용

### 1. Satori 인포그래픽 안정화
- satori_cli.js 4종 레이아웃 디버깅 + 수정
- 프롬프트 파싱 로직 강화 (한글 프롬프트 처리)
- 각 레이아웃별 실제 테스트 이미지 생성 확인

### 2. HTML→PNG(Claude CLI) 경로 프롬프트 개선
- `_prompt_to_html()` 호출 시 Claude에게 전달하는 시스템 프롬프트에 품질 기준 추가:
  - 최소 폰트 크기 24px 제목 / 14px 본문
  - padding: 20px+
  - word-break: keep-all (한글 줄바꿈)
  - 색상: 진한 배경 + 밝은 텍스트 또는 밝은 배경 + 진한 텍스트 (중간 톤 금지)

### 3. 이미지 QA 검증 단계 추가
- 생성된 이미지의 품질을 자동 검증하는 로직:
  - 이미지 크기 확인 (최소 800px 이상)
  - 빈 이미지 / 대부분 흰색 감지
  - 생성 실패 시 재시도 전 프롬프트 자동 단순화

## 참조 파일
- image_router.py: `/home/jay/workspace/tools/ai-image-gen/image_router.py`
- satori_cli.js: `/home/jay/workspace/tools/ai-image-gen/satori-test/satori_cli.js`
- 광고 배너 스펙: `/home/jay/workspace/dashboard/data/ad-banner-specs.md`
- server.py 이미지 생성: `/home/jay/workspace/dashboard/server.py` (line 971)
- 문제 스크린샷: `/home/jay/.cokacdir/workspace/autoset/photo_AQAD6AxrG_il2FZ-.jpg`

## 테스트
1. infographic 유형 프롬프트 5개 → satori_cli.js 직접 실행 → 5개 모두 이미지 생성 확인
2. process_flow/comparison_table/checklist 각 1개씩 생성 확인
3. 생성된 이미지 폰트 크기 24px+ / 14px+ 확인
4. 대시보드에서 전체 파이프라인 테스트 (글작성 → 이미지 생성 → 모두 성공)

## 보고서
`/home/jay/workspace/memory/reports/task-{TASK_ID}.md`