package org.hzhub.erp.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.hzhub.erp.domain.entity.ErpApiStats;

import java.time.LocalDateTime;
import java.util.List;

/**
 * ERP动态API调用统计Mapper
 *
 * @author HZHub Team
 */
@Mapper
public interface ErpApiStatsMapper extends BaseMapper<ErpApiStats> {

    /**
     * 根据API ID和时间范围查询统计
     *
     * @param apiId API ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 统计列表
     */
    List<ErpApiStats> selectByApiIdAndTime(@Param("apiId") Long apiId,
                                            @Param("startTime") LocalDateTime startTime,
                                            @Param("endTime") LocalDateTime endTime);

    /**
     * 查询API的错误日志
     *
     * @param apiId API ID
     * @param limit 限制数量
     * @return 错误日志列表
     */
    List<ErpApiStats> selectErrorLogByApiId(@Param("apiId") Long apiId,
                                            @Param("limit") Integer limit);

    /**
     * 统计API调用次数
     *
     * @param apiId API ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 调用次数
     */
    Long countByApiId(@Param("apiId") Long apiId,
                     @Param("startTime") LocalDateTime startTime,
                     @Param("endTime") LocalDateTime endTime);

    /**
     * 统计API平均响应时间
     *
     * @param apiId API ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 平均响应时间（ms）
     */
    Integer avgResponseTimeByApiId(@Param("apiId") Long apiId,
                                   @Param("startTime") LocalDateTime startTime,
                                   @Param("endTime") LocalDateTime endTime);

    /**
     * 统计API错误率
     *
     * @param apiId API ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 错误次数
     */
    Long countErrorByApiId(@Param("apiId") Long apiId,
                          @Param("startTime") LocalDateTime startTime,
                          @Param("endTime") LocalDateTime endTime);
}