# DMPatentLandscape-Kor (디엠패턴트랜드스케이프코어)

## 목적
USPTO·EPO·KIPO·JPO·CNIPA·WIPO PCT의 당뇨병(DM) 관련 특허(NCE·biologic·formulation·delivery device·DTx)를 family 통합 view로 큐레이션하고, 만료/PTE/SPC 카운트다운, IPC/CPC 분류, claim scope 요약, 한국 출원인 동향을 한국어로 weekly digest 알림하는 standalone Streamlit patent landscape watch 도구.

## 도메인 / 카테고리
- **도메인**: DM (Diabetes Mellitus, 당뇨병)
- **카테고리**: 연구 알림 (목요일 정규)
- **날짜 슬롯**: 2026-05-28 (오후 1시 — daily idea 파이프라인 slot 1)

## 핵심 기능 5개
1. **multi-office API 통합 + family clustering**: USPTO PEDS·EPO OPS·KIPO KIPRIS·JPO J-PlatPat·CNIPA·WIPO PATENTSCOPE 통합 ingest 시뮬레이션 + INPADOC family clustering + 같은 발명의 글로벌 family 통합 view
2. **당뇨 분류 + claim scope 요약**: IPC(A61K 31/4985 등)·CPC 당뇨 sub-class 자동 필터 + GLP-1RA/SGLT2i/DPP-4i/insulin/CGM/insulin pump/closed-loop/DTx 카테고리 자동 태깅 + 독립 claim 1 한국어 rule-based 요약
3. **만료·PTE/SPC + Orange Book 연계**: grant date·standard 20년 만료일·미국 PTE(최대 5년)·EU SPC(최대 5년)·소아 전용 6개월 자동 산출 + Orange Book Express 연계 + 만료 카운트다운(D-365·D-180·D-90 alert) + generic/biosimilar 진입 가능 시점
4. **한국 출원인 동향 + 경쟁 landscape**: 한국 주요 출원인(LG화학·HK inno.N·종근당·동아ST·대웅·한미·일동·녹십자·삼성바이오에피스·셀트리온·SK바이오팜) 출원/grant 누적 + 글로벌 top assignee 시계열 + IP whitespace 자동 highlight
5. **weekly digest + FTO 보조 + 리포트**: 사용자 관심영역 필터로 weekly digest Markdown + FTO 보조 view + 한국 출원인별 quarterly 리포트 docx export

## 실행법

### Streamlit 앱
```bash
pip install -r requirements.txt
streamlit run app.py
```

### CLI (lazy import — pandas/streamlit 없이도 --help 동작)
```bash
python3 main.py --help
python3 main.py --summary
python3 main.py --top 10
python3 main.py --export-digest weekly_digest.md
```

## 검수 체크리스트
- [x] `python3 -c "import ast; ast.parse(open('app.py').read())"` — Streamlit 앱 구문 OK
- [x] `python3 -c "import ast; ast.parse(open('main.py').read())"` — CLI 구문 OK
- [x] `python3 main.py --help` 실행 가능 (lazy import)
- [x] mock data JSON 로드 테스트
- [x] mock patent records ≥ 80건 (실제 약물·한국 출원인 reference)

## 데이터 출처 (시뮬레이션 reference)
- USPTO PEDS (https://ped.uspto.gov/) — 실제 호출 없음, 응답 형식 모사
- EPO OPS (https://ops.epo.org/) — 실제 호출 없음
- KIPRIS Plus API (한국특허정보원) — 실제 호출 없음
- J-PlatPat (일본특허청) — 실제 호출 없음
- CNIPA Patent Search (중국 국가지식산권국) — 실제 호출 없음
- WIPO PATENTSCOPE — 실제 호출 없음
- FDA Orange Book Express — 실제 호출 없음
- INPADOC family data — 시뮬레이션

본 MVP는 오프라인 mock/synthetic data로만 동작하며, 외부 네트워크 호출이 없다.

## 디스클레이머
- 본 도구는 **연구·참고용**이며, 실제 IP/FTO(Freedom-to-Operate) 결정은 반드시 **변리사 자문**을 받아야 한다.
- 본 도구의 특허 데이터는 **mock/synthetic**이며, 실제 USPTO·EPO·KIPO·JPO·CNIPA·WIPO 등록 정보가 아니다.
- 약물·디바이스·DTx 식별 정보는 IPC/CPC 분류와 한국어 claim 요약을 위한 reference이며, **의학적·법적 결정의 근거**가 될 수 없다.
- PTE/SPC/Orange Book 연계 산출 값은 단순화된 규칙 기반이며, 실제 만료일·generic 진입 시점은 USPTO/FDA/EPO 공식 자료를 확인해야 한다.

## 파일 구조
```
2026-05-28-1-dm-patent-landscape-kor/
├── README.md
├── app.py
├── main.py
├── requirements.txt
├── QA.md
└── data/
    └── patents.json  # mock patent records (≥80건)
```