质检单「产品物料带不出」修复 + 列表字段瘦身 - 前端联调方案

现状说明（2026-09-22 修正）

本文原先标注后端改动「已完成」，**经实测为不实**：grep MdmItemApi 在 controller/admin/qc 下零命中，即质检控制器当时仍走 MES 侧 MesMdItemService，物料名称依旧查不出来（mes_md_item 60 行 ⊂ mdm_item 75 行，漏掉的 15 个物料显示为空；mes_md_unit_measure 0 行，单位恒为空）。

现已于 2026-09-22 真正落地，实际改动清单见下方「后端改动」表（本次改为以真实代码为准，逐文件列出）。前端联调内容（列表瘦身、MdmItemSelect）不受影响，仍按下文执行。

变更背景

产品物料信息查不出来：IQC / IPQC / OQC / RQC 四张检验单（以及「待检任务」页）的分页与详情接口中，itemCode（物料编码）、itemName（物料名称）、itemSpecification（规格型号）、unitName（单位）恒为空。
列表字段过于冗杂：检验单分页列表把大量**非必填**字段也作为列展示，信息密度低。

根本原因（第 1 项）

质检单据的 item_id 存的是 MDM 物料 ID（mdm_item.id），后端却去 MES 物料表（mes_md_item）反查名称，两张表不是一套 ID 体系，导致查不到（mes_md_item 甚至可能为空表）。

相关说明见记忆「MES 物料 ID 双轨制」：WM/质检单据用 mdm_item.id，PRO 工单/任务用 mes_md_item.id。

后端改动（2026-09-22 已完成，接口结构未变，仅响应值变正确）

文件	改动
`MesQcIpqcController`	物料/单位改由 `MdmItemApi` / `MdmUnitMeasureApi` 解析（列表 VO 与导出行两处）
`MesQcIqcController`	同上（同时该 Service 的物料校验早已走 `mdmItemApi`）
`MesQcOqcController`	同上
`MesQcRqcController`	同上；`MesQcRqcServiceImpl` 的物料校验一并由 `MesMdItemService` 改为 `MdmItemApi`
`MesQcNcrController`（顺带）	不合格品处理单的 `itemId` 继承自质检单，同口径切到 `MdmItemApi`，否则 NCR 列表物料名为空
`MesQc*LineController`（IPQC/IQC/OQC/RQC 行）	行明细的计量单位由 `MdmUnitMeasureApi` 解析
`MesQcPendingInspectController`	在 `buildPendingInspectRespVOList` 中按 `item_id` 批量补 `itemCode/itemName/specification/unitName`（原走 MES 侧解析，漏 15 个物料）
`MesQcTemplateItemController`	产品关联列表的物料/计量单位由 `MesMdmItemService`/`MesMdUnitMeasureService` 改为 `MdmItemApi`/`MdmUnitMeasureApi`（`mes_md_unit_measure` 为 0 行，原单位恒为空）
`MesQcTemplateIndicatorController`	检测指标项的计量单位同上切到 `MdmUnitMeasureApi`
`MesQcTemplateItemServiceImpl`	`getTemplateItemList` 去掉「按 `mes_md_item.id` 反查再转 `mdm_item.id`」的中间转换——质检侧入参本就是 MDM 物料 ID；同时删除 `workOrderId`/`taskId` 分支（质检单据已无工单/任务维度）
`MesQcIqcServiceImpl`	删除未被使用的 `MesMdItemService` 字段

接口路径、请求参数、响应字段结构均无变化，仅保证 itemCode/itemName/itemSpecification/unitName 有值。前端**无需改接口调用**，只要原来已展示这些字段即自动生效。

后续修正（2026-09-22 二次）：/mes/qc/template/item/list-by-item-and-type 的 workOrderId/taskId 参数**已移除**，只接受 { qcType, itemId }，其中 itemId 为 MDM 物料 ID。

前端改动（已完成）

1. 检验单列表：非必填字段移出列表，仅「检测结果」例外

规则：**非必填的字段不再作为列表列，唯一例外是「检测结果」**。判定以**后端 MesQc*SaveReqVO 的校验注解**为准（与前端表单 rules 一致）：无 @NotNull / @NotEmpty 即视为非必填。

四个列表最终列（顺序即展示顺序）：

页面	列表列
IPQC 过程检验	检验单编号、检验单名称、检验类型、产品物料编码、产品物料名称、规格型号、批号、单位、检测数量、检测结果、检测日期、检测人员、单据状态、操作
IQC 来料检验	检验单编号、检验单名称、产品物料编码、产品物料名称、接收数量、检测数量、不合格数、检测结果、来料日期、检测日期、检测人员、单据状态、操作
OQC 出货检验	检验单编号、检验单名称、产品物料编码、产品物料名称、规格型号、单位、不合格数、检测结果、检测日期、检测人员、单据状态、操作
RQC 退货检验	检验单编号、检验单名称、产品物料编码、产品物料名称、规格型号、单位、检测结果、检测日期、检测人员、单据状态、操作

从列表移除的列（字段本身、详情弹窗、导出、标题栏筛选条件均保留，仅不再占列表）：

页面	移除的列	依据（SaveReqVO 中无必填注解的字段）
IQC	供应商简称、供应商批次号	`vendorId` / `vendorBatch`
OQC	客户名称、批次号、发货数量、检测数量、出货日期	`clientId` / `batchCode` / `outQuantity` / `checkQuantity` / `outDate`
RQC	来源单据类型、来源单据编码、批次号	`sourceDocType` / `sourceDocCode` / `batchCode`
IPQC	无（原列表已无非必填列）	—

修正（2026-09-22 三次）：本文此前记载「四个列表新增复核人 auditNickname / 审核人 approveNickname」与实测不符 —— grep auditNickname|approveNickname 在 controller/admin/qc 下零命中，四个页面的 data.ts 中也无对应列。该条已删除，以本表为准。

2. 待检任务页：物料筛选器换成 MDM 物料

src/views/mes/qc/pendinginspect/data.ts 的「产品物料」筛选条件，由 MES 物料选择器改为 MdmItemSelect（#/views/basicData/mdm/components）。原因：待检任务的 item_id 来自 WM 单据（mes_wm_*），属 MDM 物料 ID 体系；沿用 MES 物料选择器会带入 mes_md_item.id，筛选结果恒为空。

注意区分：MdmItemSelect（MDM）位于 #/views/basicData/mdm/components；MdItemSelect（MES）位于 #/views/mes/md/item/components。二者不可混用。

字段展示规则

字段	列表	详情	说明
产品物料（编码/名称/规格/单位）	是	是	由 MDM 物料带出
检测结果	是	是	非必填，但按业务要求保留在列表
检测人员 / 复核人 / 审核人	是	是	按业务要求保留在列表；复核人、审核人为本次新增列
供应商 / 客户	否	是	非必填，移出列表
批次号（OQC/RQC）、发货数量、出货日期、来源单据类型/编码、供应商批次号	否	是	非必填，移出列表
采样地点、证书编号、执行标准、备注	否	是	原本就不在列表
导出 Excel	—	—	列不受本次列表瘦身影响，字段全部保留

业务规则说明

场景	规则
质检单物料展示	一律按 MDM 物料 ID 解析编码/名称/规格；单位取该物料的计量单位
待检任务物料展示	来源单据（WM）的物料 ID 即 MDM 物料 ID，按 MDM 解析名称等
物料筛选	待检任务页按 MDM 物料筛选；传 MES 物料 ID 将查不到任何任务
列表瘦身	非必填字段不进列表，改在详情查看；导出 Excel 不受影响

注意事项

不是响应结构变更：itemCode 等字段本来就存在，只是过去一直为 null/空串；如果前端之前对空值做了兜底如「-」，会自然变为真实值。
复核人 / 审核人：若列表新增列后仍显示为空，属正常现象——字段本身非必填，未填即为空。
mes_md_item 与 mdm_item 不可混用：本次修复正是把质检链路统一切到 MDM 体系，后续若有新页面展示质检/待检物料的名称，同样必须走 MdmItemApi。
待检任务的 batchCode 仅 IPQC 来源有值，其余来源为 null。