数据统计

schoolNewsServ/api/api-study/src/main/java/org/xyzh/api/study/record/LearningRecordService.java

@@ -5,6 +5,7 @@ import org.xyzh.common.dto.study.TbLearningRecord;
 
 import java.math.BigDecimal;
 import java.util.List;
+import java.util.Map;
 
 /**
  * @description 学习记录服务接口
@@ -110,4 +111,22 @@ public interface LearningRecordService {
      * @since 2025-10-24
      */
     ResultDomain<TbLearningRecord> getCourseLearningRecord(TbLearningRecord learningRecord);
+
+    // ----------------学习记录统计相关--------------------------------
+
+    /**
+     * @description 获取学习记录统计图表数据
+     * @return ResultDomain<Map<String, Object>> 图表数据（本周课程和文章的总学习时长）
+     * @author yslg
+     * @since 2025-10-30
+     */
+    ResultDomain<Map<String, Object>> getStudyRecordsCharts();
+
+    /**
+     * @description 获取学习记录排行榜数据
+     * @return ResultDomain<Map<String, Object>> 排行榜数据（学习时长排行榜、课程排行榜、文章排行榜、任务完成排行榜）
+     * @author yslg
+     * @since 2025-10-30
+     */
+    ResultDomain<Map<String, Object>> getStudyRecordsRankings();
 }

schoolNewsServ/api/api-study/src/main/java/org/xyzh/api/study/task/LearningTaskService.java

@@ -9,6 +9,7 @@ import org.xyzh.common.vo.TaskVO;
 import org.xyzh.common.dto.study.TbTaskItem;
 
 import java.util.List;
+import java.util.Map;
 
 /**
  * @description 学习任务服务接口
@@ -216,4 +217,24 @@ public interface LearningTaskService {
      * @since 2025-10-15
      */
     ResultDomain<Boolean> removeTaskResource(String taskID, String resourceID);
+
+    // ----------------任务统计相关--------------------------------
+
+    /**
+     * @description 获取任务统计图表数据
+     * @param taskID 任务ID
+     * @return ResultDomain<Map<String, Object>> 图表数据（学习时长分布、学习进度分布）
+     * @author yslg
+     * @since 2025-10-30
+     */
+    ResultDomain<Map<String, Object>> getTaskStatisticsCharts(String taskID);
+
+    /**
+     * @description 获取任务排行榜数据
+     * @param taskID 任务ID
+     * @return ResultDomain<Map<String, Object>> 排行榜数据（完成时间排行榜、学习时长排行榜）
+     * @author yslg
+     * @since 2025-10-30
+     */
+    ResultDomain<Map<String, Object>> getTaskStatisticsRankings(String taskID);
 }