✨ feat(mes): 更新销售出库单状态流转逻辑，添加 OQC 检验支持

优化销售出库单的状态流转逻辑，新增待检测状态以支持 OQC 检验。根据检验结果自动流转状态，提升出库流程的灵活性和准确性。

✨ feat(mes): 更新销售出库单状态流转逻辑，添加 OQC 检验支持
优化销售出库单的状态流转逻辑，新增待检测状态以支持 OQC 检验。根据检验结果自动流转状态，提升出库流程的灵活性和准确性。
YunaiV
1 parent b31f78c8
Showing 6 changed files with 64 additions and 11 deletions
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/enums/ErrorCodeConstants.java
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/enums/wm/MesWmProductSalesStatusEnum.java
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/wm/productsales/MesWmProductSalesLineServiceImpl.java
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/wm/productsales/MesWmProductSalesService.java
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/wm/productsales/MesWmProductSalesServiceImpl.java
yudao-module-mes/src/main/resources/mapper/qc/pendinginspect/MesQcPendingInspectMapper.xml
@@ -533,7 +533,8 @@ public interface ErrorCodeConstants {
     ErrorCode WM_PRODUCT_SALES_CANNOT_SHIPPING = new ErrorCode(1_040_714_006, "当前状态不允许填写运单");
     ErrorCode WM_PRODUCT_SALES_CANNOT_FINISH = new ErrorCode(1_040_714_007, "当前状态不允许执行出库");
     ErrorCode WM_PRODUCT_SALES_CANNOT_CANCEL = new ErrorCode(1_040_714_008, "当前状态不允许取消");
-    ErrorCode WM_PRODUCT_SALES_DETAILS_EMPTY = new ErrorCode(1_040_714_009, "拣货明细不能为空");
+    ErrorCode WM_PRODUCT_SALES_CANNOT_CONFIRM = new ErrorCode(1_040_714_009, "当前状态不允许确认检验通过");
+    ErrorCode WM_PRODUCT_SALES_DETAILS_EMPTY = new ErrorCode(1_040_714_020, "拣货明细不能为空");
     ErrorCode WM_PRODUCT_SALES_DETAIL_QUANTITY_MISMATCH = new ErrorCode(1_040_714_010, "拣货数量与出库数量不匹配");
     ErrorCode WM_PRODUCT_SALES_LINE_NOT_EXISTS = new ErrorCode(1_040_714_011, "销售出库单行不存在");
     ErrorCode WM_PRODUCT_SALES_DETAIL_NOT_EXISTS = new ErrorCode(1_040_714_012, "销售出库明细不存在");
@@ -28,10 +28,18 @@ public enum MesWmProductSalesStatusEnum implements ArrayValuable&lt;Integer&gt; {
      */
     PREPARE(MesOrderStatusConstants.PREPARE, "草稿"),
     /**
-     * 待拣货
+     * 待检测（需要 OQC 检验时），对接 qc 模块的 MesQcOqcDO 后续流程
      *
      * 对应方法：{@link MesWmProductSalesService#submitProductSales(Long)}
      */
+    CONFIRMED(MesOrderStatusConstants.CONFIRMED, "待检测"),
+    /**
+     * 待拣货
+     *
+     * 对应方法：
+     * 1. 不需要 OQC 检验时：{@link MesWmProductSalesService#submitProductSales(Long)}
+     * 2. 或 OQC 检验完成时：{@link MesWmProductSalesService#confirmProductSales(Long)}
+     */
     APPROVING(MesOrderStatusConstants.APPROVING, "待拣货"),
     /**
      * 待填写运单
@@ -115,19 +115,30 @@ public class MesWmProductSalesLineServiceImpl implements MesWmProductSalesLineSe
         productSalesLineMapper.updateById(new MesWmProductSalesLineDO()
                 .setId(id).setOqcId(oqcId).setQualityStatus(qualityStatus));
-        // 2. 检查同一出库单下所有需要 OQC 检验的行的质检状态，联动更新出库单整体状态
+        // 2. 检查同一出库单下所有需要 OQC 检验的行
         MesWmProductSalesLineDO currentLine = productSalesLineMapper.selectById(id);
         if (currentLine == null || currentLine.getSalesId() == null) {
             return;
         }
         Long salesId = currentLine.getSalesId();
         List<MesWmProductSalesLineDO> allLines = productSalesLineMapper.selectListBySalesId(salesId);
+
+        // 2.1 检查是否有不合格行 → 取消出库单
         boolean hasNg = CollectionUtils.anyMatch(allLines,
                 line -> Boolean.TRUE.equals(line.getOqcCheckFlag())
                         && Objects.equals(line.getQualityStatus(), MesWmQualityStatusEnum.FAIL.getStatus()));
         if (hasNg) {
             log.info("[updateProductSalesLineWhenOqcFinish][销售出库单({}) 存在质检不合格行，取消出库单]", salesId);
             productSalesService.cancelProductSales(salesId);
+            return;
+        }
+
+        // 2.2 检查是否所有 OQC 行都已完成，自动流转 CONFIRMED → APPROVING
+        boolean hasUnchecked = CollectionUtils.anyMatch(allLines,
+                line -> Boolean.TRUE.equals(line.getOqcCheckFlag()) && line.getOqcId() == null);
+        if (!hasUnchecked) {
+            log.info("[updateProductSalesLineWhenOqcFinish][销售出库单({}) 所有 OQC 行检验完成，流转到待拣货]", salesId);
+            productSalesService.confirmProductSales(salesId);
         }
     }
@@ -53,7 +53,11 @@ public interface MesWmProductSalesService {
     PageResult<MesWmProductSalesDO> getProductSalesPage(MesWmProductSalesPageReqVO pageReqVO);
     /**
-     * 提交销售出库单（草稿 → 待拣货）
+     * 提交销售出库单
+     * <ul>
+     *     <li>有 OQC 检验行：草稿 → 待检测</li>
+     *     <li>无 OQC 检验行：草稿 → 待拣货</li>
+     * </ul>
      *
      * @param id 编号
      */
@@ -95,4 +99,11 @@ public interface MesWmProductSalesService {
      */
     void cancelProductSales(Long id);
+    /**
+     * OQC 检验完成后，自动流转（待检测 → 待拣货）
+     *
+     * @param id 编号
+     */
+    void confirmProductSales(Long id);
+
 }
@@ -117,7 +117,16 @@ public class MesWmProductSalesServiceImpl implements MesWmProductSalesService {
             throw exception(WM_PRODUCT_SALES_LINES_EMPTY);
         }
-        // 提交（草稿 → 待拣货）
+        // 检查所有行的 oqcCheckFlag：如果有需要 OQC 检验的行，进入待检测状态
+        boolean needOqc = CollectionUtils.anyMatch(lines,
+                line -> Boolean.TRUE.equals(line.getOqcCheckFlag()));
+        if (needOqc) {
+            // 需要检验，进入待检测
+            productSalesMapper.updateById(new MesWmProductSalesDO()
+                    .setId(id).setStatus(MesWmProductSalesStatusEnum.CONFIRMED.getStatus()));
+            return;
+        }
+        // 不需要检验，直接进入待拣货
         productSalesMapper.updateById(new MesWmProductSalesDO()
                 .setId(id).setStatus(MesWmProductSalesStatusEnum.APPROVING.getStatus()));
     }
@@ -215,6 +224,18 @@ public class MesWmProductSalesServiceImpl implements MesWmProductSalesService {
                 .setId(id).setStatus(MesWmProductSalesStatusEnum.CANCELED.getStatus()));
     }
+    @Override
+    public void confirmProductSales(Long id) {
+        // 校验存在 + 待检测状态
+        MesWmProductSalesDO sales = validateProductSalesExists(id);
+        if (ObjUtil.notEqual(MesWmProductSalesStatusEnum.CONFIRMED.getStatus(), sales.getStatus())) {
+            throw exception(WM_PRODUCT_SALES_CANNOT_CONFIRM);
+        }
+        // OQC 检验完成，流转到待拣货
+        productSalesMapper.updateById(new MesWmProductSalesDO()
+                .setId(id).setStatus(MesWmProductSalesStatusEnum.APPROVING.getStatus()));
+    }
+
     private MesWmProductSalesDO validateProductSalesExists(Long id) {
         MesWmProductSalesDO sales = productSalesMapper.selectById(id);
         if (sales == null) {
@@ -4,12 +4,12 @@
     <!--
         待检任务查询（UNION ALL 多来源），已实现的来源：
-        1. 到货通知单（IQC）：单据状态=待质检(2)，行的 iqc_check_flag=1 且 iqc_id 为空
-        2. 外协入库单（IQC）：单据状态=待检验(1)，行的 iqc_check_flag=1 且 iqc_id 为空
-        3. 生产报工（IPQC）：单据状态=待检验(3)
-        4. 销售出库单（OQC）：无单据状态要求，行的 oqc_check_flag=1 且 oqc_id 为空
-        5. 生产退料单（RQC）：单据状态=待检验(1)，行的 rqc_check_flag=1 且 rqc_id 为空 且 quality_status=0(待检)
-        6. 销售退货单（RQC）：单据状态=待检验(1)，行的 rqc_check_flag=1 且 rqc_id 为空 且 quality_status=0(待检)
+        1. 到货通知单（IQC）：单据状态=PENDING_QC(2)，行的 iqc_check_flag=1 且 iqc_id 为空
+        2. 外协入库单（IQC）：单据状态=CONFIRMED(1)，行的 iqc_check_flag=1 且 iqc_id 为空
+        3. 生产报工（IPQC）：单据状态=UNCHECK(3)
+        4. 销售出库单（OQC）：单据状态=CONFIRMED(1)，行的 oqc_check_flag=1 且 oqc_id 为空
+        5. 生产退料单（RQC）：单据状态=CONFIRMED(1)，行的 rqc_check_flag=1 且 rqc_id 为空 且 quality_status=0(待检)
+        6. 销售退货单（RQC）：单据状态=CONFIRMED(1)，行的 rqc_check_flag=1 且 rqc_id 为空 且 quality_status=0(待检)
     -->
     <select id="selectQcPendingPage" resultType="cn.iocoder.yudao.module.mes.controller.admin.qc.pendinginspect.vo.MesQcPendingInspectRespVO">
         SELECT * FROM (
@@ -103,6 +103,7 @@
                 JOIN mes_wm_product_sales_line sl ON s.id = sl.sales_id
             WHERE sl.oqc_check_flag = 1
               AND sl.oqc_id IS NULL
+              AND s.status = ${@cn.iocoder.yudao.module.mes.enums.wm.MesWmProductSalesStatusEnum@CONFIRMED.status}
               AND s.deleted = 0
               AND sl.deleted = 0