package cn.iocoder.yudao.module.aftersales.service.compensation;
|
|
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.aftersales.controller.admin.compensation.vo.AfterSaleCompensationPageReqVO;
|
import cn.iocoder.yudao.module.aftersales.controller.admin.compensation.vo.AfterSaleCompensationSaveReqVO;
|
import cn.iocoder.yudao.module.aftersales.dal.dataobject.compensation.AfterSaleCompensationDO;
|
import cn.iocoder.yudao.module.aftersales.dal.mysql.compensation.AfterSaleCompensationMapper;
|
import cn.iocoder.yudao.module.aftersales.enums.AfterSaleCompensationAuditStatusEnum;
|
import cn.iocoder.yudao.module.aftersales.enums.ErrorCodeConstants;
|
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 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.Set;
|
|
import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
|
import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
|
|
/**
|
* 售后赔付/服务补偿单 Service 实现类
|
*/
|
@Service
|
@Validated
|
@Slf4j
|
public class AfterSaleCompensationServiceImpl implements AfterSaleCompensationService {
|
|
/**
|
* 赔付单审批的业务类型编码
|
*
|
* 与 system_approval_config.biz_type 对应，审批人在「系统管理 - 审批配置」中维护。
|
*/
|
private static final String COMPENSATION_APPROVE_BIZ_TYPE = "compensation_approve";
|
|
/**
|
* 赔付单审批的 BPM 流程定义 Key
|
*/
|
private static final String COMPENSATION_APPROVE_PROCESS_KEY = "compensation_approve";
|
|
@Resource
|
private AfterSaleCompensationMapper compensationMapper;
|
@Resource
|
private ApprovalConfigApi approvalConfigApi;
|
@Resource
|
private AdminUserApi adminUserApi;
|
@Resource
|
private BpmProcessInstanceApi bpmProcessInstanceApi;
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public Long createCompensation(AfterSaleCompensationSaveReqVO createReqVO) {
|
String compensationNo = generateCompensationNo();
|
if (compensationMapper.selectByCompensationNo(compensationNo) != null) {
|
throw exception(ErrorCodeConstants.COMPENSATION_NO_EXISTS);
|
}
|
AfterSaleCompensationDO entity = BeanUtils.toBean(createReqVO, AfterSaleCompensationDO.class, req -> req
|
.setCompensationNo(compensationNo)
|
.setAuditStatus(AfterSaleCompensationAuditStatusEnum.DRAFT.getStatus()));
|
compensationMapper.insert(entity);
|
return entity.getId();
|
}
|
|
@Override
|
public void updateCompensation(AfterSaleCompensationSaveReqVO updateReqVO) {
|
AfterSaleCompensationDO exists = compensationMapper.selectById(updateReqVO.getId());
|
if (exists == null) {
|
throw exception(ErrorCodeConstants.COMPENSATION_NOT_EXISTS);
|
}
|
if (ObjUtil.notEqual(exists.getAuditStatus(), AfterSaleCompensationAuditStatusEnum.DRAFT.getStatus())
|
&& ObjUtil.notEqual(exists.getAuditStatus(), AfterSaleCompensationAuditStatusEnum.REJECT.getStatus())) {
|
throw exception(ErrorCodeConstants.COMPENSATION_UPDATE_FAIL_NOT_EDITABLE);
|
}
|
AfterSaleCompensationDO entity = BeanUtils.toBean(updateReqVO, AfterSaleCompensationDO.class, req -> req
|
.setCompensationNo(exists.getCompensationNo())
|
.setAuditStatus(exists.getAuditStatus()));
|
compensationMapper.updateById(entity);
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void deleteCompensation(Long id) {
|
AfterSaleCompensationDO exists = compensationMapper.selectById(id);
|
if (exists == null) {
|
throw exception(ErrorCodeConstants.COMPENSATION_NOT_EXISTS);
|
}
|
if (ObjUtil.notEqual(exists.getAuditStatus(), AfterSaleCompensationAuditStatusEnum.DRAFT.getStatus())) {
|
throw exception(ErrorCodeConstants.COMPENSATION_DELETE_FAIL_NOT_DRAFT);
|
}
|
compensationMapper.deleteById(id);
|
}
|
|
@Override
|
public AfterSaleCompensationDO getCompensation(Long id) {
|
return compensationMapper.selectById(id);
|
}
|
|
@Override
|
public PageResult<AfterSaleCompensationDO> getCompensationPage(AfterSaleCompensationPageReqVO pageReqVO) {
|
return compensationMapper.selectPage(pageReqVO);
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void submitCompensation(Long id) {
|
// 1. 校验存在 + 可提交状态（未提交 / 审核不通过）
|
AfterSaleCompensationDO compensation = validateCompensationExists(id);
|
if (ObjUtil.notEqual(compensation.getAuditStatus(), AfterSaleCompensationAuditStatusEnum.DRAFT.getStatus())
|
&& ObjUtil.notEqual(compensation.getAuditStatus(), AfterSaleCompensationAuditStatusEnum.REJECT.getStatus())) {
|
throw exception(ErrorCodeConstants.COMPENSATION_SUBMIT_FAIL_NOT_EDITABLE);
|
}
|
|
// 2. 校验审批配置已启用且配置了有效审批人（未配置时抛出带明确提示的业务异常）
|
approvalConfigApi.validateApprovalEnabledAndGetApprovers(COMPENSATION_APPROVE_BIZ_TYPE);
|
|
// 3. 状态置为审批中，并清空上一轮审核结果，避免残留「审核不通过」的原因
|
if (compensationMapper.submitAndResetAuditInfo(id,
|
AfterSaleCompensationAuditStatusEnum.PROCESS.getStatus()) != 1) {
|
throw exception(ErrorCodeConstants.COMPENSATION_SUBMIT_FAIL_NOT_EDITABLE);
|
}
|
|
// 4. 创建 BPM 流程实例，使审批出现在「协同办公 - 我的流程」
|
bpmProcessInstanceApi.createProcessInstance(getLoginUserId(),
|
new BpmProcessInstanceCreateReqDTO()
|
.setProcessDefinitionKey(COMPENSATION_APPROVE_PROCESS_KEY)
|
.setBusinessKey(String.valueOf(id)));
|
}
|
|
@Override
|
public Set<Long> getCompensationApproverUserIds() {
|
return approvalConfigApi.getApproverUserIds(COMPENSATION_APPROVE_BIZ_TYPE);
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void auditCompensation(Long id, Boolean pass, String reviewRemark) {
|
// 1. 校验存在
|
AfterSaleCompensationDO compensation = validateCompensationExists(id);
|
// 2. 校验处于审批中状态
|
if (ObjUtil.notEqual(compensation.getAuditStatus(), AfterSaleCompensationAuditStatusEnum.PROCESS.getStatus())) {
|
throw exception(ErrorCodeConstants.COMPENSATION_AUDIT_FAIL_NOT_PROCESS);
|
}
|
// 3. 校验当前登录用户是该业务类型的审批人（或签：任一人均可审核）
|
Long userId = getLoginUserId();
|
approvalConfigApi.validateApprover(COMPENSATION_APPROVE_BIZ_TYPE, userId);
|
// 4. 审核不通过：必须填写原因，状态置为审核不通过，退回提交人修改后可重新提交
|
if (!Boolean.TRUE.equals(pass)) {
|
if (StrUtil.isBlank(reviewRemark)) {
|
throw exception(ErrorCodeConstants.COMPENSATION_AUDIT_REJECT_REASON_REQUIRED);
|
}
|
if (compensationMapper.auditCompensation(id, AfterSaleCompensationAuditStatusEnum.REJECT.getStatus(),
|
userId, getUserNickname(userId), reviewRemark) != 1) {
|
throw exception(ErrorCodeConstants.COMPENSATION_AUDIT_FAIL_NOT_PROCESS);
|
}
|
return;
|
}
|
// 5. 审核通过：记录审核人与审核意见，状态置为审核通过
|
if (compensationMapper.auditCompensation(id, AfterSaleCompensationAuditStatusEnum.APPROVE.getStatus(),
|
userId, getUserNickname(userId), reviewRemark) != 1) {
|
throw exception(ErrorCodeConstants.COMPENSATION_AUDIT_FAIL_NOT_PROCESS);
|
}
|
// 6. 审核通过后的后置业务逻辑：当前赔付单审批通过后无自动生成下游单据的动作，
|
// 支付状态（payStatus）待后续接入财务模块时再联动。
|
}
|
|
@Override
|
public void updateCompensationAuditStatus(Long id, Integer bpmStatus, String reason) {
|
// BPM 审批结果映射为赔付单审核状态：通过=20 / 不通过=30 / 取消=40
|
Integer auditStatus;
|
if (BpmTaskStatusEnum.APPROVE.getStatus().equals(bpmStatus)) {
|
auditStatus = AfterSaleCompensationAuditStatusEnum.APPROVE.getStatus();
|
} else if (BpmTaskStatusEnum.REJECT.getStatus().equals(bpmStatus)) {
|
auditStatus = AfterSaleCompensationAuditStatusEnum.REJECT.getStatus();
|
} else if (BpmTaskStatusEnum.CANCEL.getStatus().equals(bpmStatus)) {
|
auditStatus = AfterSaleCompensationAuditStatusEnum.CANCEL.getStatus();
|
} else {
|
return;
|
}
|
if (compensationMapper.updateAuditStatusByBpm(id, auditStatus, reason) != 1) {
|
log.warn("[updateCompensationAuditStatus] 赔付单({}) 不处于审批中状态，忽略 BPM 结果({})", id, bpmStatus);
|
}
|
}
|
|
private AfterSaleCompensationDO validateCompensationExists(Long id) {
|
AfterSaleCompensationDO compensation = compensationMapper.selectById(id);
|
if (compensation == null) {
|
throw exception(ErrorCodeConstants.COMPENSATION_NOT_EXISTS);
|
}
|
return compensation;
|
}
|
|
/**
|
* 获取用户昵称
|
*
|
* @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 generateCompensationNo() {
|
return "PS" + LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyyMMddHHmmss"))
|
+ RandomUtil.randomNumbers(4);
|
}
|
|
}
|
