package cn.iocoder.yudao.module.mes.service.wm.warning;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.mes.controller.admin.wm.warning.vo.MesWmStockWarningHandleReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.wm.warning.vo.MesWmStockWarningPageReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.wm.warning.vo.MesWmStockWarningRespVO;

import java.util.List;

/**
 * MES 库存预警 Service 接口
 * <p>
 * 预警双通道：实时计算查询 + 定时任务落库。
 */
public interface MesWmStockWarningService {

    /**
     * 获得库存预警分页（落库记录）
     *
     * @param pageReqVO 分页查询
     * @return 预警分页
     */
    PageResult<MesWmStockWarningRespVO> getWarningPage(MesWmStockWarningPageReqVO pageReqVO);

    /**
     * 实时计算当前库存预警（低库存 / 临期 / 库龄），不落库
     *
     * @return 当前预警列表
     */
    List<MesWmStockWarningRespVO> getCurrentWarnings();

    /**
     * 落库当前预警（定时任务调用）：删除旧的未处理预警，写入当前预警，保留已处理历史
     *
     * @return 本次落库条数
     */
    int persistCurrentWarnings();

    /**
     * 处理预警（标记已处理）
     *
     * @param reqVO 处理请求
     */
    void handle(MesWmStockWarningHandleReqVO reqVO);

}