# task-785.1 완료 보고서: 카드뉴스 로고 오버레이

## SCQA

**S**: ThreadAuto 카드뉴스 렌더러(`cardnews.py`)가 커버/CTA 슬라이드를 생성하나, "서울대보험쌤" 로고가 포함되어 있지 않다.

**C**: 제이회장님이 카드뉴스의 첫 카드(커버)와 마지막 카드(CTA)에 브랜드 로고를 우측 상단에 삽입하도록 요청하였으며, 어두운 테마에서는 흰색 로고를 사용해야 한다.

**Q**: 테마 밝기에 따라 적절한 로고 버전을 자동 선택하여 커버/CTA 슬라이드에 삽입할 수 있는가?

**A**: 로고 PNG 2벌(dark/white) 전처리 후 `_draw_logo_overlay()` 메서드를 추가하여 구현 완료. pytest 4건 전체 통과, pyright 에러 0건. 밝은 테마(GREEN_WHITE)에서 네이비 로고, 어두운 테마(NAVY_GOLD)에서 흰색 로고가 정확히 배치됨을 시각적으로 검증.

## 생성/수정 파일 목록

- `renderer/cardnews.py` — `_draw_logo_overlay()` 메서드 추가(574-605줄), `render_cover()`에 호출 추가(842줄), `render_summary_cta()`에 호출 추가(1950줄)
- `static/logo_snu_insurance_dark.png` — 밝은 테마용 네이비 로고 (투명배경, 136KB)
- `static/logo_snu_insurance_white.png` — 다크 테마용 흰색 로고 (투명배경, 52.5KB)
- `scripts/prepare_logo.py` — 로고 전처리 스크립트
- `tests/test_logo_overlay.py` — 로고 오버레이 테스트 4건

## 테스트 결과

```
tests/test_logo_overlay.py::test_cover_light_theme_dark_logo PASSED
tests/test_logo_overlay.py::test_cover_dark_theme_white_logo PASSED
tests/test_logo_overlay.py::test_cta_with_logo               PASSED
tests/test_logo_overlay.py::test_logo_overlay_selects_correct_logo PASSED

4 passed in 0.57s
```

pyright: `0 errors, 0 warnings, 0 informations`
black/isort: `1 file left unchanged`

## 검증용 이미지

`/home/jay/projects/ThreadAuto/output/` 에 저장:
- `test_cover_green_white.png` — GREEN_WHITE 테마 커버 (네이비 로고 우측 상단)
- `test_cover_navy_gold.png` — NAVY_GOLD 테마 커버 (흰색 로고 우측 상단)
- `test_cta_navy_gold.png` — NAVY_GOLD 테마 CTA (흰색 로고 우측 상단)

## 발견 이슈 및 해결

### 자체 해결 (3건)
1. **로고 배경 투명화 경계 아티팩트** — luminance threshold 0.85 + softness 0.06 구간 anti-aliasing으로 자연스러운 경계 처리
2. **pyright Image.LANCZOS 경고** — `Image.Resampling.LANCZOS` 으로 변경하여 해결
3. **로고 파일 경로 해석** — `Path(__file__).resolve().parent.parent / "static"` 패턴으로 worktree/원본 모두 호환

## 머지 판단

- **머지 필요**: Yes
- **브랜치**: task/task-785.1-dev2
- **워크트리 경로**: /home/jay/projects/ThreadAuto/.worktrees/task-785.1-dev2
- **머지 의견**: pytest 4건 전체 통과, pyright 에러 0건, 시각적 검증 완료. 기존 코드(워터마크, 다른 슬라이드)에 영향 없음. 충돌 가능성 낮음 (cardnews.py의 기존 메서드 미변경).