出货检验（OQC，Outgoing Quality Control）模块，由 yudao-module-mes 后端模块的 qc.oqc 包实现，覆盖销售出库前对产品的质量检验场景。

OQC 检验单关联来源单据（销售出库单），创建时系统根据被检物料 + OQC 类型自动匹配质检方案并生成检验行。检验完成后自动回写销售出库行的检验结果。

本文涉及表如下图所示：

1. 出货检验单（OQC）

出货检验单，由 MesQcOqcController 提供接口。在销售出库流程的「待检测」阶段执行。

1.1 表结构

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

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

  `code` varchar(64) NOT NULL COMMENT '检验单编码',
  `name` varchar(500) DEFAULT NULL COMMENT '检验单名称',
  `template_id` bigint DEFAULT NULL COMMENT '质检方案ID',

  `source_doc_type` tinyint DEFAULT NULL COMMENT '来源单据类型',
  `source_doc_id` bigint DEFAULT NULL COMMENT '来源单据ID',
  `source_line_id` bigint DEFAULT NULL COMMENT '来源单据行ID',
  `source_doc_code` varchar(64) DEFAULT NULL COMMENT '来源单据编码',

  `client_id` bigint DEFAULT NULL COMMENT '客户ID',
  `batch_code` varchar(64) DEFAULT NULL COMMENT '批次编码',
  `item_id` bigint NOT NULL COMMENT '物料ID',

  `min_check_quantity` int DEFAULT NULL COMMENT '最低检验数量',
  `max_unqualified_quantity` int DEFAULT NULL COMMENT '最大不合格数量',
  `out_quantity` decimal(14,2) DEFAULT NULL COMMENT '出库数量',
  `check_quantity` decimal(14,2) DEFAULT NULL COMMENT '检验数量',
  `qualified_quantity` decimal(14,2) DEFAULT '0.00' COMMENT '合格数量',
  `unqualified_quantity` decimal(14,2) DEFAULT '0.00' COMMENT '不合格数量',

  `critical_rate` decimal(14,2) DEFAULT NULL COMMENT '致命缺陷率',
  `major_rate` decimal(14,2) DEFAULT NULL COMMENT '严重缺陷率',
  `minor_rate` decimal(14,2) DEFAULT NULL COMMENT '轻微缺陷率',
  `critical_quantity` int DEFAULT NULL COMMENT '致命缺陷数',
  `major_quantity` int DEFAULT NULL COMMENT '严重缺陷数',
  `minor_quantity` int DEFAULT NULL COMMENT '轻微缺陷数',

  `check_result` tinyint DEFAULT NULL COMMENT '检验结果',

  `out_date` datetime DEFAULT NULL COMMENT '出库日期',
  `inspect_date` datetime DEFAULT NULL COMMENT '检验日期',
  `inspector_user_id` bigint NOT NULL COMMENT '检验员',

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

① template_id 关联 mes_qc_template 表，创建时由系统根据 item_id + OQC 类型自动匹配。详见 《【质量】质检方案》。

② source_doc_type 为来源单据类型（选填），枚举 MesQcSourceDocTypeEnum（PRODUCT_SALES=销售出库单）。source_doc_id、source_line_id、source_doc_code 标识来源单据及行信息。

来源单据不是必填项，可以独立创建 OQC 检验单；但如果填写了来源单据，检验完成后会自动回写。创建后不可修改来源单据。

③ client_id 关联客户。item_id 为被检物料。

out_quantity 为出库数量。min_check_quantity 为最低检验数量，max_unqualified_quantity 为最大不合格数量（两者从质检方案克隆）。

check_quantity 为实际检验数量，由检验员填写。qualified_quantity（合格数量）和 unqualified_quantity（不合格数量）在检验完成时由系统自动计算。

④ critical_rate/major_rate/minor_rate 和 critical_quantity/major_quantity/minor_quantity 为缺陷统计数据，由系统根据缺陷记录自动汇总更新（通过 recalculateDefectStats 方法）。

⑤ check_result 为检验结果，枚举 MesQcCheckResultEnum（1=检验通过，2=检验不通过）。由检验员手动填写。

⑥ status 为检验单状态，枚举 MesQcStatusEnum（0=草稿，4=已完成）：

状态值	枚举名	说明	可执行操作
0	PREPARE	草稿	编辑、录入检测结果/缺陷记录、填写检验结论、完成
4	FINISHED	已完成	—

状态流转说明

创建 ──→ 草稿(0) ──录入检测结果──→ 录入缺陷记录 ──→ 填写检验结论 ──完成──→ 已完成(4)
                                                                      │
                                                                      └── 回写销售出库行

• 创建（createOqc）：校验客户、物料、检验员存在。通过 item_id + OQC 类型自动匹配质检方案，从方案检测项克隆生成检验行。
• 完成（finishOqc）：校验 checkResult 已填写，且至少存在一条检测结果。状态变为「已完成」，同时回写销售出库行（mes_wm_product_sales_line）：
  • 将 oqc_id 和 quality_status（检验结果映射的质量状态）写入出库行
  • 若任一出库行质检不合格，直接取消整张销售出库单（cancelProductSales）
  • 若所有需 OQC 检验的行均已通过，销售出库单自动流转为「待拣货」（confirmProductSales）

---

该表包含一个子表：

• mes_qc_oqc_line（OQC 检验行）：由方案自动生成，记录每个检测项的检测方法和标准值/阈值。

1.2 管理后台

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

列表

支持按检验单编码、客户、批次号、产品物料、检测结果等条件搜索。

新增

点击【新增】按钮，弹出 OQC 新增表单。主要填写检验单编码（可自动生成）、来源单据（销售出库单）、客户、物料（必填）、检验员（必填）、出库数量、检验数量、检验日期。新建成功后弹窗自动切换为编辑模式，在表单下方展示检验行列表。

修改

点击编码链接或【编辑】按钮（仅草稿状态可编辑），弹出 OQC 修改表单。表单下方通过 el-divider 分隔展示检验行、检测结果和缺陷记录列表。

★ 检验行（编辑弹窗下方）：由 mes_qc_oqc_line 表存储，从质检方案自动生成。由 MesQcOqcLineController 提供接口。

mes_qc_oqc_line 表结构

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

  `oqc_id` bigint NOT NULL COMMENT '检验单ID',

  `indicator_id` bigint NOT NULL COMMENT '检测项ID',
  `tool` varchar(255) DEFAULT NULL COMMENT '检测工具',
  `check_method` varchar(500) DEFAULT NULL COMMENT '检测方法',

  `standard_value` decimal(14,4) DEFAULT NULL COMMENT '标准值',
  `unit_measure_id` bigint DEFAULT NULL COMMENT '计量单位ID',
  `max_threshold` decimal(14,4) DEFAULT NULL COMMENT '上限值',
  `min_threshold` decimal(14,4) DEFAULT NULL COMMENT '下限值',

  `critical_quantity` int DEFAULT NULL COMMENT '致命缺陷数',
  `major_quantity` int DEFAULT NULL COMMENT '严重缺陷数',
  `minor_quantity` int DEFAULT NULL COMMENT '轻微缺陷数',

  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB COMMENT='MES 出货检验行';

① oqc_id 关联主表 mes_qc_oqc 的 id 字段。

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

其余字段（tool、check_method、standard_value、unit_measure_id、max_threshold、min_threshold）均为说明性字段，从质检方案检测项克隆而来（详见 《【质量】质检方案》），后端不参与业务逻辑判定，供检验员在前端页面中参考。

③ critical_quantity、major_quantity、minor_quantity 为该检测项维度的缺陷数统计，由系统根据缺陷记录自动汇总。

检测结果

在编辑弹窗中录入每个检测项的实际检测结果值。检测结果由 mes_qc_indicator_result 表存储（详见 《【质量】待检任务、检验结果、缺陷记录》），关联质检单和检测项。

缺陷记录

在编辑弹窗中记录检验过程中发现的缺陷。选择缺陷类型（来自常见缺陷）、缺陷等级（致命/严重/轻微）、缺陷数量。

缺陷记录变更时，系统通过 MesQcOqcServiceImpl 的 recalculateDefectStats 方法自动按等级汇总缺陷数量和缺陷率到检验行和主表。

完成

在编辑弹窗中填写检验结论（通过/不通过）后，点击【完成】按钮。系统校验至少存在一条检测结果，状态变为「已完成」。同时自动回写销售出库行。