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

package com.klp.service;

import com.klp.domain.vo.WmsActualWarehouseVo;
import com.klp.domain.vo.WmsActualWarehouseTreeVo;
import com.klp.domain.vo.WmsActualWarehouseImportVo;
import com.klp.domain.bo.WmsActualWarehouseBo;
import com.klp.domain.bo.WmsActualWarehouseHierarchyBo;
import com.klp.domain.bo.WmsActualWarehouseBatchGenerateBo;

import java.util.Collection;
import java.util.List;

/**
 * 实际库区/库位自关联Service接口
 *
 * @author klp
 * @date 2025-11-24
 */
public interface IWmsActualWarehouseService {

    /**
     * 查询实际库区/库位自关联
     */
    WmsActualWarehouseVo queryById(Long actualWarehouseId);


    /**
     * 查询实际库区/库位自关联列表
     */
    List<WmsActualWarehouseVo> queryList(WmsActualWarehouseBo bo);

    /**
     * 查询完整的三级目录树
     */
    List<WmsActualWarehouseTreeVo> queryTree(WmsActualWarehouseBo bo);

    /**
     * 新增实际库区/库位自关联
     */
    Boolean insertByBo(WmsActualWarehouseBo bo);

    /**
     * 通过一次提交批量创建/复用三级目录
     */
    List<Long> createHierarchy(WmsActualWarehouseHierarchyBo bo);

    /**
     * 导入层级目录
     */
    void importHierarchy(List<WmsActualWarehouseImportVo> importList);

    /**
     * 修改实际库区/库位自关联
     */
    Boolean updateByBo(WmsActualWarehouseBo bo);

    /**
     * 校验并批量删除实际库区/库位自关联信息
     */
    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);

    List<WmsActualWarehouseTreeVo> queryTreeExcludeLevelThree(WmsActualWarehouseBo bo);

    /**
     * 批量生成库位
     * @return 成功创建数量
     */
    int batchGenerateLocations(WmsActualWarehouseBatchGenerateBo bo);
}