using CMS.Plugin.$NameSpacePath$.Application.Contracts.Dtos.$EntityName$;
using Volo.Abp.Application.Services;
using CmsQueryExtensions.Entitys;
using System.Linq.Expressions;
using CMS.Plugin.$NameSpacePath$.Domain.$EntityName$;

namespace CMS.Plugin.$NameSpacePath$.Application.Contracts.Services;

/// <summary>
/// $ChinaComment$应用服务接口
/// </summary>
public interface I$EntityName$AppService : ICrudAppService<$EntityName$Dto, Guid, Get$EntityName$Input, $EntityName$CreateDto, $EntityName$UpdateDto>
{
    /// <summary>
    /// 克隆$ChinaComment$
    /// </summary>
    /// <param name="ids"></param>
    /// <returns></returns>
    Task<List<$EntityName$Dto>> CloneAsync(IEnumerable<Guid> ids, MyCurrentUser myCurrentUser);

    /// <summary>
    /// 删除$ChinaComment$
    /// </summary>
    /// <param name="ids"></param>
    /// <returns></returns>
    Task DeleteManyAsync(IEnumerable<Guid> ids, MyCurrentUser myCurrentUser);

    /// <summary>
    /// 物理删除$ChinaComment$
    /// </summary>
    /// <param name="id">主键ID</param>
    /// <param name="cancellationToken"></param>
    /// <returns></returns>
    Task DeletePermanentlyAsync(Guid id, MyCurrentUser myCurrentUser, CancellationToken cancellationToken = default);


    /// <summary>
    /// 批量物理删除$ChinaComment$（直接删除，不软删除）
    /// </summary>
    /// <param name="ids">要删除的主键ID列表</param>
    /// <param name="cancellationToken"></param>
    /// <returns></returns>
    Task BatchDeletePermanentlyAsync(IEnumerable<Guid> ids, MyCurrentUser myCurrentUser, CancellationToken cancellationToken = default);

    /// <summary>
    /// 调整排序$ChinaComment$
    /// </summary>
    /// <param name="id"></param>
    /// <param name="sort"></param>
    /// <returns></returns>
    Task AdjustSortAsync(Guid id, int sort);

    /// <summary>
    /// 导入$ChinaComment$
    /// </summary>
    /// <param name="input"></param>
    /// <returns></returns>
    Task ImportAsync($EntityName$sImportModel input, MyCurrentUser myCurrentUser);

    /// <summary>
    /// 导出$ChinaComment$
    /// </summary>
    /// <param name="input"></param>
    /// <returns></returns>
    Task<(Dictionary<string, object> Sheets, string FileName)> ExportAsync(Get$EntityName$Input input);

    /// <summary>
    /// 根据条件获取$ChinaComment$列表
    /// </summary>
    /// <param name="whereConditions"></param>
    /// <param name="cancellationToken"></param>
    /// <returns></returns>
    Task<List<$EntityName$>> GetListByFilterAsync(Expression<Func<$EntityName$, bool>> whereConditions, CancellationToken cancellationToken = default);


    /// <summary>
    ///  根据条件获取单个$ChinaComment$
    /// </summary>
    /// <param name="whereConditions"></param>
    /// <param name="isMultipleThrowException">是否查询出多条就报错</param>
    /// <param name="cancellationToken"></param>
    /// <returns></returns>
    /// <exception cref="UserFriendlyException"></exception>
    Task<$EntityName$> GetSingleByFilterAsync(Expression<Func<$EntityName$, bool>> whereConditions, bool is​MultipleThrowException = false, CancellationToken cancellationToken = default);

    /// <summary> 
    /// 根据条件获取$ChinaComment$列表
    /// </summary> 
    /// <param name="input"></param> 
    /// <returns></returns> 
    Task<List<$EntityName$Dto>> FindListByFilterAsync(Get$EntityName$Input input, CancellationToken cancellationToken = default);
    
    /// <summary> 
    /// 根据条件获取单个$ChinaComment$
    /// </summary> 
    /// <param name="input"></param> 
    /// <returns></returns> 
    Task<$EntityName$Dto> FindSingleByFilterAsync(Get$EntityName$Input input, CancellationToken cancellationToken = default);
}