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 getProductReceiptPage(MesWmProductReceiptPageReqVO pageReqVO) { return productReceiptMapper.selectPage(pageReqVO); } @Override @Transactional(rollbackFor = Exception.class) public void submitProductReceipt(Long id) { // 校验存在 + 草稿状态 validateProductReceiptExistsAndDraft(id); // 校验至少有一条行 List 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 lines = productReceiptLineService.getProductReceiptLineListByRecptId(receipt.getId()); if (CollUtil.isEmpty(lines)) { throw new ServiceException(WM_PRODUCT_RECPT_NO_LINE.getCode(), String.format("收货单[%s]没有收货行,无法执行上架:请先在单据中添加收货行(物料与收货数量)后再执行上架。", receipt.getCode())); } Map 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 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 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 lines = productReceiptLineService.getProductReceiptLineListByRecptId(id); for (MesWmProductReceiptLineDO line : lines) { List 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 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 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); } } }