using MiAssessment.Model.Models.Home;


namespace MiAssessment.Core.Interfaces;

/// <summary>
/// 首页服务接口
/// </summary>
public interface IHomeService
{
    /// <summary>
    /// 获取Banner列表
    /// </summary>
    /// <remarks>
    /// 返回所有启用状态的Banner记录，按Sort降序排列
    /// </remarks>
    /// <returns>Banner列表</returns>
    Task<List<BannerDto>> GetBannerListAsync();

    /// <summary>
    /// 获取测评入口列表
    /// </summary>
    /// <remarks>
    /// 返回所有未删除的测评类型，包含状态信息（已上线/即将上线）
    /// </remarks>
    /// <returns>测评类型列表</returns>
    Task<List<AssessmentTypeDto>> GetAssessmentListAsync();

    /// <summary>
    /// 获取首页导航入口列表
    /// </summary>
    /// <param name="position">区域标识（可选），不传返回全部</param>
    Task<List<HomeNavigationDto>> GetNavigationListAsync(int? position = null);

    /// <summary>
    /// 获取宣传图列表
    /// </summary>
    /// <remarks>
    /// 返回首页位置（Position=1）且启用状态的宣传图
    /// </remarks>
    /// <returns>宣传图列表</returns>
    Task<List<PromotionDto>> GetPromotionListAsync();
}