package cn.iocoder.yudao.module.mes.service.wm.returnvendor;
|
|
import cn.hutool.core.collection.CollUtil;
|
import cn.hutool.core.util.ObjUtil;
|
import cn.iocoder.yudao.framework.common.pojo.PageResult;
|
import cn.iocoder.yudao.framework.common.util.collection.CollectionUtils;
|
import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
|
import cn.iocoder.yudao.framework.common.util.object.ObjectUtils;
|
import cn.iocoder.yudao.module.mes.controller.admin.wm.returnvendor.vo.MesWmReturnVendorPageReqVO;
|
import cn.iocoder.yudao.module.mes.controller.admin.wm.returnvendor.vo.MesWmReturnVendorSaveReqVO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.wm.returnvendor.MesWmReturnVendorDO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.wm.returnvendor.MesWmReturnVendorDetailDO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.wm.returnvendor.MesWmReturnVendorLineDO;
|
import cn.iocoder.yudao.module.mes.dal.mysql.wm.returnvendor.MesWmReturnVendorMapper;
|
import cn.iocoder.yudao.module.mes.enums.MesBizTypeConstants;
|
import cn.iocoder.yudao.module.mes.enums.wm.MesWmReturnVendorStatusEnum;
|
import cn.iocoder.yudao.module.mes.enums.wm.MesWmTransactionTypeEnum;
|
import cn.iocoder.yudao.module.srm.api.supplier.SrmSupplierApi;
|
import cn.iocoder.yudao.module.mes.service.wm.transaction.MesWmTransactionService;
|
import cn.iocoder.yudao.module.mes.service.wm.transaction.dto.MesWmTransactionSaveReqDTO;
|
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.dal.dataobject.definition.BpmProcessDefinitionInfoDO;
|
import cn.iocoder.yudao.module.bpm.enums.task.BpmTaskStatusEnum;
|
import cn.iocoder.yudao.module.bpm.service.definition.BpmProcessDefinitionService;
|
import jakarta.annotation.Resource;
|
import lombok.extern.slf4j.Slf4j;
|
import org.flowable.engine.repository.ProcessDefinition;
|
import org.springframework.security.core.Authentication;
|
import org.springframework.security.core.context.SecurityContextHolder;
|
import org.springframework.stereotype.Service;
|
import org.springframework.transaction.annotation.Transactional;
|
import org.springframework.validation.annotation.Validated;
|
|
import java.math.BigDecimal;
|
import java.util.*;
|
|
import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
|
import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
|
import static cn.iocoder.yudao.module.mes.enums.ErrorCodeConstants.*;
|
|
/**
|
* MES 供应商退货单 Service 实现类
|
*/
|
@Service
|
@Validated
|
@Slf4j
|
public class MesWmReturnVendorServiceImpl implements MesWmReturnVendorService {
|
|
@Resource
|
private MesWmReturnVendorMapper returnVendorMapper;
|
|
@Resource
|
private MesWmReturnVendorLineService returnVendorLineService;
|
@Resource
|
private MesWmReturnVendorDetailService returnVendorDetailService;
|
@Resource
|
private SrmSupplierApi srmSupplierApi;
|
@Resource
|
private MesWmTransactionService wmTransactionService;
|
@Resource
|
private BpmProcessInstanceApi processInstanceApi;
|
@Resource
|
private BpmProcessDefinitionService bpmProcessDefinitionService;
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public Long createReturnVendor(MesWmReturnVendorSaveReqVO createReqVO) {
|
// 1. 校验数据
|
validateReturnVendorSaveData(createReqVO);
|
|
// 2. 插入主表
|
MesWmReturnVendorDO returnVendor = BeanUtils.toBean(createReqVO, MesWmReturnVendorDO.class);
|
returnVendor.setStatus(MesWmReturnVendorStatusEnum.PREPARE.getStatus());
|
returnVendorMapper.insert(returnVendor);
|
return returnVendor.getId();
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void updateReturnVendor(MesWmReturnVendorSaveReqVO updateReqVO) {
|
// 1. 校验数据
|
validateReturnVendorSaveData(updateReqVO);
|
|
// 2. 更新主表
|
MesWmReturnVendorDO updateObj = BeanUtils.toBean(updateReqVO, MesWmReturnVendorDO.class);
|
returnVendorMapper.updateById(updateObj);
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void deleteReturnVendor(Long id) {
|
// 1. 校验存在 + 准备中状态
|
validateReturnVendorExistsAndPrepare(id);
|
|
// 2.1 级联删除明细
|
returnVendorDetailService.deleteReturnVendorDetailByReturnId(id);
|
// 2.2 级联删除行
|
returnVendorLineService.deleteReturnVendorLineByReturnId(id);
|
// 2.3 删除主表
|
returnVendorMapper.deleteById(id);
|
}
|
|
@Override
|
public MesWmReturnVendorDO getReturnVendor(Long id) {
|
return returnVendorMapper.selectById(id);
|
}
|
|
@Override
|
public PageResult<MesWmReturnVendorDO> getReturnVendorPage(MesWmReturnVendorPageReqVO pageReqVO) {
|
return returnVendorMapper.selectPage(pageReqVO);
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void submitReturnVendorApproval(Long id, String processDefinitionKey) {
|
// 校验存在 + 草稿状态
|
validateReturnVendorExistsAndPrepare(id);
|
// 校验至少有一条行
|
List<MesWmReturnVendorLineDO> lines = returnVendorLineService.getReturnVendorLineListByReturnId(id);
|
if (CollUtil.isEmpty(lines)) {
|
throw exception(WM_RETURN_VENDOR_NO_LINE);
|
}
|
// 创建 BPM 流程实例
|
String processInstanceId = processInstanceApi.createProcessInstance(getCurrentUserId(),
|
new BpmProcessInstanceCreateReqDTO()
|
.setProcessDefinitionKey(processDefinitionKey)
|
.setBusinessKey(String.valueOf(id)));
|
// 提交审批（草稿 → 审批中）
|
returnVendorMapper.updateById(new MesWmReturnVendorDO()
|
.setId(id)
|
.setStatus(MesWmReturnVendorStatusEnum.APPROVING.getStatus())
|
.setProcessInstanceId(processInstanceId));
|
}
|
|
@Override
|
public List<Map<String, Object>> getReturnVendorApprovalProcessDefinitionList() {
|
return getProcessDefinitionListByCategory(APPROVE_CATEGORY_CODE);
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void updateReturnVendorAuditStatus(Long id, Integer bpmResult) {
|
// 1. 校验存在
|
MesWmReturnVendorDO returnVendor = validateReturnVendorExists(id);
|
if (!MesWmReturnVendorStatusEnum.APPROVING.getStatus().equals(returnVendor.getStatus())) {
|
log.warn("[updateReturnVendorAuditStatus] 供应商退货单({}) 不处于审批中状态", id);
|
return;
|
}
|
// 2. 根据审批结果更新状态
|
Integer newStatus = convertBpmResultToStatus(bpmResult);
|
if (newStatus != null) {
|
returnVendorMapper.updateById(new MesWmReturnVendorDO().setId(id).setStatus(newStatus));
|
}
|
}
|
|
private Integer convertBpmResultToStatus(Integer bpmResult) {
|
if (BpmTaskStatusEnum.APPROVE.getStatus().equals(bpmResult)) {
|
return MesWmReturnVendorStatusEnum.APPROVED.getStatus();
|
}
|
if (BpmTaskStatusEnum.REJECT.getStatus().equals(bpmResult)) {
|
return MesWmReturnVendorStatusEnum.PREPARE.getStatus();
|
}
|
if (BpmTaskStatusEnum.CANCEL.getStatus().equals(bpmResult)) {
|
return MesWmReturnVendorStatusEnum.CANCELED.getStatus();
|
}
|
return null;
|
}
|
|
private List<Map<String, Object>> getProcessDefinitionListByCategory(String categoryCode) {
|
List<BpmProcessDefinitionInfoDO> definitionInfoList = bpmProcessDefinitionService
|
.getProcessDefinitionInfoListByCategory(categoryCode);
|
if (CollUtil.isEmpty(definitionInfoList)) {
|
return Collections.emptyList();
|
}
|
// 过滤激活状态，保留最新版本
|
Map<String, ProcessDefinition> latestVersionMap = new HashMap<>();
|
for (BpmProcessDefinitionInfoDO info : definitionInfoList) {
|
ProcessDefinition pd = bpmProcessDefinitionService.getProcessDefinition(info.getProcessDefinitionId());
|
if (pd == null || pd.isSuspended()) {
|
continue;
|
}
|
ProcessDefinition existing = latestVersionMap.get(pd.getKey());
|
if (existing == null || pd.getVersion() > existing.getVersion()) {
|
latestVersionMap.put(pd.getKey(), pd);
|
}
|
}
|
List<Map<String, Object>> result = new ArrayList<>();
|
for (ProcessDefinition pd : latestVersionMap.values()) {
|
Map<String, Object> item = new HashMap<>();
|
item.put("id", pd.getId());
|
item.put("key", pd.getKey());
|
item.put("name", pd.getName());
|
result.add(item);
|
}
|
return result;
|
}
|
|
private Long getCurrentUserId() {
|
Authentication authentication = SecurityContextHolder.getContext().getAuthentication();
|
if (authentication != null && authentication.getPrincipal() instanceof Long) {
|
return (Long) authentication.getPrincipal();
|
}
|
return 1L; // 默认用户
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void stockReturnVendor(Long id) {
|
// 校验存在
|
MesWmReturnVendorDO returnVendor = validateReturnVendorExists(id);
|
if (ObjUtil.notEqual(MesWmReturnVendorStatusEnum.APPROVING.getStatus(), returnVendor.getStatus())) {
|
throw exception(WM_RETURN_VENDOR_STATUS_INVALID);
|
}
|
// 执行拣货（待拣货 -> 待执行退货）
|
returnVendorMapper.updateById(new MesWmReturnVendorDO()
|
.setId(id).setStatus(MesWmReturnVendorStatusEnum.APPROVED.getStatus()));
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void finishReturnVendor(Long id) {
|
// 1.1 校验存在
|
MesWmReturnVendorDO returnVendor = validateReturnVendorExists(id);
|
if (ObjUtil.notEqual(MesWmReturnVendorStatusEnum.APPROVED.getStatus(), returnVendor.getStatus())) {
|
throw exception(WM_RETURN_VENDOR_STATUS_INVALID);
|
}
|
// 1.2 校验明细不为空
|
List<MesWmReturnVendorDetailDO> details = returnVendorDetailService.getReturnVendorDetailListByReturnId(id);
|
if (CollUtil.isEmpty(details)) {
|
throw exception(WM_RETURN_VENDOR_NO_DETAIL);
|
}
|
|
// 2. 遍历所有明细，创建库存事务（扣减库存 + 记录流水）
|
createTransactionList(returnVendor, details);
|
|
// 3. 更新退货单状态
|
returnVendorMapper.updateById(new MesWmReturnVendorDO()
|
.setId(id).setStatus(MesWmReturnVendorStatusEnum.FINISHED.getStatus()));
|
}
|
|
private void createTransactionList(MesWmReturnVendorDO returnVendor, List<MesWmReturnVendorDetailDO> details) {
|
wmTransactionService.createTransactionList(convertList(details, detail -> new MesWmTransactionSaveReqDTO()
|
.setType(MesWmTransactionTypeEnum.OUT.getType()).setItemId(detail.getItemId())
|
.setQuantity(detail.getQuantity().negate()) // 出库数量为负数
|
.setBatchId(detail.getBatchId()).setBatchCode(detail.getBatchCode())
|
.setWarehouseId(detail.getWarehouseId()).setLocationId(detail.getLocationId()).setAreaId(detail.getAreaId())
|
.setVendorId(returnVendor.getVendorId())
|
.setBizType(MesBizTypeConstants.WM_RETURN_VENDOR).setBizId(returnVendor.getId())
|
.setBizCode(returnVendor.getCode()).setBizLineId(detail.getLineId())));
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void cancelReturnVendor(Long id) {
|
// 校验存在
|
MesWmReturnVendorDO returnVendor = validateReturnVendorExists(id);
|
// 已完成和已取消不允许取消
|
if (ObjectUtils.equalsAny(returnVendor.getStatus(),
|
MesWmReturnVendorStatusEnum.FINISHED.getStatus(),
|
MesWmReturnVendorStatusEnum.CANCELED.getStatus())) {
|
throw exception(WM_RETURN_VENDOR_CANCEL_NOT_ALLOWED);
|
}
|
|
// 取消
|
returnVendorMapper.updateById(new MesWmReturnVendorDO()
|
.setId(id).setStatus(MesWmReturnVendorStatusEnum.CANCELED.getStatus()));
|
}
|
|
@Override
|
public Boolean checkReturnVendorQuantity(Long id) {
|
List<MesWmReturnVendorLineDO> lines = returnVendorLineService.getReturnVendorLineListByReturnId(id);
|
for (MesWmReturnVendorLineDO line : lines) {
|
List<MesWmReturnVendorDetailDO> details = returnVendorDetailService.getReturnVendorDetailListByLineId(line.getId());
|
BigDecimal totalDetailQty = CollectionUtils.getSumValue(details,
|
MesWmReturnVendorDetailDO::getQuantity, BigDecimal::add, BigDecimal.ZERO);
|
if (line.getQuantity() != null && totalDetailQty.compareTo(line.getQuantity()) != 0) {
|
return false;
|
}
|
}
|
return true;
|
}
|
|
@Override
|
public MesWmReturnVendorDO validateReturnVendorExists(Long id) {
|
MesWmReturnVendorDO returnVendor = returnVendorMapper.selectById(id);
|
if (returnVendor == null) {
|
throw exception(WM_RETURN_VENDOR_NOT_EXISTS);
|
}
|
return returnVendor;
|
}
|
|
@Override
|
public MesWmReturnVendorDO validateReturnVendorExistsAndPrepare(Long id) {
|
MesWmReturnVendorDO returnVendor = validateReturnVendorExists(id);
|
if (ObjUtil.notEqual(MesWmReturnVendorStatusEnum.PREPARE.getStatus(), returnVendor.getStatus())) {
|
throw exception(WM_RETURN_VENDOR_STATUS_INVALID);
|
}
|
return returnVendor;
|
}
|
|
/**
|
* 校验退货单创建/修改的公共数据
|
*/
|
private void validateReturnVendorSaveData(MesWmReturnVendorSaveReqVO reqVO) {
|
// 校验存在 + 草稿状态（仅修改时）
|
if (reqVO.getId() != null) {
|
validateReturnVendorExistsAndPrepare(reqVO.getId());
|
}
|
// 校验供应商存在
|
srmSupplierApi.getSupplier(reqVO.getVendorId());
|
// 校验编码唯一
|
validateCodeUnique(reqVO.getId(), reqVO.getCode());
|
}
|
|
/**
|
* 校验退货单编号唯一
|
*/
|
private void validateCodeUnique(Long id, String code) {
|
MesWmReturnVendorDO existing = returnVendorMapper.selectByCode(code);
|
if (existing == null) {
|
return;
|
}
|
if (ObjUtil.notEqual(id, existing.getId())) {
|
throw exception(WM_RETURN_VENDOR_CODE_DUPLICATE);
|
}
|
}
|
|
@Override
|
public Long getReturnVendorCountByVendorId(Long vendorId) {
|
return returnVendorMapper.selectCountByVendorId(vendorId);
|
}
|
|
}
|
