package cn.iocoder.yudao.module.iot.service.rule.scene;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.iot.controller.admin.rule.vo.scene.IotSceneRulePageReqVO;
import cn.iocoder.yudao.module.iot.controller.admin.rule.vo.scene.IotSceneRuleSaveReqVO;
import cn.iocoder.yudao.module.iot.core.mq.message.IotDeviceMessage;
import cn.iocoder.yudao.module.iot.dal.dataobject.rule.IotSceneRuleDO;
import cn.iocoder.yudao.module.iot.enums.rule.IotSceneRuleTriggerTypeEnum;
import jakarta.validation.Valid;

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

/**
 * IoT 规则场景规则 Service 接口
 *
 * @author 芋道源码
 */
public interface IotSceneRuleService {

    /**
     * 创建场景联动
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createSceneRule(@Valid IotSceneRuleSaveReqVO createReqVO);

    /**
     * 更新场景联动
     *
     * @param updateReqVO 更新信息
     */
    void updateSceneRule(@Valid IotSceneRuleSaveReqVO updateReqVO);

    /**
     * 更新场景联动状态
     *
     * @param id     场景联动编号
     * @param status 状态
     */
    void updateSceneRuleStatus(Long id, Integer status);

    /**
     * 删除场景联动
     *
     * @param id 编号
     */
    void deleteSceneRule(Long id);

    /**
     * 获得场景联动
     *
     * @param id 编号
     * @return 场景联动
     */
    IotSceneRuleDO getSceneRule(Long id);

    /**
     * 获得场景联动分页
     *
     * @param pageReqVO 分页查询
     * @return 场景联动分页
     */
    PageResult<IotSceneRuleDO> getSceneRulePage(IotSceneRulePageReqVO pageReqVO);

    /**
     * 校验规则场景联动规则编号们是否存在。如下情况，视为无效：
     * 1. 规则场景联动规则编号不存在
     *
     * @param ids 场景联动规则编号数组
     */
    void validateSceneRuleList(Collection<Long> ids);

    /**
     * 获得指定状态的场景联动列表
     *
     * @param status 状态
     * @return 场景联动列表
     */
    List<IotSceneRuleDO> getSceneRuleListByStatus(Integer status);

    /**
     * 【缓存】获得指定设备的场景列表
     *
     * @param productId 产品 ID
     * @param deviceId  设备 ID
     * @return 场景列表
     */
    List<IotSceneRuleDO> getSceneRuleListByProductIdAndDeviceIdFromCache(Long productId, Long deviceId);

    /**
     * 基于 {@link IotSceneRuleTriggerTypeEnum} 场景，执行规则场景
     * 1. {@link IotSceneRuleTriggerTypeEnum#DEVICE_STATE_UPDATE}
     * 2. {@link IotSceneRuleTriggerTypeEnum#DEVICE_PROPERTY_POST}
     *    {@link IotSceneRuleTriggerTypeEnum#DEVICE_EVENT_POST}
     * 3. {@link IotSceneRuleTriggerTypeEnum#DEVICE_EVENT_POST}
     *    {@link IotSceneRuleTriggerTypeEnum#DEVICE_SERVICE_INVOKE}
     * @param message 消息
     */
    void executeSceneRuleByDevice(IotDeviceMessage message);

    /**
     * 基于 {@link IotSceneRuleTriggerTypeEnum#TIMER} 场景，执行规则场景
     *
     * @param id 场景联动规则编号
     */
    void executeSceneRuleByTimer(Long id);

}