---
task_id: task-2166
type: plan
scope: task
created: 2026-04-25
updated: 2026-04-25
status: completed
---

# 계획서: task-2166

**task**: task-2166
**목표**: MediScan Phase 1-C 리포트 생성기 개발 (HTML 리포트 + 고지양식 자동 생성)
**승인**: 아누 2026-04-25
**근거**: MediScan 마스터플랜 Phase 1-C (계획서 섹션 2.2C)

---

## 목표

AnalysisReport를 받아 (1) HTML 시각화 리포트, (2) 텍스트 기반 고지양식을 생성하는 모듈 구현.
- 252개 테스트 PASS (기존 207 + 신규 45)
- HTML 리포트에 9개 섹션 렌더링
- 고지양식에 병원명 마스킹, 수술명 포맷, 주사제 제외 적용

## 범위

### 포함
- src/report/ 패키지 신규 생성 (formatters, html_report, disclosure_form)
- Jinja2 HTML 템플릿 (report.html, disclosure.html)
- 포맷터 단위 테스트 23개 + 리포트/고지양식 테스트 22개

### 제외 (다음 페이즈 이후)
- AI 상병코드 자연어 설명 (Phase 2)
- 위험도 점수화 (Phase 2)
- PDF 다운로드/카카오톡 공유 (Phase 3)
- 프론트엔드 UI 통합 (Phase 2)

## 위임 계획

- 포맷터 모듈: **토르(백엔드)** — 날짜/금액/병원명/투약 포맷 함수
- 포맷터 테스트: **헤임달(테스터)** — TDD 선행 테스트
- 리포트/고지양식 생성기: **토르(백엔드)** — HtmlReportGenerator, DisclosureFormGenerator
- Jinja2 템플릿: **프레이야(프론트엔드)** — HTML/CSS 구현
- 통합 테스트: **헤임달(테스터)** — 렌더링 검증

## 검증 기준

- 전체 테스트: `pytest tests/ -q` → 252 passed
- HTML 리포트 생성: 샘플 AnalysisReport → 8KB+ HTML 파일
- 고지양식 생성: 주사제 제외, 병원명 마스킹 확인
- Phase 1-A/B 코드 수정 없음 확인
