package com.guo.learningprogresstracker.service;

import com.guo.learningprogresstracker.dto.ReviewFeedItem;
import com.guo.learningprogresstracker.dto.ReviewTaskStats;
import com.guo.learningprogresstracker.entity.StudyReportFragmentsEntity;
import com.guo.learningprogresstracker.entity.StudyReportsEntity;
import com.guo.learningprogresstracker.exception.NotFindEntitiesException;

import java.util.List;

/**
 * 复习模块 Service 接口
 */
public interface ReviewService {

    /**
     * 获取复习 feed 列表，合并报告和残片按时间倒序
     */
    List<ReviewFeedItem> getReviewFeed(int limit, String mode);

    /**
     * 获取所有任务的复习统计数据
     */
    List<ReviewTaskStats> getReviewTaskStats();

    /**
     * 获取指定任务的复习统计数据
     */
    ReviewTaskStats getReviewTaskStats(String taskNum);

    /**
     * 获取指定任务下的所有报告和残片
     */
    List<ReviewFeedItem> getTaskReview(String taskNum);

    /**
     * 获取报告详情
     */
    StudyReportsEntity getReportDetail(int id) throws NotFindEntitiesException;

    /**
     * 获取残片详情
     */
    StudyReportFragmentsEntity getFragmentDetail(int id) throws NotFindEntitiesException;
}