package com.ard.work.device.camera.service;

import com.ard.work.api.domian.ArdCameraHepu;
import java.util.List;

/**
 * 合浦设备物理节点 Service 接口
 * 
 * @author liusuyi
 * @date 2026-03-17
 */
public interface IArdCameraHepuService {

    /**
     * 查询合浦设备物理节点
     * 
     * @param id 节点ID
     * @return 合浦设备物理节点
     */
    public ArdCameraHepu selectArdCameraHepuById(String id);

    /**
     * 【核心】根据主设备ID查询所有子节点列表
     * 用于设备登录、通道获取等场景
     * 
     * @param cameraId 主设备ID (ard_camera.id)
     * @return 合浦设备物理节点列表
     */
    public List<ArdCameraHepu> selectByCameraId(String cameraId);

    /**
     * 查询合浦设备物理节点列表
     * 
     * @param ardCameraHepu 合浦设备物理节点
     * @return 合浦设备物理节点集合
     */
    public List<ArdCameraHepu> selectArdCameraHepuList(ArdCameraHepu ardCameraHepu);

    /**
     * 新增合浦设备物理节点
     * <p>
     * 注意：通常在新增合浦主设备时，会批量调用此方法插入3条记录。
     * 建议在 ServiceImpl 中配合事务使用。
     * </p>
     * 
     * @param ardCameraHepu 合浦设备物理节点
     * @return 结果
     */
    public int insertArdCameraHepu(ArdCameraHepu ardCameraHepu);

    /**
     * 【新增】批量插入合浦物理节点
     * @param list 节点列表
     * @return 插入行数
     */
    public int batchInsertArdCameraHepu(List<ArdCameraHepu> list);
    /**
     * 修改合浦设备物理节点
     * 
     * @param ardCameraHepu 合浦设备物理节点
     * @return 结果
     */
    public int updateArdCameraHepu(ArdCameraHepu ardCameraHepu);


    /**
     * 删除合浦设备物理节点信息
     * 
     * @param id 节点ID
     * @return 结果
     */
    public int deleteArdCameraHepuById(String id);

    /**
     * 批量删除合浦设备物理节点
     * 
     * @param ids 需要删除的节点ID数组
     * @return 结果
     */
    public int deleteArdCameraHepuByIds(String[] ids);

    /**
     * 【核心】根据主设备ID删除所有子节点
     * <p>
     * 当删除主表 ard_camera 记录时，必须调用此方法清理子表数据
     * </p>
     * 
     * @param cameraId 主设备ID
     * @return 结果
     */
    public int deleteByCameraId(String cameraId);

}