# MASLDHCCSurv-Kor — MASLD/HCC Surveillance Cohort Dashboard > **연구·교육용 전용** — 본 도구는 임상 의사결정 또는 HCC surveillance 표준 도구가 아닙니다. ## 목적 MASLD/MASH 환자에서 HCC 발생 위험이 높은 군(F2~F4 cirrhosis + non-cirrhotic high-risk)을 대상으로, 다기관 외래 export를 받아 다음을 통합 시각화한다: - KASL 2022 · AASLD 2023 · EASL 2018 가이드라인별 surveillance 대상 정의 토글 - 6개월 US + AFP cycle compliance 및 KLCA US visualization adequacy - AFP / AFP-L3 / DCP(PIVKA-II) trajectory - LI-RADS v2018 결절 분류 + 2-reader concordance (Cohen's κ) - BCLC 0/A/B/C/D stage + 치료 modality timeline + DFS/OS Kaplan–Meier - GLP-1RA / SGLT2i / metformin / statin / aspirin chemoprevention RWE association - per-site benchmark + KASL/KLCA quality indicator + 한국어 보고서 ## 도메인 / 카테고리 - 도메인: **MASLD** (특히 MASLD-HCC surveillance) - 카테고리: **웹기반 코호트 모니터링 대시보드** ## 5가지 핵심 기능 1. **대상 정의 toggle** — KASL 2022(cirrhosis ≥1점 + 일부 non-cirrhotic high-risk), AASLD 2023(advanced fibrosis F3/F4, NIT 기반), EASL 2018(cirrhosis only) 비교 2. **6mo US+AFP cycle compliance heat map** — patient × cycle 격자에 interval bucket(≤210d / 211–270d / ≥271d) 색깔, KLCA US visualization A/B/C/D, missed ≥9개월 alert 3. **AFP / AFP-L3 / DCP trajectory** — per-patient log-scale time series + 결절 LI-RADS v2018 LR-1~LR-5/LR-M/LR-TIV/LR-NC 분류 + 2-reader confusion + Cohen's κ 4. **BCLC + 치료 modality + KM** — BCLC 0/A/B/C/D 자동 분류, resection·LDLT·RFA·MWA·TACE·HAIC·atezo+bev·sorafenib·lenvatinib·nivo+ipi·STRIDE timeline, DFS·OS Kaplan–Meier (BCLC 0/A vs B/C/D) 5. **Chemoprevention RWE association + benchmark + 보고서** — GLP-1RA·SGLT2i·metformin·statin·aspirin 노출 vs HCC 발생 ratio-of-rates, site별 KASL/KLCA QI 표, 한국어 보고서 텍스트(복사) ## 실행법 브라우저에서 직접 `index.html`을 열거나, 로컬 서버를 추천: ```bash cd "projects/2026-05-13-3-masld-hcc-surv-kor" python3 -m http.server 8765 # http://localhost:8765/ ``` 데이터 재생성(선택): ```bash cd data && python3 generate_cohort.py ``` 외부 네트워크는 Plotly.js CDN(pinned `plotly-2.35.2.min.js`)만 사용합니다. ## 폴더 구조 ``` 2026-05-13-3-masld-hcc-surv-kor/ ├── index.html 단일 페이지 대시보드 (Plotly.js) ├── README.md 본 문서 ├── QA.md 검수 로그 └── data/ ├── generate_cohort.py 합성 코호트 생성기 (시드 고정) ├── cohort.json 대시보드 입력 (bundled) ├── sites.csv 5개 다기관 site ├── patients.csv 72명 baseline (fibrosis, FIB-4, MRE, PNPLA3, 대상자격) ├── surveillance.csv 6mo US+AFP cycle (400 visits) ├── nodules.csv LI-RADS 2018 결절(2-reader) ├── treatments.csv BCLC stage + 치료 modality + DFS/OS └── chemoprevention.csv GLP-1RA/SGLT2i/metformin/statin/aspirin 노출 ``` ## 검수 체크리스트 - [x] `index.html` 존재, UTF-8, `` - [x] Plotly CDN pinned 버전 사용 (`plotly-2.35.2.min.js`) - [x] `data/cohort.json` 파싱 가능 - [x] CSV 6종 헤더·행 카운트 확인 - [x] `generate_cohort.py` `ast.parse` 통과 - [x] 의학적 디스클레이머 첫 화면 노출 - [x] KASL / AASLD / EASL 3개 가이드라인 토글 동작 - [x] LI-RADS κ 계산식(Cohen) 구현 - [x] Kaplan–Meier step trace 구현 ## 출처 / 인용 - **KASL 2022** — 대한간학회 간세포암종 진료 가이드라인 2022 - **AASLD 2023** — AASLD Practice Guidance on HCC (Hepatology 2023) - **EASL 2018** — EASL Clinical Practice Guidelines: Management of HCC (J Hepatol 2018) - **LI-RADS v2018** — ACR Liver Imaging Reporting and Data System - **KLCA-NCC** — 한국간암학회·국립암센터 HCC practice guideline - **BCLC 2022** — Reig M, et al. *J Hepatol* 2022 (BCLC update) - **Chemoprevention RWE** - Yen Y-H, et al. *JAMA Oncol* 2024 — GLP-1RA와 MASLD-HCC 위험 감소 association - Simon TG, et al. *Hepatology* 2022 — aspirin과 HCC chemoprevention - Lange NF, et al. *J Hepatol* 2023 — statin과 HCC risk - Tsai M-J, et al. *Diabetes Care* 2022 — metformin & SGLT2i 관련 ## 면책 / Disclaimer 본 도구의 모든 데이터는 합성(mock) 데이터이며, 실제 환자 정보가 아닙니다. 임상 의사결정·HCC surveillance 표준 도구로 사용해서는 안 됩니다.