【质量】检测项设置、常见缺陷
质量管理覆盖来料检验(IQC)、过程检验(IPQC)、出货检验(OQC)、退货检验(RQC)四个环节,贯穿从原材料入库到成品出货的全流程。本文介绍质量检验的基础数据,由 yudao-module-mes 后端模块的 qc.indicator、qc.defect 包实现。
本文涉及两个子模块:
- 检测项设置:定义质量检验中的检测项(如外观检查、尺寸测量、硬度测试等),是质检方案的最小检验单元。
- 常见缺陷:定义生产和检验过程中的常见缺陷项(如划痕、变形、色差等),为后续缺陷记录的快速选择做数据准备(当前缺陷记录仍为手动填写)。
本文涉及表如下图所示:
# 1. 检测项设置
检测项设置,由 MesQcIndicatorController 提供接口。检测项是质检方案中的最小检验单元,定义「检什么」、「用什么工具检」、「结果是什么类型」。
# 1.1 表结构
省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段
CREATE TABLE `mes_qc_indicator` (
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
`code` varchar(64) NOT NULL COMMENT '检测项编码',
`name` varchar(255) NOT NULL COMMENT '检测项名称',
`type` tinyint NOT NULL COMMENT '检测项类型',
`tool` varchar(255) DEFAULT NULL COMMENT '检测工具',
`result_type` tinyint NOT NULL COMMENT '结果类型',
`result_specification` varchar(255) DEFAULT NULL COMMENT '结果值属性',
`remark` varchar(500) DEFAULT '' COMMENT '备注',
PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 质检指标';
① type 为检测项类型,使用数据字典 mes_indicator_type(如外观检测、尺寸检测、性能检测等),可在系统管理中自定义扩展。
② result_type 为检测结果的数据类型,枚举 MesQcResultValueTypeEnum(1=浮点,2=整数,3=文本,4=字典,5=文件)。决定了质检时该检测项的结果录入方式。
③ result_specification 为结果值属性。当 result_type 为字典(4)时填写数据字典类型编码(如 sys_yes_no);为文件(5)时填写 IMG(图片)或 FILE(文件)。浮点/整数/文本类型不使用此字段。
# 1.2 管理后台
对应 [MES 系统 -> 质量管理 -> 检测项设置] 菜单,对应 yudao-ui-admin-vue3 项目的 @/views/mes/qc/indicator 目录。
# 列表
支持按检测项编码、名称、类型等条件搜索。

# 新增/修改
点击【新增】或【编辑】按钮,弹出检测项表单。主要填写检测项编码(可自动生成)、名称、类型、检测工具、结果类型。

# 2. 常见缺陷
常见缺陷,由 MesQcDefectController 提供接口。预定义生产和检验过程中的常见缺陷项,为缺陷记录提供基础数据(当前缺陷记录组件尚未接入快速选择,仍为手动填写缺陷描述和等级)。
# 2.1 表结构
省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段
CREATE TABLE `mes_qc_defect` (
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '编号',
`code` varchar(64) NOT NULL COMMENT '缺陷编码',
`name` varchar(500) NOT NULL COMMENT '缺陷描述',
`type` tinyint NOT NULL COMMENT '检测项类型',
`level` int NOT NULL COMMENT '缺陷等级',
`remark` varchar(500) DEFAULT '' COMMENT '备注',
PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 缺陷类型表';
① type 为检测项类型,使用数据字典 mes_defect_type(如尺寸、外观、重量、性能、成分等),可在系统管理中自定义扩展。
② level 为缺陷等级,枚举 MesQcDefectLevelEnum(1=致命,2=严重,3=轻微),用于评估缺陷的严重程度。
# 2.2 管理后台
对应 [MES 系统 -> 质量管理 -> 常见缺陷] 菜单,对应 yudao-ui-admin-vue3 项目的 @/views/mes/qc/defect 目录。
# 列表
支持按缺陷编码、名称、类型、等级等条件搜索。

# 新增/修改
点击【新增】或【编辑】按钮,弹出缺陷表单。主要填写缺陷编码(可自动生成)、缺陷描述、检测项类型、缺陷等级。

# 3. 质量检验体系概览
基础数据在质量检验体系中的位置
检测项设置 ──→ 质检方案(模板) ──→ 来料检验(IQC) / 过程检验(IPQC) / 出货检验(OQC) / 退货检验(RQC)
│
常见缺陷 ──→ 缺陷记录(检验过程中引用)──────────────┘
- 检测项是质检方案的组成单元。一个质检方案包含多个检测项(通过
mes_qc_template_indicator关联),每个检测项定义检测内容和结果类型。详见 《【质量】质检方案》。 - 常见缺陷为质检过程中的缺陷记录提供基础数据。当前缺陷记录组件(DefectRecordInlineList.vue)采用手动填写缺陷描述和选择等级的方式,尚未接入常见缺陷快速选择功能(
getDefectSimpleListAPI 已定义但未被页面调用)。