serv-学习

This commit is contained in:
2025-10-24 18:28:26 +08:00
parent 6f5603dd8b
commit 8968409b2d
55 changed files with 2144 additions and 2570 deletions

View File

@@ -6,6 +6,7 @@ import org.xyzh.common.core.page.PageRequest;
import org.xyzh.common.dto.study.TbCourse;
import org.xyzh.common.dto.study.TbCourseChapter;
import org.xyzh.common.dto.study.TbCourseNode;
import org.xyzh.common.dto.study.TbLearningRecord;
import org.xyzh.common.vo.CourseVO;
import java.util.List;

View File

@@ -19,12 +19,12 @@ public interface LearningRecordService {
* @description 获取用户学习记录
* @param userID 用户ID
* @param resourceType 资源类型(可选)
* @param taskID 任务ID可选
* @param resourceID 资源ID可选
* @return ResultDomain<TbLearningRecord> 学习记录列表
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbLearningRecord> getUserLearningRecords(String userID, Integer resourceType, String taskID);
ResultDomain<TbLearningRecord> getLearningRecord(TbLearningRecord learningRecord);
/**
* @description 获取资源学习记录
@@ -34,7 +34,7 @@ public interface LearningRecordService {
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbLearningRecord> getResourceLearningRecords(Integer resourceType, String resourceID);
ResultDomain<TbLearningRecord> getResourceLearningRecords(TbLearningRecord learningRecord);
/**
* @description 创建或更新学习记录
@@ -43,32 +43,25 @@ public interface LearningRecordService {
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbLearningRecord> saveLearningRecord(TbLearningRecord learningRecord);
ResultDomain<TbLearningRecord> insertLearningRecord(TbLearningRecord learningRecord);
/**
* @description 更新学习进度
* @param userID 用户ID
* @param resourceType 资源类型
* @param resourceID 资源ID
* @param progress 进度
* @param duration 学习时长(秒)
* @param learningRecord 学习记录
* @return ResultDomain<TbLearningRecord> 更新结果
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbLearningRecord> updateLearningProgress(String userID, Integer resourceType, String resourceID, BigDecimal progress, Integer duration);
ResultDomain<TbLearningRecord> updateLearningRecord(TbLearningRecord learningRecord);
/**
* @description 标记学习完成
* @param userID 用户ID
* @param resourceType 资源类型
* @param resourceID 资源ID
* @param taskID 任务ID可选
* @param learningRecord 学习记录
* @return ResultDomain<TbLearningRecord> 更新结果
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbLearningRecord> markLearningComplete(String userID, Integer resourceType, String resourceID, String taskID);
ResultDomain<TbLearningRecord> markLearningComplete(TbLearningRecord learningRecord);
/**
* @description 获取用户学习统计
@@ -108,4 +101,13 @@ public interface LearningRecordService {
* @since 2025-10-15
*/
ResultDomain<TbLearningRecord> getTaskLearningStatistics(String taskID);
/**
* @description 获取用户课程的学习记录
* @param learningRecord 学习记录
* @return ResultDomain<TbLearningRecord> 学习记录
* @author yslg
* @since 2025-10-24
*/
ResultDomain<TbLearningRecord> getCourseLearningRecord(TbLearningRecord learningRecord);
}

View File

@@ -6,8 +6,7 @@ import org.xyzh.common.dto.study.TbLearningTask;
import org.xyzh.common.dto.study.TbTaskUser;
import org.xyzh.common.vo.TaskItemVO;
import org.xyzh.common.vo.TaskVO;
import org.xyzh.common.dto.study.TbTaskCourse;
import org.xyzh.common.dto.study.TbTaskResource;
import org.xyzh.common.dto.study.TbTaskItem;
import java.util.List;
@@ -48,6 +47,15 @@ public interface LearningTaskService {
*/
ResultDomain<TaskVO> getTaskById(String taskID);
/**
* @description 根据ID获取任务用户详情
* @param taskID 任务ID
* @return ResultDomain<TaskItemVO> 任务用户详情
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TaskVO> getTaskUser(String taskID);
/**
* @description 创建学习任务
* @param task 任务信息
@@ -154,20 +162,20 @@ public interface LearningTaskService {
/**
* @description 获取任务课程列表
* @param taskID 任务ID
* @return ResultDomain<TbTaskCourse> 课程列表
* @return ResultDomain<TbTaskItem> 课程列表
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbTaskCourse> getTaskCourses(String taskID);
ResultDomain<TbTaskItem> getTaskCourses(String taskID);
/**
* @description 添加任务课程
* @param taskCourse 任务课程信息
* @return ResultDomain<TbTaskCourse> 添加结果
* @param taskItem 任务信息
* @return ResultDomain<TbTaskItem> 添加结果
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbTaskCourse> addTaskCourse(TbTaskCourse taskCourse);
ResultDomain<TbTaskItem> addTaskCourse(TbTaskItem taskItem);
/**
* @description 移除任务课程
@@ -184,20 +192,20 @@ public interface LearningTaskService {
/**
* @description 获取任务资源列表
* @param taskID 任务ID
* @return ResultDomain<TbTaskResource> 资源列表
* @return ResultDomain<TbTaskItem> 资源列表
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbTaskResource> getTaskResources(String taskID);
ResultDomain<TbTaskItem> getTaskResources(String taskID);
/**
* @description 添加任务资源
* @param taskResource 任务资源信息
* @return ResultDomain<TbTaskResource> 添加结果
* @param taskItem 任务信息
* @return ResultDomain<TbTaskItem> 添加结果
* @author yslg
* @since 2025-10-15
*/
ResultDomain<TbTaskResource> addTaskResource(TbTaskResource taskResource);
ResultDomain<TbTaskItem> addTaskResource(TbTaskItem taskItem);
/**
* @description 移除任务资源