web-文件接口

schoolNewsServ/api/api-study/src/main/java/org/xyzh/api/study/course/CourseService.java

@@ -9,7 +9,7 @@ import java.util.List;
 /**
  * @description 课程服务接口
  * @filename CourseService.java
- * @author system
+ * @author yslg
  * @copyright xyzh
  * @since 2025-10-15
  */
@@ -19,7 +19,7 @@ public interface CourseService {
      * @description 获取课程列表
      * @param filter 过滤条件
      * @return ResultDomain<TbCourse> 课程列表
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbCourse> getCourseList(TbCourse filter);
@@ -28,7 +28,7 @@ public interface CourseService {
      * @description 根据ID获取课程详情
      * @param courseID 课程ID
      * @return ResultDomain<TbCourse> 课程详情
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbCourse> getCourseById(String courseID);
@@ -37,7 +37,7 @@ public interface CourseService {
      * @description 创建课程
      * @param course 课程信息
      * @return ResultDomain<TbCourse> 创建结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbCourse> createCourse(TbCourse course);
@@ -46,7 +46,7 @@ public interface CourseService {
      * @description 更新课程
      * @param course 课程信息
      * @return ResultDomain<TbCourse> 更新结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbCourse> updateCourse(TbCourse course);
@@ -55,7 +55,7 @@ public interface CourseService {
      * @description 删除课程
      * @param courseID 课程ID
      * @return ResultDomain<Boolean> 删除结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<Boolean> deleteCourse(String courseID);
@@ -65,7 +65,7 @@ public interface CourseService {
      * @param courseID 课程ID
      * @param status 状态
      * @return ResultDomain<TbCourse> 更新结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbCourse> updateCourseStatus(String courseID, Integer status);
@@ -74,7 +74,7 @@ public interface CourseService {
      * @description 增加课程浏览次数
      * @param courseID 课程ID
      * @return ResultDomain<TbCourse> 更新结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbCourse> incrementViewCount(String courseID);
@@ -83,7 +83,7 @@ public interface CourseService {
      * @description 增加课程学习人数
      * @param courseID 课程ID
      * @return ResultDomain<TbCourse> 更新结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbCourse> incrementLearnCount(String courseID);
@@ -94,7 +94,7 @@ public interface CourseService {
      * @description 获取课程章节列表
      * @param courseID 课程ID
      * @return ResultDomain<TbCourseChapter> 章节列表
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbCourseChapter> getCourseChapters(String courseID);
@@ -103,7 +103,7 @@ public interface CourseService {
      * @description 根据ID获取章节详情
      * @param chapterID 章节ID
      * @return ResultDomain<TbCourseChapter> 章节详情
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbCourseChapter> getChapterById(String chapterID);
@@ -112,7 +112,7 @@ public interface CourseService {
      * @description 创建课程章节
      * @param chapter 章节信息
      * @return ResultDomain<TbCourseChapter> 创建结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbCourseChapter> createChapter(TbCourseChapter chapter);
@@ -121,7 +121,7 @@ public interface CourseService {
      * @description 更新课程章节
      * @param chapter 章节信息
      * @return ResultDomain<TbCourseChapter> 更新结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbCourseChapter> updateChapter(TbCourseChapter chapter);
@@ -130,7 +130,7 @@ public interface CourseService {
      * @description 删除课程章节
      * @param chapterID 章节ID
      * @return ResultDomain<Boolean> 删除结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<Boolean> deleteChapter(String chapterID);
@@ -140,7 +140,7 @@ public interface CourseService {
      * @param chapterID 章节ID
      * @param orderNum 排序号
      * @return ResultDomain<TbCourseChapter> 更新结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbCourseChapter> updateChapterOrder(String chapterID, Integer orderNum);

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

@@ -9,7 +9,7 @@ import java.util.List;
 /**
  * @description 学习记录服务接口
  * @filename LearningRecordService.java
- * @author system
+ * @author yslg
  * @copyright xyzh
  * @since 2025-10-15
  */
@@ -21,7 +21,7 @@ public interface LearningRecordService {
      * @param resourceType 资源类型（可选）
      * @param taskID 任务ID（可选）
      * @return ResultDomain<TbLearningRecord> 学习记录列表
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbLearningRecord> getUserLearningRecords(String userID, Integer resourceType, String taskID);
@@ -31,7 +31,7 @@ public interface LearningRecordService {
      * @param resourceType 资源类型
      * @param resourceID 资源ID
      * @return ResultDomain<TbLearningRecord> 学习记录列表
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbLearningRecord> getResourceLearningRecords(Integer resourceType, String resourceID);
@@ -40,7 +40,7 @@ public interface LearningRecordService {
      * @description 创建或更新学习记录
      * @param learningRecord 学习记录
      * @return ResultDomain<TbLearningRecord> 创建/更新结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbLearningRecord> saveLearningRecord(TbLearningRecord learningRecord);
@@ -53,7 +53,7 @@ public interface LearningRecordService {
      * @param progress 进度
      * @param duration 学习时长（秒）
      * @return ResultDomain<TbLearningRecord> 更新结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbLearningRecord> updateLearningProgress(String userID, Integer resourceType, String resourceID, BigDecimal progress, Integer duration);
@@ -65,7 +65,7 @@ public interface LearningRecordService {
      * @param resourceID 资源ID
      * @param taskID 任务ID（可选）
      * @return ResultDomain<TbLearningRecord> 更新结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbLearningRecord> markLearningComplete(String userID, Integer resourceType, String resourceID, String taskID);
@@ -75,7 +75,7 @@ public interface LearningRecordService {
      * @param userID 用户ID
      * @param resourceType 资源类型（可选）
      * @return ResultDomain<TbLearningRecord> 学习统计
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbLearningRecord> getUserLearningStatistics(String userID, Integer resourceType);
@@ -86,7 +86,7 @@ public interface LearningRecordService {
      * @param resourceType 资源类型
      * @param resourceID 资源ID
      * @return ResultDomain<TbLearningRecord> 学习进度
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbLearningRecord> getUserLearningProgress(String userID, Integer resourceType, String resourceID);
@@ -95,7 +95,7 @@ public interface LearningRecordService {
      * @description 删除学习记录
      * @param recordID 记录ID
      * @return ResultDomain<Boolean> 删除结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<Boolean> deleteLearningRecord(String recordID);
@@ -104,7 +104,7 @@ public interface LearningRecordService {
      * @description 获取任务学习进度统计
      * @param taskID 任务ID
      * @return ResultDomain<TbLearningRecord> 学习进度统计
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbLearningRecord> getTaskLearningStatistics(String taskID);

schoolNewsServ/api/api-study/src/main/java/org/xyzh/api/study/statistics/LearningStatisticsService.java

@@ -9,7 +9,7 @@ import java.util.List;
 /**
  * @description 学习统计服务接口
  * @filename LearningStatisticsService.java
- * @author system
+ * @author yslg
  * @copyright xyzh
  * @since 2025-10-15
  */
@@ -21,7 +21,7 @@ public interface LearningStatisticsService {
      * @param startDate 开始日期（可选）
      * @param endDate 结束日期（可选）
      * @return ResultDomain<TbLearningStatistics> 学习统计列表
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbLearningStatistics> getUserLearningStatistics(String userID, Date startDate, Date endDate);
@@ -31,7 +31,7 @@ public interface LearningStatisticsService {
      * @param userID 用户ID
      * @param statDate 统计日期
      * @return ResultDomain<TbLearningStatistics> 学习统计
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbLearningStatistics> getDailyLearningStatistics(String userID, Date statDate);
@@ -40,7 +40,7 @@ public interface LearningStatisticsService {
      * @description 创建或更新学习统计
      * @param statistics 学习统计
      * @return ResultDomain<TbLearningStatistics> 创建/更新结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbLearningStatistics> saveLearningStatistics(TbLearningStatistics statistics);
@@ -54,7 +54,7 @@ public interface LearningStatisticsService {
      * @param courseCount 学习课程数量
      * @param completeCount 完成数量
      * @return ResultDomain<TbLearningStatistics> 更新结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbLearningStatistics> updateLearningStatistics(String userID, Date statDate, Integer totalDuration, Integer resourceCount, Integer courseCount, Integer completeCount);
@@ -64,7 +64,7 @@ public interface LearningStatisticsService {
      * @param statDate 统计日期
      * @param limit 限制数量
      * @return ResultDomain<TbLearningStatistics> 排行榜
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbLearningStatistics> getLearningRanking(Date statDate, Integer limit);
@@ -75,7 +75,7 @@ public interface LearningStatisticsService {
      * @param startDate 开始日期
      * @param endDate 结束日期
      * @return ResultDomain<TbLearningStatistics> 部门学习统计
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbLearningStatistics> getDeptLearningStatistics(String deptID, Date startDate, Date endDate);
@@ -85,7 +85,7 @@ public interface LearningStatisticsService {
      * @param startDate 开始日期
      * @param endDate 结束日期
      * @return ResultDomain<TbLearningStatistics> 总体学习统计
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbLearningStatistics> getOverallLearningStatistics(Date startDate, Date endDate);
@@ -94,7 +94,7 @@ public interface LearningStatisticsService {
      * @description 删除学习统计
      * @param statisticsID 统计ID
      * @return ResultDomain<Boolean> 删除结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<Boolean> deleteLearningStatistics(String statisticsID);

schoolNewsServ/api/api-study/src/main/java/org/xyzh/api/study/tag/CourseTagService.java

@@ -8,7 +8,7 @@ import java.util.List;
 /**
  * @description 课程标签服务接口
  * @filename CourseTagService.java
- * @author system
+ * @author yslg
  * @copyright xyzh
  * @since 2025-10-15
  */
@@ -17,7 +17,7 @@ public interface CourseTagService {
     /**
      * @description 获取所有课程标签
      * @return ResultDomain<TbCourseTag> 标签列表
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbCourseTag> getAllCourseTags();
@@ -26,7 +26,7 @@ public interface CourseTagService {
      * @description 根据ID获取标签详情
      * @param tagID 标签ID
      * @return ResultDomain<TbCourseTag> 标签详情
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbCourseTag> getTagById(String tagID);
@@ -35,7 +35,7 @@ public interface CourseTagService {
      * @description 创建课程标签
      * @param courseTag 标签信息
      * @return ResultDomain<TbCourseTag> 创建结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbCourseTag> createCourseTag(TbCourseTag courseTag);
@@ -44,7 +44,7 @@ public interface CourseTagService {
      * @description 更新课程标签
      * @param courseTag 标签信息
      * @return ResultDomain<TbCourseTag> 更新结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbCourseTag> updateCourseTag(TbCourseTag courseTag);
@@ -53,7 +53,7 @@ public interface CourseTagService {
      * @description 删除课程标签
      * @param tagID 标签ID
      * @return ResultDomain<Boolean> 删除结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<Boolean> deleteCourseTag(String tagID);
@@ -62,7 +62,7 @@ public interface CourseTagService {
      * @description 获取课程的标签
      * @param courseID 课程ID
      * @return ResultDomain<TbCourseTag> 标签列表
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbCourseTag> getCourseTags(String courseID);
@@ -72,7 +72,7 @@ public interface CourseTagService {
      * @param courseID 课程ID
      * @param tagID 标签ID
      * @return ResultDomain<Boolean> 添加结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<Boolean> addCourseTag(String courseID, String tagID);
@@ -82,7 +82,7 @@ public interface CourseTagService {
      * @param courseID 课程ID
      * @param tagID 标签ID
      * @return ResultDomain<Boolean> 移除结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<Boolean> removeCourseTag(String courseID, String tagID);
@@ -91,7 +91,7 @@ public interface CourseTagService {
      * @description 根据标签获取课程列表
      * @param tagID 标签ID
      * @return ResultDomain<String> 课程ID列表
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<String> getCoursesByTag(String tagID);

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

@@ -11,7 +11,7 @@ import java.util.List;
 /**
  * @description 学习任务服务接口
  * @filename LearningTaskService.java
- * @author system
+ * @author yslg
  * @copyright xyzh
  * @since 2025-10-15
  */
@@ -21,7 +21,7 @@ public interface LearningTaskService {
      * @description 获取学习任务列表
      * @param filter 过滤条件
      * @return ResultDomain<TbLearningTask> 任务列表
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbLearningTask> getTaskList(TbLearningTask filter);
@@ -30,7 +30,7 @@ public interface LearningTaskService {
      * @description 根据ID获取任务详情
      * @param taskID 任务ID
      * @return ResultDomain<TbLearningTask> 任务详情
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbLearningTask> getTaskById(String taskID);
@@ -39,7 +39,7 @@ public interface LearningTaskService {
      * @description 创建学习任务
      * @param task 任务信息
      * @return ResultDomain<TbLearningTask> 创建结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbLearningTask> createTask(TbLearningTask task);
@@ -48,7 +48,7 @@ public interface LearningTaskService {
      * @description 更新学习任务
      * @param task 任务信息
      * @return ResultDomain<TbLearningTask> 更新结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbLearningTask> updateTask(TbLearningTask task);
@@ -57,7 +57,7 @@ public interface LearningTaskService {
      * @description 删除学习任务
      * @param taskID 任务ID
      * @return ResultDomain<Boolean> 删除结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<Boolean> deleteTask(String taskID);
@@ -67,7 +67,7 @@ public interface LearningTaskService {
      * @param taskID 任务ID
      * @param status 状态
      * @return ResultDomain<TbLearningTask> 更新结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbLearningTask> updateTaskStatus(String taskID, Integer status);
@@ -78,7 +78,7 @@ public interface LearningTaskService {
      * @description 获取任务用户列表
      * @param taskID 任务ID
      * @return ResultDomain<TbTaskUser> 用户列表
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbTaskUser> getTaskUsers(String taskID);
@@ -87,7 +87,7 @@ public interface LearningTaskService {
      * @description 添加任务用户
      * @param taskUser 任务用户信息
      * @return ResultDomain<TbTaskUser> 添加结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbTaskUser> addTaskUser(TbTaskUser taskUser);
@@ -98,7 +98,7 @@ public interface LearningTaskService {
      * @param userIDs 用户ID列表
      * @param deptID 部门ID
      * @return ResultDomain<TbTaskUser> 添加结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbTaskUser> batchAddTaskUsers(String taskID, List<String> userIDs, String deptID);
@@ -108,7 +108,7 @@ public interface LearningTaskService {
      * @param taskID 任务ID
      * @param userID 用户ID
      * @return ResultDomain<Boolean> 移除结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<Boolean> removeTaskUser(String taskID, String userID);
@@ -120,7 +120,7 @@ public interface LearningTaskService {
      * @param status 状态
      * @param progress 进度
      * @return ResultDomain<TbTaskUser> 更新结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbTaskUser> updateTaskUserStatus(String taskID, String userID, Integer status, java.math.BigDecimal progress);
@@ -131,7 +131,7 @@ public interface LearningTaskService {
      * @description 获取任务课程列表
      * @param taskID 任务ID
      * @return ResultDomain<TbTaskCourse> 课程列表
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbTaskCourse> getTaskCourses(String taskID);
@@ -140,7 +140,7 @@ public interface LearningTaskService {
      * @description 添加任务课程
      * @param taskCourse 任务课程信息
      * @return ResultDomain<TbTaskCourse> 添加结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbTaskCourse> addTaskCourse(TbTaskCourse taskCourse);
@@ -150,7 +150,7 @@ public interface LearningTaskService {
      * @param taskID 任务ID
      * @param courseID 课程ID
      * @return ResultDomain<Boolean> 移除结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<Boolean> removeTaskCourse(String taskID, String courseID);
@@ -161,7 +161,7 @@ public interface LearningTaskService {
      * @description 获取任务资源列表
      * @param taskID 任务ID
      * @return ResultDomain<TbTaskResource> 资源列表
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbTaskResource> getTaskResources(String taskID);
@@ -170,7 +170,7 @@ public interface LearningTaskService {
      * @description 添加任务资源
      * @param taskResource 任务资源信息
      * @return ResultDomain<TbTaskResource> 添加结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<TbTaskResource> addTaskResource(TbTaskResource taskResource);
@@ -180,7 +180,7 @@ public interface LearningTaskService {
      * @param taskID 任务ID
      * @param resourceID 资源ID
      * @return ResultDomain<Boolean> 移除结果
-     * @author system
+     * @author yslg
      * @since 2025-10-15
      */
     ResultDomain<Boolean> removeTaskResource(String taskID, String resourceID);