宁夏三级mom后端
编辑 | blame | 历史 | 原始文档

注塑机数采监控 - 前端联调方案

涉及页面

  • 设备管理 - 设备台账（新增数采字段、导入模板）
  • 设备管理 - 数采监控（新增）
  • 设备管理 - 数采监控 - 设备详情/历史（新增）
  • 设备管理 - 数采报警（新增，或作为数采监控页签）

业务流程与数据带入

  1. 设备台账维护 collectDeviceCode（如 C01）并启用 collectEnabled 后，数采报文才能自动关联到该设备。
  2. 数采监控列表以设备台账为基准展示，collectDeviceCode 是列表与各明细接口之间的唯一关联键，选中设备后需把该值作为 deviceCode 带入实时状态、工艺参数、周期数据、参数变更、报警查询。
  3. 列表中的 taskId / workOrderId 由后端按设备所在工作站自动解析当前运行任务，前端只读展示，不需要传参。
  4. 从列表进入报警时，建议默认带入当前 deviceCode 与 status=0（未消除），保证用户先看到当前设备的待处理报警。

API

方法 路径 说明
GET /mes/collect/device/list 数采设备状态列表
GET /mes/collect/realtime/get 设备最新实时状态
GET /mes/collect/realtime/history-page 实时状态历史分页
GET /mes/collect/cycle/page 周期过程数据分页
GET /mes/collect/cycle/get 周期过程数据明细
GET /mes/collect/tech/get 设备最新工艺参数快照
GET /mes/collect/operate-log/page 参数变更日志分页
GET /mes/collect/alarm/page 报警记录分页
PUT /mes/collect/alarm/ack 人工确认消除报警

设备台账字段新增

新增/更新、分页查询、Excel 导入导出均需支持以下字段：

字段 类型 必填 说明
collectDeviceCode String 否 数采设备编号（MQTT devId），全局唯一，如 C01
collectEnabled Boolean 否 是否启用数采，默认否
  • 设备台账分页查询支持按 collectDeviceCode、collectEnabled 过滤。
  • Excel 导入模板新增“数采设备编号”列；同一次导入内重复的编号会整行失败并返回具体行号与编号。

设备状态列表

GET /mes/collect/device/list

无请求参数，返回已配置 collectDeviceCode 的全部设备。

响应字段：

字段 类型 说明
machineryId Long 设备台账编号
machineryCode String 设备编码
machineryName String 设备名称
workstationId Long 工作站编号
workstationName String 工作站名称
collectDeviceCode String 数采设备编号
collectEnabled Boolean 是否启用数采
lastCollectTime DateTime 最近采集时间
online Boolean 是否在线（5 分钟内有数据）
sts / stsName Integer / String 运行状态：1 待机、2 生产
opm / opmName Integer / String 运行模式：0 手动、1 半自动、2 电眼自动、3 时间自动、4 调模使用
ot Decimal 油温
temps String 各段温度 JSON 字符串
taskId / taskCode / taskName Long / String / String 当前生产任务
workOrderId / workOrderCode Long / String 当前生产工单
activeAlarmCount Long 未消除报警数量

实时状态

GET /mes/collect/realtime/get，参数 deviceCode（必填）。

响应字段：id、machineryId、deviceCode、taskId、workOrderId、collectTime、sts/stsName、opm/opmName、asts、ot、temps、dataJson。设备暂无数据时 data 为 null。

GET /mes/collect/realtime/history-page

参数 类型 必填 说明
pageNo / pageSize Integer 是 分页参数
deviceCode String 否 数采设备编号
machineryId Long 否 设备台账编号
taskId Long 否 生产任务编号
workOrderId Long 否 生产工单编号
collectTime DateTime[] 否 采集时间范围，传开始、结束两个值

响应结构同实时状态，按采集时间倒序。

周期过程数据

GET /mes/collect/cycle/page

参数 类型 必填 说明
pageNo / pageSize Integer 是 分页参数
deviceCode String 否 数采设备编号
machineryId Long 否 设备台账编号
taskId Long 否 生产任务编号
workOrderId Long 否 生产工单编号
collectTime DateTime[] 否 采集时间范围

响应字段：id、machineryId、deviceCode、taskId、workOrderId、cycleNo、collectTime、ecyct、eiss、eivm、eipm、esipt、esipp、esips、eipt、eipse、eplst、eplsse、eplspm、etTemps（JSON 字符串，键为 ET1..ETn）、dataJson。

GET /mes/collect/cycle/get，参数 id（必填），返回单条明细，字段同上。

工艺参数快照

GET /mes/collect/tech/get，参数 deviceCode（必填）。

响应字段：id、machineryId、deviceCode、taskId、workOrderId、collectTime、dataJson。dataJson 为设备上报的完整工艺参数键值对，约 150 个变量；无数据时 data 为 null。

参数变更日志

GET /mes/collect/operate-log/page

参数 类型 必填 说明
pageNo / pageSize Integer 是 分页参数
deviceCode String 否 数采设备编号
machineryId Long 否 设备台账编号
workOrderId Long 否 生产工单编号
varId String 否 变量编码，如 SIPS
modifyTime DateTime[] 否 参数修改时间范围

响应字段：id、machineryId、deviceCode、taskId、workOrderId、varId、oldValue、newValue、modifyTime、collectTime、dataJson。

报警记录

GET /mes/collect/alarm/page

参数 类型 必填 说明
pageNo / pageSize Integer 是 分页参数
deviceCode String 否 数采设备编号
machineryId Long 否 设备台账编号
workOrderId Long 否 生产工单编号
status Integer 否 0 未消除、1 已消除
wmTime DateTime[] 否 报警时间范围

响应字段：id、machineryId、deviceCode、taskId、workOrderId、wmId（2 产生、0 消失）、wmMsg、wmTime、status/statusName、clearTime、collectTime、dataJson。

PUT /mes/collect/alarm/ack，参数 id（必填），无请求体，成功返回 true。

字段展示规则

字段 展示位置 说明
collectDeviceCode 台账列表、台账详情、数采监控列表 台账列表可直接展示，便于现场核对
collectEnabled 台账列表、台账表单 未启用的设备仍展示在监控列表，便于发现配置错误
online 监控列表 在线为绿色标识，离线为灰色；依据 5 分钟采集窗口
sts/stsName 监控列表、设备详情 生产/待机两态
opm/opmName 监控列表、设备详情 五态枚举，直接展示中文名称
ot、temps 监控列表、设备详情 temps 为 JSON 字符串，前端解析后按 T1..Tn 展示
taskCode/taskName、workOrderCode 监控列表、设备详情 只读；无运行任务时显示为空
activeAlarmCount 监控列表 大于 0 时高亮，可点击跳转报警页签并带入设备
status/statusName 报警列表 未消除/已消除
dataJson 各详情抽屉 作为“原始数据”折叠展示，便于排障

业务规则说明

场景 规则
设备未配置数采编号 不出现在 /device/list，但后端仍会接收并保存其报文，补绑台账后新数据自动关联
设备离线判定 最近采集时间早于当前时间 5 分钟即离线，与设备启停无关
工单带入 后端按设备工作站自动匹配生产中/部分完成/已停工任务，任务切换最长 30 秒生效
报警产生 设备上报 wmId=2 新增一条未消除记录，同一报警重复上报不重复生成
报警消失 设备上报 wmId=0 自动把该设备全部未消除记录置为已消除并写消除时间
人工确认 仅未消除记录可确认；已消除记录再次确认会提示“该报警已消除，无需重复确认”
周期数据去重 同一设备、同一周期序号、同一采集时间只保留一条
数据保留 原始报文 7 天、实时历史 30 天，周期/工艺/参数变更/报警长期保留

注意事项

  • 所有数采查询接口需权限 mes:collect:query，人工确认报警需 mes:collect-alarm:ack。
  • deviceCode 统一使用台账 collectDeviceCode，不要使用设备编码 machineryCode。
  • collectTime、modifyTime、wmTime 时间范围为两个值：第一个为开始时间，第二个为结束时间。
  • temps、etTemps、dataJson 均为 JSON 字符串，需要前端二次解析；解析失败时按原文本展示，避免页面报错。
  • 设备列表接口一次返回全部已配置数采的设备（当前 8 台），不需要分页。
  • 台账保存时数采编号重复会返回“数采设备编号已被其他设备占用”，需提示用户更换编号。