package cn.iocoder.yudao.module.mes.service.wm.stocktaking.plan;
|
|
import cn.iocoder.yudao.framework.common.pojo.PageResult;
|
import cn.iocoder.yudao.module.mes.controller.admin.wm.stocktaking.plan.vo.MesWmStockTakingPlanPageReqVO;
|
import cn.iocoder.yudao.module.mes.controller.admin.wm.stocktaking.plan.vo.MesWmStockTakingPlanSaveReqVO;
|
import cn.iocoder.yudao.module.mes.dal.dataobject.wm.stocktaking.plan.MesWmStockTakingPlanDO;
|
import jakarta.validation.Valid;
|
|
import java.time.LocalDateTime;
|
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 MesWmStockTakingPlanService {
|
|
/**
|
* 创建盘点方案
|
*
|
* @param createReqVO 创建信息
|
* @return 盘点方案编号
|
*/
|
Long createStockTakingPlan(@Valid MesWmStockTakingPlanSaveReqVO createReqVO);
|
|
/**
|
* 更新盘点方案
|
*
|
* @param updateReqVO 更新信息
|
*/
|
void updateStockTakingPlan(@Valid MesWmStockTakingPlanSaveReqVO updateReqVO);
|
|
/**
|
* 删除盘点方案
|
*
|
* @param id 盘点方案编号
|
*/
|
void deleteStockTakingPlan(Long id);
|
|
/**
|
* 更新盘点方案状态。
|
*
|
* @param id 盘点方案编号
|
* @param status 状态
|
*/
|
void updateStockTakingPlanStatus(Long id, Integer status);
|
|
/**
|
* 获得盘点方案
|
*
|
* @param id 盘点方案编号
|
* @return 盘点方案
|
*/
|
MesWmStockTakingPlanDO getStockTakingPlan(Long id);
|
|
/**
|
* 校验盘点方案是否存在
|
*
|
* @param id 盘点方案编号
|
* @return 盘点方案
|
*/
|
MesWmStockTakingPlanDO validateStockTakingPlanExists(Long id);
|
|
/**
|
* 校验盘点方案是否可编辑
|
*
|
* @param id 盘点方案编号
|
* @return 盘点方案
|
*/
|
MesWmStockTakingPlanDO validateStockTakingPlanEditable(Long id);
|
|
/**
|
* 校验盘点方案存在且已启用
|
*
|
* @param id 盘点方案编号
|
* @return 盘点方案
|
*/
|
MesWmStockTakingPlanDO validateStockTakingPlanEnabled(Long id);
|
|
/**
|
* 获得盘点方案列表。
|
*
|
* @param ids 盘点方案编号集合
|
* @return 盘点方案列表
|
*/
|
List<MesWmStockTakingPlanDO> getStockTakingPlanList(Collection<Long> ids);
|
|
/**
|
* 获得盘点方案 Map
|
*
|
* @param ids 盘点方案编号集合
|
* @return 盘点方案 Map
|
*/
|
default Map<Long, MesWmStockTakingPlanDO> getStockTakingPlanMap(Collection<Long> ids) {
|
return convertMap(getStockTakingPlanList(ids), MesWmStockTakingPlanDO::getId);
|
}
|
|
/**
|
* 分页查询盘点方案
|
*
|
* @param pageReqVO 分页查询条件
|
* @return 盘点方案分页结果
|
*/
|
PageResult<MesWmStockTakingPlanDO> getStockTakingPlanPage(MesWmStockTakingPlanPageReqVO pageReqVO);
|
|
/**
|
* 获取启用且开启定期自动生成的盘点方案列表
|
*
|
* <p>供后台定时任务扫描：按各方案配置的 cron 周期自动创建盘点任务。
|
*
|
* @return 盘点方案列表
|
*/
|
List<MesWmStockTakingPlanDO> getEnableAutoGeneratePlanList();
|
|
/**
|
* 更新盘点方案上次自动生成时间
|
*
|
* @param id 盘点方案编号
|
* @param time 上次自动生成时间
|
*/
|
void updateStockTakingPlanLastGenerateTime(Long id, LocalDateTime time);
|
|
}
|
