# 报工质检标识取值调整 - 前端联调方案 ## 涉及页面 - 生产订单(工单工序列表、工序编辑) - MES 生产任务(任务列表、任务详情、待报工台账) - MES 生产报工(新增/修改、审批) - 生产工作台(任务列表、报工页签) ## 业务背景 工单创建时可以在「工序」页签单独勾选本工单每道工序是否质检,该配置保存在工单工序快照 `mes_pro_work_order_process`。 此前报工审批、任务列表、工作台判断「是否需要质检」时读取的是工艺路线模板 `mes_pro_route_process`,导致工单上勾选「质检」但工艺路线该工序为「否」时,报工审批走的是免检分支:产出直接按合格入库,不生成待检任务,任务报完工后不会进入质检。 调整后统一为:**一律以工单工序快照的「质检」标识为准**,仅在工单未维护对应工序时回退工艺路线模板。 ## 记账/流程规则 | 场景 | 规则 | |------|------| | 工单工序勾选质检 | 报工审批后生成「待检验」产出,进入待检任务,质检完成后才入库 | | 工单工序未勾选质检 | 报工审批后按合格/不合格数量直接完成入库 | | 工单未维护该工序 | 回退读取工艺路线工序的质检标识 | | 倒冲标识 | 与质检标识一致:工单工序快照优先,工艺路线兜底 | ## API 接口路径、请求参数、响应结构均无变化,仅 `checkFlag` 字段的取值来源调整。 | 方法 | 路径 | 说明 | |------|------|------| | GET | /mes/pro/task/get | 任务详情,`checkFlag` 改为取工单工序快照 | | GET | /mes/pro/task/page | 任务分页,同上 | | GET | /mes/pro/task/pending-feedback-page | 待报工台账,同上 | | GET | /mes/pro/feedback/get | 报工详情,`checkFlag` 改为取工单工序快照 | | GET | /mes/pro/feedback/page | 报工分页,同上 | | PUT | /mes/pro/feedback/update | 校验口径改为工单工序快照(需检工序只校验报工数量) | | POST | /mes/pro/feedback/approve | 审批按工单工序快照决定是否进入质检 | ## 字段展示规则 | 字段 | 展示位置 | 变化说明 | |------|----------|----------| | checkFlag | 生产任务列表、任务选择弹窗 | 取工单工序快照,表示该任务产出是否需要质检 | | checkFlag | 报工表单数量区域 | 为 true 时只填报工数量,为 false 时填合格/不合格数量 | | backflushFlag | 任务列表 | 取工单工序快照,表示该工序是否倒冲扣料 | ## 多产出物料的检验规则 同一道工序可能同时产出多个物料(主产出 + 联产出,来源为工单工序快照 `outputItemId`),需要检验时: | 场景 | 规则 | |------|------| | 报工审批 | 每个产出物料各生成一条「待检验」产出行,产出单保持未完成,报工状态为待检验 | | 待检任务 | 每条产出行呈现为一条待检记录,物料取产出行物料,工序取报工单工序 | | 创建过程检验单 | 检验物料按来源产出行确定(不再取任务物料),工序取报工单工序 | | 完成某张检验单 | 只拆分该检验单对应的产出行(生成合格/不合格明细) | | 完成报工 | 同一报工的所有产出行都检验完成后,产出单才完成入库,报工/任务进度才回写 | | 数量口径 | 报工单与任务的合格/不合格/废品数量只统计主产出物料,联产出物料单独检验、单独入库 | | 检验模板 | 每个产出物料都必须单独配置启用的过程检验模板(IPQC),否则审批或建单会提示缺失 | ## 注意事项 - 工单工序勾选「质检」时,该工序的每个产出物料都必须已配置启用的过程检验模板(IPQC),否则审批会提示「未配置启用的过程检验模板」。 - 前端如自行调用 `/mes/pro/route-process/get-by-route-and-process` 推导 `checkFlag`,应改为优先使用任务或报工接口返回的 `checkFlag`,避免与后端审批口径不一致。 - 过程检验单的物料由后端按来源产出行确定,前端无需传 `itemId`;传了也不会改变检验物料。 - 历史任务 RW2611070009 已按 `scripts/feedback-qc-rollback-20261107/01_rollback_rw2611070009.sql` 和 `03_rollback_per_material_ipqc.sql` 回退报工单、任务进度、产出/自动入库单及过程检验单,可重新报工验证质检流程。