using QYZH.InteractiveMagazine.Models.Dto;
using System.Linq.Expressions;

namespace QYZH.InteractiveMagazine.Repository;

/// <summary>
/// 基础仓储接口
/// </summary>
/// <typeparam name="T">实体类型</typeparam>
public interface IBaseRepository<T> where T : class, new()
{
    /// <summary>
    /// 根据Id获取实体
    /// </summary>
    /// <param name="id">主键Id</param>
    /// <returns>实体对象</returns>
    Task<T?> GetByIdAsync(long id);

    /// <summary>
    /// 获取所有列表
    /// </summary>
    /// <returns>实体列表</returns>
    Task<List<T>> GetListAsync();

    /// <summary>
    /// 根据条件获取列表
    /// </summary>
    /// <param name="where">查询条件</param>
    /// <returns>实体列表</returns>
    Task<List<T>> GetListByWhereAsync(Expression<Func<T, bool>> where);

    /// <summary>
    /// 分页查询
    /// </summary>
    /// <param name="where">查询条件</param>
    /// <param name="pageQuery">分页参数</param>
    /// <returns>分页结果</returns>
    Task<PageListModel<T>> GetPageListAsync(Expression<Func<T, bool>> where, PageQueryModel pageQuery);

    /// <summary>
    /// 插入单条记录
    /// </summary>
    /// <param name="entity">实体对象</param>
    /// <returns>是否成功</returns>
    Task<bool> InsertAsync(T entity);

    /// <summary>
    /// 批量插入记录
    /// </summary>
    /// <param name="entities">实体列表</param>
    /// <returns>是否成功</returns>
    Task<bool> InsertRangeAsync(List<T> entities);

    /// <summary>
    /// 更新单条记录
    /// </summary>
    /// <param name="entity">实体对象</param>
    /// <returns>是否成功</returns>
    Task<bool> UpdateAsync(T entity);

    /// <summary>
    /// 批量更新记录
    /// </summary>
    /// <param name="entities">实体列表</param>
    /// <returns>是否成功</returns>
    Task<bool> UpdateRangeAsync(List<T> entities);

    /// <summary>
    /// 根据Id删除记录（软删除）
    /// </summary>
    /// <param name="id">主键Id</param>
    /// <returns>是否成功</returns>
    Task<bool> DeleteByIdAsync(long id);

    /// <summary>
    /// 根据条件删除记录（软删除）
    /// </summary>
    /// <param name="where">删除条件</param>
    /// <returns>是否成功</returns>
    Task<bool> DeleteByWhereAsync(Expression<Func<T, bool>> where);

    /// <summary>
    /// 根据条件获取记录数
    /// </summary>
    /// <param name="where">查询条件</param>
    /// <returns>记录数</returns>
    Task<int> GetCountAsync(Expression<Func<T, bool>> where);
}