项目说明与使用指引

这是演示 Demo 数据真实回放浏览器即开即用无需安装

01这是什么

把一台顶部驱动钻井装置（顶驱）做成一个可在浏览器里交互的「数字孪生 + 预测性维护（PHM）」演示平台。

前端Three.js 三维模型，实时呈现结构 / 运行状态 / 告警

后端FastAPI + ISO 13374 标准 PHM 引擎

数据回放真实油井传感器时序，非随机造数

采集层 L1→ 特征提取 L2→ 健康评估 L3→ 预测 L4→ 决策支持 L5

02能干什么

三维可视化：设备 → 系统 → 部件层级，点击部件查看其测点。
实时监测：转速 / 转矩 / 振动 / 温度 / 电流等多通道，左栏与右侧趋势同步刷新。
故障与退化告警：部件高亮蓝(选中) / 琥珀(预警) / 红(告警)，左栏告警列表可逐条确认。
预测性维护演示：轴承 / 电机绝缘 / IGBT 键合线 / VFD 电容等多部件按物理-经验退化模型推进，演示剩余寿命思路。
多数据源：3W 真实回放 / 模拟 PLC / 内置合成一键切换；可注入故障做演练。

03数据来源

线上默认 · OPC-UA 3W 回放：巴西 Petrobras 公开真实油井数据集（16 口井 / 1984 条 CSV），由平台逐帧回放为顶驱测点信号。
这是「贴近工业真实场景」的公开数据，用于练习与演示，非本厂生产实时数据。
另支持 模拟 PLC（自测信号）与 内置合成（物理模型）作为对照 / 离线演示。

首页顶部「数据源」实时显示当前实际接入源；切换数据源按钮可即时换源体验。

04使用指引

·打开方式

电脑或手机浏览器访问 https://www.phm.lyf233.cn（需联网）。
建议开启浏览器 / 显卡硬件加速，三维更流畅。

·首页看什么

左栏：资产结构树、数据采集层（数据源 / 端点 / 连接）、运行控制、告警列表。
中间：顶驱三维模型，部件随告警状态变色。
右栏：选中测点的实时趋势曲线。

·颜色与告警含义

选中 / 正常高亮（蓝）

预警 warn（琥珀）

告警 alarm（红）

连接正常（绿）

左上「连接」指示灯：绿=已连接数据源，灰=未连接。告警列表可按严重度过滤、逐条确认。

·交互操作

点部件 → 右栏出对应测点趋势；X-ray 透视 / 热力着色 / 分层显隐 切换视图。
数据源按钮切换 3W 回放 / 模拟 PLC / 内置合成；「故障注入」可触发演练工况。
顶部「运行控制」可停止 / 启动采集、切自动工况、手动设转速。

·模型加载（慢网提示）

三维模型已做 Draco 压缩（34MB → 2.5MB）。首次打开请耐心等待，加载进度可见。
若卡在加载，硬刷新（Ctrl/Cmd + Shift + R）即可重新拉取。

·移动端

支持访问，但三维渲染依赖设备 GPU，低端机可能偏卡，建议用电脑获得完整体验。

05Demo 边界

本平台是演示 / 验证版：数据来自公开数据集回放与物理仿真，未接入真实生产顶驱的实时测点。
退化与告警为演示用物理-经验模型，不代表对某台具体设备的真实健康结论。
架构已按工业 PHM 系统前后端分离搭建，未来可平滑接入 OPC-UA 真实数据源升级为在线监测系统。