package cn.iocoder.yudao.module.iot.service.product;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.iot.controller.admin.product.vo.product.IotProductPageReqVO;
import cn.iocoder.yudao.module.iot.controller.admin.product.vo.product.IotProductSaveReqVO;
import cn.iocoder.yudao.module.iot.dal.dataobject.product.IotProductDO;
import jakarta.validation.Valid;

import javax.annotation.Nullable;
import java.time.LocalDateTime;
import java.util.Collection;
import java.util.List;
import java.util.Map;

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

/**
 * IoT 产品 Service 接口
 *
 * @author ahh
 */
public interface IotProductService {

    /**
     * 创建产品
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createProduct(@Valid IotProductSaveReqVO createReqVO);

    /**
     * 更新产品
     *
     * @param updateReqVO 更新信息
     */
    void updateProduct(@Valid IotProductSaveReqVO updateReqVO);

    /**
     * 删除产品
     *
     * @param id 编号
     */
    void deleteProduct(Long id);

    /**
     * 获得产品
     *
     * @param id 编号
     * @return 产品
     */
    IotProductDO getProduct(Long id);

    /**
     * 【缓存】获得产品
     * <p>
     * 注意：该方法会忽略租户信息，所以调用时，需要确认会不会有跨租户访问的风险！！！
     *
     * @param id 编号
     * @return 产品
     */
    IotProductDO getProductFromCache(Long id);

    /**
     * 根据产品 key 获得产品
     *
     * @param productKey 产品 key
     * @return 产品
     */
    IotProductDO getProductByProductKey(String productKey);

    /**
     * 校验产品存在
     *
     * @param id 编号
     * @return 产品
     */
    IotProductDO validateProductExists(Long id);

    /**
     * 校验产品存在
     *
     * @param productKey 产品 key
     * @return 产品
     */
    IotProductDO validateProductExists(String productKey);

    /**
     * 获得产品分页
     *
     * @param pageReqVO 分页查询
     * @return 产品分页
     */
    PageResult<IotProductDO> getProductPage(IotProductPageReqVO pageReqVO);

    /**
     * 更新产品状态
     *
     * @param id 编号
     * @param status 状态
     */
    void updateProductStatus(Long id, Integer status);

    /**
     * 获得所有产品
     *
     * @return 产品列表
     */
    List<IotProductDO> getProductList();

    /**
     * 根据设备类型获得产品列表
     *
     * @param deviceType 设备类型（可选）
     * @return 产品列表
     */
    List<IotProductDO> getProductList(@Nullable Integer deviceType);

    /**
     * 获得产品数量
     *
     * @param createTime 创建时间，如果为空，则统计所有产品数量
     * @return 产品数量
     */
    Long getProductCount(@Nullable LocalDateTime createTime);

    /**
     * 批量获得产品列表
     *
     * @param ids 产品编号集合
     * @return 产品列表
     */
    List<IotProductDO> getProductList(Collection<Long> ids);

    /**
     * 批量获得产品 Map
     *
     * @param ids 产品编号集合
     * @return 产品 Map（key: 产品编号, value: 产品）
     */
    default Map<Long, IotProductDO> getProductMap(Collection<Long> ids) {
        return convertMap(getProductList(ids), IotProductDO::getId);
    }

    /**
     * 批量校验产品存在
     *
     * @param ids 产品编号集合
     */
    void validateProductsExist(Collection<Long> ids);

    /**
     * 同步产品的 TDengine 表结构
     *
     * 目的：当 MySQL 和 TDengine 不同步时，强制将已发布产品的表结构同步到 TDengine 中
     */
    void syncProductPropertyTable();

}