package cn.iocoder.yudao.module.mes.service.wm.productreceipt;
|
|
import cn.hutool.core.collection.CollUtil;
|
import cn.hutool.core.util.ObjUtil;
|
import cn.iocoder.yudao.framework.common.exception.ServiceException;
|
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.productreceipt.vo.MesWmProductReceiptPageReqVO;
|
import cn.iocoder.yudao.module.mes.controller.admin.wm.productreceipt.vo.MesWmProductReceiptSaveReqVO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.pro.workorder.MesProWorkOrderDO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.wm.productreceipt.MesWmProductReceiptDO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.wm.productreceipt.MesWmProductReceiptDetailDO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.wm.productreceipt.MesWmProductReceiptLineDO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.wm.warehouse.MesWmWarehouseAreaDO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.wm.warehouse.MesWmWarehouseDO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.wm.warehouse.MesWmWarehouseLocationDO;
|
import cn.iocoder.yudao.module.mes.dal.mysql.wm.productreceipt.MesWmProductReceiptMapper;
|
import cn.iocoder.yudao.module.mes.enums.MesBizTypeConstants;
|
import cn.iocoder.yudao.module.mes.enums.wm.MesWmProductReceiptStatusEnum;
|
import cn.iocoder.yudao.module.mes.enums.wm.MesWmTransactionTypeEnum;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.md.item.MesMdItemDO;
|
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.transaction.MesWmTransactionService;
|
import cn.iocoder.yudao.module.mes.service.wm.transaction.dto.MesWmTransactionSaveReqDTO;
|
import cn.iocoder.yudao.module.mes.service.wm.warehouse.MesWmWarehouseAreaService;
|
import cn.iocoder.yudao.module.mes.service.wm.warehouse.MesWmWarehouseLocationService;
|
import cn.iocoder.yudao.module.mes.service.wm.warehouse.MesWmWarehouseService;
|
import jakarta.annotation.Resource;
|
import org.springframework.stereotype.Service;
|
import org.springframework.transaction.annotation.Transactional;
|
import org.springframework.validation.annotation.Validated;
|
|
import java.math.BigDecimal;
|
import java.util.List;
|
import java.util.Map;
|
import java.util.Objects;
|
import java.util.stream.Collectors;
|
|
import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
|
import static cn.iocoder.yudao.module.mes.enums.ErrorCodeConstants.*;
|
|
/**
|
* MES 产品收货单 Service 实现类
|
*/
|
@Service
|
@Validated
|
public class MesWmProductReceiptServiceImpl implements MesWmProductReceiptService {
|
|
@Resource
|
private MesWmProductReceiptMapper productReceiptMapper;
|
|
@Resource
|
private MesWmProductReceiptLineService productReceiptLineService;
|
@Resource
|
private MesWmProductReceiptDetailService productReceiptDetailService;
|
@Resource
|
private MesWmTransactionService wmTransactionService;
|
@Resource
|
private MesProWorkOrderService workOrderService;
|
@Resource
|
private MesMdItemService itemService;
|
@Resource
|
private MesWmWarehouseService warehouseService;
|
@Resource
|
private MesWmWarehouseLocationService locationService;
|
@Resource
|
private MesWmWarehouseAreaService areaService;
|
|
@Override
|
public Long createProductReceipt(MesWmProductReceiptSaveReqVO createReqVO) {
|
// 1. 校验关联数据
|
MesProWorkOrderDO workOrder = validateProductReceiptSaveData(createReqVO);
|
|
// 2. 插入
|
MesWmProductReceiptDO receipt = BeanUtils.toBean(createReqVO, MesWmProductReceiptDO.class);
|
if (workOrder != null) {
|
receipt.setItemId(workOrder.getProductId());
|
}
|
receipt.setStatus(MesWmProductReceiptStatusEnum.PREPARE.getStatus());
|
productReceiptMapper.insert(receipt);
|
return receipt.getId();
|
}
|
|
@Override
|
public void updateProductReceipt(MesWmProductReceiptSaveReqVO updateReqVO) {
|
// 1.1 校验存在 + 草稿状态
|
validateProductReceiptExistsAndDraft(updateReqVO.getId());
|
// 1.2 校验关联数据
|
MesProWorkOrderDO workOrder = validateProductReceiptSaveData(updateReqVO);
|
|
// 2. 更新
|
MesWmProductReceiptDO updateObj = BeanUtils.toBean(updateReqVO, MesWmProductReceiptDO.class);
|
if (workOrder != null) {
|
updateObj.setItemId(workOrder.getProductId());
|
}
|
productReceiptMapper.updateById(updateObj);
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void deleteProductReceipt(Long id) {
|
// 校验存在 + 草稿状态
|
validateProductReceiptExistsAndDraft(id);
|
|
// 级联删除明细和行
|
productReceiptDetailService.deleteProductReceiptDetailByRecptId(id);
|
productReceiptLineService.deleteProductReceiptLineByRecptId(id);
|
// 删除
|
productReceiptMapper.deleteById(id);
|
}
|
|
@Override
|
public MesWmProductReceiptDO getProductReceipt(Long id) {
|
return productReceiptMapper.selectById(id);
|
}
|
|
@Override
|
public PageResult<MesWmProductReceiptDO> getProductReceiptPage(MesWmProductReceiptPageReqVO pageReqVO) {
|
return productReceiptMapper.selectPage(pageReqVO);
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void submitProductReceipt(Long id) {
|
// 校验存在 + 草稿状态
|
validateProductReceiptExistsAndDraft(id);
|
// 校验至少有一条行
|
List<MesWmProductReceiptLineDO> lines = productReceiptLineService.getProductReceiptLineListByRecptId(id);
|
if (CollUtil.isEmpty(lines)) {
|
throw exception(WM_PRODUCT_RECPT_NO_LINE);
|
}
|
|
// 提交（草稿 → 待上架）
|
productReceiptMapper.updateById(new MesWmProductReceiptDO()
|
.setId(id).setStatus(MesWmProductReceiptStatusEnum.APPROVING.getStatus()));
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void stockProductReceipt(Long id) {
|
// 校验存在
|
MesWmProductReceiptDO receipt = validateProductReceiptExists(id);
|
if (ObjUtil.notEqual(MesWmProductReceiptStatusEnum.APPROVING.getStatus(), receipt.getStatus())) {
|
throw exception(WM_PRODUCT_RECPT_STATUS_ERROR);
|
}
|
|
// 校验上架明细已覆盖每一行收货数量：状态一旦推进到「待执行入库」，明细就不能再编辑，
|
// 若此时明细为空或数量不足，单据将永远无法执行入库（会被卡死在待执行入库）
|
validateProductReceiptStockDetail(receipt);
|
|
// 执行上架（待上架 → 待入库）
|
productReceiptMapper.updateById(new MesWmProductReceiptDO()
|
.setId(id).setStatus(MesWmProductReceiptStatusEnum.APPROVED.getStatus()));
|
}
|
|
/**
|
* 校验执行上架前的上架明细：每一行的收货数量都必须被该行的上架明细合计覆盖
|
*
|
* 提示按「具体行 + 双方数量 + 下一步动作」组织，避免只报一句笼统的"数量不匹配"
|
*/
|
private void validateProductReceiptStockDetail(MesWmProductReceiptDO receipt) {
|
List<MesWmProductReceiptLineDO> lines = productReceiptLineService.getProductReceiptLineListByRecptId(receipt.getId());
|
if (CollUtil.isEmpty(lines)) {
|
throw new ServiceException(WM_PRODUCT_RECPT_NO_LINE.getCode(),
|
String.format("收货单[%s]没有收货行，无法执行上架：请先在单据中添加收货行（物料与收货数量）后再执行上架。",
|
receipt.getCode()));
|
}
|
Map<Long, MesMdItemDO> itemMap = itemService.getItemMap(lines.stream()
|
.map(MesWmProductReceiptLineDO::getItemId).filter(Objects::nonNull).collect(Collectors.toSet()));
|
for (int i = 0; i < lines.size(); i++) {
|
MesWmProductReceiptLineDO line = lines.get(i);
|
String lineLabel = String.format("第 %d 行[%s]", i + 1, formatItemLabel(line.getItemId(), itemMap));
|
if (line.getBatchCode() != null) {
|
lineLabel += String.format("（批次[%s]）", line.getBatchCode());
|
}
|
BigDecimal lineQuantity = line.getQuantity() == null ? BigDecimal.ZERO : line.getQuantity();
|
List<MesWmProductReceiptDetailDO> details =
|
productReceiptDetailService.getProductReceiptDetailListByLineId(line.getId());
|
// 明细为空时直接提示"去点上架"，比提示"合计 0 与 20 不一致"更明确
|
if (CollUtil.isEmpty(details)) {
|
throw new ServiceException(WM_PRODUCT_RECPT_NO_DETAIL.getCode(),
|
String.format("收货单[%s]%s还没有上架明细（收货数量[%s]）：请先在该行点「上架」，填写入库仓库与上架数量，"
|
+ "合计填满 %s 后再执行上架。", receipt.getCode(), lineLabel,
|
formatQuantity(lineQuantity), formatQuantity(lineQuantity)));
|
}
|
BigDecimal detailQuantity = CollectionUtils.getSumValue(details,
|
MesWmProductReceiptDetailDO::getQuantity, BigDecimal::add, BigDecimal.ZERO);
|
if (detailQuantity.compareTo(lineQuantity) != 0) {
|
BigDecimal diff = lineQuantity.subtract(detailQuantity);
|
String action = diff.signum() > 0
|
? String.format("还差[%s]：请在该行点「上架」补登缺少的上架明细", formatQuantity(diff))
|
: String.format("多出[%s]：请删除或调整该行多余的上架明细", formatQuantity(diff.negate()));
|
throw new ServiceException(WM_PRODUCT_RECPT_DETAIL_QUANTITY_MISMATCH.getCode(),
|
String.format("收货单[%s]%s上架明细合计[%s]与收货数量[%s]不一致，%s，调整一致后再执行上架。",
|
receipt.getCode(), lineLabel, formatQuantity(detailQuantity),
|
formatQuantity(lineQuantity), action));
|
}
|
}
|
}
|
|
/**
|
* 数量显示：去掉数据库 scale 带出的多余 0（20.000000 → 20）
|
*/
|
private String formatQuantity(BigDecimal quantity) {
|
if (quantity == null) {
|
return "0";
|
}
|
return quantity.stripTrailingZeros().toPlainString();
|
}
|
|
/**
|
* 物料显示名：优先「名称/编码」，查不到时回退为 ID，避免把裸 ID 直接抛给用户
|
*/
|
private String formatItemLabel(Long itemId, Map<Long, MesMdItemDO> itemMap) {
|
MesMdItemDO item = itemId == null ? null : itemMap.get(itemId);
|
if (item == null) {
|
return itemId == null ? "物料[未选择]" : String.format("物料[ID=%s]", itemId);
|
}
|
return String.format("%s/%s", item.getName(), item.getCode());
|
}
|
|
@Override
|
public Boolean checkProductReceiptQuantity(Long id) {
|
List<MesWmProductReceiptLineDO> lines = productReceiptLineService.getProductReceiptLineListByRecptId(id);
|
for (MesWmProductReceiptLineDO line : lines) {
|
List<MesWmProductReceiptDetailDO> details = productReceiptDetailService.getProductReceiptDetailListByLineId(line.getId());
|
BigDecimal totalDetailQty = CollectionUtils.getSumValue(details,
|
MesWmProductReceiptDetailDO::getQuantity, BigDecimal::add, BigDecimal.ZERO);
|
if (line.getQuantity() != null && totalDetailQty.compareTo(line.getQuantity()) != 0) {
|
return false;
|
}
|
}
|
return true;
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void finishProductReceipt(Long id) {
|
// 校验存在
|
MesWmProductReceiptDO receipt = validateProductReceiptExists(id);
|
if (ObjUtil.notEqual(MesWmProductReceiptStatusEnum.APPROVED.getStatus(), receipt.getStatus())) {
|
throw exception(WM_PRODUCT_RECPT_STATUS_ERROR);
|
}
|
// 校验明细非空
|
List<MesWmProductReceiptDetailDO> details = productReceiptDetailService.getProductReceiptDetailListByRecptId(id);
|
if (CollUtil.isEmpty(details)) {
|
throw exception(WM_PRODUCT_RECPT_NO_DETAIL);
|
}
|
|
// 创建库存事务
|
createTransactionList(receipt, details);
|
|
// 更新收货单状态
|
productReceiptMapper.updateById(new MesWmProductReceiptDO()
|
.setId(id).setStatus(MesWmProductReceiptStatusEnum.FINISHED.getStatus()));
|
}
|
|
private void createTransactionList(MesWmProductReceiptDO receipt, List<MesWmProductReceiptDetailDO> details) {
|
// 1. 查询虚拟线边库
|
MesWmWarehouseDO virtualWarehouse = warehouseService.getWarehouseByCode(MesWmWarehouseDO.WIP_VIRTUAL_WAREHOUSE);
|
MesWmWarehouseLocationDO virtualLocation = locationService.getWarehouseLocationByCode(MesWmWarehouseLocationDO.WIP_VIRTUAL_LOCATION);
|
MesWmWarehouseAreaDO virtualArea = areaService.getWarehouseAreaByCode(MesWmWarehouseAreaDO.WIP_VIRTUAL_AREA);
|
|
// 2. 遍历明细，每条明细产生 OUT（虚拟线边库扣减）+ IN（实际仓库增加）
|
for (MesWmProductReceiptDetailDO detail : details) {
|
// 2.1 先从虚拟线边库出库（库存减少）
|
Long outTransactionId = wmTransactionService.createTransaction(new MesWmTransactionSaveReqDTO()
|
.setType(MesWmTransactionTypeEnum.OUT.getType()).setItemId(detail.getItemId())
|
.setQuantity(detail.getQuantity().negate()) // 库存减少
|
.setBatchId(detail.getBatchId())
|
.setWarehouseId(virtualWarehouse.getId()).setLocationId(virtualLocation.getId()).setAreaId(virtualArea.getId())
|
.setCheckFlag(false) // 线边库允许负库存
|
.setBizType(MesBizTypeConstants.WM_PRODUCT_RECPT).setBizId(receipt.getId())
|
.setBizCode(receipt.getCode()).setBizLineId(detail.getLineId()));
|
// 2.2 再入实际仓库（库存增加）
|
wmTransactionService.createTransaction(new MesWmTransactionSaveReqDTO()
|
.setType(MesWmTransactionTypeEnum.IN.getType()).setItemId(detail.getItemId())
|
.setQuantity(detail.getQuantity()) // 库存增加
|
.setBatchId(detail.getBatchId())
|
.setWarehouseId(detail.getWarehouseId()).setLocationId(detail.getLocationId()).setAreaId(detail.getAreaId())
|
.setBizType(MesBizTypeConstants.WM_PRODUCT_RECPT).setBizId(receipt.getId())
|
.setBizCode(receipt.getCode()).setBizLineId(detail.getLineId())
|
.setRelatedTransactionId(outTransactionId)); // 关联出库事务
|
}
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void cancelProductReceipt(Long id) {
|
// 校验存在
|
MesWmProductReceiptDO receipt = validateProductReceiptExists(id);
|
// 已完成和已取消不允许取消
|
if (ObjectUtils.equalsAny(receipt.getStatus(),
|
MesWmProductReceiptStatusEnum.FINISHED.getStatus(),
|
MesWmProductReceiptStatusEnum.CANCELED.getStatus())) {
|
throw exception(WM_PRODUCT_RECPT_CANCEL_NOT_ALLOWED);
|
}
|
|
// 取消
|
productReceiptMapper.updateById(new MesWmProductReceiptDO()
|
.setId(id).setStatus(MesWmProductReceiptStatusEnum.CANCELED.getStatus()));
|
}
|
|
@Override
|
public MesWmProductReceiptDO validateProductReceiptEditable(Long id) {
|
MesWmProductReceiptDO receipt = validateProductReceiptExists(id);
|
if (ObjUtil.notEqual(receipt.getStatus(), MesWmProductReceiptStatusEnum.PREPARE.getStatus())
|
&& ObjUtil.notEqual(receipt.getStatus(), MesWmProductReceiptStatusEnum.APPROVING.getStatus())) {
|
throw exception(WM_PRODUCT_RECPT_STATUS_NOT_PREPARE);
|
}
|
return receipt;
|
}
|
|
private MesWmProductReceiptDO validateProductReceiptExists(Long id) {
|
MesWmProductReceiptDO receipt = productReceiptMapper.selectById(id);
|
if (receipt == null) {
|
throw exception(WM_PRODUCT_RECPT_NOT_EXISTS);
|
}
|
return receipt;
|
}
|
|
/**
|
* 校验产品收货单存在且为草稿状态
|
*/
|
private MesWmProductReceiptDO validateProductReceiptExistsAndDraft(Long id) {
|
MesWmProductReceiptDO receipt = validateProductReceiptExists(id);
|
if (ObjUtil.notEqual(MesWmProductReceiptStatusEnum.PREPARE.getStatus(), receipt.getStatus())) {
|
throw exception(WM_PRODUCT_RECPT_STATUS_NOT_PREPARE);
|
}
|
return receipt;
|
}
|
/**
|
* 校验保存时的关联数据
|
*
|
* @return 工单对象（可能为 null）
|
*/
|
private MesProWorkOrderDO validateProductReceiptSaveData(MesWmProductReceiptSaveReqVO reqVO) {
|
// 校验编码唯一
|
validateCodeUnique(reqVO.getId(), reqVO.getCode());
|
// 校验工单存在
|
return reqVO.getWorkOrderId() != null ?
|
workOrderService.validateWorkOrderConfirmed(reqVO.getWorkOrderId()) : null;
|
}
|
|
private void validateCodeUnique(Long id, String code) {
|
MesWmProductReceiptDO receipt = productReceiptMapper.selectByCode(code);
|
if (receipt == null) {
|
return;
|
}
|
if (ObjUtil.notEqual(id, receipt.getId())) {
|
throw exception(WM_PRODUCT_RECPT_CODE_DUPLICATE);
|
}
|
}
|
|
}
|
