基础参数与工序绑定 + 报工填写参数字段 - 前端联调方案

需求背景

• 基础参数（工艺参数，菜单「工艺设计 → 基础参数」）原本无法与「工序」直接绑定。
• 本次实现：**工序主数据可绑定基础参数**；任务无参数模板时，生成任务会按工序绑定的参数自动固化参数快照；**报工时必须填写绑定的参数字段**（必填参数强校验），报工详情/列表回显参数值。

涉及页面

1. 工序设置页（mes/process-design/process/index）——新增「工艺参数」Tab，维护工序绑定的参数
2. 基础参数页（mes/process-design/parameter/index）——新增「关联工序」入口，查看该参数被哪些工序使用
3. 生产任务创建/自动排产——任务按工序绑定参数生成参数快照（无模板时）
4. 生产报工新增/编辑——按任务参数记录渲染参数字段，必填参数校验
5. 报工详情/列表——回显已填写的参数值

业务流程与数据带入

1. 工序设置页 → 「工艺参数」Tab → 勾选基础参数，设置是否必填/排序 → 保存到 mes_pro_process_param
2. 排产/手工建任务 → 任务的工序若未绑定参数模板，则从「工序绑定的参数」生成任务参数记录快照
   （参数来源优先级：工单工序绑定模板 → 路线工序绑定模板 → 工序主数据绑定参数 → 无参数记录）
3. 生产报工 → 按任务参数记录渲染参数字段（参数名 + 单位 + 必填星号）
4. 提交报工 → 必填参数为空则后端拒绝（报错「必填参数【xxx】未填写」）
5. 报工详情/列表 → 回显本次任务参数快照及已填写的参数值

API

一、工序-工艺参数绑定（新增）

权限：读 mes:pro-process:query；写 mes:pro-process:update（复用工序权限，无需新菜单）。

GET /list-by-process 请求参数：

响应：

{
  "code": 0,
  "data": [
    {
      "id": 9,
      "processId": 10,
      "processParamId": 7,
      "paramCode": "CS202607150004",
      "paramName": "测试参数_数值",
      "paramType": 1,
      "unitMeasureId": 1,
      "unitMeasureName": "吨",
      "required": true,
      "sort": 1,
      "remark": null
    }
  ]
}

POST /update-bindings 请求参数（全量覆盖）：

GET /list-by-param 请求参数：

响应： data 为工序列表（id、code、name）。

二、任务参数记录（已有接口，行为增强）

任务创建/自动排产时，若任务无参数模板但工序绑定了参数，会生成一条 templateName=工序绑定参数、templateId=null 的参数记录。

明细快照新增字段：required（是否必填）。

三、生产报工（已有接口，增强）

请求参数新增（已存在）：

响应字段新增（报工详情/列表）：

响应示例（报工详情）：

{
  "code": 0,
  "data": {
    "id": 48,
    "code": "FB_TEST_39",
    "processId": 10,
    "paramValues": [
      { "detailId": 55, "paramCode": "CS202607150004", "paramName": "测试参数_数值", "paramType": 1, "unitMeasureName": "吨", "paramValue": "200", "required": true },
      { "detailId": 56, "paramCode": "CS202607100003", "paramName": "测试参数11", "paramType": 2, "unitMeasureName": "千克", "paramValue": "200", "required": false }
    ]
  }
}

字段展示规则

工序设置页「工艺参数」Tab

基础参数页「关联工序」

生产报工表单

业务规则说明

注意事项

• paramValues[].detailId 是**任务参数记录明细编号**，不是模板明细编号；前端应先按任务参数记录接口取明细，再以其 id 提交。
• 任务无模板但工序绑定了参数时，参数记录的 templateId=null、templateName=工序绑定参数，工单参数记录页按此展示。
• 参数类型：1=文本 2=数值 3=布尔 4=日期，报工表单按类型渲染输入控件。
• 报工提交时即使不填参数（paramValues 为空），后端也会校验必填参数，任务绑定了参数时必须填写。
• 工序绑定参数接口的读写权限复用工序设置页权限（mes:pro-process:query/update）。
• 前端页面路径与菜单：工序设置 mes/process-design/process/index、基础参数 mes/process-design/parameter/index。