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);
}