82 lines
3.2 KiB
C#
82 lines
3.2 KiB
C#
|
using QYZH.InteractiveMagazine.Models.Dto.UserAnswerTaskService;
|
|||
|
|
using QYZH.InteractiveMagazine.Models.Entity;
|
|||
|
|
|
|||
|
|
namespace QYZH.InteractiveMagazine.IService;
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 用户作答任务服务接口
|
|||
|
|
/// </summary>
|
|||
|
|
public interface IUserAnswerTaskService : IBaseService<JournalPageTaskUserAnswer>
|
|||
|
|
{
|
|||
|
|
/// <summary>
|
|||
|
|
/// 获取用户期刊学习进度列表（按期刊分组）
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="userId">用户Id</param>
|
|||
|
|
/// <returns>按期刊分组的学习进度数据</returns>
|
|||
|
|
Task<List<JournalProgressOutput>> GetJournalProgressAsync(long userId);
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 获取目录列表（按一级目录分组，二级目录含完成状态）
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="journalId">期刊Id</param>
|
|||
|
|
/// <param name="userId">用户Id</param>
|
|||
|
|
/// <returns>按一级目录分组的目录列表</returns>
|
|||
|
|
Task<List<CatalogListOutput>> GetCatalogListAsync(long journalId, long userId);
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 获取一级目录概览（含二级目录详情、页码范围、任务完成状态）
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="catalogId">一级目录Id（JournalCatalogId）</param>
|
|||
|
|
/// <param name="userId">用户Id</param>
|
|||
|
|
/// <returns>一级目录概览数据</returns>
|
|||
|
|
Task<CatalogOverviewOutput> GetCatalogOverviewAsync(long catalogId, long userId);
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 获取用户答题任务列表
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="catalogId">二级目录Id（JournalCatalogId）</param>
|
|||
|
|
/// <param name="userId">用户Id</param>
|
|||
|
|
/// <returns>答题任务列表</returns>
|
|||
|
|
Task<UserAnswerTaskListOutput> GetUserAnswerTaskListAsync(long catalogId, long userId);
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 获取跨页题目详情
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="journalPageTaskId">任务Id</param>
|
|||
|
|
/// <param name="userId">用户Id</param>
|
|||
|
|
/// <returns>跨页题目详情</returns>
|
|||
|
|
Task<CrossPageTaskOutput> GetCrossPageTaskAsync(long journalPageTaskId, long userId);
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 领取任务积分
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="journalPageTaskId">任务Id</param>
|
|||
|
|
/// <param name="userId">用户Id</param>
|
|||
|
|
/// <returns>领取结果</returns>
|
|||
|
|
Task<ClaimTaskPointsOutput> ClaimTaskPointsAsync(long journalPageTaskId, long userId);
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 批量领取任务积分（一键领取）
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="input">批量领取参数</param>
|
|||
|
|
/// <param name="userId">用户Id</param>
|
|||
|
|
/// <returns>批量领取结果</returns>
|
|||
|
|
Task<BatchClaimPointsOutput> BatchClaimPointsAsync(BatchClaimPointsInput input, long userId);
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 获取杂志列表
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="userId">用户Id</param>
|
|||
|
|
/// <param name="queryType">查询类型：Bound=已绑定，Unbound=未绑定（添加书籍用），默认是：Bound</param>
|
|||
|
|
/// <returns>杂志列表</returns>
|
|||
|
|
Task<List<JournalListOutput>> GetJournalListAsync(long userId, string? queryType);
|
|||
|
|
|
|||
|
|
/// <summary>
|
|||
|
|
/// 新增学生
|
|||
|
|
/// </summary>
|
|||
|
|
/// <param name="input">新增学生参数</param>
|
|||
|
|
/// <param name="userId">当前登录用户Id（WxUserId）</param>
|
|||
|
|
/// <returns>新增学生结果</returns>
|
|||
|
|
Task<bool> AddStudentAsync(AddStudentInput input, long userId);
|
|||
|
|
}
|