package cn.iocoder.yudao.module.mes.service.pro.workorder;
|
|
import cn.iocoder.yudao.framework.common.pojo.PageResult;
|
import cn.iocoder.yudao.module.mes.controller.admin.pro.workorder.vo.MesProWorkOrderPageReqVO;
|
import cn.iocoder.yudao.module.mes.controller.admin.pro.workorder.vo.MesProWorkOrderSaveReqVO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.pro.workorder.MesProWorkOrderDO;
|
import jakarta.validation.Valid;
|
|
import java.math.BigDecimal;
|
import java.util.Collection;
|
import java.util.List;
|
import java.util.Map;
|
|
import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
|
|
/**
|
* MES 生产工单 Service 接口
|
*
|
* @author 芋道源码
|
*/
|
public interface MesProWorkOrderService {
|
|
/**
|
* 创建生产工单
|
*
|
* @param createReqVO 创建信息
|
* @return 编号
|
*/
|
Long createWorkOrder(@Valid MesProWorkOrderSaveReqVO createReqVO);
|
|
/**
|
* 更新生产工单
|
*
|
* @param updateReqVO 更新信息
|
*/
|
void updateWorkOrder(@Valid MesProWorkOrderSaveReqVO updateReqVO);
|
|
/**
|
* 删除生产工单
|
*
|
* @param id 编号
|
*/
|
void deleteWorkOrder(Long id);
|
|
/**
|
* 校验生产工单存在
|
*
|
* @param id 编号
|
* @return 生产工单
|
*/
|
MesProWorkOrderDO validateWorkOrderExists(Long id);
|
|
/**
|
* 获得生产工单
|
*
|
* @param id 编号
|
* @return 生产工单
|
*/
|
MesProWorkOrderDO getWorkOrder(Long id);
|
|
/**
|
* 根据编码获得生产工单
|
*
|
* @param code 编码
|
* @return 生产工单
|
*/
|
MesProWorkOrderDO getWorkOrder(String code);
|
|
/**
|
* 获得生产工单分页
|
*
|
* @param pageReqVO 分页查询
|
* @return 生产工单分页
|
*/
|
PageResult<MesProWorkOrderDO> getWorkOrderPage(MesProWorkOrderPageReqVO pageReqVO);
|
|
/**
|
* 获得工单列表
|
*
|
* @param ids 编号数组
|
* @return 工单列表
|
*/
|
List<MesProWorkOrderDO> getWorkOrderList(Collection<Long> ids);
|
|
/**
|
* 获得工单 Map
|
*
|
* @param ids 编号数组
|
* @return 工单 Map
|
*/
|
default Map<Long, MesProWorkOrderDO> getWorkOrderMap(Collection<Long> ids) {
|
return convertMap(getWorkOrderList(ids), MesProWorkOrderDO::getId);
|
}
|
|
/**
|
* 校验工单已确认
|
*
|
* @param id 编号
|
* @return 工单
|
*/
|
MesProWorkOrderDO validateWorkOrderConfirmed(Long id);
|
|
/**
|
* 确认工单（草稿 → 已确认）
|
*
|
* @param id 编号
|
*/
|
void confirmWorkOrder(Long id);
|
|
/**
|
* 完成工单
|
*
|
* @param id 编号
|
*/
|
void finishWorkOrder(Long id);
|
|
/**
|
* 取消工单
|
*
|
* @param id 编号
|
*/
|
void cancelWorkOrder(Long id);
|
|
/**
|
* 提交工单审批
|
*
|
* @param id 编号
|
* @param userId 用户编号
|
*/
|
void submitWorkOrder(Long id, Long userId);
|
|
/**
|
* 更新工单的审批状态
|
*
|
* @param id 编号
|
* @param bpmResult BPM 审批结果
|
*/
|
void updateWorkOrderAuditStatus(Long id, Integer bpmResult);
|
|
/**
|
* 累加工单的已生产数量
|
*
|
* @param id 工单编号
|
* @param incrQuantityProduced 本次已生产数量增量
|
*/
|
void updateProducedQuantity(Long id, BigDecimal incrQuantityProduced);
|
|
/**
|
* 根据供应商 ID 统计工单数量
|
*
|
* @param vendorId 供应商 ID
|
* @return 数量
|
*/
|
Long getWorkOrderCountByVendorId(Long vendorId);
|
|
}
|
