# CHANGELOG — ObesityTrialProtocolAmend-Kor

## [2026-05-28]

### 수행 내용
- ObesityTrialProtocolAmend-Kor MVP 초기 빌드 (목요일 연구 알림 / Obesity 도메인).
- 5개 trial registry (ClinicalTrials.gov · EudraCT · jRCT · CRIS-Korea · ANZCTR) 항비만 trial protocol amendment 감시 도구 standalone Streamlit + CLI 구현.
- 핵심 기능 5개 모두 구현: ingest 필터 / amendment delta / rule-based 채점·alert / dashboard·landscape / weekly digest·RoB2 보조.

### 주요 결정 사항
- **mock data 31 trial × 평균 2건 amendment** 로 구성 (요구 ≥30 충족). 실제 phase 3 항비만 trial 이름(SURMOUNT-MMO, STEP-UP, REDEFINE-1, TRIUMPH-1, ESSENCE-MASLD, MERIDIAN-Obesity, VK2735-VENTURE, ATTAIN-1 등) 활용.
- **rule-based 채점**: 12개 규칙 + composite crisis score. primary endpoint 변경/약화·sample size 감소·termination 은 ★★★(3점), sample size ≥20% 증가·analysis plan post-hoc·sponsor·funding 변경은 ★★(2점), target completion 지연은 ★(1점). ALERT threshold 6점, WATCH 3점.
- **LLM 호출 0**: rule-based만 사용 — 의료 도메인 도구 정책 준수, 외부 API 비용 없음.
- **lazy import**: `main.py --help`가 streamlit/pandas 미설치 상태에서도 동작하도록 cmd 함수 안쪽에서만 core/pandas 의존 import.
- **docx export 대신 Markdown + CSV**: python-docx 외부 의존 회피. competitor intelligence는 CSV로 제공.
- **한국 sponsor 우대**: LG Chem (MC4R LB54640), Dong-A ST (DA-1241), Ildong (semaglutide biosimilar), Chong Kun Dang+Welt (DTx), Severance+Yuhan (sarcopenic obesity) 5개 CRIS-Korea trial 별도 등재. `--korea` CLI 옵션과 dashboard 하이라이트 섹션 제공.

### 변경된 파일
- `README.md` — 프로젝트 개요, 실행법, 검수 체크리스트, 디스클레이머
- `app.py` — Streamlit 5 tab UI
- `main.py` — CLI 진입점 (8 명령)
- `core.py` — 공용 분석 로직 (필터·채점·집계·digest·RoB2)
- `requirements.txt` — streamlit + pandas
- `data/trials.json` — 31 항비만 trial × 64 amendment mock
- `data/scoring_rules.json` — 12 채점 규칙 + 5 종료사유 카테고리 + 임계치
- `QA.md` — 검수 로그

### 재현 방법
```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
streamlit run app.py            # 브라우저 UI
python3 main.py --help          # CLI 진입점
python3 main.py --summary
python3 main.py --top 10
python3 main.py --alerts
python3 main.py --trial NCT06077461
python3 main.py --korea
python3 main.py --rob2
python3 main.py --export-digest /tmp/digest.md
python3 main.py --export-csv /tmp/trials.csv
```