package org.dromara.app.service;

import org.dromara.app.domain.bo.AppDeviceBo;
import org.dromara.app.domain.vo.AppDeviceVo;
import org.dromara.app.domain.vo.DashboardStatsVo;
import org.dromara.common.mybatis.core.page.PageQuery;
import org.dromara.common.mybatis.core.page.TableDataInfo;

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

/**
 * 设备信息
Service接口
 *
 * @author Lion Li
 * @date 2026-04-25
 */
public interface IAppDeviceService {

    /**
     * 查询设备信息

     *
     * @param id 主键
     * @return 设备信息

     */
    AppDeviceVo queryById(String deviceNo);

    /**
     * 按设备编号批量查询设备。
     *
     * @param deviceNos 设备编号集合
     * @return 设备列表
     */
    List<AppDeviceVo> queryByDeviceNos(Collection<String> deviceNos);

    /**
     * 分页查询设备信息
列表
     *
     * @param bo        查询条件
     * @param pageQuery 分页参数
     * @return 设备信息
分页列表
     */
    TableDataInfo<AppDeviceVo> queryPageList(AppDeviceBo bo, PageQuery pageQuery);

    /**
     * 查询符合条件的设备信息
列表
     *
     * @param bo 查询条件
     * @return 设备信息
列表
     */
    List<AppDeviceVo> queryList(AppDeviceBo bo);

    /**
     * 新增设备信息

     *
     * @param bo 设备信息

     * @return 是否新增成功
     */
    Boolean insertByBo(AppDeviceBo bo);

    /**
     * 修改设备信息

     *
     * @param bo 设备信息

     * @return 是否修改成功
     */
    Boolean updateByBo(AppDeviceBo bo);

    /**
     * MQTT设备注册或刷新设备基础信息
     *
     * @param bo 设备信息
     * @return 是否保存成功
     */
    Boolean registerByMqtt(AppDeviceBo bo);

    /**
     * 将已注册设备绑定到当前登录用户
     *
     * @param bo 设备信息
     * @return 设备信息
     */
    AppDeviceVo bindRegisteredDevice(AppDeviceBo bo);

    Boolean switchDevice(String deviceNo, String workStatus, String startTime, Integer durationMin);

    /**
     * 批量生成设备二维码并保存到设备二维码字段
     *
     * @param deviceNos 设备编号集合
     * @return 是否生成成功
     */
    Boolean generateQrCode(Collection<String> deviceNos);

    /**
     * 校验并批量删除设备信息
信息
     *
     * @param deviceNos     待删除的主键集合
     * @param isValid 是否进行有效性校验
     * @return 是否删除成功
     */
    Boolean deleteWithValidByIds(Collection<String> deviceNos, Boolean isValid);

    /**
     * 解绑设备：清空设备用户、删除设备关联数据，并下发设备初始化指令。
     *
     * @param deviceNos 设备编号集合
     * @param userId 当前用户ID
     * @return 是否解绑成功
     */
    Boolean unbindDevices(Collection<String> deviceNos, Long userId);

    Map<String, Object> bindDeviceStatus(AppDeviceBo appDevice);

    /**
     * 仪表盘统计 — 返回首页 8 个统计卡片数据。
     *
     * @return 仪表盘统计 VO（设备总数/在线/待机/离线/故障/工作中/空闲/未绑定用户）
     */
    DashboardStatsVo getDashboardStats();
}
