package cn.iocoder.yudao.module.crm.service.cancellation; import cn.hutool.core.util.ObjUtil; import cn.hutool.core.util.RandomUtil; import cn.hutool.core.util.StrUtil; import cn.iocoder.yudao.framework.common.pojo.PageResult; import cn.iocoder.yudao.framework.common.util.object.BeanUtils; import cn.iocoder.yudao.module.crm.controller.admin.cancellation.vo.CrmCancellationPageReqVO; import cn.iocoder.yudao.module.crm.controller.admin.cancellation.vo.CrmCancellationRespVO; import cn.iocoder.yudao.module.crm.controller.admin.cancellation.vo.CrmCancellationSaveReqVO; import cn.iocoder.yudao.module.crm.dal.dataobject.cancellation.CrmCancellationDO; import cn.iocoder.yudao.module.crm.dal.dataobject.customer.CrmCustomerDO; import cn.iocoder.yudao.module.crm.dal.mysql.cancellation.CrmCancellationMapper; import cn.iocoder.yudao.module.crm.dal.mysql.customer.CrmCustomerMapper; import cn.iocoder.yudao.module.crm.enums.ErrorCodeConstants; import cn.iocoder.yudao.module.crm.enums.common.CrmAuditStatusEnum; 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.BpmTaskStatusEnum; import cn.iocoder.yudao.module.system.api.approval.ApprovalConfigApi; import cn.iocoder.yudao.module.system.api.user.AdminUserApi; import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO; import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper; import jakarta.annotation.Resource; import lombok.extern.slf4j.Slf4j; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; import org.springframework.validation.annotation.Validated; import java.time.LocalDateTime; import java.time.format.DateTimeFormatter; import java.util.List; import java.util.Set; import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception; import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId; @Service @Validated @Slf4j public class CrmCancellationServiceImpl implements CrmCancellationService { /** * CRM 销户申请审批的业务类型编码 * * 与 system_approval_config.biz_type 对应,审批人在「系统管理 - 审批配置」中维护。 */ private static final String CANCELLATION_APPROVE_BIZ_TYPE = "cancellation_approve"; /** * CRM 销户申请审批的 BPM 流程定义 Key */ private static final String CANCELLATION_APPROVE_PROCESS_KEY = "cancellation_approve"; @Resource private CrmCancellationMapper cancellationMapper; @Resource private CrmCustomerMapper customerMapper; @Resource private AdminUserApi adminUserApi; @Resource private ApprovalConfigApi approvalConfigApi; @Resource private BpmProcessInstanceApi bpmProcessInstanceApi; @Override @Transactional(rollbackFor = Exception.class) public Long createCancellation(CrmCancellationSaveReqVO createReqVO) { if (StrUtil.isBlank(createReqVO.getCancellationNo())) { createReqVO.setCancellationNo(generateCancellationNo()); } else if (cancellationMapper.selectByCancellationNo(createReqVO.getCancellationNo()) != null) { throw exception(ErrorCodeConstants.CRM_CANCELLATION_NO_DUPLICATE); } CrmCustomerDO customer = customerMapper.selectById(createReqVO.getCustomerId()); if (customer == null) { throw exception(ErrorCodeConstants.CUSTOMER_NOT_EXISTS); } if (StrUtil.isBlank(createReqVO.getCustomerName())) { createReqVO.setCustomerName(customer.getName()); } if (createReqVO.getApplyTime() == null) { createReqVO.setApplyTime(LocalDateTime.now()); } createReqVO.setAuditStatus(CrmAuditStatusEnum.DRAFT.getStatus()); // 默认为未提交状态 CrmCancellationDO entity = BeanUtils.toBean(createReqVO, CrmCancellationDO.class); cancellationMapper.insert(entity); return entity.getId(); } @Override public void updateCancellation(CrmCancellationSaveReqVO updateReqVO) { // 1. 校验存在 + 只有草稿、审核不通过可以修改 CrmCancellationDO cancellation = validateCancellationExists(updateReqVO.getId()); if (ObjUtil.notEqual(cancellation.getAuditStatus(), CrmAuditStatusEnum.DRAFT.getStatus()) && ObjUtil.notEqual(cancellation.getAuditStatus(), CrmAuditStatusEnum.REJECT.getStatus())) { throw exception(ErrorCodeConstants.CRM_CANCELLATION_UPDATE_FAIL_NOT_EDITABLE); } // 2. 更新销户申请;审批状态与审核结果只能由提交/审核变更,此处显式清空 CrmCancellationDO entity = BeanUtils.toBean(updateReqVO, CrmCancellationDO.class); // 审核相关字段只能由提交/审核变更 entity.setAuditStatus(null); entity.setReviewerId(null); entity.setReviewerName(null); entity.setReviewTime(null); entity.setReviewRemark(null); cancellationMapper.update(entity, new LambdaUpdateWrapper() .eq(CrmCancellationDO::getId, entity.getId()) .set(CrmCancellationDO::getAuditStatus, null) .set(CrmCancellationDO::getReviewerId, null) .set(CrmCancellationDO::getReviewerName, null) .set(CrmCancellationDO::getReviewTime, null) .set(CrmCancellationDO::getReviewRemark, null)); } @Override public void deleteCancellation(Long id) { // 校验存在 + 只有草稿、审核不通过可以删除 CrmCancellationDO cancellation = validateCancellationExists(id); if (ObjUtil.notEqual(cancellation.getAuditStatus(), CrmAuditStatusEnum.DRAFT.getStatus()) && ObjUtil.notEqual(cancellation.getAuditStatus(), CrmAuditStatusEnum.REJECT.getStatus())) { throw exception(ErrorCodeConstants.CRM_CANCELLATION_DELETE_FAIL_NOT_EDITABLE); } cancellationMapper.deleteById(id); } @Override public CrmCancellationRespVO getCancellation(Long id) { CrmCancellationDO entity = cancellationMapper.selectById(id); return entity == null ? null : BeanUtils.toBean(entity, CrmCancellationRespVO.class); } @Override public PageResult getCancellationPage(CrmCancellationPageReqVO pageReqVO) { return BeanUtils.toBean(cancellationMapper.selectPage(pageReqVO), CrmCancellationRespVO.class); } @Override public List getCancellationList(CrmCancellationPageReqVO reqVO) { return BeanUtils.toBean(cancellationMapper.selectList(reqVO), CrmCancellationRespVO.class); } @Override @Transactional(rollbackFor = Exception.class) public void submitCancellation(Long id) { // 1. 校验存在 + 可提交状态(未提交 / 审核不通过) CrmCancellationDO cancellation = validateCancellationExists(id); if (ObjUtil.notEqual(cancellation.getAuditStatus(), CrmAuditStatusEnum.DRAFT.getStatus()) && ObjUtil.notEqual(cancellation.getAuditStatus(), CrmAuditStatusEnum.REJECT.getStatus())) { throw exception(ErrorCodeConstants.CRM_CANCELLATION_SUBMIT_FAIL_NOT_EDITABLE); } // 2. 校验审批配置已启用且配置了有效审批人(未配置时抛出带明确提示的业务异常) approvalConfigApi.validateApprovalEnabledAndGetApprovers(CANCELLATION_APPROVE_BIZ_TYPE); // 3. 状态置为审批中,并清空上一轮审核结果,避免残留「审核不通过」的原因 if (cancellationMapper.submitAndResetAuditInfo(id, CrmAuditStatusEnum.PROCESS.getStatus()) != 1) { throw exception(ErrorCodeConstants.CRM_CANCELLATION_SUBMIT_FAIL_NOT_EDITABLE); } // 4. 创建 BPM 流程实例,使审批出现在「协同办公 - 我的流程」 bpmProcessInstanceApi.createProcessInstance(getLoginUserId(), new BpmProcessInstanceCreateReqDTO() .setProcessDefinitionKey(CANCELLATION_APPROVE_PROCESS_KEY) .setBusinessKey(String.valueOf(id))); } @Override public Set getCancellationApproverUserIds() { return approvalConfigApi.getApproverUserIds(CANCELLATION_APPROVE_BIZ_TYPE); } @Override @Transactional(rollbackFor = Exception.class) public void auditCancellation(Long id, Boolean pass, String reviewRemark) { // 1. 校验存在 CrmCancellationDO cancellation = validateCancellationExists(id); // 2. 校验处于审批中状态 if (ObjUtil.notEqual(cancellation.getAuditStatus(), CrmAuditStatusEnum.PROCESS.getStatus())) { throw exception(ErrorCodeConstants.CRM_CANCELLATION_AUDIT_FAIL_NOT_PROCESS); } // 3. 校验当前登录用户是该业务类型的审批人(或签:任一人均可审核) Long userId = getLoginUserId(); approvalConfigApi.validateApprover(CANCELLATION_APPROVE_BIZ_TYPE, userId); // 4. 审核不通过:必须填写原因,状态置为审核不通过,退回提交人修改后可重新提交 if (!Boolean.TRUE.equals(pass)) { if (StrUtil.isBlank(reviewRemark)) { throw exception(ErrorCodeConstants.CRM_CANCELLATION_AUDIT_REJECT_REASON_REQUIRED); } if (cancellationMapper.auditCancellation(id, CrmAuditStatusEnum.REJECT.getStatus(), userId, getUserNickname(userId), reviewRemark) != 1) { throw exception(ErrorCodeConstants.CRM_CANCELLATION_AUDIT_FAIL_NOT_PROCESS); } return; } // 5. 审核通过:记录审核人与审核意见,状态置为审核通过 if (cancellationMapper.auditCancellation(id, CrmAuditStatusEnum.APPROVE.getStatus(), userId, getUserNickname(userId), reviewRemark) != 1) { throw exception(ErrorCodeConstants.CRM_CANCELLATION_AUDIT_FAIL_NOT_PROCESS); } } @Override @Transactional(rollbackFor = Exception.class) public void updateCancellationAuditStatus(Long id, Integer bpmStatus, String reason) { // BPM 审批结果映射为销户申请审核状态:通过=20 / 不通过=30 / 取消=40 Integer auditStatus; if (BpmTaskStatusEnum.APPROVE.getStatus().equals(bpmStatus)) { auditStatus = CrmAuditStatusEnum.APPROVE.getStatus(); } else if (BpmTaskStatusEnum.REJECT.getStatus().equals(bpmStatus)) { auditStatus = CrmAuditStatusEnum.REJECT.getStatus(); } else if (BpmTaskStatusEnum.CANCEL.getStatus().equals(bpmStatus)) { auditStatus = CrmAuditStatusEnum.CANCEL.getStatus(); } else { return; } if (cancellationMapper.updateAuditStatusByBpm(id, auditStatus, reason) != 1) { log.warn("[updateCancellationAuditStatus] 销户申请({}) 不处于审批中状态,忽略 BPM 结果({})", id, bpmStatus); } } private CrmCancellationDO validateCancellationExists(Long id) { CrmCancellationDO cancellation = cancellationMapper.selectById(id); if (cancellation == null) { throw exception(ErrorCodeConstants.CRM_CANCELLATION_NOT_EXISTS); } return cancellation; } /** * 获取用户昵称 * * @param userId 用户编号 * @return 昵称,用户不存在时返回 null */ private String getUserNickname(Long userId) { if (userId == null) { return null; } AdminUserRespDTO user = adminUserApi.getUser(userId); return user == null ? null : user.getNickname(); } private String generateCancellationNo() { return "CL" + LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyyMMddHHmmss")) + RandomUtil.randomNumbers(4); } }