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

## 涉及页面

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

## 业务流程与数据带入

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` 为空不代表删除参数记录；没有模板的任务才不生成参数记录。