package cn.iocoder.yudao.module.mes.service.pro.task;
|
|
import cn.iocoder.yudao.framework.common.pojo.PageResult;
|
import cn.iocoder.yudao.module.mes.controller.admin.pro.task.vo.MesProTaskPageReqVO;
|
import cn.iocoder.yudao.module.mes.controller.admin.pro.task.vo.MesProTaskSaveReqVO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.pro.task.MesProTaskDO;
|
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 MesProTaskService {
|
|
/**
|
* 创建生产任务
|
*
|
* @param createReqVO 创建信息
|
* @return 编号
|
*/
|
Long createTask(@Valid MesProTaskSaveReqVO createReqVO);
|
|
/**
|
* 更新生产任务
|
*
|
* @param updateReqVO 更新信息
|
*/
|
void updateTask(@Valid MesProTaskSaveReqVO updateReqVO);
|
|
/**
|
* 删除生产任务
|
*
|
* @param id 编号
|
*/
|
void deleteTask(Long id);
|
|
/**
|
* 获得生产任务
|
*
|
* @param id 编号
|
* @return 生产任务
|
*/
|
MesProTaskDO getTask(Long id);
|
|
/**
|
* 获得生产任务分页
|
*
|
* @param pageReqVO 分页查询
|
* @return 生产任务分页
|
*/
|
PageResult<MesProTaskDO> getTaskPage(MesProTaskPageReqVO pageReqVO);
|
|
/**
|
* 获得待报工台账分页（进行中且仍有待报工量的任务）
|
*
|
* @param pageReqVO 分页查询
|
* @return 待报工任务分页
|
*/
|
PageResult<MesProTaskDO> getPendingFeedbackPage(MesProTaskPageReqVO pageReqVO);
|
|
/**
|
* 根据工单编号列表，批量获得生产任务列表
|
*
|
* @param workOrderIds 工单编号列表
|
* @return 生产任务列表
|
*/
|
List<MesProTaskDO> getTaskListByWorkOrderIds(Collection<Long> workOrderIds);
|
|
/**
|
* 校验任务是否存在
|
*
|
* @param id 编号
|
* @return 生产任务
|
*/
|
MesProTaskDO validateTaskExists(Long id);
|
|
/**
|
* 校验任务存在且未完成（非终态）
|
*
|
* @param id 编号
|
* @return 生产任务
|
*/
|
MesProTaskDO validateTaskNotFinished(Long id);
|
|
/**
|
* 获得生产任务列表
|
*
|
* @param ids 编号列表
|
* @return 生产任务列表
|
*/
|
List<MesProTaskDO> getTaskList(Collection<Long> ids);
|
|
/**
|
* 获得生产任务 Map
|
*
|
* @param ids 编号列表
|
* @return 生产任务 Map
|
*/
|
default Map<Long, MesProTaskDO> getTaskMap(Collection<Long> ids) {
|
return convertMap(getTaskList(ids), MesProTaskDO::getId);
|
}
|
|
/**
|
* 根据工单编号，完成所有关联任务
|
*
|
* @param workOrderId 工单编号
|
*/
|
void finishTaskByOrderId(Long workOrderId);
|
|
/**
|
* 根据工单编号，取消所有关联任务
|
*
|
* @param workOrderId 工单编号
|
*/
|
void cancelTaskByOrderId(Long workOrderId);
|
|
/**
|
* 累加任务的已生产、合格、不合格数量
|
*
|
* @param id 任务编号
|
* @param incrProducedQuantity 本次已生产数量增量（不良品也计入）
|
* @param incrQualifyQuantity 本次合格品数量增量
|
* @param incrUnqualifyQuantity 本次不合格品数量增量
|
*/
|
void updateProducedQuantity(Long id,
|
BigDecimal incrProducedQuantity,
|
BigDecimal incrQualifyQuantity,
|
BigDecimal incrUnqualifyQuantity);
|
|
}
|
