# MetaboValue — 대사약물 가치·예산 대시보드

> ⚠️ **연구용·참고용 도구입니다.** 합성/근사 데이터 기반이며 실제 임상 의사결정을 대체하지 않습니다.

## 목적
코호트의 약물 효과 데이터(체중·HbA1c·FIB-4 baseline/follow-up)와 약가표를 결합해, 단순 효과가 아닌 **가치 지표**(반응자당 비용, 예산영향, 가치 사분면, 디프리스크라이빙 절감)를 자동 산출하는 오프라인 단독실행 웹 대시보드.

- **도메인:** Obesity · MASLD · DM
- **카테고리:** 웹기반 대시보드 (코호트 모니터링 · 경제 KPI 시각화)
- **slug:** `metabovalue`
- **빌드일:** 2026-06-07

## 핵심 기능
1. **반응자당 비용 (Cost-per-Responder):** 사용자 정의 반응 기준(체중감량 ≥5/10/15%, HbA1c<7%, FIB-4 1단계 개선)별로 약물군의 cost-per-responder를 비교.
2. **예산영향 시뮬레이터 (What-if):** 코호트의 X%를 특정 약물(예: 티르제파타이드 15mg)로 전환 시 연간 약제비 변화(ΔKRW) 슬라이더.
3. **가치 사분면 (Value Quadrant):** 약물군을 (환자당 비용 × 평균 효과) 2차원에 배치 → 고효과·저비용 vs 저효과·고비용 식별 (중앙값 기준선 표시).
4. **디프리스크라이빙 절감 추정:** 무반응자 중단 가정 시 연간 회수가능 약제비 + 반응자 1명당 NNT(≈1/반응률).
5. **약가표 내장 + 오버라이드:** 심평원 공개약가/비급여 수준의 합성 약가표 내장, 인라인 편집 시 전 지표 즉시 재계산.

## 실행법
1. `index.html`을 브라우저로 엽니다.
   - **권장:** 프로젝트 폴더에서 로컬 서버 실행 후 접속 (CSV/JSON fetch 정상 동작)
     ```
     cd projects/2026-06-07-1-metabovalue
     python3 -m http.server 8000
     # 브라우저에서 http://localhost:8000 접속
     ```
   - `file://`로 직접 열어도 동작합니다(내장 데모 데이터로 자동 폴백). 단, `data/cohort.csv` 전체(220행)를 쓰려면 로컬 서버 권장.
2. 페이지 로드 시 **기본 합성 데이터로 즉시 데모가 표시**됩니다(업로드 불필요).
3. 자체 코호트를 보려면 상단 "코호트 데이터"에서 CSV 업로드.

### CSV 형식 (열 헤더)
```
patient_id,age,sex,drug,dose,duration_months,
weight_baseline_kg,weight_followup_kg,bmi_baseline,
hba1c_baseline,hba1c_followup,fib4_baseline,fib4_followup
```
약가표(`data/price_table.json`)에 동일한 `drug`/`dose` 키가 있어야 비용이 계산됩니다. 누락 시 해당 약물의 단가는 0으로 처리되며 약가표 편집기에서 추가/수정 가능.

## 산출물
- `index.html` — 단일 파일 대시보드 (Plotly 2.27.0 pinned CDN 1개)
- `data/cohort.csv` — 합성 코호트 220행
- `data/price_table.json` — 합성 약가표 (KRW/월)
- `README.md` / `QA.md`

## 검수 체크리스트
- [ ] `index.html`이 브라우저에서 열리고 KPI·차트 4종·표가 렌더링된다.
- [ ] 반응 기준 드롭다운 변경 시 모든 지표가 갱신된다.
- [ ] 예산 시뮬레이터 슬라이더가 ΔKRW를 갱신한다.
- [ ] 약가표 값 수정 시 반응자당 비용·사분면이 즉시 재계산된다.
- [ ] 디스클레이머가 README와 index.html 양쪽에 있다.
- [ ] Plotly CDN이 정확한 pinned 버전(`plotly-2.27.0.min.js`)이다.
- [ ] `data/cohort.csv`가 헤더+220행, 13열이다.

## 데이터 출처 / 보정 근거
- **약가:** 한국 건강보험심사평가원(심평원) 공개약가 및 비급여 retail 수준을 **근사한 합성치** (실제 고시가 아님).
- **효과 분포:** 다음 공개 임상시험 요약통계 **수준으로 현실적으로 보정한 합성 데이터** (개별 환자 데이터 아님):
  - **SURMOUNT-1** (Tirzepatide, 비만): 고용량 ~15–21% 체중감량
  - **SURPASS** (Tirzepatide, T2DM): 강한 HbA1c 감소
  - **STEP** (Semaglutide 2.4mg, 비만): ~12–15% 체중감량
  - **MAESTRO-NASH** (Resmetirom, MASH): 경미한 체중변화, 뚜렷한 섬유화/FIB-4 개선
  - Liraglutide / Metformin: 비교군

## 면책
본 대시보드의 수치는 모두 합성/근사값이며 교육·연구·프로토타이핑 목적입니다. 어떠한 처방·급여·예산 의사결정에도 실제 임상·재무 데이터 검증 없이 사용해서는 안 됩니다.