# PostLTMASHMetabolicKor (포스트엘티매시메타볼릭코어)

간이식(LT) 후 환자 cohort의 **MASH 재발·NODAT/PTDM·면역억제제 trough/dose vs metabolic AE·항당뇨제(GLP-1RA/SGLT2i/metformin) post-LT 사용 안전성**을 한 화면에서 추적하는 standalone Streamlit post-LT cohort dashboard.

- 도메인: MASLD (간이식 후 metabolic / MASH 재발 RWE)
- 카테고리: 웹기반 대시보드 (코호트 모니터링 · KPI 추적)
- 산출 일자: 2026-05-20
- 빌드 ID: 2026-05-20-3-post-lt-mash-metabolic-kor

---

## 의학 디스클레이머

본 대시보드는 **이식 RWE 연구 · quality improvement 보조용**이며, 실제 임상 의사결정은 이식센터 다학제팀(이식외과·간내과·내분비내과·이식약사·이식코디네이터) 판단 하에 이루어져야 한다. 합성 데이터로 동작하며, 실제 환자 데이터 분석 시에는 IRB 승인 · de-identification · 기관 IT 보안 준수가 선행되어야 한다.

---

## 핵심기능 (5개)

1. **post-LT timeline + MASH 재발 NIT 모듈** — LT=0 기준 longitudinal NIT (VCTE LSM · MRI-PDFF · FIB-4 · ELF) · biopsy 재발 fibrosis stage (F0~F4) trajectory, 환자별 재발 timing (1y / 3y / 5y) heatmap.
2. **NODAT/PTDM screening 부합률** — WHO/ADA 진단 기준 자동 분류, screening 시행률 KPI (1m/3m/6m/1y/매년), 5y cumulative incidence Kaplan-Meier, 약물별(tacrolimus vs cyclosporine vs sirolimus vs steroid) NODAT 위험 비교.
3. **면역억제제 trough/dose vs metabolic AE** — tacrolimus · sirolimus · cyclosporine · MMF · steroid trough/dose timeline + HbA1c · 체중 · BP · LDL/TG/HDL · 요산 추적, trough/dose change 전후 비교, 약물 전환 (예: tacrolimus → sirolimus) 전후 비교.
4. **GLP-1RA / SGLT2i / metformin post-LT 사용 RWE** — 사용 vs 미사용군 metabolic outcome · 간기능 (ALT/AST/GGT · MELD) · 면역억제제 trough · 이식 거부 · 감염 비교.
5. **KLTF · KASL post-LT 가이드 호환 리포트 + multicenter 비교** — 6대 이식센터 de-identified 비교, 국문/영문 docx 리포트 생성.

---

## 실행법

```bash
# 1. 가상환경 생성 및 의존성 설치
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# 2. 합성 데이터 생성 (재현 가능, seed=20260520)
python3 data/generate_synthetic.py

# 3. Streamlit 앱 실행
streamlit run app.py
```

- 브라우저에서 `http://localhost:8501` 자동 오픈.
- 외부 네트워크 / API 호출 0, 전역 패키지 설치 0.

---

## 빌드 구성

```
2026-05-20-3-post-lt-mash-metabolic-kor/
├── README.md                          # 본 문서
├── requirements.txt                   # 의존성
├── app.py                             # Streamlit 진입점 (5개 탭)
├── data/
│   ├── generate_synthetic.py          # 합성 데이터 생성
│   ├── synthetic_post_lt_cohort.csv   # cohort cross-sectional (n≥250)
│   └── synthetic_longitudinal.csv     # LT=0 기준 ~5y 추적
├── assets/
│   └── guidelines.json                # KLTF·KASL·AASLD·EASL 권고 라이브러리
└── QA.md                              # 검수 로그
```

---

## 검수 체크리스트

- [x] `python3 -c "import ast; ast.parse(open('app.py').read())"` — 구문 OK
- [x] `python3 -c "import ast; ast.parse(open('data/generate_synthetic.py').read())"` — 구문 OK
- [x] `python3 data/generate_synthetic.py` — 데이터 파일 생성
- [x] `python3 -c "import pandas as pd; df=pd.read_csv('data/synthetic_post_lt_cohort.csv'); print(df.shape)"` — 데이터 로드 OK
- [x] `python3 -c "import pandas as pd; df=pd.read_csv('data/synthetic_longitudinal.csv'); print(df.shape)"` — longitudinal 로드 OK
- [x] `python3 -m py_compile app.py` — 컴파일 OK
- [x] `requirements.txt` 존재
- [x] `assets/guidelines.json` JSON 파싱 OK
- [x] 의학 디스클레이머 명시

---

## 출처 (가이드라인)

- **KLTF** (Korean Liver Transplantation Society) post-LT care 권고.
- **KASL** (대한간학회) MASLD/MASH 임상진료 가이드 (한국형 권고 포함).
- **AASLD 2023** Practice Guidance on the Clinical Assessment and Management of Nonalcoholic Fatty Liver Disease (MASLD nomenclature 반영).
- **EASL-EASD-EASO 2024** Clinical Practice Guidelines on the management of MASLD.
- **ADA Standards of Care 2024-2025** — NODAT/PTDM 진단·screening 기준.
- **WHO** diabetes diagnostic criteria (FPG ≥126 / OGTT 2h ≥200 / HbA1c ≥6.5%).
- **KONOS** (Korean Network for Organ Sharing) 통계 — 한국 LT cohort baseline 분포 참조.
- **ILTS-AASLD-NASPGHAN 2022** consensus on PTDM screening / management.

> 합성 데이터의 통계 분포는 위 출처에서 보고된 한국 LT cohort 데이터를 광범위하게 참조하여 작성되었으나, **실제 환자 데이터가 아님**을 분명히 한다.