package cn.iocoder.yudao.module.mes.service.wm.stockwarning; import cn.iocoder.yudao.framework.common.pojo.PageResult; import cn.iocoder.yudao.module.mes.controller.admin.wm.stockwarning.vo.MesWmStockWarningAlertRespVO; import cn.iocoder.yudao.module.mes.controller.admin.wm.stockwarning.vo.MesWmStockWarningRulePageReqVO; import cn.iocoder.yudao.module.mes.controller.admin.wm.stockwarning.vo.MesWmStockWarningRuleRespVO; import cn.iocoder.yudao.module.mes.controller.admin.wm.stockwarning.vo.MesWmStockWarningRuleSaveReqVO; import cn.iocoder.yudao.module.mes.dal.dataobject.wm.stockwarning.MesWmStockWarningRuleDO; import java.math.BigDecimal; import java.util.List; /** * MES 库存预警 Service 接口 * * 需求 5.1②:为商品配置库存预警规则,库存异常时自动标记并通知 */ public interface MesWmStockWarningService { /** * 创建库存预警规则 */ Long createRule(MesWmStockWarningRuleSaveReqVO createReqVO); /** * 更新库存预警规则 */ void updateRule(MesWmStockWarningRuleSaveReqVO updateReqVO); /** * 删除库存预警规则 */ void deleteRule(Long id); /** * 获得库存预警规则 */ MesWmStockWarningRuleDO getRule(Long id); /** * 获得库存预警规则分页 */ PageResult getRulePage(MesWmStockWarningRulePageReqVO pageReqVO); /** * 获得当前触发预警的库存明细 * * @param itemId 物料编号,可空 * @param warehouseId 仓库编号,可空 * @return 预警明细 */ List getAlertList(Long itemId, Long warehouseId); /** * 库存变动后校验预警规则:跨越下限/上限时发送站内通知 * * @param itemId 物料编号 * @param warehouseId 仓库编号 * @param deltaQuantity 本次变动数量(入库为正、出库为负) */ void checkAfterStockChange(Long itemId, Long warehouseId, BigDecimal deltaQuantity); }