package cn.iocoder.yudao.module.crm.service.refund; 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.refund.vo.CrmRefundPageReqVO; import cn.iocoder.yudao.module.crm.controller.admin.refund.vo.CrmRefundRespVO; import cn.iocoder.yudao.module.crm.controller.admin.refund.vo.CrmRefundSaveReqVO; import cn.iocoder.yudao.module.crm.dal.dataobject.customer.CrmCustomerDO; import cn.iocoder.yudao.module.crm.dal.dataobject.refund.CrmRefundDO; import cn.iocoder.yudao.module.crm.dal.mysql.customer.CrmCustomerMapper; import cn.iocoder.yudao.module.crm.dal.mysql.refund.CrmRefundMapper; import cn.iocoder.yudao.module.crm.enums.ErrorCodeConstants; import cn.iocoder.yudao.module.crm.enums.common.CrmAuditStatusEnum; 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 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 CrmRefundServiceImpl implements CrmRefundService { /** * CRM 退费单审批的业务类型编码 * * 与 system_approval_config.biz_type 对应,审批人在「系统管理 - 审批配置」中维护。 */ private static final String REFUND_APPROVE_BIZ_TYPE = "refund_approve"; @Resource private CrmRefundMapper refundMapper; @Resource private CrmCustomerMapper customerMapper; @Resource private AdminUserApi adminUserApi; @Resource private ApprovalConfigApi approvalConfigApi; @Override @Transactional(rollbackFor = Exception.class) public Long createRefund(CrmRefundSaveReqVO createReqVO) { if (StrUtil.isBlank(createReqVO.getRefundNo())) { createReqVO.setRefundNo(generateRefundNo()); } else if (refundMapper.selectByRefundNo(createReqVO.getRefundNo()) != null) { throw exception(ErrorCodeConstants.CRM_REFUND_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()); // 默认为未提交状态 CrmRefundDO entity = BeanUtils.toBean(createReqVO, CrmRefundDO.class); refundMapper.insert(entity); return entity.getId(); } @Override public void updateRefund(CrmRefundSaveReqVO updateReqVO) { // 1. 校验存在 + 审核通过的退费单不允许修改 CrmRefundDO refund = validateRefundExists(updateReqVO.getId()); if (ObjUtil.equal(refund.getAuditStatus(), CrmAuditStatusEnum.APPROVE.getStatus())) { throw exception(ErrorCodeConstants.CRM_REFUND_UPDATE_FAIL_APPROVE); } // 2. 更新退费单 CrmRefundDO entity = BeanUtils.toBean(updateReqVO, CrmRefundDO.class); entity.setAuditStatus(null); // 审批状态只能由提交/审核变更 refundMapper.updateById(entity); } @Override public void deleteRefund(Long id) { // 校验存在 + 审核通过的退费单不允许删除 CrmRefundDO refund = validateRefundExists(id); if (ObjUtil.equal(refund.getAuditStatus(), CrmAuditStatusEnum.APPROVE.getStatus())) { throw exception(ErrorCodeConstants.CRM_REFUND_DELETE_FAIL_APPROVE); } refundMapper.deleteById(id); } @Override public CrmRefundRespVO getRefund(Long id) { CrmRefundDO entity = refundMapper.selectById(id); return entity == null ? null : BeanUtils.toBean(entity, CrmRefundRespVO.class); } @Override public PageResult getRefundPage(CrmRefundPageReqVO pageReqVO) { return BeanUtils.toBean(refundMapper.selectPage(pageReqVO), CrmRefundRespVO.class); } @Override public List getRefundList(CrmRefundPageReqVO reqVO) { return BeanUtils.toBean(refundMapper.selectList(reqVO), CrmRefundRespVO.class); } @Override @Transactional(rollbackFor = Exception.class) public void submitRefund(Long id) { // 1. 校验存在 + 可提交状态(未提交 / 审核不通过) CrmRefundDO refund = validateRefundExists(id); if (ObjUtil.notEqual(refund.getAuditStatus(), CrmAuditStatusEnum.DRAFT.getStatus()) && ObjUtil.notEqual(refund.getAuditStatus(), CrmAuditStatusEnum.REJECT.getStatus())) { throw exception(ErrorCodeConstants.CRM_REFUND_SUBMIT_FAIL_NOT_EDITABLE); } // 2. 校验审批配置已启用且配置了有效审批人(未配置时抛出带明确提示的业务异常) approvalConfigApi.validateApprovalEnabledAndGetApprovers(REFUND_APPROVE_BIZ_TYPE); // 3. 状态置为审批中,并清空上一轮审核结果,避免残留「审核不通过」的原因 refundMapper.submitAndResetAuditInfo(id, CrmAuditStatusEnum.PROCESS.getStatus()); } @Override public Set getRefundApproverUserIds() { return approvalConfigApi.getApproverUserIds(REFUND_APPROVE_BIZ_TYPE); } @Override @Transactional(rollbackFor = Exception.class) public void auditRefund(Long id, Boolean pass, String reviewRemark) { // 1. 校验存在 CrmRefundDO refund = validateRefundExists(id); // 2. 校验处于审批中状态 if (ObjUtil.notEqual(refund.getAuditStatus(), CrmAuditStatusEnum.PROCESS.getStatus())) { throw exception(ErrorCodeConstants.CRM_REFUND_AUDIT_FAIL_NOT_PROCESS); } // 3. 校验当前登录用户是该业务类型的审批人(或签:任一人均可审核) Long userId = getLoginUserId(); approvalConfigApi.validateApprover(REFUND_APPROVE_BIZ_TYPE, userId); // 4. 审核不通过:必须填写原因,状态置为审核不通过,退回提交人修改后可重新提交 if (!Boolean.TRUE.equals(pass)) { if (StrUtil.isBlank(reviewRemark)) { throw exception(ErrorCodeConstants.CRM_REFUND_AUDIT_REJECT_REASON_REQUIRED); } refundMapper.auditRefund(id, CrmAuditStatusEnum.REJECT.getStatus(), userId, getUserNickname(userId), reviewRemark); return; } // 5. 审核通过:记录审核人与审核意见,状态置为审核通过 refundMapper.auditRefund(id, CrmAuditStatusEnum.APPROVE.getStatus(), userId, getUserNickname(userId), reviewRemark); } private CrmRefundDO validateRefundExists(Long id) { CrmRefundDO refund = refundMapper.selectById(id); if (refund == null) { throw exception(ErrorCodeConstants.CRM_REFUND_NOT_EXISTS); } return refund; } /** * 获取用户昵称 * * @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 generateRefundNo() { return "RF" + LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyyMMddHHmmss")) + RandomUtil.randomNumbers(4); } }