# MediScan 체크리스트

**상태**: draft
**작성일**: 2026-04-24

---

## Phase 0: 자료 확보 + 설계 확정

### 필수 자료 확보
- [ ] 심평원 기본진료내역 PDF 샘플 — 미확보, 자동차사고기본진료정보 구조로 대체 설계 가능
- [x] 심평원 세부진료정보 PDF 샘플 — 확보 (6p, 2026-04-25)
- [x] 심평원 처방조제정보 PDF 샘플 — 확보 (5p, 2026-04-25)
- [x] 심평원 자동차사고 기본/세부 PDF 샘플 — 확보 (1p+5p, 2026-04-25)
- [ ] 심평원 내가먹는약 엑셀/CSV 샘플 — 미확보
- [x] 건보공단 건강검진 결과 PDF 샘플 — 확보 (1p, 2026-04-25)
- [ ] KCD 상병코드 전체 목록 DB (건보공단 공개 자료)
- [ ] 고지의무 기준표 — 표준체 (3개월/1년/5년)
- [ ] 고지의무 기준표 — 간편심사 (주요 보험사 3개+)
- [ ] MHS 실제 출력 레포트 샘플 (벤치마크용)
- [ ] 6대질병 상세 목록 (암/뇌/심장/간/당뇨/고혈압 하위 코드)
- [ ] 수술/시술/검사 수가코드 분류 기준

### 설계 확정
- [ ] 에이전트 미팅: 아키텍처 확정 (서버 구조, DB 스키마, API 설계)
- [ ] PDF 파싱 전략 PoC (pdfplumber vs camelot vs PyMuPDF)
- [ ] 심평원 PDF 테이블 구조 분석 (컬럼명, 데이터 형식)
- [ ] DB 스키마 설계 (analysis_results, analysis_files, kcd_codes, 고지기준)
- [ ] API 설계 (업로드, 분석시작, 결과조회, 이력관리)
- [ ] 이용약관/면책 문구 작성
- [ ] 보안 설계 검토 (암호화, 접근제어, 데이터 삭제)

---

## Phase 1: MVP (표준체 기본 분석)

### 1.1 PDF 파서 모듈
- [ ] 기본진료내역 파서 (진단일, 상병코드, 상병명, 의료기관, 진료유형)
- [ ] 세부진료정보 파서 (수술/처치, 수가코드, 수가명, 일수)
- [ ] 처방조제정보 파서 (약품명, 투약일수, 처방일, 조제기관)
- [ ] 암호화 PDF 복호화 처리
- [ ] 파일 형식 검증 (심평원 PDF인지 확인)
- [ ] 다중 파일 병렬 파싱
- [ ] 파서 단위 테스트 (각 PDF 타입별 최소 3케이스)

### 1.2 분석 엔진 코어
- [ ] 상병코드 정규화기 (주상병/부상병 분리, KCD 매핑)
- [ ] 표준체 고지의무 판별기
  - [ ] 3개월 기준 판별 (진단·치료·투약 동적 분기)
  - [ ] 1년 기준 판별 (입원/수술/재검사)
  - [ ] 5년 기준 판별 (7일+ 입원, 수술, 중대질병)
- [ ] 누적 투약일수 산출기 (동일 상병 합산)
- [ ] 진료일/입원일 교차검증기 (중복 제거, 실제 일수)
- [ ] 수술 분류기 (수술 vs 단순처치/보조처치)
- [ ] 중대/특수치료 분류기 (항암/방사선/중재시술/체외충격파)
- [ ] 7일+ 치료 합산기 (동일원인 합산 로직)
- [ ] 분석 엔진 통합 테스트

### 1.3 리포트 생성기
- [ ] HTML 리포트 기본 템플릿
- [ ] 3개월/1년/5년 섹션별 렌더링
- [ ] 수술/중증치료 섹션
- [ ] 고지양식 자동 생성 (복사 가능)
- [ ] 리포트 PDF 다운로드

### 1.4 백엔드 API
- [ ] POST /api/mediscan/upload (파일 업로드 + 암호화)
- [ ] POST /api/mediscan/analyze (분석 시작)
- [ ] GET /api/mediscan/result/{id} (결과 조회)
- [ ] GET /api/mediscan/history (분석 이력 목록)
- [ ] DELETE /api/mediscan/result/{id} (결과 삭제)
- [ ] JWT 인증 + 히든 플랜 검증
- [ ] 원본 PDF 분석 후 즉시 삭제 로직
- [ ] API 통합 테스트

### 1.5 프론트엔드 (InsuRo 내)
- [ ] 파일 업로드 드래그&드롭 UI
- [ ] 파일 타입별 안내 (어떤 PDF를 넣어야 하는지)
- [ ] 분석 진행 상태바 (퍼센트 + 현재 단계)
- [ ] 결과 리포트 뷰어 (HTML 렌더링)
- [ ] 고지양식 복사 버튼
- [ ] 분석 이력 목록
- [ ] 결과 삭제
- [ ] 모바일 반응형

### 1.6 보안/인프라
- [ ] TLS + AES-256 암호화 구현
- [ ] 원본 PDF 즉시 삭제 로직 검증
- [ ] RLS 정책 (본인/조직 접근 제한)
- [ ] 접근 로그 기록
- [ ] Supabase 마이그레이션 파일

### 1.7 QC
- [ ] 정확도 검증: MHS 결과와 교차 비교 (최소 5케이스)
- [ ] 보안 침투 테스트 (composite-team)
- [ ] e2e 테스트 (업로드 → 분석 → 결과 확인)

---

## Phase 2: 확장 분석

### 2.1 추가 PDF 파서
- [ ] 자동차사고 기본진료 파서
- [ ] 자동차사고 세부진료 파서
- [ ] 투약정보(내가먹는약) 파서
- [ ] 건강검진 결과 파서

### 2.2 분석 엔진 확장
- [ ] 간편심사 판별기 (보험사별 기준 DB)
- [ ] 처방 의료기관 기반 분리 (통원/입원/수술별)
- [ ] 텍스트 표준화 (양방/한방, 의료법인명 필터)
- [ ] 3개월 진료정보 매칭 (확정/미확정)
- [ ] 수술 vs 중증/특수치료 정밀 분리
- [ ] 검사 오탐 방지 알고리즘

### 2.3 리포트 고도화
- [ ] 고지 가이드라인 (표준체/유병자별 아코디언)
- [ ] 고위험 경고 UI (붉은 Bold)
- [ ] 동일원인 합산 근거 토글
- [ ] 병원명 마스킹 (중간 * 처리)
- [ ] 투약 포맷 개선 ([N일] 약품명)
- [ ] 진료기간·일수 통합 표기
- [ ] 세부내역/검사/투약 토글 UI
- [ ] 처방정보 페이지 분할

---

## Phase 3: AI 고도화

### 3.1 AI 분석
- [ ] 상병코드 자연어 해석 (Claude)
- [ ] 질병예측 분석 (건강검진 기반)
- [ ] 위험도 점수화 (고/중/저)

### 3.2 고객 관리
- [ ] 고객별 분석 이력 DB
- [ ] 분석 타임라인 (재분석 시 변화 추이)
- [ ] 조직 내 결과 공유

### 3.3 통합
- [ ] 분석 결과 → 맞춤 보험 콘텐츠 추천
- [ ] 고지양식 → 청약서 필드 자동 매핑

---

## 미해결 항목
- [미해결] PDF 샘플 미확보 — Phase 0 진행 불가의 주요 블로커
- [미해결] 고지의무 기준표 미확보 — 분석 엔진 정확도에 직결
- [미해결] 서버 배포 전략 — InsuRo 서버 내 vs 별도 마이크로서비스
- [미해결] 분석 요금 정책 — 횟수 제한 vs 무제한 (히든 플랜)