11 KiB
11 KiB
工厂看板与 WMS 对接进度
更新时间:2026-06-01
本文档记录当前工厂看板项目和 WMS 后端改造的已完成工作、验证结果和后续建议。当前目标不是通用拖拽式大屏设计器,而是沉淀一个可直接承接项目需求的 React 看板基础工程,并逐步接入 WMS 后端清洗后的实时数据。
1. 当前项目定位
dev-screen-starter:项目型大屏开发基础框架,负责屏幕适配、图表工厂、视觉组件、示例看板和客户项目模板。apps/factory-dashboard:工厂设备看板示例项目,当前以 CNC、激光设备、配电柜为业务场景。WMS:现有业务后端,负责 MQTT 数据接收、死区过滤、数据清洗、汇总落库,并通过 SignalR 向看板推送清洗后的数据。
2. 看板侧已完成
2.1 基础框架
- 已采用 React、TypeScript、Vite、pnpm workspace。
- 已保留项目型开发模式,不做拖拽编辑器。
- 已完成
ScreenStage屏幕适配能力,支持fit、fill、stretch、none等缩放模式。 - 已沉淀
packages/charts图表工厂,基于 ECharts 生成常用图表 option。 - 已沉淀
packages/visual-kit,用于大屏视觉装饰和展示组件。 - 已提供
ChartPanel、Panel、MetricCard等基础组合能力。
2.2 factory-dashboard 页面
- 已将主界面从“每台设备一个大方框”的模式,调整为更适合老板和参观人员观看的焦点设备模式。
- 当前布局包括:
- 左侧设备列表和设备状态入口。
- 中间焦点设备实时信息。
- 中间设备近 7 日产量或趋势图。
- 右侧设备总览、今日产量、近 7 日趋势、告警列表。
- 已支持设备点击切换焦点设备。
- 已补齐 CNC、激光、配电柜的 mock 展示数据。
- CNC 设备编号已统一为
CNC-001到CNC-013。 - 自动滚动列表已调整到面板内显示,避免越界。
2.3 SignalR 数据接入
- 已新增
@microsoft/signalr依赖。 - 已新增
apps/factory-dashboard/src/api/dashboardSignalR.ts。 - 看板支持通过 URL 参数或环境变量切换数据模式:
- 默认:mock 数据。
?dataMode=signalr:连接 WMS SignalR。
- 已支持连接 WMS
/dashboardHub。 - 已支持启动后调用
GetSnapshot获取设备快照和当前告警。 - 已支持监听:
device.updatedalarm.updatedtrend.updated
- 已将后端 CNC、配电柜 DTO 映射到现有前端
FactoryDevice类型。 - 页面底部已展示实时链路状态,例如
SignalR 已连接。 dataMode=signalr时不再使用 mock 设备和 mock 告警兜底,避免连接失败时误展示假数据。- SignalR 连接失败时会展示空状态和连接错误,方便现场判断后端链路问题。
- 告警推送已改为按设备合并和清空,避免单设备告警覆盖全局告警列表。
2.4 产量口径调整
- CNC 类型已新增
todayProduce字段。 - CNC 卡片的“今日产量”优先使用后端推送的
todayProduce。 - 焦点设备的“今日产量”优先使用后端推送的
todayProduce。 - 右侧汇总区的“今日产量”对 CNC 优先使用后端推送的
todayProduce。 - mock/周统计数据仅作为无后端数据时的 fallback。
- CNC 焦点下方图表使用后端
DeviceProductionDaily的最近 7 天日期、日产量和运行时长,避免前端日期与 mock 数据错位。 - CNC 当天产量使用实时
todayProduce覆盖 7 天图表最后一天,保证当天数据及时。
2.5 配电柜趋势展示
- 配电柜焦点下方图表已调整为最近 1 小时三相电流趋势。
- 趋势数据来自后端
DeviceMetricTrendPoint。 - 前端用阶梯线展示死区后的稀疏趋势点,表达“数值保持到下一次变化”。
- 图表末尾会补入最新
device.updated中的实时 A/B/C 电流。 - 如果最近 1 小时内无趋势点,但设备有当前实时值,图表仍会显示当前点,不会空白。
3. WMS 后端已完成
3.1 MQTT 接收运行控制
- 已新增 MQTT 全局运行状态。
- 启动时读取
MqttSubscription.IsEnabled:- 只要存在一条启用订阅,就认为 MQTT 接收开启。
- 全部禁用则认为 MQTT 接收关闭。
- 前端修改订阅启用状态时,同步更新全局运行变量。
- MQTT job 消费消息时读取全局变量,用于判断是否继续处理。
3.2 设备数据表
已新增并通过 EF Core 同步到 MySQL 的表:
DeviceCurrentState- 保存设备当前状态。
- 用于看板快照、设备在线状态、最后一次实时数据展示。
DeviceMetricTrendPoint- 保存清洗后的趋势点。
- 用于电流趋势、转速趋势、进给趋势、运行时长等图表。
DeviceAlarmRecord- 保存设备告警生命周期。
- 用于当前告警列表和后续告警统计。
DeviceProductionDaily- 保存设备日产能汇总。
- 用于今日产量、日报、近 7 日产量趋势。
3.3 配电柜清洗流程
- 已新增
PowerCabinetMessageProcessor。 - 已支持识别配电柜 MQTT payload。
- 已提取 A/B/C 三相电流。
- 已做电流死区过滤,减少无意义写库和推送。
- 已更新
DeviceCurrentState。 - 死区命中时不会新增
DeviceMetricTrendPoint,但会更新DeviceCurrentState.LastPayloadTime、LastUpdateTime和RealtimeJson,表示设备仍在持续上报且当前值有效。 - 已写入分钟级趋势点:
currentAcurrentBcurrentCcurrentAvgestimatedPowerimbalanceRate
- 已同步配电柜异常告警。
- 已返回统一
ProcessingResult,供 job 和 SignalR 推送使用。
3.4 CNC 清洗流程
- 已新增
CncMessageProcessor。 - 已支持识别 CNC MQTT payload。
- 已提取:
- 设备状态。
- 当前程序名和程序号。
- 累计产量
currentProduceCount。 - 主轴转速。
- 进给速度。
- 设定主轴倍率。
- 设定进给倍率。
- 运行时间。
- 切削时间。
- 循环时间。
- 工作模式。
- 告警信息。
- CNC 类型和轴数。
- 已支持设备号解析,例如从 topic 或 payload 映射到
CNC-001。 - 已做死区过滤:
- 状态、程序、产量、告警变化会触发更新。
- 主轴转速小幅变化、进给速度小幅变化可被过滤。
- 超过最大静默时间后仍会更新,避免长期无推送。
- 已更新
DeviceCurrentState。 - 已写入趋势点:
cncProduceCountspindleSpeedfeedRateruntimeMinutescuttimeMinutes
- 已更新
DeviceProductionDaily:StartCounterEndCounterProduceCountRuntimeMinutesCuttimeMinutes
- 已同步 CNC 告警。
- 已在清洗后的实时数据中加入
todayProduce。
3.5 SignalR 推送服务
- 已新增
DashboardHub。 - 已将 hub 映射到
/dashboardHub。 - 已新增 CORS 策略,允许本地看板连接:
http://localhost:5173http://127.0.0.1:5173
- 已新增
DashboardPushService。 - MQTT job 在清洗成功后会推送:
device.updatedtrend.updatedalarm.updated
- MQTT job 已调整为先保存清洗结果,再推送 SignalR,避免趋势和告警查询滞后一拍。
device.updated使用ProcessingResult.ParsedData,也就是清洗后的数据,而不是重新从原始报文解析。GetSnapshot会返回当前设备状态和当前活跃告警。GetSnapshot会从DeviceProductionDaily合并当天 CNCtodayProduce,保证页面刚打开时也能拿到今日产量。GetSnapshot和device.updated会返回 CNC 最近 7 天DailyProduction,作为前端 7 天产量/运行趋势的唯一数据源。- 配电柜
trend.updated会返回最近 1 小时DeviceMetricTrendPoint,并补窗口开始前最后一个有效点,保证死区稳定时趋势图不断档。
4. 当前验证结果
已执行并通过:
dotnet build WMS.sln
pnpm --filter @dev-screen-starter/factory-dashboard typecheck
pnpm --filter @dev-screen-starter/factory-dashboard build
验证情况:
- WMS 编译通过。
- WMS 编译仅存在
.NET 6停止支持的 SDK warning。 - factory-dashboard 类型检查通过。
- factory-dashboard 生产构建通过。
- 前端构建存在 SignalR/ECharts chunk 较大的提示,不影响当前运行。
- WMS 已可监听
http://127.0.0.1:5000。 /dashboardHub/negotiate已验证返回200。- 浏览器中
http://localhost:5173/?scaleMode=fit&dataMode=signalr已可显示 SignalR 连接状态。
5. 本次提交范围
本次提交包含 WMS 后端和 factory-dashboard 看板的联动改造。
WMS 侧主要改动:
HHWMS.Web/Program.csHHWMS.Web/Areas/System/Controllers/jobs/MqttMessageJob.csHHWMS.Web/Areas/Hub/DashboardHub.csHHWMS.Web/Services/DeviceData/PowerCabinetMessageProcessor.csHHWMS.Web/Services/DeviceData/CncMessageProcessor.csHHWMS.Web/Services/DeviceData/DashboardPushService.csHHWMS.Web/Services/DeviceData/ProcessingResult.cs
看板侧主要改动:
apps/factory-dashboard/package.jsonapps/factory-dashboard/src/api/dashboardSignalR.tsapps/factory-dashboard/src/pages/DashboardPage.tsxapps/factory-dashboard/src/components/CncCard.tsxapps/factory-dashboard/src/components/FocusDevicePanel.tsxapps/factory-dashboard/src/components/StatusSummary.tsxapps/factory-dashboard/src/domain/deviceTypes.tsapps/factory-dashboard/src/mock/factoryDevices.tsapps/factory-dashboard/src/styles/factory-dashboard.csspackages/charts/src/optionFactories.tspnpm-lock.yamldoc/factory-dashboard-wms-progress.md
6. 后续建议
6.1 后端优先事项
- 激光设备暂时继续使用外部 HTTP 信息,不纳入当前 MQTT/SignalR 清洗链路。
- 增加看板专用查询接口:
- 设备列表。
- 最近 1 小时或自定义时间窗电流趋势。
- 近 7 日产量趋势。
- 当前告警列表。
- 设备详情页数据。
- 增加聚合推送事件,例如
summary.updated,用于推送整屏汇总指标。 - 为
DeviceMetricTrendPoint增加按设备、指标、时间范围查询能力。 - 明确设备编码映射规则,避免 topic、payload、数据库设备号不一致。
- 后续将 .NET 6 升级到受支持版本,减少运行环境风险。
6.2 看板优先事项
- 将右侧近 7 日趋势从 mock 切到后端接口。
- 将焦点设备趋势图从 mock 切到后端接口或 SignalR 聚合数据。
- 增加设备详情页:
- CNC 详情。
- 激光详情。
- 配电柜详情。
- 增加真实数据和 mock 数据并行调试开关。
- 对 SignalR 断线、重连、空数据、后端异常增加更明确的页面状态。
- 对生产环境构建做代码拆分,降低首屏 JS 体积。
6.3 数据口径建议
- 今日产量、总产能、近 7 日产量这类业务指标应以后端汇总表为准。
- 前端只负责展示,不再计算核心业务口径。
- 原始 MQTT 数据只用于采集和审计,不直接推给看板。
- 看板实时链路统一消费后端清洗后的 WebSocket/SignalR 数据。