# AntiObesityBoneLean-Kor / 안티오베시티본린코어

항비만약(GLP-1RA / tirzepatide / CagriSema / MariTide / retatrutide / orforglipron / survodutide)
trial 환자별 DXA + bone turnover + functional test longitudinal 입력으로
**약물별 expected loss reference curve overlay**, **sarcopenic obesity composite endpoint 자동 산출**,
**FRAX 10년 골절 위험 trajectory**, **sample size / effect size library**까지 한 화면에서 다루는
연구·trial 설계 보조 prototype.

## 빠른 시작
1. 이 폴더 안에서 정적 서버 실행:
   ```bash
   cd "/Users/sangjoonpark/claude daily project/2026 metabolic daily idea/projects/2026-05-12-2-anti-obesity-bone-lean-kor"
   python3 -m http.server 8080
   ```
2. 브라우저에서 `http://localhost:8080/index.html` 열기.
3. "**demo_subjects.csv 로드**" 버튼 → 25명 합성 환자 longitudinal 적재.
4. 탭 ②~⑤ 순서대로 진행.

> file:// 직접 열기로도 동작하나, 일부 브라우저는 `fetch('data/...')` 차단함.
> 그 경우 CSV/JSON을 직접 업로드하거나 정적 서버 사용 권장.

## 핵심 기능 (5개)

### ① Multi-format ingest + cross-machine harmonization
- DXA CSV 업로드 (Hologic Apex / GE Lunar enCORE / Norland)
- machine 컬럼 기반 5% systematic difference 자동 보정
- Hologic 기준 변환: GE Lunar × 0.952, Norland × 1.030
- 원본 보존 + `BMD_*_hologic_eq` 파생 컬럼 추가

### ② 약물별 expected loss reference curve library
- 7개 약물(+위약) 공개 trial 기반 BMD/lean/fat/ALMI 연간 변화율
- 환자 trajectory 위에 expected reference overlay
- 예상 대비 ≥2% deviation → alert / warn

### ③ Composite sarcopenic obesity endpoint + FRAX
- 5축 자동 계산:
  - BMD T-score ≤ −2.5 (간이 추정)
  - ALMI 컷오프 (남 7.0 / 여 5.5, definition별 변형)
  - grip < 28(M) / 18(F) kg
  - STS-5 ≥ 12 sec
  - gait < 0.8 m/s
- 3축 이상 시 composite endpoint 도달
- EWGSOP2 / AWGS 2019 / KSSO 정의 toggle
- FRAX 10년 골절 위험(major osteoporotic, hip) 간이 모형 산출

### ④ Sample size / effect size library + power calculator
- 공식: n<sub>arm</sub> = 2·(Z<sub>α/2</sub>+Z<sub>β</sub>)²·σ²/Δ²
- 라이브러리 preset (STEP/SURMOUNT/TRIUMPH 등 post-hoc bone effect size)
- 15% dropout 보정 표본 자동 계산

### ⑤ Cohort dashboard + 한국어 보고서
- per-subject spaghetti plot (약물 색상)
- KPI (subjects, visits, composite endpoint 도달률)
- KSSO/KOSSO/KSBMR 학회 발표용 한국어 요약 layout
- 인쇄/PDF 저장 지원 (print stylesheet)

## 파일 구성
```
2026-05-12-2-anti-obesity-bone-lean-kor/
├── README.md
├── index.html                      # 단일 SPA (모든 기능 인라인)
├── data/
│   ├── demo_subjects.csv           # 합성 환자 25명 longitudinal (~125 rows)
│   └── drug_reference.json         # 약물별 expected loss + thresholds + ES library
└── QA.md
```

## 디스클레이머
본 도구는 **연구용·trial 설계 보조용 prototype**이며,
expected loss reference curve는 공개 trial 및 post-hoc 데이터로부터 도출된 추정치임.
실제 trial 운영 시 sponsor의 SAP 및 통계분석계획서를 따라야 함.
의학적 판단·진료에 직접 사용하지 말 것.

## 외부 의존성 (pinned CDN)
- Chart.js 4.4.1 (CDN)
- Papa Parse 5.4.1 (CDN)
- 외부 API 호출 없음. 네트워크 차단 환경에서는 CDN을 미리 캐시하거나 로컬 사본으로 교체.
