klp-oa/klp-wms/src/main/java/com/klp/service/IWmsStockService.java

package com.klp.service;

import com.klp.domain.WmsStock;
import com.klp.domain.vo.WmsStockVo;
import com.klp.domain.bo.WmsStockBo;
import com.klp.common.core.page.TableDataInfo;
import com.klp.common.core.domain.PageQuery;

import java.math.BigDecimal;
import java.util.Collection;
import java.util.List;

/**
 * 库存：原材料/产品与库区/库位的存放关系Service接口
 *
 * @author Joshi
 * @date 2025-07-18
 */
public interface IWmsStockService {

    /**
     * 查询库存：原材料/产品与库区/库位的存放关系
     */
    WmsStockVo queryById(Long stockId);

    /**
     * 查询库存：原材料/产品与库区/库位的存放关系列表
     */
    TableDataInfo<WmsStockVo> queryPageList(WmsStockBo bo, PageQuery pageQuery);

    /**
     * 查询库存：原材料/产品与库区/库位的存放关系列表
     */
    List<WmsStockVo> queryList(WmsStockBo bo);

    /**
     * 新增库存：原材料/产品与库区/库位的存放关系
     */
    Boolean insertByBo(WmsStockBo bo);

    /**
     * 修改库存：原材料/产品与库区/库位的存放关系
     */
    Boolean updateByBo(WmsStockBo bo);

    /**
     * 校验并批量删除库存：原材料/产品与库区/库位的存放关系信息
     */
    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);

    /**
     * 根据原材料ID获取库存数量 (用于生成推荐采购计划)
     */
    BigDecimal getStockByItemId(Long rawMaterialId);

    /**
     * 查询库存分布（按仓库统计）
     */
    WmsStockVo queryStockDistribution(WmsStockBo bo);

}