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

MES 计量器具与计量检测记录 - 前端联调方案

涉及页面

页面 菜单路径 路由路径 component_name
计量器具 设备管理 -> 计量器具 mes/dv/metering/index MesDvMetering
计量检测记录 设备管理 -> 计量检测记录 mes/dv/meteringcheck/index MesDvMeteringCheck

两个页面为平级菜单。检测记录页可通过「计量器具」下拉筛选，仅查看某台器具的检测历史。

业务流程与数据带入

  1. 计量器具列表 -> 新增/编辑表单：录入器具编码、名称、类别、校准周期、使用部门、责任人等。
  2. 计量检测记录 -> 新增/编辑表单：选择「计量器具」（从 /mes/dv/metering/simple-list 带入 meteringId、code、name）。
  3. 检测记录保存后，后端自动计算 nextCheckDate 并**回写**到计量器具的 lastCheckDate、nextCheckDate：
  • nextCheckDate 传空时 = checkDate + 校准周期(月)（自动计算）；
  • nextCheckDate 传值时 = 以传入值为准（手动指定）。
  1. 计量器具列表展示 expireStatus 到期状态标记，由后端按 nextCheckDate 与全局配置的提醒天数计算。

API

计量器具

方法 路径 说明 权限
POST /mes/dv/metering/create 创建计量器具 mes:dv-metering:create
PUT /mes/dv/metering/update 更新计量器具 mes:dv-metering:update
DELETE /mes/dv/metering/delete?id= 删除计量器具（有关联检测记录时拒绝） mes:dv-metering:delete
GET /mes/dv/metering/get?id= 获得计量器具详情 mes:dv-metering:query
GET /mes/dv/metering/page 计量器具分页 mes:dv-metering:query
GET /mes/dv/metering/export-excel 导出 Excel mes:dv-metering:export
GET /mes/dv/metering/simple-list 精简列表（下拉选项） mes:dv-metering:query

分页筛选参数（page 接口）：

参数 类型 必填 说明
code String 否 器具编码模糊
name String 否 器具名称模糊
brand String 否 品牌/生产厂家模糊
category Integer 否 器具类别（字典）
deptId Long 否 使用部门
chargeUserId Long 否 责任人
status Integer 否 状态（字典）
expireStatus Integer 否 到期状态：1 已过期 / 2 即将到期 / 3 正常

计量检测记录

方法 路径 说明 权限
POST /mes/dv/metering-check/create 创建检测记录 mes:dv-metering-check:create
PUT /mes/dv/metering-check/update 更新检测记录 mes:dv-metering-check:update
DELETE /mes/dv/metering-check/delete?id= 删除检测记录 mes:dv-metering-check:delete
GET /mes/dv/metering-check/get?id= 获得检测记录详情 mes:dv-metering-check:query
GET /mes/dv/metering-check/page 检测记录分页 mes:dv-metering-check:query
GET /mes/dv/metering-check/export-excel 导出 Excel mes:dv-metering-check:export

分页筛选参数（page 接口）：

参数 类型 必填 说明
meteringId Long 否 计量器具（从器具列表带入）
checkCode String 否 检测编号模糊
checkResult Integer 否 检测结论（字典）
checkDate LocalDate[] 否 检测日期区间

响应字段新增说明

计量器具列表/详情响应额外返回：

字段 类型 说明
deptName String 使用部门名称
chargeUserNickname String 责任人昵称
expireStatus Integer 到期状态：1 已过期 / 2 即将到期 / 3 正常
expireDays Long 距到期天数（正数未到、负数已过期）

计量检测记录列表/详情响应额外返回：

字段 类型 说明
meteringCode String 计量器具编码
meteringName String 计量器具名称
checkUserNickname String 检测人昵称

字段展示规则

字段 展示位置 说明
expireStatus 计量器具列表 1 已过期=危险(danger)；2 即将到期=警告(warning)；3 正常=成功(success)
status 计量器具列表、表单 字典 mes_dv_metering_status（在用=success/停用=info/报废=danger）
category 计量器具列表、表单 字典 mes_dv_metering_category
nextCheckDate 两个页面 计量器具展示为「下次检测日期」列；检测记录保存时回写
checkResult 检测记录列表、表单 字典 mes_dv_metering_check_result（合格=success/不合格=danger）
meteringCode/meteringName 检测记录列表 从器具带入展示
deptName/chargeUserNickname 计量器具列表 部门、责任人名称

业务规则说明

场景 规则
检测记录新增 未填 nextCheckDate 时按 checkDate + 校准周期 自动计算并保存
检测记录更新 重新计算 nextCheckDate，并回写器具
检测记录删除 器具按剩余「最新一条记录」整体重算回写（无记录则 lastCheckDate/nextCheckDate 置空）
计量器具删除 已关联检测记录时拒绝删除，提示「计量器具已关联检测记录，无法删除」
到期提醒 到期前 N 天（全局配置 mes.dv-metering.remind-days，默认 30）发送站内信给责任人；同一器具同一到期日 60 天内只提醒一次
编码/编号唯一 器具 code、检测 checkCode 均唯一，重复时后端报错

注意事项

  • expireStatus 由后端计算并返回，前端只需按三态渲染 tag 颜色，无需自行计算天数。
  • 删除器具前需确认无关联检测记录；删除检测记录后器具的到期日会随之变化，前端应刷新器具列表。
  • 检测记录页依赖计量器具数据，应先存在器具再登记检测记录。
  • 提醒天数可在「基础设施 -> 配置管理」中修改 mes.dv-metering.remind-days，改后立即生效。
  • 三个新字典可在「系统管理 -> 字典管理」中维护：mes_dv_metering_category、mes_dv_metering_status、mes_dv_metering_check_result。