package cn.iocoder.yudao.module.mes.service.pro.mps;
|
|
import cn.iocoder.yudao.framework.common.pojo.PageResult;
|
import cn.iocoder.yudao.module.mes.controller.admin.pro.mps.vo.MesProMpsPageReqVO;
|
import cn.iocoder.yudao.module.mes.controller.admin.pro.mps.vo.MesProMpsSaveReqVO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.pro.mps.MesProMpsDO;
|
import jakarta.validation.Valid;
|
|
import java.math.BigDecimal;
|
import java.util.Collection;
|
import java.util.List;
|
|
/**
|
* MES 生产主计划（MPS）Service 接口
|
*
|
* @author 芋道源码
|
*/
|
public interface MesProMpsService {
|
|
/**
|
* 创建 MPS（供 API 调用，自动映射物料）
|
*
|
* @param saleOrderId 销售订单ID
|
* @param saleOrderNo 销售订单号
|
* @param saleOrderItemId 销售订单明细ID
|
* @param mdmItemId MDM 物料ID
|
* @param productName 产品名称（用于错误提示）
|
* @param quantity 计划数量
|
* @param clientId 客户ID
|
* @param requestDate 需求日期
|
* @param remark 备注
|
* @return MPS 编号，如果 MES 产品不存在返回 null
|
* @throws cn.iocoder.yudao.framework.common.exception.ServiceException 如果 MES 产品不存在
|
*/
|
Long createMps(Long saleOrderId, String saleOrderNo, Long saleOrderItemId,
|
Long mdmItemId, String productName, BigDecimal quantity, Long clientId,
|
String requestDate, String remark);
|
|
/**
|
* 创建 MPS
|
*
|
* @param createReqVO 创建信息
|
* @return MPS 编号
|
*/
|
Long createMps(@Valid MesProMpsSaveReqVO createReqVO);
|
|
/**
|
* 更新 MPS
|
*
|
* @param updateReqVO 更新信息
|
*/
|
void updateMps(@Valid MesProMpsSaveReqVO updateReqVO);
|
|
/**
|
* 删除 MPS（仅草稿状态）
|
*
|
* @param id 编号
|
*/
|
void deleteMps(Long id);
|
|
/**
|
* 下发单条 MPS
|
*
|
* @param id MPS 编号
|
* @return 生成的工单 ID
|
*/
|
Long issueMps(Long id);
|
|
/**
|
* 合并下发多条 MPS
|
* 将多条相同产品的 MPS 合并生成一条生产工单
|
*
|
* @param mpsIds MPS 编号列表
|
* @return 生成的工单 ID
|
*/
|
Long mergeAndIssueMps(List<Long> mpsIds);
|
|
/**
|
* 取消 MPS
|
*
|
* @param id 编号
|
*/
|
void cancelMps(Long id);
|
|
/**
|
* 完成 MPS（由生产工单完成时触发）
|
*
|
* @param id 编号
|
*/
|
void finishMps(Long id);
|
|
/**
|
* 根据销售订单明细获取 MPS
|
*
|
* @param saleOrderItemId 销售订单明细ID
|
* @return MPS
|
*/
|
MesProMpsDO getMpsBySaleOrderItemId(Long saleOrderItemId);
|
|
/**
|
* 获取 MPS
|
*
|
* @param id 编号
|
* @return MPS
|
*/
|
MesProMpsDO getMps(Long id);
|
|
/**
|
* 获取 MPS 分页
|
*
|
* @param pageReqVO 分页查询
|
* @return 分页结果
|
*/
|
PageResult<MesProMpsDO> getMpsPage(MesProMpsPageReqVO pageReqVO);
|
|
/**
|
* 获取 MPS 列表
|
*
|
* @param ids 编号列表
|
* @return MPS 列表
|
*/
|
List<MesProMpsDO> getMpsList(Collection<Long> ids);
|
|
/**
|
* 根据销售订单明细ID列表获取 MPS 列表
|
*
|
* @param saleOrderItemIds 销售订单明细ID列表
|
* @return MPS 列表
|
*/
|
List<MesProMpsDO> getMpsListBySaleOrderItemIds(Collection<Long> saleOrderItemIds);
|
|
/**
|
* 获取可合并的 MPS 列表（相同产品、草稿状态）
|
*
|
* @param productId 产品ID
|
* @return MPS 列表
|
*/
|
List<MesProMpsDO> getMergeableMpsList(Long productId);
|
|
/**
|
* 更新已生产数量
|
*
|
* @param id MPS 编号
|
* @param incrQuantity 增量
|
*/
|
void updateProducedQuantity(Long id, BigDecimal incrQuantity);
|
|
/**
|
* 检查销售订单的所有 MPS 是否已完成生产
|
*
|
* 完成条件：
|
* 1. 已生产数量 >= 计划数量
|
* 2. 所有报工单状态为 FINISHED（确保质检完成）
|
*
|
* @param saleOrderId 销售订单ID
|
* @return true=全部完成，false=未全部完成
|
*/
|
Boolean checkSaleOrderProductionFinished(Long saleOrderId);
|
|
/**
|
* 根据工单ID获取 MPS
|
*
|
* @param workOrderId 工单ID
|
* @return MPS
|
*/
|
MesProMpsDO getMpsByWorkOrderId(Long workOrderId);
|
|
/**
|
* 检查并自动完成 MPS
|
*
|
* 如果 MPS 满足完成条件（已生产数量 >= 计划数量 且 所有报工已完成），
|
* 则自动将 MPS 状态更新为已完成
|
*
|
* @param mpsId MPS 编号
|
* @return true=已完成或本次自动完成，false=未完成
|
*/
|
Boolean checkAndFinishMps(Long mpsId);
|
|
}
|
