gaoluyang
2026-10-30 cbadfd8e691ab335965202a984db16e55ac8e42c
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
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<MesWmStockWarningRuleRespVO> getRulePage(MesWmStockWarningRulePageReqVO pageReqVO);
 
    /**
     * 获得当前触发预警的库存明细
     *
     * @param itemId      物料编号,可空
     * @param warehouseId 仓库编号,可空
     * @return 预警明细
     */
    List<MesWmStockWarningAlertRespVO> getAlertList(Long itemId, Long warehouseId);
 
    /**
     * 库存变动后校验预警规则:跨越下限/上限时发送站内通知
     *
     * @param itemId      物料编号
     * @param warehouseId 仓库编号
     * @param deltaQuantity 本次变动数量(入库为正、出库为负)
     */
    void checkAfterStockChange(Long itemId, Long warehouseId, BigDecimal deltaQuantity);
 
}