编辑 | blame | 历史 | 原始文档

设备台账新增字段 - 前端联调方案

涉及页面

页面 路由路径 说明
设备台账列表 /mes/dv-machinery 列表新增筛选条件、表格列
设备台账表单 /mes/dv-machinery (弹窗) 新增/编辑表单中增加 3 个字段
设备台账导入 同上（导入弹窗） Excel 模板新增 3 列

新增字段说明

字段 类型 必填 说明
productionEfficiency BigDecimal 否 生产效率，单位：每小时生产数量，用于下排产自动计算生产时间
conveyorBelt Integer 否 传送履带数量，例：2 代表双倍效率
workstationId Long 否 工作站编号，用于将设备绑定到指定工作站

API

已有接口（无需新增）

方法 路径 说明
POST /mes/dv/machinery/create 创建设备
PUT /mes/dv/machinery/update 更新设备
GET /mes/dv/machinery/get?id={id} 获取详情
GET /mes/dv/machinery/page 分页查询
GET /mes/dv/machinery/simple-list 精简列表（下拉选项）
POST /mes/dv/machinery/import 导入设备
GET /mes/dv/machinery/get-import-template 下载导入模板

请求参数 - 创建/更新（MesDvMachinerySaveReqVO）

新增字段：

字段 类型 必填 说明
productionEfficiency BigDecimal 否 生产效率（每分钟）
conveyorBelt Integer 否 传送履带数量
workstationId Long 否 工作站编号

分页查询参数（MesDvMachineryPageReqVO）

新增筛选字段：

字段 类型 必填 说明
workstationId Long 否 按工作站筛选

响应（MesDvMachineryRespVO）

新增字段：

字段 类型 说明
productionEfficiency BigDecimal 生产效率
conveyorBelt Integer 传送履带
workstationId Long 工作站编号
workstationName String 工作站名称

响应示例：

{
  "code": 0,
  "data": {
    "id": 1,
    "name": "CNC 加工中心",
    "code": "EQ-001",
    "productionEfficiency": 10.5,
    "conveyorBelt": 2,
    "workstationId": 300,
    "workstationName": "一号工作站",
    ...
  }
}

前端修改点

1. 列表页 - 筛选项

在列表搜索栏新增"工作站"下拉筛选框，调用 /mes/md-workstation/simple-list 获取选项。

2. 列表页 - 表格列

新增列 绑定字段 说明
生产效率 productionEfficiency 显示数值
传送履带 conveyorBelt 显示数值
工作站 workstationName 显示工作站名称

3. 表单页 - 新增/编辑

在表单中新增 3 个字段：

字段 组件 说明
生产效率 <el-input-number> 支持小数，单位提示"每小时"
传送履带 <el-input-number> 正整数，提示"2=双倍效率"
工作站 <el-select> 下拉选择，调用工作站精简列表接口

4. 导入模板

导入 Excel 模板新增 3 列（可选列）：

列名 说明
生产效率(每小时) 数字，可选
传送履带 整数，可选
工作站编码 工作站编码，可选，填了则校验是否存在

业务规则说明

规则 说明
生产效率单位 固定为"每小时生产数量"，前端直接展示"每小时"
传送履带含义 数值 2 代表双倍效率，排产时 conveyorBelt × productionEfficiency 得到最终产能
工作站绑定 一台设备可绑定一个工作站（非强制），下拉数据源为 /mes/md-workstation/simple-list
导入时工作站 填入工作站编码（非 ID），系统自动转换，编码不存在则导入失败

注意事项

  • 3 个新字段均为可选，不影响现有数据
  • 生产效率输入建议限制最小值 0，保留 2 位小数
  • 传送履带仅允许正整数
  • 工作站下拉使用已有接口 /mes/md-workstation/simple-list，无需新增
  • Excel 导入时工作站列填编码而非 ID
  • 导入模板后端接口 /mes/dv/machinery/get-import-template 也会返回新列