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

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.mes.controller.admin.wm.warehouse.vo.area.MesWmWarehouseAreaPageReqVO;
import cn.iocoder.yudao.module.mes.controller.admin.wm.warehouse.vo.area.MesWmWarehouseAreaSaveReqVO;
import cn.iocoder.yudao.module.mes.dal.dataobject.wm.warehouse.MesWmWarehouseAreaDO;
import jakarta.validation.Valid;

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

import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;

/**
 * MES 库位 Service 接口
 */
public interface MesWmWarehouseAreaService {

    /**
     * 创建库位
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createWarehouseArea(@Valid MesWmWarehouseAreaSaveReqVO createReqVO);

    /**
     * 更新库位
     *
     * @param updateReqVO 更新信息
     */
    void updateWarehouseArea(@Valid MesWmWarehouseAreaSaveReqVO updateReqVO);

    /**
     * 删除库位
     *
     * @param id 编号
     */
    void deleteWarehouseArea(Long id);

    /**
     * 校验库位存在
     *
     * @param id 编号
     * @return 库位
     */
    MesWmWarehouseAreaDO validateWarehouseAreaExists(Long id);

    /**
     * 获得库位
     *
     * @param id 编号
     * @return 库位
     */
    MesWmWarehouseAreaDO getWarehouseArea(Long id);

    /**
     * 获得库位分页
     *
     * @param pageReqVO 分页参数
     * @return 库位分页
     */
    PageResult<MesWmWarehouseAreaDO> getWarehouseAreaPage(MesWmWarehouseAreaPageReqVO pageReqVO);

    /**
     * 按库区获得库位列表
     *
     * @param locationId 库区编号
     * @return 库位列表
     */
    List<MesWmWarehouseAreaDO> getWarehouseAreaList(Long locationId);

    /**
     * 按编号集合获得库位列表
     *
     * @param ids 编号集合
     * @return 库位列表
     */
    List<MesWmWarehouseAreaDO> getWarehouseAreaList(Collection<Long> ids);

    default Map<Long, MesWmWarehouseAreaDO> getWarehouseAreaMap(Collection<Long> ids) {
        return convertMap(getWarehouseAreaList(ids), MesWmWarehouseAreaDO::getId);
    }

    /**
     * 获得指定库区下的库位数量
     *
     * @param locationId 库区编号
     * @return 库位数量
     */
    Long getWarehouseAreaCountByLocationId(Long locationId);

    /**
     * 校验仓库、库区、库位的父子关系
     *
     * @param warehouseId 仓库编号
     * @param locationId 库区编号
     * @param areaId 库位编号
     */
    void validateWarehouseAreaExists(Long warehouseId, Long locationId, Long areaId);

    /**
     * 批量设置指定库区下所有库位的混放规则
     *
     * @param locationId 库区编号
     * @param allowItemMixing 是否允许物料混放（null 表示不修改）
     * @param allowBatchMixing 是否允许批次混放（null 表示不修改）
     */
    void updateByLocationId(Long locationId, Boolean allowItemMixing, Boolean allowBatchMixing);

    /**
     * 按编码获得库位（如果是虚拟线边库位编码且不存在，会自动插入）
     *
     * @param code 编码
     * @return 库位
     */
    MesWmWarehouseAreaDO getWarehouseAreaByCode(String code);

}