From cccbfadcb6e96c23a33c40c0687a27c2f6efa1db Mon Sep 17 00:00:00 2001
From: 云 <2163098428@qq.com>
Date: 星期一, 09 十一月 2026 13:16:42 +0800
Subject: [PATCH] feat(seal): 添加印章详情及图片预览功能

---
 yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/qc/ncr/MesQcNcrServiceImpl.java |  455 +++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 files changed, 441 insertions(+), 14 deletions(-)

diff --git a/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/qc/ncr/MesQcNcrServiceImpl.java b/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/qc/ncr/MesQcNcrServiceImpl.java
index 56ed686..3f3bb69 100644
--- a/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/qc/ncr/MesQcNcrServiceImpl.java
+++ b/yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/qc/ncr/MesQcNcrServiceImpl.java
@@ -1,17 +1,49 @@
 package cn.iocoder.yudao.module.mes.service.qc.ncr;
 
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.exception.ServiceException;
 import cn.iocoder.yudao.framework.common.pojo.PageResult;
 import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.bpm.api.task.BpmProcessInstanceApi;
+import cn.iocoder.yudao.module.bpm.api.task.dto.BpmProcessInstanceCreateReqDTO;
+import cn.iocoder.yudao.module.bpm.enums.task.BpmProcessInstanceStatusEnum;
+import cn.iocoder.yudao.module.mes.controller.admin.pro.workorder.vo.MesProWorkOrderSaveReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.qc.ncr.vo.MesQcNcrDisposeReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.qc.ncr.vo.MesQcNcrDisposeRespVO;
 import cn.iocoder.yudao.module.mes.controller.admin.qc.ncr.vo.MesQcNcrPageReqVO;
 import cn.iocoder.yudao.module.mes.controller.admin.qc.ncr.vo.MesQcNcrSaveReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.wm.batch.vo.MesWmBatchGenerateReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.wm.miscreceipt.vo.MesWmMiscReceiptSaveReqVO;
+import cn.iocoder.yudao.module.mes.controller.admin.wm.miscreceipt.vo.line.MesWmMiscReceiptLineSaveReqVO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.md.item.MesMdItemDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.mdm.MesMdmItemDO;
 import cn.iocoder.yudao.module.mes.dal.dataobject.qc.ncr.MesQcNcrDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.qc.oqc.MesQcOqcDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.wm.warehouse.MesWmWarehouseAreaDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.wm.warehouse.MesWmWarehouseDO;
+import cn.iocoder.yudao.module.mes.dal.dataobject.wm.warehouse.MesWmWarehouseLocationDO;
 import cn.iocoder.yudao.module.mes.dal.mysql.qc.ncr.MesQcNcrMapper;
+import cn.iocoder.yudao.module.mes.enums.md.autocode.MesMdAutoCodeRuleCodeEnum;
+import cn.iocoder.yudao.module.mes.enums.pro.MesProWorkOrderSourceTypeEnum;
+import cn.iocoder.yudao.module.mes.enums.pro.MesProWorkOrderTypeEnum;
+import cn.iocoder.yudao.module.mes.enums.qc.MesNcrDispositionEnum;
 import cn.iocoder.yudao.module.mes.enums.qc.MesNcrStatusEnum;
 import cn.iocoder.yudao.module.mes.enums.qc.MesQcTypeEnum;
+import cn.iocoder.yudao.module.mes.enums.wm.MesWmMiscReceiptTypeEnum;
+import cn.iocoder.yudao.module.mes.service.md.autocode.MesMdAutoCodeRecordService;
+import cn.iocoder.yudao.module.mes.service.md.item.MesMdItemService;
+import cn.iocoder.yudao.module.mes.service.mdm.MesMdmItemService;
+import cn.iocoder.yudao.module.mes.service.pro.workorder.MesProWorkOrderService;
 import cn.iocoder.yudao.module.mes.service.qc.iqc.MesQcIqcService;
 import cn.iocoder.yudao.module.mes.service.qc.ipqc.MesQcIpqcService;
 import cn.iocoder.yudao.module.mes.service.qc.oqc.MesQcOqcService;
 import cn.iocoder.yudao.module.mes.service.qc.rqc.MesQcRqcService;
+import cn.iocoder.yudao.module.mes.service.wm.batch.MesWmBatchService;
+import cn.iocoder.yudao.module.mes.service.wm.miscreceipt.MesWmMiscReceiptLineService;
+import cn.iocoder.yudao.module.mes.service.wm.miscreceipt.MesWmMiscReceiptService;
+import cn.iocoder.yudao.module.mes.service.wm.warehouse.MesWmWarehouseAreaService;
+import cn.iocoder.yudao.module.mes.service.wm.warehouse.MesWmWarehouseLocationService;
+import cn.iocoder.yudao.module.mes.service.wm.warehouse.MesWmWarehouseService;
 import cn.iocoder.yudao.module.mdm.api.item.MdmItemApi;
 import jakarta.annotation.Resource;
 import org.springframework.context.annotation.Lazy;
@@ -19,10 +51,12 @@
 import org.springframework.transaction.annotation.Transactional;
 import org.springframework.validation.annotation.Validated;
 
+import java.math.BigDecimal;
 import java.time.LocalDateTime;
 import java.util.Collection;
 import java.util.Map;
 import java.util.Objects;
+import java.util.Set;
 
 import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
 import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
@@ -38,11 +72,31 @@
 @Validated
 public class MesQcNcrServiceImpl implements MesQcNcrService {
 
+    /**
+     * NCR 鍗忓悓瀹℃壒娴佺▼鍒嗙被/娴佺▼瀹氫箟 key
+     */
+    private static final String NCR_APPROVAL_PROCESS_KEY = "mes_ncr_approve";
+
+    /**
+     * 鏈�缁堝缃厑璁稿�硷細璁╂鏀捐銆佽繑淇�佽繑宸ャ�佹姤搴�
+     * <p>
+     * 閫�璐�(1)銆侀檷绾т娇鐢�(5) 浠嶄繚鐣欏湪 {@link MesNcrDispositionEnum} 涓庡瓧鍏镐腑锛岀敤浜庡巻鍙叉暟鎹樉绀猴紝
+     * 浣嗕笉鍐嶄綔涓鸿川閲忛儴鏈�缁堝缃殑鍙�夐」銆�
+     */
+    private static final Set<Integer> DISPOSITION_ALLOWED_TYPES = Set.of(
+            MesNcrDispositionEnum.SCRAP.getType(),
+            MesNcrDispositionEnum.REWORK.getType(),
+            MesNcrDispositionEnum.CONCESSION.getType(),
+            MesNcrDispositionEnum.REPAIR.getType());
+
     @Resource
     private MesQcNcrMapper ncrMapper;
 
     @Resource
     private MdmItemApi mdmItemApi;
+
+    @Resource
+    private BpmProcessInstanceApi processInstanceApi;
 
     @Resource
     @Lazy
@@ -56,6 +110,42 @@
     @Resource
     @Lazy
     private MesQcRqcService rqcService;
+
+    @Resource
+    @Lazy
+    private MesWmMiscReceiptService miscReceiptService;
+    @Resource
+    @Lazy
+    private MesWmMiscReceiptLineService miscReceiptLineService;
+    @Resource
+    @Lazy
+    private MesWmWarehouseService warehouseService;
+    @Resource
+    @Lazy
+    private MesWmWarehouseLocationService warehouseLocationService;
+    @Resource
+    @Lazy
+    private MesWmWarehouseAreaService warehouseAreaService;
+    @Resource
+    @Lazy
+    private MesWmBatchService batchService;
+    @Resource
+    @Lazy
+    private MesProWorkOrderService workOrderService;
+    @Resource
+    @Lazy
+    private MesMdmItemService mdmItemService;
+    @Resource
+    @Lazy
+    private MesMdItemService mesItemService;
+    @Resource
+    @Lazy
+    private MesMdAutoCodeRecordService autoCodeRecordService;
+
+    /**
+     * 鏉傞」鍏ュ簱鍗曟潵婧愬崟鎹被鍨嬶細涓嶅悎鏍煎搧澶勭悊鍗�
+     */
+    private static final String MISC_RECEIPT_SOURCE_TYPE_NCR = "QC_NCR";
 
     @Override
     @Transactional(rollbackFor = Exception.class)
@@ -105,6 +195,7 @@
                            Integer defectLevel, String reviewOpinion) {
         // 1. 鏍¢獙瀛樺湪 + 寰呰瘎瀹$姸鎬�
         validateNcrStatusPendingReview(id);
+        validateDisposition(disposition);
 
         // 2. 鏇存柊璇勫淇℃伅
         MesQcNcrDO updateObj = new MesQcNcrDO()
@@ -123,21 +214,333 @@
 
     @Override
     @Transactional(rollbackFor = Exception.class)
-    public void disposeNcr(Long id, Long handlerUserId, String handleResult) {
-        // 1. 鏍¢獙瀛樺湪 + 宸茶瘎瀹$姸鎬�
-        MesQcNcrDO ncr = validateNcrExists(id);
+    public MesQcNcrDisposeRespVO disposeNcr(MesQcNcrDisposeReqVO disposeReqVO) {
+        // 1. 鏍¢獙瀛樺湪 + 宸茶瘎瀹★紙瀹℃壒閫氳繃锛夌姸鎬�
+        MesQcNcrDO ncr = validateNcrExists(disposeReqVO.getId());
         if (!MesNcrStatusEnum.REVIEWED.getStatus().equals(ncr.getStatus())) {
-            throw exception(QC_NCR_NOT_REVIEWED);
+            throw exception(QC_NCR_DISPOSE_STATUS_INVALID, ncr.getCode(), resolveStatusName(ncr.getStatus()));
+        }
+        // 2. 澶勭疆鏂瑰紡蹇呭~锛屼笖蹇呴』鏄悎娉曟灇涓惧��
+        validateDisposition(disposeReqVO.getDisposition());
+        // 3. 涓嶅悎鏍兼暟閲忓繀椤诲ぇ浜� 0锛屽惁鍒欐棤娉曠敓鎴愬叆搴撳崟 / 鐢熶骇璁㈠崟
+        if (ncr.getUnqualifiedQuantity() == null
+                || ncr.getUnqualifiedQuantity().compareTo(BigDecimal.ZERO) <= 0) {
+            throw exception(QC_NCR_DISPOSE_QUANTITY_INVALID, ncr.getUnqualifiedQuantity());
         }
 
-        // 2. 鏇存柊澶勭疆淇℃伅
-        // TODO: WM 妯″潡闆嗘垚 鈥� 澶勭疆涓洪��璐ф椂瑙﹀彂渚涘簲鍟嗛��璐э紝澶勭疆涓烘姤搴熸椂瑙﹀彂鏉傞」鍑哄簱
+        // 4. 鎸夊缃柟寮忚仈鍔ㄧ敓鎴愪笟鍔″崟鎹�
+        MesQcNcrDisposeRespVO respVO;
+        if (Objects.equals(MesNcrDispositionEnum.CONCESSION.getType(), disposeReqVO.getDisposition())
+                || Objects.equals(MesNcrDispositionEnum.SCRAP.getType(), disposeReqVO.getDisposition())) {
+            // 璁╂鏀捐 / 鎶ュ簾锛氱敓鎴愭潅椤瑰叆搴撳崟骞惰嚜鍔ㄥ畬鎴愬叆搴�
+            respVO = createMiscReceiptForDispose(ncr, disposeReqVO);
+        } else {
+            // 杩斿伐 / 杩斾慨锛氱敓鎴愯嚜琛岀敓浜х被鍨嬬殑鐢熶骇璁㈠崟
+            respVO = createReworkWorkOrderForDispose(ncr, disposeReqVO);
+        }
+
+        // 5. 鏇存柊澶勭疆淇℃伅锛堝缃柟寮忎互鏈澶勭疆閫夋嫨涓哄噯骞惰惤搴擄級
+        ncrMapper.updateById(new MesQcNcrDO()
+                .setId(ncr.getId())
+                .setDisposition(disposeReqVO.getDisposition())
+                .setHandlerUserId(disposeReqVO.getHandlerUserId())
+                .setHandleDate(LocalDateTime.now())
+                .setHandleResult(disposeReqVO.getHandleResult())
+                .setStatus(MesNcrStatusEnum.DISPOSED.getStatus()));
+        return respVO;
+    }
+
+    /**
+     * 璁╂鏀捐 / 鎶ュ簾锛氱敓鎴愭潅椤瑰叆搴撳崟锛岃嚜鍔ㄦ彁浜ゅ苟瀹屾垚鍏ュ簱
+     */
+    private MesQcNcrDisposeRespVO createMiscReceiptForDispose(MesQcNcrDO ncr, MesQcNcrDisposeReqVO reqVO) {
+        boolean scrap = Objects.equals(MesNcrDispositionEnum.SCRAP.getType(), reqVO.getDisposition());
+        String dispositionName = scrap ? MesNcrDispositionEnum.SCRAP.getName() : MesNcrDispositionEnum.CONCESSION.getName();
+        MesWmMiscReceiptTypeEnum receiptType = scrap
+                ? MesWmMiscReceiptTypeEnum.SCRAP : MesWmMiscReceiptTypeEnum.CONCESSION;
+
+        // 4.1 鏍¢獙鍏ュ簱浠撳簱 / 搴撳尯 / 搴撲綅
+        MesMdmItemDO item = mdmItemService.validateItemExists(ncr.getItemId());
+        if (reqVO.getWarehouseId() == null || reqVO.getLocationId() == null || reqVO.getAreaId() == null) {
+            throw new ServiceException(QC_NCR_DISPOSE_STORAGE_REQUIRED.getCode(),
+                    String.format("澶勭疆鏂瑰紡[%s]闇�瑕佸叆搴撳埌鎸囧畾搴撲綅锛氬綋鍓嶄粨搴揫%s]銆佸簱鍖篬%s]銆佸簱浣峓%s]鏈�夊叏锛�"
+                                    + "璇峰洖鍒板缃脊绐楄ˉ閫夌己澶遍」鍚庨噸鏂版彁浜�",
+                            dispositionName, resolveWarehouseName(reqVO.getWarehouseId()),
+                            resolveLocationName(reqVO.getLocationId()), resolveAreaName(reqVO.getAreaId())));
+        }
+        try {
+            warehouseAreaService.validateWarehouseAreaExists(
+                    reqVO.getWarehouseId(), reqVO.getLocationId(), reqVO.getAreaId());
+        } catch (ServiceException ex) {
+            throw new ServiceException(QC_NCR_DISPOSE_STORAGE_DISABLED.getCode(),
+                    String.format("澶勭疆鏂瑰紡[%s]鎵�閫夊叆搴撳簱浣嶆牎楠屽け璐ワ細浠撳簱[%s]銆佸簱鍖篬%s]銆佸簱浣峓%s]銆傚師鍥狅細%s锛�"
+                                    + "璇峰洖鍒板缃脊绐楅噸鏂伴�夋嫨浠撳簱/搴撳尯/搴撲綅",
+                            dispositionName, resolveWarehouseName(reqVO.getWarehouseId()),
+                            resolveLocationName(reqVO.getLocationId()), resolveAreaName(reqVO.getAreaId()),
+                            ex.getMessage()));
+        }
+
+        // 4.2 鎵规绠$悊鐨勭墿鏂欙細鎵规鍙峰繀濉紝涓嶅瓨鍦ㄦ椂鑷姩鍒涘缓鎵规
+        String batchCode = StrUtil.trimToNull(reqVO.getBatchCode());
+        if (Boolean.TRUE.equals(item.getIsBatchManaged())) {
+            if (batchCode == null) {
+                throw new ServiceException(QC_NCR_DISPOSE_BATCH_REQUIRED.getCode(),
+                        String.format("鐗╂枡[%s]鍚敤浜嗘壒娆$鐞嗭紝澶勭疆鏂瑰紡[%s]鍏ュ簱鏃跺繀椤诲~鍐欐壒娆″彿锛�"
+                                + "璇峰湪澶勭疆寮圭獥鐨刐鎵规鍙穄涓~鍐欏悗閲嶈瘯", buildItemLabel(item), dispositionName));
+            }
+            MesWmBatchGenerateReqVO batchReqVO = new MesWmBatchGenerateReqVO();
+            batchReqVO.setItemId(ncr.getItemId());
+            batchReqVO.setBatchCode(batchCode);
+            batchReqVO.setReceiptDate(LocalDateTime.now());
+            try {
+                batchService.getOrGenerateBatchCode(batchReqVO);
+            } catch (ServiceException ex) {
+                throw new ServiceException(ex.getCode(),
+                        String.format("涓虹墿鏂橻%s]鍑嗗鎵规[%s]澶辫触锛�%s锛涜琛ュ厖鎵规淇℃伅鍚庨噸鏂板缃�",
+                                buildItemLabel(item), batchCode, ex.getMessage()));
+            }
+        }
+
+        // 4.3 鍒涘缓鏉傞」鍏ュ簱鍗�
+        String receiptCode = autoCodeRecordService.generateAutoCode(
+                MesMdAutoCodeRuleCodeEnum.WM_MISC_RECEIPT_CODE.getCode());
+        String receiptName = String.format("%s鍏ュ簱鍗�-%s", dispositionName, ncr.getCode());
+        MesWmMiscReceiptSaveReqVO receiptReqVO = new MesWmMiscReceiptSaveReqVO();
+        receiptReqVO.setCode(receiptCode);
+        receiptReqVO.setName(receiptName);
+        receiptReqVO.setType(receiptType.getType());
+        receiptReqVO.setSourceDocType(MISC_RECEIPT_SOURCE_TYPE_NCR);
+        receiptReqVO.setSourceDocId(ncr.getId());
+        receiptReqVO.setSourceDocCode(ncr.getCode());
+        receiptReqVO.setReceiptDate(LocalDateTime.now());
+        receiptReqVO.setRemark(String.format("鐢变笉鍚堟牸鍝佸鐞嗗崟[%s]澶勭疆涓篬%s]鑷姩鐢熸垚骞跺畬鎴愬叆搴�",
+                ncr.getCode(), dispositionName));
+        Long receiptId = miscReceiptService.createMiscReceipt(receiptReqVO);
+
+        // 4.4 鍒涘缓鍏ュ簱琛岋紙鍚岀墿鏂� / 涓嶅悎鏍兼暟閲� / 鐩爣搴撲綅 / 鎵规鍙凤級
+        MesWmMiscReceiptLineSaveReqVO lineReqVO = new MesWmMiscReceiptLineSaveReqVO();
+        lineReqVO.setReceiptId(receiptId);
+        lineReqVO.setItemId(ncr.getItemId());
+        lineReqVO.setQuantity(ncr.getUnqualifiedQuantity());
+        lineReqVO.setBatchCode(batchCode);
+        lineReqVO.setWarehouseId(reqVO.getWarehouseId());
+        lineReqVO.setLocationId(reqVO.getLocationId());
+        lineReqVO.setAreaId(reqVO.getAreaId());
+        lineReqVO.setRemark(String.format("鏉ユ簮涓嶅悎鏍煎搧澶勭悊鍗昜%s]", ncr.getCode()));
+        miscReceiptLineService.createMiscReceiptLine(lineReqVO);
+
+        // 4.5 鑷姩鎻愪氦骞跺畬鎴愬叆搴擄紙澧炲姞搴撳瓨 + 璁板綍娴佹按锛�
+        miscReceiptService.submitMiscReceipt(receiptId);
+        miscReceiptService.finishMiscReceipt(receiptId);
+
+        MesQcNcrDisposeRespVO respVO = new MesQcNcrDisposeRespVO();
+        respVO.setDisposition(reqVO.getDisposition());
+        respVO.setDocType("MISC_RECEIPT");
+        respVO.setDocId(receiptId);
+        respVO.setDocCode(receiptCode);
+        respVO.setDocName(receiptName);
+        respVO.setMessage(String.format("宸茬敓鎴�%s骞跺畬鎴愬叆搴擄紝鍏ュ簱鍗曞彿[%s]", receiptName, receiptCode));
+        return respVO;
+    }
+
+    /**
+     * 杩斿伐 / 杩斾慨锛氱敓鎴愯嚜琛岀敓浜х被鍨嬬殑鐢熶骇璁㈠崟锛堣崏绋挎�侊紝BOM/鏉$爜鑷姩鐢熸垚锛屽伐鑹鸿矾绾夸汉宸ヨˉ鍏咃級
+     */
+    private MesQcNcrDisposeRespVO createReworkWorkOrderForDispose(MesQcNcrDO ncr, MesQcNcrDisposeReqVO reqVO) {
+        boolean rework = Objects.equals(MesNcrDispositionEnum.REWORK.getType(), reqVO.getDisposition());
+        String dispositionName = rework ? MesNcrDispositionEnum.REWORK.getName() : MesNcrDispositionEnum.REPAIR.getName();
+
+        // 鐢熶骇璁㈠崟鐨勪骇鍝佹槸 MES 浜у搧涓绘暟鎹紙mes_md_item锛夛紝NCR 瀛樼殑鏄� MDM 鐗╂枡锛坢dm_item锛夛紝闇�鍏堟槧灏�
+        MesMdItemDO product = mesItemService.getItemByMdmItemId(ncr.getItemId());
+        if (product == null) {
+            // 鍏煎鍘嗗彶鏁版嵁锛歁ES 浜у搧涓� MDM 鐗╂枡涓婚敭涓�鑷存椂鐩存帴鎸変富閿彇
+            product = mesItemService.getItem(ncr.getItemId());
+        }
+        if (product == null) {
+            MesMdmItemDO mdmItem = mdmItemService.getItem(ncr.getItemId());
+            throw new ServiceException(QC_NCR_DISPOSE_PRODUCT_NOT_EXISTS.getCode(),
+                    String.format("鐗╂枡[%s]鍦� MES 浜у搧涓绘暟鎹腑涓嶅瓨鍦紙MDM 鐗╂枡 ID=%s锛夛紝鏃犳硶鐢熸垚杩斿伐/杩斾慨鐢熶骇璁㈠崟锛�"
+                                    + "璇峰厛鍦╗鐗╂枡浜у搧]涓淮鎶よ浜у搧鍚庡啀澶勭疆",
+                            mdmItem != null ? buildItemLabel(mdmItem) : "鏈煡鐗╂枡", ncr.getItemId()));
+        }
+
+        String workOrderCode = autoCodeRecordService.generateAutoCode(
+                MesMdAutoCodeRuleCodeEnum.PRO_WORK_ORDER_CODE.getCode());
+        String workOrderName = String.format("%s鍗�-%s", dispositionName, ncr.getCode());
+        MesProWorkOrderSaveReqVO workOrderReqVO = new MesProWorkOrderSaveReqVO();
+        workOrderReqVO.setCode(workOrderCode);
+        workOrderReqVO.setName(workOrderName);
+        workOrderReqVO.setType(MesProWorkOrderTypeEnum.SELF.getType());
+        workOrderReqVO.setOrderSourceType(MesProWorkOrderSourceTypeEnum.STORE.getType());
+        workOrderReqVO.setOrderSourceCode(ncr.getCode());
+        workOrderReqVO.setProductId(product.getId());
+        workOrderReqVO.setQuantity(ncr.getUnqualifiedQuantity());
+        workOrderReqVO.setRequestDate(LocalDateTime.now());
+        workOrderReqVO.setRemark(String.format("鐢变笉鍚堟牸鍝佸鐞嗗崟[%s]澶勭疆涓篬%s]鑷姩鐢熸垚锛岃琛ュ厖宸ヨ壓璺嚎鍚庝笅杈�",
+                ncr.getCode(), dispositionName));
+        // 鍑鸿揣妫�楠屾潵婧愮殑 NCR锛氬甫涓婂鎴凤紝婊¤冻浜у搧鎵规閰嶇疆锛坈lientFlag锛夊瀹㈡埛蹇呭~鐨勮姹�
+        Long clientId = resolveSourceClientId(ncr);
+        if (clientId != null) {
+            workOrderReqVO.setClientId(clientId);
+        }
+        Long workOrderId = workOrderService.createWorkOrder(workOrderReqVO);
+
+        MesQcNcrDisposeRespVO respVO = new MesQcNcrDisposeRespVO();
+        respVO.setDisposition(reqVO.getDisposition());
+        respVO.setDocType("WORK_ORDER");
+        respVO.setDocId(workOrderId);
+        respVO.setDocCode(workOrderCode);
+        respVO.setDocName(workOrderName);
+        respVO.setMessage(String.format("宸茬敓鎴�%s[%s]锛岃鍒扮敓浜ц鍗曚腑琛ュ厖宸ヨ壓璺嚎鍚庝笅杈�", workOrderName, workOrderCode));
+        return respVO;
+    }
+
+    /**
+     * 鍙栨潵婧愭楠屽崟涓婄殑瀹㈡埛锛氫粎鍑鸿揣妫�楠岋紙OQC锛夊甫鏈夊鎴蜂俊鎭�
+     */
+    private Long resolveSourceClientId(MesQcNcrDO ncr) {
+        if (!Objects.equals(MesQcTypeEnum.OQC.getType(), ncr.getQcType()) || ncr.getQcId() == null) {
+            return null;
+        }
+        MesQcOqcDO oqc = oqcService.getOqc(ncr.getQcId());
+        return oqc != null ? oqc.getClientId() : null;
+    }
+
+    /**
+     * 鐗╂枡灞曠ず锛氱紪鐮� + 鍚嶇О
+     */
+    private String buildItemLabel(MesMdmItemDO item) {
+        if (item == null) {
+            return "鏈煡鐗╂枡";
+        }
+        String code = StrUtil.blankToDefault(item.getCode(), "");
+        String name = StrUtil.blankToDefault(item.getName(), "");
+        String label = (code + " " + name).trim();
+        return label.isEmpty() ? "ID=" + item.getId() : label;
+    }
+
+    /**
+     * 浠撳簱鍚嶇О锛岃В鏋愬け璐ュ洖閫�涓哄彲璇� ID
+     */
+    private String resolveWarehouseName(Long warehouseId) {
+        if (warehouseId == null) {
+            return "鏈�夋嫨";
+        }
+        MesWmWarehouseDO warehouse = warehouseService.getWarehouse(warehouseId);
+        return warehouse != null && StrUtil.isNotBlank(warehouse.getName())
+                ? warehouse.getName() : "ID=" + warehouseId;
+    }
+
+    /**
+     * 搴撳尯鍚嶇О锛岃В鏋愬け璐ュ洖閫�涓哄彲璇� ID
+     */
+    private String resolveLocationName(Long locationId) {
+        if (locationId == null) {
+            return "鏈�夋嫨";
+        }
+        MesWmWarehouseLocationDO location = warehouseLocationService.getWarehouseLocation(locationId);
+        return location != null && StrUtil.isNotBlank(location.getName())
+                ? location.getName() : "ID=" + locationId;
+    }
+
+    /**
+     * 搴撲綅鍚嶇О锛岃В鏋愬け璐ュ洖閫�涓哄彲璇� ID
+     */
+    private String resolveAreaName(Long areaId) {
+        if (areaId == null) {
+            return "鏈�夋嫨";
+        }
+        MesWmWarehouseAreaDO area = warehouseAreaService.getWarehouseArea(areaId);
+        return area != null && StrUtil.isNotBlank(area.getName())
+                ? area.getName() : "ID=" + areaId;
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void submitNcrApproval(Long id) {
+        // 璇存槑锛欱PM 鐨� createProcessInstance 鍐呴儴閫氳繃 FlowableUtils.executeAuthenticatedUserId 鎵ц锛�
+        // 璇ユ柟娉曚細鎶婃墍鏈夊紓甯哥粺涓�鍖呮垚 RuntimeException锛屽洜姝よ繖閲屼笉鑳界洿鎺� catch ServiceException锛�
+        // 蹇呴』娌� cause 閾惧垽鏂槸鍚︿负銆屾祦绋嬪畾涔変笉瀛樺湪銆嶃��
+        // 1. 鏍¢獙瀛樺湪 + 寰呰瘎瀹★紙鑽夌/瀹℃壒椹冲洖鍚庯級鐘舵��
+        MesQcNcrDO ncr = validateNcrExists(id);
+        if (!MesNcrStatusEnum.PENDING_REVIEW.getStatus().equals(ncr.getStatus())) {
+            throw exception(QC_NCR_SUBMIT_STATUS_INVALID, ncr.getCode(), resolveStatusName(ncr.getStatus()));
+        }
+
+        // 2. 鍏ㄥ眬鍏嶅鎵癸細涓氬姟鏍¢獙閫氳繃鍚庣洿鎺ヨ涓哄鎵归�氳繃锛堝凡璇勫/寰呭缃級锛屾棤闇�娴佺▼妯″瀷
+        if (processInstanceApi.isGlobalAutoApprove()) {
+            ncrMapper.updateById(new MesQcNcrDO()
+                    .setId(id)
+                    .setStatus(MesNcrStatusEnum.REVIEWED.getStatus())
+                    .setProcessInstanceId(""));
+            return;
+        }
+
+        // 3. 鍒涘缓 BPM 娴佺▼瀹炰緥锛涘彇涓嶅埌娴佺▼瀹氫箟鏃舵寜绾﹀畾璧拌嚜鍔ㄩ�氳繃鍏滃簳
+        String processInstanceId;
+        try {
+            processInstanceId = processInstanceApi.createProcessInstance(getLoginUserId(),
+                    new BpmProcessInstanceCreateReqDTO()
+                            .setProcessDefinitionKey(NCR_APPROVAL_PROCESS_KEY)
+                            .setBusinessKey(String.valueOf(id)));
+        } catch (RuntimeException ex) {
+            if (isProcessDefinitionNotExists(ex)) {
+                ncrMapper.updateById(new MesQcNcrDO()
+                        .setId(id)
+                        .setStatus(MesNcrStatusEnum.REVIEWED.getStatus())
+                        .setProcessInstanceId(""));
+                return;
+            }
+            throw ex;
+        }
+
+        // 4. 鏇存柊 NCR 鐘舵�佷负瀹℃壒涓紝骞跺洖鍐欐祦绋嬪疄渚嬬紪鍙�
         ncrMapper.updateById(new MesQcNcrDO()
                 .setId(id)
-                .setHandlerUserId(handlerUserId)
-                .setHandleDate(LocalDateTime.now())
-                .setHandleResult(handleResult)
-                .setStatus(MesNcrStatusEnum.DISPOSED.getStatus()));
+                .setStatus(MesNcrStatusEnum.APPROVING.getStatus())
+                .setProcessInstanceId(processInstanceId));
+    }
+
+    /**
+     * 鍒ゆ柇寮傚父閾句腑鏄惁鍖呭惈銆屾祦绋嬪畾涔変笉瀛樺湪銆嶏紙BPM 瀵瑰浼氬寘涓�灞� RuntimeException锛�
+     */
+    private static boolean isProcessDefinitionNotExists(Throwable ex) {
+        Throwable current = ex;
+        while (current != null) {
+            if (current instanceof ServiceException serviceException
+                    && cn.iocoder.yudao.module.bpm.enums.ErrorCodeConstants.PROCESS_DEFINITION_NOT_EXISTS
+                            .getCode().equals(serviceException.getCode())) {
+                return true;
+            }
+            current = current.getCause();
+        }
+        return false;
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void updateNcrAuditStatus(Long id, Integer bpmResult) {
+        // 1. 鏍¢獙瀛樺湪 + 瀹℃壒涓紙閬垮厤骞跺彂鎴栭噸澶嶅洖璋冭鐩栧凡澶勭疆/宸插叧闂姸鎬侊級
+        MesQcNcrDO ncr = validateNcrExists(id);
+        if (!MesNcrStatusEnum.APPROVING.getStatus().equals(ncr.getStatus())) {
+            return;
+        }
+
+        // 2. 瀹℃壒閫氳繃 -> 宸茶瘎瀹★紙寰呭缃級锛涢┏鍥�/鍙栨秷 -> 寰呰瘎瀹★紙鍙噸鏂颁慨鏀瑰苟鎻愪氦锛�
+        if (BpmProcessInstanceStatusEnum.APPROVE.getStatus().equals(bpmResult)) {
+            ncrMapper.updateById(new MesQcNcrDO()
+                    .setId(id)
+                    .setStatus(MesNcrStatusEnum.REVIEWED.getStatus()));
+            return;
+        }
+        if (BpmProcessInstanceStatusEnum.REJECT.getStatus().equals(bpmResult)
+                || BpmProcessInstanceStatusEnum.CANCEL.getStatus().equals(bpmResult)) {
+            // 淇濈暀 processInstanceId锛氶┏鍥�/鍙栨秷鍚庝粛鍙湪銆屾煡鐪嬪鎵广�嶄腑鏌ョ湅瀹℃壒鎰忚锛�
+            // 閲嶆柊鎻愪氦鏃朵細鐢ㄦ柊娴佺▼瀹炰緥缂栧彿瑕嗙洊銆�
+            ncrMapper.updateById(new MesQcNcrDO()
+                    .setId(id)
+                    .setStatus(MesNcrStatusEnum.PENDING_REVIEW.getStatus()));
+        }
     }
 
     @Override
@@ -146,7 +549,7 @@
         // 1. 鏍¢獙瀛樺湪 + 宸插缃姸鎬�
         MesQcNcrDO ncr = validateNcrExists(id);
         if (!MesNcrStatusEnum.DISPOSED.getStatus().equals(ncr.getStatus())) {
-            throw exception(QC_NCR_NOT_DISPOSED);
+            throw exception(QC_NCR_CLOSE_STATUS_INVALID, ncr.getCode(), resolveStatusName(ncr.getStatus()));
         }
 
         // 2. 鏇存柊鍏抽棴淇℃伅
@@ -164,7 +567,7 @@
     public MesQcNcrDO validateNcrExists(Long id) {
         MesQcNcrDO ncr = ncrMapper.selectById(id);
         if (ncr == null) {
-            throw exception(QC_NCR_NOT_EXISTS);
+            throw exception(QC_NCR_NOT_EXISTS, id);
         }
         return ncr;
     }
@@ -175,9 +578,33 @@
     private MesQcNcrDO validateNcrStatusPendingReview(Long id) {
         MesQcNcrDO ncr = validateNcrExists(id);
         if (!MesNcrStatusEnum.PENDING_REVIEW.getStatus().equals(ncr.getStatus())) {
-            throw exception(QC_NCR_NOT_PENDING_REVIEW);
+            throw exception(QC_NCR_STATUS_NOT_PENDING, ncr.getCode(), resolveStatusName(ncr.getStatus()));
         }
         return ncr;
+    }
+
+    /**
+     * 鏍¢獙澶勭疆鏂瑰紡锛氬繀濉� + 蹇呴』鏄悎娉曟灇涓惧��
+     */
+    private void validateDisposition(Integer disposition) {
+        if (disposition == null) {
+            throw exception(QC_NCR_DISPOSITION_REQUIRED);
+        }
+        if (!DISPOSITION_ALLOWED_TYPES.contains(disposition)) {
+            throw exception(QC_NCR_DISPOSITION_INVALID, disposition);
+        }
+    }
+
+    /**
+     * 鐘舵�佸�艰浆鍚嶇О锛岃В鏋愬け璐ュ洖閫�涓� ID 瀛楃涓�
+     */
+    private String resolveStatusName(Integer status) {
+        for (MesNcrStatusEnum value : MesNcrStatusEnum.values()) {
+            if (value.getStatus().equals(status)) {
+                return value.getName();
+            }
+        }
+        return "ID=" + status;
     }
 
     /**
@@ -186,7 +613,7 @@
     private void validateNcrCodeUnique(Long id, String code) {
         MesQcNcrDO existing = ncrMapper.selectByCode(code);
         if (existing != null && !existing.getId().equals(id)) {
-            throw exception(QC_NCR_CODE_DUPLICATE);
+            throw exception(QC_NCR_CODE_DUPLICATE, code);
         }
     }
 

--
Gitblit v1.9.3