OncoIntel HOT — 실시간 종양학 인텔리전스 대시보드은(는) 무엇을 하나요?
종양 약물 산업을 위한 드롭인 인텔리전스 사이트입니다. 공개 API(API 키 불필요)의 실시간 데이터와 소규모 백엔드 RSS 수집기를 통해 데이터를 가져와 AI-HOT 스타일의 피드를 렌더링합니다: 사이드바 탐색 + 카드 타임라인(출처, 유형 배지, 중요도 점수, 북마크, '중요한 이유'). 모든 것은 바닐라 HTML/CSS/JS와 Python 표준 라이브러리 + feedparser로 구성되어 있어, 어떤 모델이나 에이전트가 구동하든 동일하게 작동합니다.
가장 중요한 하나의 규칙: 데이터를 절대 조작하지 마세요
이 도구는 수기로 작성된 "샘플" 인텔리전스가 실제 데이터처럼 보이지만 쓸모없을 뿐만 아니라 오히려 해롭기 때문에 만들어졌습니다. 모든 카드는 실제 API 응답 또는 실제 RSS 항목에 기반해야 합니다. 측정이 아닌 추론된 신호(예: 임상 시험 단계/규모를 통해 추론된 '높은 관심도')는 UI에 추론됨으로 표시해야 합니다. 소스에 접근할 수 없는 경우, 가짜 항목을 만들지 말고 정직하게 오류를 표시하세요. 사이트를 확장할 때도 이 원칙을 유지하세요.
이 스킬의 구성
app/
index.html # UI 셸: 사이드바 + 타임라인 피드 + 상세 모달
styles.css # 라이트/다크 테마, 타임라인, 카드
app.js # 프런트엔드: 3개의 실시간 API 호출, 정규화, 필터링, 렌더링
fetch_news.py # 백엔드: 미디어/학회 RSS 수집 -> data/news.json
data/news.json # fetch_news.py의 샘플 출력 (새 데이터를 위해 재생성)
references/
extending.md # 소스 추가, 분류 체계 조정, 백엔드 크론 설정 방법
빠른 시작 (배포 + 실행)
app/을 사용자가 원하는 위치에 복사합니다 (해당 폴더를SITE/라고 부릅니다).- 상위 디렉터리에서 HTTP로 서비스합니다 (상대 경로가 필요함):
cd <SITE-상위-디렉터리> python3 -m http.server 8769http://127.0.0.1:8769/SITE/를 엽니다. 세 가지 실시간 API(openFDA, ClinicalTrials.gov, Europe PMC)는 빌드 과정이나 키 없이 브라우저에서 즉시 로드됩니다. - 업계 뉴스 / 학회 섹션을 위해
data/news.json을 생성합니다:필요에 따라 다시 실행하거나 크론 작업으로 설정하여 새로 고칩니다. 이 파일이 없어도 나머지 세 섹션은 정상 작동하며, 사이트는 "업계 동향이 생성되지 않았습니다"라는 정직한 메모를 표시합니다.pip install feedparser cd SITE && python3 fetch_news.py
브라우저에서 편집 후 오래된 UI가 표시되면 HTTP 캐싱 때문이므로 강제 새로고침(Cmd/Ctrl+Shift+R)을 하세요. index.html/app.js/styles.css에 ?v=N 쿼리를 추가하여 캐시를 무효화할 수도 있습니다.
구축 방식 (변경 사항을 이해할 수 있도록)
프런트엔드 데이터 흐름 (app.js): 네 개의 수집기(fetchFDA, fetchTrials, fetchPapers, fetchNews)가 병렬로 실행되며, 각각 소스를 하나의 공통 항목 형태(type, date, title, source, detailUrl, company, cancer, modality, score, why, tags, ...)로 정규화합니다. 원시 영어 데이터는 키워드 정규식 테이블(CANCER_MAP, MODALITY_MAP, COMPANY_MAP)을 통해 중국어 분류 체계로 매핑됩니다. 사이드바에서 보기를 선택하고, filteredItems()가 필터링 및 정렬을 수행하며, renderItems()가 타임라인을 그립니다.
보기: 전체 동향 / 일일 브리핑 / 임상 시험(계층형) / 고영향 논문 / 약물 승인 / 업계 동향 / 제약사 동향 / 북마크. 북마크와 테마는 localStorage에 유지됩니다.
임상 시험은 계층형으로 제공됩니다: normalizeTrial은 각 연구를 계층별로 태그합니다 — 결과/상태 업데이트(결과 발표 또는 상태→완료/종료), 신규 등록, 진행 중(모집 중/활성), 높은 관심도(단계/등록/후원자로부터 추론). 보기에는 실시간 개수와 각 카드에 "변경 사항" 컬러 배지가 있는 하위 탭이 표시됩니다.
뉴스는 이벤트별로 중복 제거됩니다 (fetch_news.py → cluster_duplicates): 여러 매체가 같은 기사를 보도하면 "🔁 N개 매체 보도"라는 하나의 카드로 접히며, 매체 수가 많을수록 점수가 높아집니다(실제 미디어 대응 신호). 학회 언급(ASCO/ESMO/AACR/…)은 감지되어 배지로 표시됩니다.
데이터 소스와 CORS 현실
브라우저는 이러한 API를 직접 호출할 수 있습니다 (공개 CORS, 키 불필요) — 이것이 프런트엔드가 독립적으로 동작하는 이유입니다:
| 섹션 | 소스 | 엔드포인트 |
|---|---|---|
| 약물 승인/라벨 | openFDA | api.fda.gov/drug/label.json |
| 임상 시험 | ClinicalTrials.gov v2 | clinicaltrials.gov/api/v2/studies |
| 고영향 논문 | Europe PMC | ebi.ac.uk/europepmc/webservices/rest/search |
이 외에도 교차 출처 API가 없는 일반 웹 페이지들도 있습니다 — 정적 페이지로는 가져올 수 없으므로 백엔드(fetch_news.py, 확장 가능)나 프록시(EMA, NMPA/CDE, 개별 기업 보도 자료, 학회 초록 사이트)가 필요합니다. 미디어 RSS(FiercePharma, STAT, BioPharma Dive, ASCO Post, FDA 보도자료)는 백엔드에서 작동하며 대부분의 기업/학회 뉴스를 이미 다룹니다.
확장하기
사용자가 다음을 원할 때 references/extending.md를 참조하세요: 데이터 소스 추가(프런트엔드 API 어댑터 또는 백엔드 RSS 피드), 암/기업/약물 분류 체계 변경, 임상 시험 계층 또는 뉴스 클러스터링 조정, 자동 새로 고침 설정. 분류 체계 맵(app.js 및 fetch_news.py에 있는)의 두 복사본을 편집할 때 동기화 상태를 유지하세요.
다른 도메인에 적용하기
아키텍처(병렬 수집기 → 공통 항목 형태 → 키워드 분류 체계 → 계층/중복 제거가 있는 타임라인 UI)는 도메인에 독립적입니다. 다른 분야(예: 심장학 또는 비의료 산업)로 전환하려면 수집기와 키워드 맵을 교체하되 항목 형태, UI, 그리고 무엇보다도 데이터를 조작하지 않는 규칙을 유지하세요.