dramaling-vocab-learning/backend/DramaLing.Api/Contracts/Services/Review/IReviewService.cs

27 lines
863 B
C#

using DramaLing.Api.Models.DTOs;
using DramaLing.Api.Controllers;
namespace DramaLing.Api.Contracts.Services.Review;
public interface IReviewService
{
/// <summary>
/// 獲取待複習的詞卡列表
/// </summary>
Task<ApiResponse<object>> GetDueFlashcardsAsync(Guid userId, DueFlashcardsQuery query);
/// <summary>
/// 提交複習結果
/// </summary>
Task<ApiResponse<ReviewResult>> SubmitReviewAsync(Guid userId, Guid flashcardId, ReviewRequest request);
/// <summary>
/// 獲取複習統計
/// </summary>
Task<ApiResponse<ReviewStats>> GetReviewStatsAsync(Guid userId, string period = "today");
/// <summary>
/// 標記詞彙為已掌握,更新下次複習時間
/// </summary>
Task<ApiResponse<object>> MarkWordMasteredAsync(Guid userId, Guid flashcardId);
}