# ObesityTrialProtocolAmend-Kor (오베시티트라이얼프로토콜어맨드코어)

5개 trial registry (**ClinicalTrials.gov v2 · EudraCT · jRCT · CRIS-Korea · ANZCTR**) 의 항비만 / 체중관리 / bariatric / DTx trial **protocol amendment audit trail** 을 일일 surveillance하여, primary endpoint 변경 · sample size delta · termination 사유 · comparator 변경 · sponsor/funding 변경을 자동 추출하고, **amendment 중요도 채점 · leading indicator alert · 한국어 weekly digest** 를 산출하는 **standalone Streamlit 도구**.

- **카테고리**: 연구 알림 (목요일 정규)
- **도메인**: Obesity (비만)
- **빌드 일자**: 2026-05-28

> 본 도구는 **연구·참고용**이며, 실제 trial 결정·규제 보고·정책 판단은 sponsor/CRO/규제기관의 책임입니다. 모든 데이터는 **오프라인 mock data** 입니다 (외부 API 호출 0, LLM 호출 0).

---

## 핵심 기능 5개

1. **5개 registry API ingest + 항비만 필터** — condition(obesity / overweight / weight loss / morbid obesity / sarcopenic obesity / MASLD-comorbid obesity) · intervention(GLP-1RA · GIP/GLP-1 dual · triple agonist · MC4R · amylin · bariatric · DTx) 자동 필터.
2. **Amendment delta 자동 추출** — primary/secondary endpoint, sample size, exclusion, comparator, blinding, analysis plan, target completion date, status, sponsor, funding 의 timestamp별 diff와 사유 텍스트 자동 parse.
3. **Amendment 중요도 채점 + leading indicator alert** — rule-based: primary endpoint 변경(★★★) · primary 약화(★★★) · sample size ≥20% 증가(★★) · sample size 감소(★★★, futility) · termination/suspension(★★★) · analysis plan post-hoc 변경(★★) · sponsor 변경(★★) · target completion ≥12mo 지연(★) → composite **trial 위기 점수** + threshold 초과 시 ALERT.
4. **Trial-level dashboard + 경쟁 landscape** — Phase 3 항비만 trial (SURMOUNT · STEP · REDEFINE · TRIUMPH · ESSENCE · MERIDIAN · VK2735 · orforglipron · CagriSema · survodutide 등) 개별 amendment timeline · 중요도 누적 · readout D-day, 약물 class · sponsor · 국가별 빈도 비교, **한국 sponsor(LG · 종근당 · 동아 · 일동 · 유한 · Severance)** trial 별도 하이라이트.
5. **Weekly digest + meta-analyst RoB2 보조** — 중요도 ★★ 이상 amendment + 위기 점수 상위 trial + readout D-day 카운트다운 Markdown digest, systematic review용 RoB2 보조 view, competitor intelligence CSV export.

---

## 실행법

### Streamlit 앱
```bash
cd "/Users/sangjoonpark/claude daily project/2026 metabolic daily idea/projects/2026-05-28-2-obesity-trial-protocol-amend-kor"
pip install -r requirements.txt   # 전역 설치 금지 시 venv 권장
streamlit run app.py
```

### CLI
```bash
python3 main.py --help
python3 main.py --summary
python3 main.py --top 10
python3 main.py --alerts
python3 main.py --trial NCT05556512
python3 main.py --korea
python3 main.py --rob2
python3 main.py --registry CRIS-Korea --top 5
python3 main.py --export-digest /tmp/digest.md
python3 main.py --export-csv /tmp/trials.csv
```

`--help`는 **streamlit / pandas 미설치 상태에서도** 동작한다 (lazy import).

---

## 디렉토리 구성

```
2026-05-28-2-obesity-trial-protocol-amend-kor/
├── README.md
├── QA.md
├── requirements.txt
├── app.py            # Streamlit UI (5 tab)
├── main.py           # CLI 진입점
├── core.py           # 공용 분석 로직 (필터 · 채점 · 집계 · digest · RoB2)
└── data/
    ├── trials.json          # 30 trial × 1~4 amendment (mock)
    └── scoring_rules.json   # rule-based 채점 규칙 + 종료사유 카테고리 + 임계치
```

---

## 검수 체크리스트

- [x] `python3 -c "import ast; ast.parse(open('app.py').read())"`
- [x] `python3 -c "import ast; ast.parse(open('main.py').read())"`
- [x] `python3 -c "import ast; ast.parse(open('core.py').read())"`
- [x] `python3 main.py --help` 실행
- [x] `data/trials.json` 로드 (30 trial)
- [x] `data/scoring_rules.json` 로드 (12 rule)
- [x] mock data 기반 핵심 함수 동작 (필터 · 채점 · digest · CSV export)
- [x] 디스클레이머 노출 (README / CLI / Streamlit)

QA 결과는 `QA.md` 참고.

---

## 출처 (mock data 기반 시뮬레이션, 실제 API 호출 없음)

- ClinicalTrials.gov v2 API — https://clinicaltrials.gov/data-api/api
- EudraCT (EU CTR) — https://eudract.ema.europa.eu/
- jRCT (일본) — https://jrct.niph.go.jp/
- CRIS (한국) — https://cris.nih.go.kr/
- ANZCTR (호주/뉴질랜드) — https://www.anzctr.org.au/
- ICH E9(R1) Addendum on Estimands
- RoB2 (Cochrane Risk of Bias 2)

> 실 운영 시에는 위 registry 의 공식 API를 사용하고, 각 registry의 이용약관 / rate limit / 데이터 라이선스를 준수해야 한다.

---

## 디스클레이머

- 모든 trial 데이터는 **공개 trial 이름**(SURMOUNT, STEP, REDEFINE 등)을 활용한 **시연용 mock**이며, 실제 amendment 사유·날짜·표본 수와 다르다.
- 본 도구의 위기 점수 · alert · RoB2 신호는 **의사결정의 근거가 될 수 없다**. systematic review · regulatory submission · competitor intelligence 보고 전 반드시 원본 registry · 임상시험 protocol · sponsor 발표를 확인하라.
- 한국어 weekly digest는 임상 결정 · 처방 · 환자 상담 자료가 아닌, **연구진 내부 모니터링 보조** 목적이다.