package cn.iocoder.yudao.module.mes.service.wm.productissue;
|
|
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.productissue.vo.MesWmProductIssuePageReqVO;
|
import cn.iocoder.yudao.module.mes.controller.admin.wm.productissue.vo.MesWmProductIssueSaveReqVO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.md.item.MesMdItemDO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.pro.task.MesProTaskDO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.pro.task.MesProTaskIssueDO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.wm.productissue.MesWmProductIssueDetailDO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.wm.productissue.MesWmProductIssueDO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.wm.productissue.MesWmProductIssueLineDO;
|
import cn.iocoder.yudao.module.mes.dal.mysql.pro.task.MesProTaskIssueMapper;
|
import cn.iocoder.yudao.module.mes.dal.mysql.wm.productissue.MesWmProductIssueMapper;
|
import cn.iocoder.yudao.module.mes.enums.MesBizTypeConstants;
|
import cn.iocoder.yudao.module.mes.enums.wm.MesWmProductIssueStatusEnum;
|
import cn.iocoder.yudao.module.mes.enums.wm.MesWmStockReserveBizTypeEnum;
|
import cn.iocoder.yudao.module.mes.enums.wm.MesWmTransactionTypeEnum;
|
import cn.iocoder.yudao.module.mes.service.md.item.MesMdItemService;
|
import cn.iocoder.yudao.module.mes.service.md.workstation.MesMdWorkstationService;
|
import cn.iocoder.yudao.module.mes.service.pro.task.MesProTaskIssueService;
|
import cn.iocoder.yudao.module.mes.service.pro.task.MesProTaskService;
|
import cn.iocoder.yudao.module.mes.service.pro.workorder.MesProWorkOrderService;
|
import cn.iocoder.yudao.module.mes.service.wm.stockreserve.MesWmStockReserveService;
|
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 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 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.time.LocalDateTime;
|
import java.util.List;
|
import java.util.Map;
|
|
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 MesWmProductIssueServiceImpl implements MesWmProductIssueService {
|
|
@Resource
|
private MesWmProductIssueMapper issueMapper;
|
|
@Resource
|
private MesWmProductIssueLineService issueLineService;
|
@Resource
|
private MesWmProductIssueDetailService issueDetailService;
|
@Resource
|
private MesMdWorkstationService workstationService;
|
@Resource
|
private MesProWorkOrderService workOrderService;
|
@Resource
|
private MesProTaskService taskService;
|
@Resource
|
private MesProTaskIssueService taskIssueService;
|
@Resource
|
private MesProTaskIssueMapper taskIssueMapper;
|
@Resource
|
private MesMdItemService mdmItemService;
|
@Resource
|
private MesWmTransactionService wmTransactionService;
|
@Resource
|
private MesWmWarehouseService warehouseService;
|
@Resource
|
private MesWmWarehouseLocationService locationService;
|
@Resource
|
private MesWmWarehouseAreaService areaService;
|
@Resource
|
private MesWmStockReserveService stockReserveService;
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public Long createProductIssue(MesWmProductIssueSaveReqVO createReqVO) {
|
// 1. 校验关联数据
|
validateProductIssueSaveData(createReqVO);
|
|
// 2. 从 task 自动带入 workOrderId 和 workstationId
|
MesProTaskDO task = taskService.validateTaskExists(createReqVO.getTaskId());
|
if (createReqVO.getWorkOrderId() == null) {
|
createReqVO.setWorkOrderId(task.getWorkOrderId());
|
}
|
if (createReqVO.getWorkstationId() == null) {
|
createReqVO.setWorkstationId(task.getWorkstationId());
|
}
|
|
// 3. 插入主表
|
MesWmProductIssueDO issue = BeanUtils.toBean(createReqVO, MesWmProductIssueDO.class);
|
issue.setStatus(MesWmProductIssueStatusEnum.PREPARE.getStatus());
|
issueMapper.insert(issue);
|
return issue.getId();
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void updateProductIssue(MesWmProductIssueSaveReqVO updateReqVO) {
|
// 1.1 校验存在 + 准备中状态
|
validateProductIssueExistsAndPrepare(updateReqVO.getId());
|
// 1.2 校验关联数据
|
validateProductIssueSaveData(updateReqVO);
|
|
// 2. 从 task 自动带入 workOrderId 和 workstationId
|
MesProTaskDO task = taskService.validateTaskExists(updateReqVO.getTaskId());
|
if (updateReqVO.getWorkOrderId() == null) {
|
updateReqVO.setWorkOrderId(task.getWorkOrderId());
|
}
|
if (updateReqVO.getWorkstationId() == null) {
|
updateReqVO.setWorkstationId(task.getWorkstationId());
|
}
|
|
// 3. 更新主表
|
MesWmProductIssueDO updateObj = BeanUtils.toBean(updateReqVO, MesWmProductIssueDO.class);
|
issueMapper.updateById(updateObj);
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void deleteProductIssue(Long id) {
|
// 1. 校验存在 + 准备中状态
|
validateProductIssueExistsAndPrepare(id);
|
|
// 2.1 级联删除明细
|
issueDetailService.deleteProductIssueDetailByIssueId(id);
|
// 2.2 级联删除行
|
issueLineService.deleteProductIssueLineByIssueId(id);
|
// 2.3 删除主表
|
issueMapper.deleteById(id);
|
}
|
|
@Override
|
public MesWmProductIssueDO getProductIssue(Long id) {
|
return issueMapper.selectById(id);
|
}
|
|
@Override
|
public PageResult<MesWmProductIssueDO> getProductIssuePage(MesWmProductIssuePageReqVO pageReqVO) {
|
return issueMapper.selectPage(pageReqVO);
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void submitProductIssue(Long id) {
|
// 校验存在 + 草稿状态
|
validateProductIssueExistsAndPrepare(id);
|
// 校验至少有一条行
|
List<MesWmProductIssueLineDO> lines = issueLineService.getProductIssueLineListByIssueId(id);
|
if (CollUtil.isEmpty(lines)) {
|
throw exception(WM_PRODUCT_ISSUE_NO_LINE);
|
}
|
|
// 提交（草稿 → 待拣货）
|
issueMapper.updateById(new MesWmProductIssueDO()
|
.setId(id).setStatus(MesWmProductIssueStatusEnum.APPROVING.getStatus()));
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void stockProductIssue(Long id) {
|
// 校验存在
|
MesWmProductIssueDO issue = validateProductIssueExists(id);
|
if (ObjUtil.notEqual(MesWmProductIssueStatusEnum.APPROVING.getStatus(), issue.getStatus())) {
|
throw exception(WM_PRODUCT_ISSUE_STATUS_INVALID);
|
}
|
// 校验拣货明细闭环：行数量 = 明细数量
|
if (!checkProductIssueQuantity(id)) {
|
throw exception(WM_PRODUCT_ISSUE_DETAIL_QUANTITY_MISMATCH);
|
}
|
|
// 创建库存占用（按明细占用库存）
|
List<MesWmProductIssueDetailDO> details = issueDetailService.getProductIssueDetailListByIssueId(id);
|
for (MesWmProductIssueDetailDO detail : details) {
|
if (detail.getMaterialStockId() != null && detail.getQuantity() != null) {
|
stockReserveService.createReserve(
|
detail.getMaterialStockId(),
|
MesWmStockReserveBizTypeEnum.PRODUCT_ISSUE.getType(),
|
id,
|
issue.getCode(),
|
detail.getId(),
|
detail.getItemId(),
|
detail.getQuantity()
|
);
|
}
|
}
|
|
// 执行拣货（待拣货 → 待执行领出）
|
issueMapper.updateById(new MesWmProductIssueDO()
|
.setId(id).setStatus(MesWmProductIssueStatusEnum.APPROVED.getStatus()));
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void finishProductIssue(Long id) {
|
// 1. 校验存在
|
MesWmProductIssueDO issue = validateProductIssueExists(id);
|
if (ObjUtil.notEqual(MesWmProductIssueStatusEnum.APPROVED.getStatus(), issue.getStatus())) {
|
throw exception(WM_PRODUCT_ISSUE_STATUS_INVALID);
|
}
|
// 校验至少有一条明细
|
List<MesWmProductIssueDetailDO> details = issueDetailService.getProductIssueDetailListByIssueId(id);
|
if (CollUtil.isEmpty(details)) {
|
throw exception(WM_PRODUCT_ISSUE_NO_DETAIL);
|
}
|
// 校验行数量 = 明细数量
|
if (!checkProductIssueQuantity(id)) {
|
throw exception(WM_PRODUCT_ISSUE_DETAIL_QUANTITY_MISMATCH);
|
}
|
|
// 2. 确认占用转出库（释放占用量）
|
stockReserveService.confirmReserveToOutbound(MesWmStockReserveBizTypeEnum.PRODUCT_ISSUE.getType(), id);
|
|
// 3. 遍历所有明细，创建库存事务（扣减库存 + 记录流水）
|
createTransactionList(issue);
|
|
// 4. 自动创建任务投料记录
|
createTaskIssueRecords(issue);
|
|
// 5. 更新出库单状态 + 领料日期
|
issueMapper.updateById(new MesWmProductIssueDO()
|
.setId(id).setStatus(MesWmProductIssueStatusEnum.FINISHED.getStatus())
|
.setIssueDate(LocalDateTime.now()));
|
}
|
|
private void createTransactionList(MesWmProductIssueDO issue) {
|
// 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（虚拟线边库增加）
|
List<MesWmProductIssueDetailDO> details = issueDetailService.getProductIssueDetailListByIssueId(issue.getId());
|
for (MesWmProductIssueDetailDO detail : details) {
|
// 2.1 先从实际仓库出库（库存减少）
|
Long outTransactionId = wmTransactionService.createTransaction(new MesWmTransactionSaveReqDTO()
|
.setType(MesWmTransactionTypeEnum.OUT.getType()).setItemId(detail.getItemId())
|
.setQuantity(detail.getQuantity().negate()) // 库存减少
|
.setBatchId(detail.getBatchId()).setBatchCode(detail.getBatchCode()).setMaterialStockId(detail.getMaterialStockId())
|
.setWarehouseId(detail.getWarehouseId()).setLocationId(detail.getLocationId()).setAreaId(detail.getAreaId())
|
.setBizType(MesBizTypeConstants.WM_ISSUE).setBizId(issue.getId())
|
.setBizCode(issue.getCode()).setBizLineId(detail.getLineId()));
|
// 2.2 再入虚拟线边库（库存增加）
|
wmTransactionService.createTransaction(new MesWmTransactionSaveReqDTO()
|
.setType(MesWmTransactionTypeEnum.IN.getType()).setItemId(detail.getItemId())
|
.setQuantity(detail.getQuantity()) // 库存增加
|
.setBatchId(detail.getBatchId()).setBatchCode(detail.getBatchCode())
|
.setWarehouseId(virtualWarehouse.getId()).setLocationId(virtualLocation.getId()).setAreaId(virtualArea.getId())
|
.setBizType(MesBizTypeConstants.WM_ISSUE).setBizId(issue.getId())
|
.setBizCode(issue.getCode()).setBizLineId(detail.getLineId())
|
.setRelatedTransactionId(outTransactionId)); // 关联出库事务
|
}
|
}
|
|
/**
|
* 领料出库完成时，自动创建任务投料记录
|
* 按行遍历，每行创建一条 task_issue 记录
|
*/
|
private void createTaskIssueRecords(MesWmProductIssueDO issue) {
|
List<MesWmProductIssueLineDO> lines = issueLineService.getProductIssueLineListByIssueId(issue.getId());
|
if (CollUtil.isEmpty(lines)) {
|
return;
|
}
|
|
// 批量查询物料信息（获取 unitMeasureId）
|
Map<Long, MesMdItemDO> itemMap = mdmItemService.getItemMap(
|
CollectionUtils.convertSet(lines, MesWmProductIssueLineDO::getItemId));
|
|
// 获取明细列表，用于提取 batchCode
|
List<MesWmProductIssueDetailDO> details = issueDetailService.getProductIssueDetailListByIssueId(issue.getId());
|
Map<Long, List<MesWmProductIssueDetailDO>> detailMapByLineId = CollectionUtils.convertMultiMap(
|
details, MesWmProductIssueDetailDO::getLineId);
|
|
for (MesWmProductIssueLineDO line : lines) {
|
// 行的 taskId 优先，否则取主表的 taskId
|
Long taskId = line.getTaskId() != null ? line.getTaskId() : issue.getTaskId();
|
if (taskId == null) {
|
continue;
|
}
|
|
// 获取物料单位
|
MesMdItemDO item = itemMap.get(line.getItemId());
|
Long unitMeasureId = item != null ? item.getUnitMeasureId() : null;
|
|
// 获取批次号：取该行第一个明细的 batchCode
|
String batchCode = null;
|
List<MesWmProductIssueDetailDO> lineDetails = detailMapByLineId.get(line.getId());
|
if (CollUtil.isNotEmpty(lineDetails)) {
|
MesWmProductIssueDetailDO firstDetail = lineDetails.get(0);
|
batchCode = firstDetail.getBatchCode();
|
}
|
|
// 创建任务投料记录
|
MesProTaskIssueDO taskIssue = MesProTaskIssueDO.builder()
|
.taskId(taskId)
|
.workOrderId(issue.getWorkOrderId())
|
.workstationId(issue.getWorkstationId())
|
.sourceDocType("PRODUCT_ISSUE")
|
.sourceDocId(issue.getId())
|
.sourceLineId(line.getId())
|
.sourceDocCode(issue.getCode())
|
.batchCode(batchCode)
|
.itemId(line.getItemId())
|
.unitMeasureId(unitMeasureId)
|
.issuedQuantity(line.getQuantity())
|
.availableQuantity(line.getQuantity()) // 初始全可用
|
.usedQuantity(BigDecimal.ZERO)
|
.build();
|
taskIssueMapper.insert(taskIssue);
|
}
|
}
|
|
@Override
|
@Transactional(rollbackFor = Exception.class)
|
public void cancelProductIssue(Long id) {
|
// 校验存在
|
MesWmProductIssueDO issue = validateProductIssueExists(id);
|
// 已完成和已取消不允许取消
|
if (ObjectUtils.equalsAny(issue.getStatus(),
|
MesWmProductIssueStatusEnum.FINISHED.getStatus(),
|
MesWmProductIssueStatusEnum.CANCELED.getStatus())) {
|
throw exception(WM_PRODUCT_ISSUE_CANCEL_NOT_ALLOWED);
|
}
|
|
// 释放库存占用
|
stockReserveService.releaseReserve(MesWmStockReserveBizTypeEnum.PRODUCT_ISSUE.getType(), id);
|
|
// 删除通过该领料单创建的任务投料记录
|
taskIssueService.deleteTaskIssueBySourceDoc("PRODUCT_ISSUE", id);
|
|
// 取消
|
issueMapper.updateById(new MesWmProductIssueDO()
|
.setId(id).setStatus(MesWmProductIssueStatusEnum.CANCELED.getStatus()));
|
}
|
|
@Override
|
public Boolean checkProductIssueQuantity(Long id) {
|
List<MesWmProductIssueLineDO> lines = issueLineService.getProductIssueLineListByIssueId(id);
|
for (MesWmProductIssueLineDO line : lines) {
|
List<MesWmProductIssueDetailDO> details = issueDetailService.getProductIssueDetailListByLineId(line.getId());
|
BigDecimal totalDetailQty = CollectionUtils.getSumValue(details,
|
MesWmProductIssueDetailDO::getQuantity, BigDecimal::add, BigDecimal.ZERO);
|
if (line.getQuantity() != null && totalDetailQty.compareTo(line.getQuantity()) != 0) {
|
return false;
|
}
|
}
|
return true;
|
}
|
|
@Override
|
public MesWmProductIssueDO validateProductIssueExists(Long id) {
|
MesWmProductIssueDO issue = issueMapper.selectById(id);
|
if (issue == null) {
|
throw exception(WM_PRODUCT_ISSUE_NOT_EXISTS);
|
}
|
return issue;
|
}
|
|
/**
|
* 校验领料出库单存在且为准备中状态
|
*/
|
@Override
|
public MesWmProductIssueDO validateProductIssueExistsAndPrepare(Long id) {
|
MesWmProductIssueDO issue = validateProductIssueExists(id);
|
if (ObjUtil.notEqual(MesWmProductIssueStatusEnum.PREPARE.getStatus(), issue.getStatus())) {
|
throw exception(WM_PRODUCT_ISSUE_STATUS_INVALID);
|
}
|
return issue;
|
}
|
|
/**
|
* 校验编码唯一性
|
*/
|
private void validateCodeUnique(Long id, String code) {
|
MesWmProductIssueDO issue = issueMapper.selectByCode(code);
|
if (issue == null) {
|
return;
|
}
|
if (ObjUtil.notEqual(id, issue.getId())) {
|
throw exception(WM_PRODUCT_ISSUE_CODE_DUPLICATE);
|
}
|
}
|
|
/**
|
* 校验保存时的关联数据
|
*/
|
private void validateProductIssueSaveData(MesWmProductIssueSaveReqVO reqVO) {
|
validateCodeUnique(reqVO.getId(), reqVO.getCode());
|
// 校验 task 存在
|
MesProTaskDO task = taskService.validateTaskExists(reqVO.getTaskId());
|
// 校验 task 关联的工单已确认
|
Long workOrderId = reqVO.getWorkOrderId() != null ? reqVO.getWorkOrderId() : task.getWorkOrderId();
|
if (workOrderId != null) {
|
workOrderService.validateWorkOrderConfirmed(workOrderId);
|
}
|
if (reqVO.getWorkstationId() != null) {
|
workstationService.validateWorkstationExistsAndEnable(reqVO.getWorkstationId());
|
}
|
}
|
|
}
|
