# MASHConMedHarmonize · 매시콘메드하모나이즈

**도메인**: MASLD/MASH RCT 동반약물(ConMed) harmonization
**카테고리**: 인체실험 도구 (RCT/observational study 설계·데이터 수집·계산기)
**빌드 날짜**: 2026-05-12 (metabolic daily idea step 2, 빌드 3/3)
**버전**: prototype v0.1

## 한 줄 요약
MASH RCT 환자의 ConMed list(한국어/영어/복합제/OTC/한약 free-text) → ATC 자동 매핑 + dose normalization + exposure window + endpoint(MRI-PDFF/LSM/ALT/ELF/NAS) sensitivity analysis + DDI signal + protocol deviation flag standalone web app.

## 핵심 기능
1. **ConMed ingest + ATC 표준화** — Fuse.js fuzzy matching, 신뢰도 score, 사용자 review/correct, 복합제 자동 split, 한약/OTC 포함 ~100개 사전.
2. **Dose normalization + exposure** — PDD/DDD ratio, duration, cumulative dose, 환자별 timeline.
3. **Endpoint sensitivity** — 5개 endpoint × 8개 subgroup forest plot + interaction Δ.
4. **DDI signal + protocol deviation** — 15개 사전 정의 DDI library 자동 매칭, exclusion/stratify/document badge.
5. **Cohort dashboard + 한국어 보고서** — class 분포, severity 분포, heat map, 학회 발표용 print layout.

## 실행 방법

### 권장: 로컬 정적 서버 (fetch JSON/CSV 필요)
```bash
cd "/Users/sangjoonpark/claude daily project/2026 metabolic daily idea/projects/2026-05-12-3-mash-conmed-harmonize"
python3 -m http.server 8000
# 브라우저에서 http://localhost:8000 접속
```

### 또는 Launch preview 패널에서 index.html 직접 열기
브라우저는 CDN을 통해 Chart.js / Papa Parse / Fuse.js를 로드합니다.

## 사용 흐름
1. **1번 탭**: "demo_conmed.csv 불러오기" 클릭 → 자동 매핑 결과 확인 → 낮은 신뢰도 항목 드롭다운으로 수정
2. **2번 탭**: Dose/DDD ratio 확인, 환자 선택 → 노출 timeline 확인
3. **3번 탭**: Endpoint 선택 → forest plot 확인
4. **4번 탭**: DDI 신호 + protocol deviation 검토
5. **5번 탭**: 코호트 차트 + 학회 발표용 layout → 인쇄/PDF 저장 또는 JSON export

## 디스클레이머
본 도구는 **연구용·MASH trial ConMed harmonization 보조용 prototype**입니다. ATC 매핑 및 DDI signal은 공개 가이드라인(WHO ATC/DDD, AASLD/EASL/KASL)을 기반으로 한 휴리스틱이며, 실제 trial 운영 시 **WHODrug Global 정식 라이선스** 및 sponsor의 **SAP(통계분석계획서)** 를 따라야 합니다.

## 파일 구성
```
2026-05-12-3-mash-conmed-harmonize/
├── README.md
├── index.html                    # 단일 HTML 앱 (~700 lines, embedded JS)
├── data/
│   ├── drug_dictionary.json      # ATC + DDD + 한국어/영어/복합제/한약 (~100 entries)
│   ├── ddi_signals.json          # DDI signal library (15 signals) + subgroups
│   └── demo_conmed.csv           # 합성 ConMed list (15명 × ~4 entries = 60 rows)
└── QA.md                         # 검수 로그
```

## 제약 준수
- 외부 네트워크/API 호출 0건 (Chart.js / Papa Parse / Fuse.js pinned CDN 한 번 로드)
- 전역 패키지 설치 없음
- 의학적 안전성 디스클레이머 헤더에 포함

## 시연 시나리오
- **MASH-002**: 다파엠정 → dapagliflozin + metformin 자동 split, 씬지로이드 + resmetirom 없으면 DDI 미발생, milk thistle은 low signal
- **MASH-003**: resmetirom + 매트포민 + milk thistle → MASH 치료제 등록 시 silymarin washout 권고
- **MASH-004**: 위고비 + 세마글루타이드 동시 등록 → DDD 비율로 중복 감지 가능
- **MASH-005**: pioglitazone과 MASH 치료제 → exclude_or_stratify 신호
- **MASH-008**: methotrexate (hepatotoxic) → exclusion criterion violation
- **MASH-012**: amiodarone → exclusion criterion violation