【质量】质检方案

质检方案模块，由 yudao-module-mes 后端模块的 qc.template 包实现，定义质量检验的模板——规定「用哪些检测项检验」、「各检测项的标准值和阈值」、「哪些物料适用该方案」。

质检方案是连接基础数据（检测项、物料）与质检业务（IQC/IPQC/OQC/RQC）的桥梁。IQC/IPQC 等质检单创建时，系统根据被检物料 + 检验类型自动匹配适用的质检方案，并从方案中克隆检验行。

本文涉及表如下图所示：

质检方案模块

1. 质检方案

质检方案，由 MesQcTemplateController 提供接口。

1.1 表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

sql

CREATE TABLE `mes_qc_template` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',

  `code` varchar(64) NOT NULL COMMENT '方案编码',
  `name` varchar(255) NOT NULL COMMENT '方案名称',
  `types` varchar(255) NOT NULL COMMENT '检验类型',

  `status` tinyint NOT NULL DEFAULT '0' COMMENT '状态',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 质检方案';

① types 为检验类型列表（多选），枚举 MesQcTypeEnum（IQC=来料检验，IPQC=过程检验，OQC=出货检验，RQC=退货检验）。一个方案可适用于多种检验类型。

② status 使用通用状态 CommonStatusEnum（0=开启，1=关闭）。方案需开启后才能被质检单自动匹配。

该表包含两个子表：

mes_qc_template_indicator（方案检测项）：定义该方案包含哪些检测项及其标准值/阈值。
mes_qc_template_item（方案适用物料）：定义该方案适用于哪些物料。

1.2 管理后台

对应 [MES 系统 -> 质量管理 -> 质检方案] 菜单，对应 yudao-ui-admin-vue3 项目的 @/views/mes/qc/template 目录。

列表

支持按方案编码、名称、检验类型、状态等条件搜索。

管理后台 - 质检方案列表

新增

点击【新增】按钮，弹出质检方案表单。主要填写方案编码（可自动生成）、方案名称、检验类型（多选）、状态。保存成功后弹窗自动关闭，刷新列表。

管理后台 - 质检方案新增

修改

点击操作列的【编辑】按钮，弹出修改表单。点击编码链接打开的是详情（只读模式）。编辑弹窗下方展示子表数据（需先保存主表后才会显示子表 Tab）：

管理后台 - 质检方案修改

★ 方案检测项（编辑弹窗下方）：由 mes_qc_template_indicator 表存储，定义该方案包含的检测项及其标准值、阈值。由 MesQcTemplateIndicatorController 提供接口。 mes_qc_template_indicator 表结构

sql

CREATE TABLE `mes_qc_template_indicator` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',

  `template_id` bigint NOT NULL COMMENT '质检方案ID',

  `indicator_id` bigint NOT NULL COMMENT '检测项ID',

  `check_method` varchar(500) DEFAULT NULL COMMENT '检测方法',
  `standard_value` decimal(12,4) DEFAULT NULL COMMENT '标准值',
  `unit_measure_id` bigint DEFAULT NULL COMMENT '计量单位ID',
  `threshold_max` decimal(12,4) DEFAULT NULL COMMENT '上限值',
  `threshold_min` decimal(12,4) DEFAULT NULL COMMENT '下限值',
  `doc_url` varchar(255) DEFAULT NULL COMMENT '说明图',

  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 质检方案检测项';

① template_id 关联主表 mes_qc_template 的 id 字段。

② indicator_id 关联 mes_qc_indicator 表的 id 字段（详见《【质量】检测项设置、常见缺陷》）。

③ 创建质检单时，以下字段会被克隆到检验行：check_method、standard_value、threshold_max/threshold_min、unit_measure_id。doc_url 仅在方案模板中维护，不会被克隆到检验行。

管理后台 - 产品关联

★ 适用物料（编辑弹窗下方）：由 mes_qc_template_item 表存储，定义该方案适用于哪些物料。由 MesQcTemplateItemController 提供接口。 mes_qc_template_item 表结构

sql

CREATE TABLE `mes_qc_template_item` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',

  `template_id` bigint NOT NULL COMMENT '质检方案ID',

  `item_id` bigint NOT NULL COMMENT '物料ID',
  `quantity_check` int NOT NULL DEFAULT '1' COMMENT '抽检数量',
  `quantity_unqualified` int NOT NULL DEFAULT '0' COMMENT '最大不合格数',

  `critical_rate` decimal(12,2) NOT NULL DEFAULT '0.00' COMMENT '致命缺陷率阈值',
  `major_rate` decimal(12,2) NOT NULL DEFAULT '0.00' COMMENT '严重缺陷率阈值',
  `minor_rate` decimal(12,2) NOT NULL DEFAULT '100.00' COMMENT '轻微缺陷率阈值',

  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 质检方案适用物料';

① template_id 关联主表 mes_qc_template 的 id 字段。

② item_id 关联 mes_md_item 表的 id 字段。

开启/关闭

在新增或编辑弹窗的「状态」字段中维护（列表页状态列为只读标签）。开启后方案可被 IQC/IPQC/OQC/RQC 自动匹配。

2. 方案自动匹配机制

自动匹配流程

创建质检单（如 IQC）时，系统自动执行以下匹配：

text

被检物料 ID + 检验类型(IQC/IPQC/OQC/RQC)
    │
    │ 查询 mes_qc_template_item
    ↓
找到 item_id 匹配的记录 → 获取 template_id
    │
    │ 验证方案已开启 + types 包含该检验类型
    ↓
从方案的检测项（mes_qc_template_indicator）克隆 → 生成质检单的检验行

匹配规则：通过 MesQcTemplateItemServiceImpl 的 getRequiredTemplateByItemIdAndType 方法实现。
如果找不到匹配的方案，创建质检单时会报错。
多方案命中时：当同一物料 + 同一检验类型存在多个已启用方案时，系统取查询结果中的第一条（findFirst），不保证确定性。建议业务上保持「同一物料 + 同一检验类型」只启用一个方案。

【质量】质检方案 ​

1. 质检方案 ​

1.1 表结构 ​

1.2 管理后台 ​

列表 ​

新增 ​

修改 ​

开启/关闭 ​

2. 方案自动匹配机制 ​