用途：面向建筑项目，将分散在多个系统中的数据整合为集中的 KPI 仪表板，用统一口径呈现项目健康度，支持实时查看与下钻。
主要能力：以 Python 数据类实现，包含 KPIStatus（on_track、at_risk、critical、unknown）与 KPICategory（进度、成本、质量、安全、生产力、可持续）。核心类 ProjectKPIDashboard 可配置项目名称、编号、起止日期、预算、币种与刷新间隔；提供 calculate_schedule_kpis（SPI、计划偏差、完成百分比）、calculate_cost_kpis（CPI、成本偏差、预算使用率）、calculate_quality_kpis（一次通过率、返工率）、calculate_safety_kpis（TRIR、安全观察、未遂事件）等计算方法，并按阈值给出红黄绿状态，同时基于历史数据计算上升、下降、稳定的趋势。get_dashboard_summary 输出按类别分组的汇总与整体健康度，export_to_dataframe 可导出 pandas DataFrame 便于报告与筛选。
使用方式：先构造 DashboardConfig 与 ProjectKPIDashboard，再依次调用各 calculate_* 方法传入计划与实际数据，最后读取 summary 或导出 DataFrame。文档给出的快速开始示例涵盖配置、进度 KPI、成本 KPI 与打印整体健康度；常见用例包括周度高管报告（筛选 critical 状态）、趋势分析（读取 history）与多项目仪表板汇总。
适用场景：建筑项目的进度、成本、质量、安全监控，以及需要跨系统汇总、尽早发现风险的报告场景。
限制：资料未提供安装命令、依赖版本、前端展示组件、数据源连接器、定价与许可信息；计算方式基于文档所给公式与示例阈值，实际使用需自行核对数据口径与目标值。