| 项目 | 内容 |
|---|---|
| 文档名称 | 山东新能源量子精密测量智能预警管控平台 — 系统开发方案 |
| 版本 | v1.0 |
| 编制日期 | 2026-07-21 |
| 状态 | 正式 |
山东新能源量子精密测量智能预警管控平台(以下简称「平台」)用于汇总、展示各场站的磁健康监测结果,并支撑告警与设备运维。
各站点部署 QLBM 量子磁力仪一体机作为采集终端,磁场数据回传中心后做统计汇总与健康评级,覆盖新能源汽车电池、储能电站、电力电缆三个业务域。大屏按「城市 → 场站 → 单次检测」分层下钻,监管和运维人员可在同一套页面上查看态势、定位异常、查阅单次会话明细。
| 业务域 | 监测对象 | 主要功能 | 当前状态 |
|---|---|---|---|
| 新能源汽车电池 | 充电场站充电枪位 | 市—站—会话三级下钻、HI 磁健康指数与 S–D 等级评估、时频域特征取证 | 主体功能已交付 |
| 储能电站 | 储能电站电池舱/簇 | 站点分布地图、簇级布局、事件时间轴与趋势分析 | 页面已实现 |
| 电缆通道 | 电力电缆走廊 | 3D 廊道数字孪生可视化 | 孪生已实现 |
| 告警中心 | 跨域告警 | 多维筛选、详情抽屉、站点/会话跳转 | 已交付 |
| 设备管理 | 探头/一体机/边缘设备 | 设备总览与异常设备双 Tab、站级巡检 | 已交付 |
济南已在充电场站部署 QLBM 量子磁力仪一体机:机内磁探头阵列在充电过程中采集车辆电池的被动磁场,边缘侧完成频域特征提取并输出健康指数(HI)评级。
采集和 HI 计算在边缘侧已能跑通,中心侧此前没有对应的城市级看板和协同入口,实际使用中暴露出这些问题:
| 痛点 | 说明 |
|---|---|
| 监测结果不可视 | 各站一体机独立工作,HI 评级和磁特征数据散落在各站点本地,没有全市统一的浏览和比对入口 |
| 异常发现靠人工 | 缺少自动化的告警聚合与分级推送,运维人员需要逐站巡查,响应滞后 |
| 设备运维分散 | 探头、一体机、边缘计算节点的在线状态与网络心跳没有集中监视手段 |
| 多角色协同不足 | 监管人员看不到现场,诊断人员拿不到数据,各角色缺少同一套页面语言与数据口径 |
| 价值维度 | 内容 |
|---|---|
| 全局可视 | 各站测量数据回传汇总,按「城市 → 场站 → 单次检测」三级在大屏浏览、比对 |
| 告警推送 | 依据 HI 评级与统计特征生成告警,经事件流和告警中心集中展示,减少逐站人工翻查 |
| 设备监管 | 探头、一体机、边缘节点的台账与在线状态同一页面查看,便于巡检和排障 |
| 多域共用 | 新能源车、储能、电缆共用同一套中心架构与导航,后续扩域不必重做壳层 |
| 角色 | 主要使用页面 | 使用目的 |
|---|---|---|
| 城市监管/运营 | L1 城市总览、告警中心 | 全市态势总览,关注异常站点与趋势变化 |
| 现场运维 | L2 场站详情、设备管理 | 枪位/探头实时状态,链路可用性,会话进度 |
| 技术诊断 | L3 会话详情 | HI 构成解读,时频域波形取证,处置建议 |
| 系统管理员 | 设备管理 | 台账维护,固件版本,心跳与离线告警 |
平台按「边缘算、中心显」分工:
三个业务域共用中心 API、存储和页面壳层;差别主要在探头怎么布、页面怎么组织:
| 业务域 | 边缘部署 | 展示层入口 | 监测粒度 |
|---|---|---|---|
| 新能源汽车电池 | 充电枪位旁磁探头阵列(3 枪位 × 4 探头,共 12 路) | L1/L2/L3 三级 + 数字孪生 | 单次充电检测会话 |
| 储能电站 | 电池舱/簇级探头布设 | 储能站地图 + 簇布局 + 数字孪生 | 电池簇/舱级持续监测 |
| 电缆通道 | 电缆廊道沿线探头 | 3D 廊道数字孪生 | 通道段巡检 |
| 层次 | 技术方案 | 说明 |
|---|---|---|
| 前端框架 | Next.js 16 + React 19 | App Router 架构,服务端与客户端组件分离 |
| 数据可视化 | ECharts 5 | 趋势、频谱、热力图、仪表盘等图表组件 |
| 地图引擎 | Leaflet + 济南 GeoJSON | 行政区划聚合与站点分布 |
| 3D 数字孪生 | Three.js | NEV 电池包、储能电池舱、电缆廊道三域孪生 |
| 服务端数据管理 | TanStack Query v5 | 轮询刷新、缓存与预取 |
| 中台 API | FastAPI(BFF 模式) | 契约驱动(OpenAPI),前后端解耦 |
| 样式体系 | CSS Modules + 语义化 Design Token | 色值与间距走 Token,避免页面内硬编码 |
平台底部设置业务域导航栏,提供五个入口:
| 导航项 | 路由 | 说明 |
|---|---|---|
| 新能源车电池 | / |
首期主路径,包含 L1/L2/L3 三级页面 |
| 储能电站 | /ess |
储能域独立页面与数字孪生 |
| 电缆 | /cable |
电缆廊道 3D 数字孪生 |
| 告警中心 | /alarms |
跨域告警管理 |
| 场站设备 | /devices |
跨域设备管理 |
新能源车电池域内部通过页面间导航实现「城市总览 → 场站详情 → 会话详情」三级下钻;告警中心、场站设备可通过底部导航栏 「告警中心」、「场站设备」 进入,处置后沿页头回程链(如 「返回告警中心」、「返回场站设备」)返回。
新能源车电池域的信息按三级展开:
L1 城市总览 全市站点的 KPI 汇总、地图分布、事件流
↓ 选中站点
L2 场站详情 单站的枪位、探头、检测会话与链路状态
↓ 选中会话
L3 会话详情 单次检测的 HI 指数、磁特征、时频图表与建议
各页面共用同一套壳层组件:
| 组件 | 作用 |
|---|---|
| AppShell | 全局布局骨架,挂载场景背景层与内容区 |
| TopBar | 顶部品牌区,包含平台标题、实时时钟、全屏切换;L1 页提供时间范围筛选(24h / 7d / 30d) |
| 业务域导航栏 | 底部横向导航,支持路由预取与高亮联动 |
| 场景背景层 | 统一的深色大屏氛围背景(网格、粒子、渐变),与业务面板分离 |
深色控制室风格:背景层管氛围,面板层放业务内容,两层分开(见 4.3)。色值、间距、字号、动效写进 Design Token,组件通过 CSS 变量引用,不在页面里硬编码 hex。
| 项目 | 做法 |
|---|---|
| 语义色 | S–D 等级、P0–P3 告警等状态各绑一组 Token,地图、列表、图表、孪生页颜色口径相同 |
| 面板 | 角切外框与统一标题栏,跨域页面用同一套 Panel 结构 |
| 分辨率 | 1920×1080 为主验收基准,clamp 流体布局适配 2K;KPI 与大数字用等宽排版 |
| 可读性 | 等级、告警不单靠颜色,须带字母或文案;背景 glow 和动效强度可控,图表曲线仍能看清 |
新能源车电池域是首期主路径。一体机在充电过程中采集被动磁场,边缘侧算 HI 并给出 S–D 评级;中心汇总各站数据,在 L1/L2/L3 三级页面展示。
L1 为左—中—右三列布局,一屏看完城市级概况:
中栏 — KPI 与地图
左栏 — 汇总/排行/对比 与 事件流
右栏 — 站点预览与趋势




进入场站后,L2 为左—中—右 + 底栏布局:
左栏 — 探头网格
中栏 — 站级 KPI 与枪位布局
右栏 — 链路与边缘状态
底栏 — 会话区
NEV 电池数字孪生
L2 页头右侧 「3D 数字孪生」 按钮(带立方体图标)进入该站 NEV 电池 3D 孪生页(/stations/[id]/twin)。须先聚焦一个有车辆的枪位,否则按钮置灰并提示「当前车位无车辆,无法进入数字孪生」。进入后展示枪位与探头空间关系,URL 携带 ?gun=、?session= 时可深链定位。


L3 展示单次检测的 HI 结论及波形、频谱等取证材料,供诊断人员核对评级依据:

演示路径(L1 → jinan-zhangqiu-xueye → 20260626-143022-zhangqiu-01)可按下面步骤走一遍:
储能域对接场站一体机,看电池舱/簇级磁场健康情况:
BESS 储能数字孪生
在地图上选中储能站后,右侧 「场区平面图」 Panel 标题栏点击 「3D 数字孪生」 按钮,进入 BESS 孪生页(/ess/twin),以 3D 电池舱模型展示簇级状态与空间布局。
典型路径:地图上看到异常标记 → 簇级布局里对应色块 → 「异常事件」 时间轴定位时间 → 「3D 数字孪生」 看物理位置 → 告警中心处理关联告警。


电缆通道域当前以 3D 廊道数字孪生 为主视图(/cable),展示沿线探头布设与通道段磁场健康状态。

告警中心汇总三个业务域的告警,支持筛选、分页和详情下钻:


设备管理页用两个 Tab 管全市硬件:设备总览看站级在线情况,异常设备看故障和离线台账。
设备总览 Tab

异常设备 Tab

设备详情抽屉 以弹层形式展示,Tab 包括 「状态」、「指标」、「日志」;探头组条目有独立详情视图。抽屉底部:「进入站点 →」(一体机)或 「进入关联站点 →」(边缘服务器)跳转 L2。
| 类别 | 内容 |
|---|---|
| 新能源车电池域 | L1 三列布局(KPI/地图/事件流/预览/趋势/等级)、L2 枪位/探头/会话/链路、L3 HI/特征/图表/建议,主路径完整可演示 |
| 储能电站域 | 站点地图、簇级布局、事件时间轴、趋势面板、KPI 条、BESS 3D 孪生 |
| 电缆通道域 | 电缆廊道 3D 数字孪生视图 |
| 告警中心 | 多维筛选、分页列表、详情抽屉、站点/会话跳转链路 |
| 设备管理 | 设备总览/异常设备双 Tab、站级巡检表、多 Tab 详情抽屉 |
| 数字孪生 | NEV 电池包、BESS 储能电池舱、电缆廊道三域 3D 孪生视图 |
| 全局能力 | 导航体系、时间范围筛选、URL 状态管理、轮询刷新、路由预取 |
| 中台 API | BFF P0 九条 GET 接口已就绪;P1 及告警/设备等演示数据当前以 Mock/dev 代理为主 |
| 工程基础 | TypeScript 严格模式、OpenAPI 类型生成、CSS Modules + Design Token、Vitest 测试框架 |
| 文档 | 路径 |
|---|---|
| 文档截图 | docs/presentation/screenshots/ |
| Dashboard 本地开发 | apps/dashboard/README.md |
| 系统架构 | docs/architecture/architecture.md |
| 功能梳理表(215 点源表) | 【新】新能源量子精密测量智能预警管控平台功能梳理_20260701.xlsx |
| 产品需求(PRD) | prd-jinan-magnetic-dashboard.md |