✨ feat(mes): 新增生产流转卡状态管理功能

- 添加状态字段到 MesProCardRespVO 和相关的前端组件 - 实现提交、执行和取消生产流转卡的 API 接口 - 更新 MesProCardService 和 MesProCardServiceImpl 以支持新功能 - 更新前端表单和列表以显示和操作流转卡状态

✨ feat(mes): 新增生产流转卡状态管理功能
- 添加状态字段到 MesProCardRespVO 和相关的前端组件 - 实现提交、执行和取消生产流转卡的 API 接口 - 更新 MesProCardService 和 MesProCardServiceImpl 以支持新功能 - 更新前端表单和列表以显示和操作流转卡状态
YunaiV
1 parent 04a31f39
Showing 7 changed files with 139 additions and 8 deletions
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/pro/card/MesProCardController.java
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/controller/admin/pro/card/vo/MesProCardRespVO.java
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/dal/dataobject/pro/card/MesProCardDO.java
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/service/pro/card/MesProCardProcessServiceImpl.java
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/pro/card/MesProCardService.java
yudao-module-mes/src/main/java/cn/iocoder/yudao/module/mes/service/pro/card/MesProCardServiceImpl.java
@@ -80,6 +80,34 @@ public class MesProCardController {
         return success(true);
     }
  
+    @PutMapping("/submit")
+    @Operation(summary = "提交生产流转卡")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:pro-card:update')")
+    public CommonResult<Boolean> submitCard(@RequestParam("id") Long id) {
+        cardService.submitCard(id);
+        return success(true);
+    }
+
+    // TODO @AI：要不改成 finish，因为它是完成；
+    @PutMapping("/execute")
+    @Operation(summary = "执行生产流转卡")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:pro-card:update')")
+    public CommonResult<Boolean> executeCard(@RequestParam("id") Long id) {
+        cardService.executeCard(id);
+        return success(true);
+    }
+
+    @PutMapping("/cancel")
+    @Operation(summary = "取消生产流转卡")
+    @Parameter(name = "id", description = "编号", required = true)
+    @PreAuthorize("@ss.hasPermission('mes:pro-card:update')")
+    public CommonResult<Boolean> cancelCard(@RequestParam("id") Long id) {
+        cardService.cancelCard(id);
+        return success(true);
+    }
+
     @GetMapping("/get")
     @Operation(summary = "获得生产流转卡")
     @Parameter(name = "id", description = "编号", required = true, example = "1024")
@@ -62,6 +62,10 @@ public class MesProCardRespVO {
     @ExcelProperty("流转数量")
     private BigDecimal transferedQuantity;
  
+    @Schema(description = "状态", example = "0")
+    @ExcelProperty("状态")
+    private Integer status;
+
     @Schema(description = "备注", example = "备注")
     @ExcelProperty("备注")
     private String remark;
@@ -54,7 +54,6 @@ public class MesProCardDO extends BaseDO {
      * 流转数量
      */
     private BigDecimal transferedQuantity;
-    // TODO @芋艿：预留字段，暂未使用；
     /**
      * 状态
      *
@@ -274,6 +274,8 @@ public interface ErrorCodeConstants {
     // ========== MES 生产管理-生产流转卡（1-040-507-000） ==========
     ErrorCode PRO_CARD_NOT_EXISTS = new ErrorCode(1_040_507_000, "生产流转卡不存在");
     ErrorCode PRO_CARD_CODE_DUPLICATE = new ErrorCode(1_040_507_001, "流转卡编码已存在");
+    ErrorCode PRO_CARD_STATUS_ERROR = new ErrorCode(1_040_507_002, "流转卡状态不正确");
+    ErrorCode PRO_CARD_CANCEL_NOT_ALLOWED = new ErrorCode(1_040_507_003, "已完成或已取消的流转卡不允许取消");
     // ========== MES 生产管理-流转卡工序（1-040-507-100） ==========
     ErrorCode PRO_CARD_PROCESS_NOT_EXISTS = new ErrorCode(1_040_507_100, "流转卡工序记录不存在");
  
@@ -6,6 +6,7 @@ import cn.iocoder.yudao.module.mes.controller.admin.pro.card.vo.process.MesProCa
 import cn.iocoder.yudao.module.mes.controller.admin.pro.card.vo.process.MesProCardProcessSaveReqVO;
 import cn.iocoder.yudao.module.mes.dal.dataobject.pro.card.MesProCardProcessDO;
 import cn.iocoder.yudao.module.mes.dal.mysql.pro.card.MesProCardProcessMapper;
+import cn.iocoder.yudao.module.mes.service.pro.process.MesProProcessService;
 import jakarta.annotation.Resource;
 import org.springframework.context.annotation.Lazy;
 import org.springframework.stereotype.Service;
@@ -30,10 +31,18 @@ public class MesProCardProcessServiceImpl implements MesProCardProcessService {
     @Lazy
     private MesProCardService cardService;
  
+    @Resource
+    private MesProProcessService processService;
+
     @Override
     public Long createCardProcess(MesProCardProcessSaveReqVO createReqVO) {
-        // 1. 校验流转卡存在
+        // TODO @AI：validateXXXSaveData
+        // 1.1 校验流转卡存在
         cardService.validateCardExists(createReqVO.getCardId());
+        // 1.2 校验工序存在
+        if (createReqVO.getProcessId() != null) {
+            processService.validateProcessExists(createReqVO.getProcessId());
+        }
  
         // 2. 插入
         MesProCardProcessDO cardProcess = BeanUtils.toBean(createReqVO, MesProCardProcessDO.class);
@@ -45,8 +54,13 @@ public class MesProCardProcessServiceImpl implements MesProCardProcessService {
     public void updateCardProcess(MesProCardProcessSaveReqVO updateReqVO) {
         // 1.1 校验存在
         validateCardProcessExists(updateReqVO.getId());
+        // TODO @AI：validateXXXSaveData
         // 1.2 校验流转卡存在
         cardService.validateCardExists(updateReqVO.getCardId());
+        // 1.3 校验工序存在
+        if (updateReqVO.getProcessId() != null) {
+            processService.validateProcessExists(updateReqVO.getProcessId());
+        }
  
         // 2. 更新
         MesProCardProcessDO updateObj = BeanUtils.toBean(updateReqVO, MesProCardProcessDO.class);
@@ -67,4 +67,25 @@ public interface MesProCardService {
      */
     List<MesProCardDO> getCardSimpleList();
  
+    /**
+     * 提交生产流转卡（草稿 → 已确认）
+     *
+     * @param id 编号
+     */
+    void submitCard(Long id);
+
+    /**
+     * 执行生产流转卡（已确认 → 已完成）
+     *
+     * @param id 编号
+     */
+    void executeCard(Long id);
+
+    /**
+     * 取消生产流转卡（任意非已完成/已取消状态 → 已取消）
+     *
+     * @param id 编号
+     */
+    void cancelCard(Long id);
+
 }
@@ -3,13 +3,14 @@ package cn.iocoder.yudao.module.mes.service.pro.card;
 import cn.hutool.core.util.ObjUtil;
 import cn.iocoder.yudao.framework.common.pojo.PageResult;
 import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
-
-import java.util.List;
+import cn.iocoder.yudao.framework.common.util.object.ObjectUtils;
 import cn.iocoder.yudao.module.mes.controller.admin.pro.card.vo.MesProCardPageReqVO;
 import cn.iocoder.yudao.module.mes.controller.admin.pro.card.vo.MesProCardSaveReqVO;
 import cn.iocoder.yudao.module.mes.dal.dataobject.pro.card.MesProCardDO;
 import cn.iocoder.yudao.module.mes.dal.mysql.pro.card.MesProCardMapper;
+import cn.iocoder.yudao.module.mes.enums.pro.MesProWorkOrderStatusEnum;
 import cn.iocoder.yudao.module.mes.enums.wm.BarcodeBizTypeEnum;
+import cn.iocoder.yudao.module.mes.service.md.item.MesMdItemService;
 import cn.iocoder.yudao.module.mes.service.pro.workorder.MesProWorkOrderService;
 import cn.iocoder.yudao.module.mes.service.wm.barcode.MesWmBarcodeService;
 import jakarta.annotation.Resource;
@@ -18,9 +19,10 @@ import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 import org.springframework.validation.annotation.Validated;
  
+import java.util.List;
+
 import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
-import static cn.iocoder.yudao.module.mes.enums.ErrorCodeConstants.PRO_CARD_CODE_DUPLICATE;
-import static cn.iocoder.yudao.module.mes.enums.ErrorCodeConstants.PRO_CARD_NOT_EXISTS;
+import static cn.iocoder.yudao.module.mes.enums.ErrorCodeConstants.*;
  
 /**
  * MES 生产流转卡 Service 实现类
@@ -42,17 +44,23 @@ public class MesProCardServiceImpl implements MesProCardService {
     @Resource
     private MesProWorkOrderService workOrderService;
     @Resource
+    private MesMdItemService itemService;
+    @Resource
     private MesWmBarcodeService barcodeService;
  
     @Override
     public Long createCard(MesProCardSaveReqVO createReqVO) {
+        // TODO @AI：validateXXXSaveData
         // 1.1 校验编码唯一
         validateCardCodeUnique(null, createReqVO.getCode());
         // 1.2 校验工单存在
         workOrderService.validateWorkOrderExists(createReqVO.getWorkOrderId());
+        // 1.3 校验物料存在
+        itemService.validateItemExists(createReqVO.getItemId());
  
         // 2. 插入
-        MesProCardDO card = BeanUtils.toBean(createReqVO, MesProCardDO.class);
+        MesProCardDO card = BeanUtils.toBean(createReqVO, MesProCardDO.class)
+                .setStatus(MesProWorkOrderStatusEnum.PREPARE.getStatus());
         cardMapper.insert(card);
  
         // 3. 自动生成条码
@@ -63,10 +71,15 @@ public class MesProCardServiceImpl implements MesProCardService {
  
     @Override
     public void updateCard(MesProCardSaveReqVO updateReqVO) {
+        // TODO @AI：validateXXXSaveData
         // 1.1 校验存在
         validateCardExists(updateReqVO.getId());
         // 1.2 校验编码唯一
         validateCardCodeUnique(updateReqVO.getId(), updateReqVO.getCode());
+        // 1.3 校验工单存在
+        workOrderService.validateWorkOrderExists(updateReqVO.getWorkOrderId());
+        // 1.4 校验物料存在
+        itemService.validateItemExists(updateReqVO.getItemId());
  
         // 2. 更新
         MesProCardDO updateObj = BeanUtils.toBean(updateReqVO, MesProCardDO.class);
@@ -99,13 +112,63 @@ public class MesProCardServiceImpl implements MesProCardService {
         return cardMapper.selectList();
     }
  
+    @Override
+    public void submitCard(Long id) {
+        // 1. 校验存在 + 草稿状态
+        validateCardExistsAndStatus(id, MesProWorkOrderStatusEnum.PREPARE);
+
+        // 2. 提交（草稿 → 已确认）
+        cardMapper.updateById(new MesProCardDO()
+                .setId(id).setStatus(MesProWorkOrderStatusEnum.CONFIRMED.getStatus()));
+    }
+
+    @Override
+    public void executeCard(Long id) {
+        // 1. 校验存在 + 已确认状态
+        validateCardExistsAndStatus(id, MesProWorkOrderStatusEnum.CONFIRMED);
+
+        // 2. 执行（已确认 → 已完成）
+        cardMapper.updateById(new MesProCardDO()
+                .setId(id).setStatus(MesProWorkOrderStatusEnum.FINISHED.getStatus()));
+    }
+
+    @Override
+    public void cancelCard(Long id) {
+        // 1.1 校验存在
+        MesProCardDO card = validateCardExistsInternal(id);
+        // 1.2 已完成和已取消不允许取消
+        if (ObjectUtils.equalsAny(card.getStatus(),
+                MesProWorkOrderStatusEnum.FINISHED.getStatus(),
+                MesProWorkOrderStatusEnum.CANCELED.getStatus())) {
+            throw exception(PRO_CARD_CANCEL_NOT_ALLOWED);
+        }
+
+        // 2. 取消
+        cardMapper.updateById(new MesProCardDO()
+                .setId(id).setStatus(MesProWorkOrderStatusEnum.CANCELED.getStatus()));
+    }
+
     // ==================== 校验方法 ====================
  
     @Override
     public void validateCardExists(Long id) {
-        if (cardMapper.selectById(id) == null) {
+        validateCardExistsInternal(id);
+    }
+
+    private MesProCardDO validateCardExistsInternal(Long id) {
+        MesProCardDO card = cardMapper.selectById(id);
+        if (card == null) {
             throw exception(PRO_CARD_NOT_EXISTS);
         }
+        return card;
+    }
+
+    private MesProCardDO validateCardExistsAndStatus(Long id, MesProWorkOrderStatusEnum status) {
+        MesProCardDO card = validateCardExistsInternal(id);
+        if (ObjUtil.notEqual(status.getStatus(), card.getStatus())) {
+            throw exception(PRO_CARD_STATUS_ERROR);
+        }
+        return card;
     }
  
     private void validateCardCodeUnique(Long id, String code) {