# DMChronoTx-Hypo (디엠크로노테라피하이포)

> 당뇨병 chronotherapy 가설 생성 + 미탐색 cell ranking + 한국어 hypothesis card + STROBE-RCT/SPIRIT protocol skeleton + IIT/grant proposal generator

**도메인**: DM (당뇨병)
**카테고리**: 연구 아이디어 생성 (가설 생성 / 문헌 갭 분석 / 온톨로지 기반 새 연구 도출)
**빌드 일자**: 2026-05-08
**버전**: v0.1.0 (mock simulation)

---

## 의학적 디스클레이머 (필독)

**본 도구는 연구·참고용 mock simulation 입니다.**

- 합성된 가짜 문헌 corpus와 mock 메타데이터에 기반합니다. 실제 PubMed/Europe PMC/ClinicalTrials.gov/WHO ICTRP 검색 결과가 아닙니다.
- 출력되는 hypothesis card, protocol skeleton, proposal abstract는 모두 자동 생성된 골격이며, **임상 진료, 처방, 환자 상담, 실제 연구계획서 제출에 그대로 사용해서는 안 됩니다.**
- 실제 chronotherapy 적용은 1차 문헌 직접 검토, IRB 승인, MFDS/식약처 라벨 확인 후에만 가능합니다.
- 모든 약물 효과·라벨·가이드라인 인용은 mock 데이터로, 정확성을 보장하지 않습니다.

---

## 한 줄 요약

PubMed/Europe PMC + bioRxiv/medRxiv + ClinicalTrials.gov + WHO ICTRP chronotherapy mining (mock) → 약물 × 시각 split × outcome 3D ontology + 미탐색 cell ranking + 한국 cohort suitability cross-link + 한국 진료환경 feasibility + FDA/EMA/MFDS 라벨 cross-link + 한국어 hypothesis card + STROBE-RCT/SPIRIT 호환 protocol skeleton standalone Python CLI.

---

## 핵심 기능 5가지

1. **Chronotherapy literature ETL + entity 정규화**
   - mock corpus 85개 abstract (약물 + chronotherapy 시각 + outcome) 합성
   - RxNorm / MeSH / MFDS 약물 코드 dictionary로 정규화

2. **3D ontology + 미탐색 cell ranking**
   - 약물 50종 × 시각 split 12종 × outcome 20종 = 12,000 cells
   - cell별 published count, expected count, novelty score
   - 약물 class × time × outcome plausibility 가중치 결합 → combined score ranking

3. **Korean cohort suitability + 진료환경 feasibility**
   - NHIS-HEALS, KoGES Ansan-Ansung, HEXA, NHIS Senior, K-CURE, KNHANES cross-link
   - 보험급여 / adherence / 수면스케줄 정합성 점수

4. **FDA / EMA / MFDS 라벨 cross-link + KDA/ADA/EASD 가이드라인 cross-link**
   - 약물별 dose timing 라벨 권고 mock 추출
   - KDA 2023, ADA 2025, EASD 2024, MFDS 통합 라벨 chronotherapy 권고 요약

5. **한국어 hypothesis card + STROBE-RCT/SPIRIT protocol skeleton + IIT/grant proposal abstract**
   - top 미탐색 cell의 한국어 hypothesis card
   - SPIRIT 6a, 7, 8, 10, 11, 12, 14, 16, 18, 20, 24-31 항목 호환 protocol skeleton
   - KHIDI / NRF / NIH / Novo Nordisk / Eli Lilly / Boehringer Ingelheim IIT 호환 proposal abstract

---

## 실행법

```bash
cd "/Users/sangjoonpark/claude daily project/2026 metabolic daily idea/projects/2026-05-08-1-dm-chrono-tx-hypo"

# 기본 (stats + top 5)
python3 main.py

# 도움말
python3 main.py --help

# top 10 미탐색 cell
python3 main.py --top 10

# 특정 약물 (영문 또는 한글)
python3 main.py --drug Empagliflozin
python3 main.py --drug 세마글루타이드

# top 1 cell의 한국어 hypothesis card
python3 main.py --card

# top 3 cell의 hypothesis card
python3 main.py --card --card-rank 3

# protocol skeleton
python3 main.py --protocol

# proposal abstract
python3 main.py --proposal

# 모두
python3 main.py --top 5 --card --protocol --proposal
```

외부 패키지 의존성 없음 (Python 3 표준 라이브러리만 사용).
외부 네트워크 호출 없음. 외부 유료 API 사용 없음.

---

## 파일 구조

```
2026-05-08-1-dm-chrono-tx-hypo/
├── README.md          # 본 문서
├── main.py            # CLI 진입점
├── data/
│   ├── drugs.json         # 약물 50종 + RxNorm·MeSH·MFDS 코드 (mock)
│   ├── time_splits.json   # 시각 split 12종 정의
│   ├── outcomes.json      # outcome 20종 정의
│   ├── corpus.json        # mock literature 85개 abstract
│   ├── korean_cohorts.json  # NHIS-HEALS, KoGES, HEXA, NHIS Senior, K-CURE, KNHANES
│   ├── labels.json        # FDA/EMA/MFDS 라벨 dose timing
│   └── guidelines.json    # KDA/ADA/EASD/MFDS chronotherapy 권고
└── QA.md              # 검수 로그
```

---

## 검수 체크리스트

- [x] `python3 -c "import ast; ast.parse(open('main.py').read())"` 구문 통과
- [x] `python3 main.py --help` 정상 실행
- [x] `python3 main.py --top 5` 정상 실행 (top 5 미탐색 cell 출력)
- [x] `python3 main.py --card` 정상 실행 (한국어 hypothesis card 출력)
- [x] `python3 main.py --protocol` 정상 실행
- [x] `python3 main.py --proposal` 정상 실행
- [x] data/*.json 모두 JSON 파싱 통과
- [x] README.md에 의학적 디스클레이머 포함
- [x] QA.md에 검수 로그 기록

---

## 출처 (Mock 데이터 영감원)

- PubMed / Europe PMC chronotherapy 검색 키워드 (mock)
- ClinicalTrials.gov / WHO ICTRP 시각 dosing 등록시험 (mock)
- bioRxiv / medRxiv preprint (mock)
- KDA 2023, ADA 2025, EASD 2024 가이드라인 chronotherapy section (요약 인용)
- FDA Drug Label / EMA EPAR / MFDS 의약품안전나라 (라벨 dose timing 요약)
- NHIS-HEALS, KoGES, HEXA, NHIS Senior, K-CURE, KNHANES 한국 cohort 메타데이터
- HYGIA Project, MAPEC trial (BP chronotherapy 비교 컨텍스트)

---

## 한계와 주의사항

- 본 corpus는 합성이며 실제 published evidence count를 반영하지 않습니다.
- novelty score는 단순 expected/observed 비율로 산출되어 과대 또는 과소 평가될 수 있습니다.
- plausibility 가중치는 임상적 직관에 기반한 휴리스틱이며, 실제 약리학적 시간생물학적 검증이 필요합니다.
- 실제 ranking에 사용할 때는 1차 PubMed/Europe PMC search → systematic review → 임상 자문 단계가 반드시 선행되어야 합니다.