cBioPortal/cbioportal

说明与用途

**价值**
cBioPortal 是癌症基因组学领域的旗舰可视化与分析平台，能够快速查询、展示和比较 TCGA、ICGC 等大型肿瘤数据集的突变、拷贝数、表达、临床特征等信息。它为科研人员、临床医生以及药物研发团队提供“一站式”交互式探索环境，帮助发现潜在的驱动基因、关联突变和患者分层方案，从而加速生物标志物发现和精准治疗的设计。

**典型接入方式**

| 场景 | 接入方式 | 关键步骤 |
|------|----------|----------|
| **内部原型 / 数据探索** | 直接克隆源码，使用 Docker Compose 或官方提供的 docker-compose.yml 启动完整服务（包括 PostgreSQL、cBioPortal 前后端） | 1. git clone https://github.com/cBioPortal/cbioportal.git <br>2. cd cbioportal <br>3. docker compose up -d <br>4. 将本地或公开的癌症数据（MAF、CNV、表达矩阵等）放入 data/ 并在 config 中配置 study.xml |
| **业务系统嵌入** | 通过 REST API（/api/）或 GraphQL（自 2025 版起支持）调用查询结果，或使用 Java SDK（cbioportal-client）在后端服务中直接访问 | 1. 在已有的微服务中添加 cbioportal-client 依赖 <br>2. 配置 API 访问凭证 <br>3. 调用如 getMutationsByGene(studyId, geneSymbol) 获取结构化数据，后自行渲染或与业务报表集成 |
| **自定义前端** | 利用开源的 React 组件库（@cbioportal/ui）或直接复用 portal-frontend 中的 UI 组件，实现专属仪表盘 | 1. npm i @cbioportal/ui <br>2. 按需引入 MutationTable, OncoPrint, SurvivalPlot 等组件 <br>3. 通过后端 API 注入项目自己的数据集 |

**生产可用性**

• **成熟度**：GitHub ★1020，活跃维护（最近一次提交 2026‑07‑06），拥有完整的 CI/CD、单元/集成测试以及详细的部署文档。
• **部署难度**：中等。官方提供的 Docker Compose 方案可在 10 分钟内部署完整环境；在 Kubernetes 环境下可使用 Helm chart（社区维护）进行弹性扩容。
• **运维要求**：需要监控 PostgreSQL（或 MariaDB）存储容量、定期备份数据集、以及前端/后端服务的日志与健康检查。对安全合规有要求的组织应自行实现 LDAP/OIDC 鉴权（平台已提供插件）。
• **适用场景**：
• **原型/内部分析**：直接使用官方镜像即可快速上线，几乎不需要额外开发。
• **生产系统**：在完成以下工作后可投入生产：① 数据质量与标准化（MAF/VCF、CNV、表达矩阵统一格式）；② 鉴权与审计日志集成；③ 高可用部署（多副本 DB + 负载均衡）；④ 定期安全补丁更新。

综上，cBioPortal 在癌症基因组学的数据探索与可视化方面价值突出，接入方式灵活（Docker、API、前端组件），在完成基本运维准备后即可达到生产级别，适合作为内部科研平台或面向客户的基因组报告系统的核心组件。

实际用途

cBioPortal/cbioportal may be useful when its README and activity match a concrete workflow.

限制与审查说明

Medium: useful for prototypes or internal workflows, with dependency and maintenance checks before production.