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

生产任务工艺参数 - 前端联调方案

涉及页面

  • 工艺路线工序维护
  • 生产排产任务新增、编辑和详情
  • 生产报工新增、编辑和详情
  • 工单参数记录查询

业务流程与数据带入

  1. 工艺路线工序可选择工艺参数模板，模板编号随路线工序保存。
  2. 自动排产根据工单工序或路线工序生成生产任务，并将参数模板编号带入任务。
  3. 任务生成时，系统复制模板及明细快照到任务参数记录；后续模板修改不影响该任务快照。
  4. 报工以任务为核心，参数值按任务参数记录明细编号提交并保存；无模板任务仍可正常报工。
  5. 报工审批、质检回调和数量回写不重新读取模板，历史参数值保持不变。

API

方法 路径 说明
POST /mes/pro/route-process/create 新增路线工序，可保存 paramTemplateId
PUT /mes/pro/route-process/update 修改路线工序及参数模板
POST /mes/pro/task/create 手工创建任务，可传 paramTemplateId
POST /mes/pro/task/auto-generate 自动排产，任务继承工单工序或路线工序的模板
POST /mes/pro/feedback/create 创建报工，可提交 paramValues
PUT /mes/pro/feedback/update 修改草稿报工及参数值
POST /mes/pro/feedback/submit 提交报工，进入审批或直接完成

参数字段

字段 类型 必填 说明
paramTemplateId Long 否 任务或路线工序使用的工艺参数模板编号
paramValues Array 否 报工填写的参数值；无模板时不传
paramValues[].detailId Long 是（传入时） 任务参数记录明细编号，不是模板明细编号
paramValues[].value String 否 本次报工参数值

字段展示规则

字段 展示位置 说明
paramTemplateId 路线工序、任务详情 展示当前任务采用的参数模板
参数编码、名称、类型、单位 任务参数记录、报工表单 从任务快照读取，不直接回查模板
参数值 报工表单、报工详情、历史记录 保存到参数记录明细，展示已保存值
firstFeedbackTime、lastFeedbackTime 任务详情 首次和最近一次正式报工时间

业务规则说明

场景 规则
无参数模板 任务正常生成，报工不要求参数值
有参数模板 任务生成时固化模板明细快照，报工按任务明细填写参数
模板后续修改 不影响已有任务参数快照和已填写报工值
参数明细编号不属于当前任务 后端拒绝保存
审批或质检回调 只处理报工和生产数量，不重新生成参数记录
正式报工后 任务参数作为历史记录保留，不覆盖原快照

注意事项

  • 报工页面应先根据任务参数记录获取参数定义，再以明细 detailId 提交值。
  • 不要将模板明细编号当作报工参数明细编号使用。
  • 数值、日期、布尔等参数的输入格式应与参数类型保持一致。
  • paramValues 为空不代表删除参数记录；没有模板的任务才不生成参数记录。