From 26780c533f2c2af6b9216306f649c1bcede94e4a Mon Sep 17 00:00:00 2001
From: yn147 <2270338776@qq.com>
Date: 星期五, 24 十一月 2023 16:43:37 +0800
Subject: [PATCH] 学生、课程
---
src/main/java/com/qxueyou/scc/teach/subject/service/ISubjectService.java | 283 +++++++++++++++++++++++++++++--------------------------
1 files changed, 149 insertions(+), 134 deletions(-)
diff --git a/src/main/java/com/qxueyou/scc/teach/subject/service/ISubjectService.java b/src/main/java/com/qxueyou/scc/teach/subject/service/ISubjectService.java
index cb49dca..c5e35a8 100644
--- a/src/main/java/com/qxueyou/scc/teach/subject/service/ISubjectService.java
+++ b/src/main/java/com/qxueyou/scc/teach/subject/service/ISubjectService.java
@@ -1,6 +1,7 @@
package com.qxueyou.scc.teach.subject.service;
import java.lang.reflect.InvocationTargetException;
+import java.util.Date;
import java.util.List;
import java.util.Map;
@@ -8,67 +9,69 @@
import com.qxueyou.scc.base.model.Result;
import com.qxueyou.scc.teach.subject.model.Subject;
import com.qxueyou.scc.teach.subject.model.view.MySubjectV;
+import com.qxueyou.scc.teach.subject.model.view.OpenSubjectV;
+import org.springframework.transaction.annotation.Transactional;
public interface ISubjectService {
/**
- * 新增课程
- *
+ * 鏂板璇剧▼
+ *
* @param subjectName
- * 课程名称
+ * 璇剧▼鍚嶇О
* @param coverPageFileId
- * 封面文件id
+ * 灏侀潰鏂囦欢id
* @param contentFileId
- * 内容文件id
+ * 鍐呭鏂囦欢id
* @return
*/
- Result add(String subjectName, String coverPageFileId, String contentFileId,int type);
+ Result add(String subjectName, String coverPageFileId, String contentFileId, int type, Date startTime, Date endTime);
/**
- * 修改课程
- *
+ * 淇敼璇剧▼
+ *
* @param subjectName
- * 课程名称
+ * 璇剧▼鍚嶇О
* @param subjectId
- * 课程id
+ * 璇剧▼id
* @param coverPageFileId
- * 封面文件id
+ * 灏侀潰鏂囦欢id
* @param contentFileId
- * 内容文件id
+ * 鍐呭鏂囦欢id
* @return
*/
Result update(String subjectId, String subjectName, String coverPageFileId, String contentFileId,int type);
/**
- * 删除课程
- *
+ * 鍒犻櫎璇剧▼
+ *
* @param subjectIds
- * 课程id数组
- * @return 上传结果:{"success":true,msg:"success",attrs:{}}
+ * 璇剧▼id鏁扮粍
+ * @return 涓婁紶缁撴灉:{"success":true,msg:"success",attrs:{}}
*/
Result delete(String[] subjectIds);
/**
- * 发布课程
- *
+ * 鍙戝竷璇剧▼
+ *
* @param subjectIds
- * 课程id数组
- * @return 上传结果:{"success":true,msg:"success",attrs:{}}
+ * 璇剧▼id鏁扮粍
+ * @return 涓婁紶缁撴灉:{"success":true,msg:"success",attrs:{}}
*/
Result doRelease(String[] subjectIds);
/**
- * 撤回课程
- *
+ * 鎾ゅ洖璇剧▼
+ *
* @param subjectIds
- * 课程id数组
- * @return 上传结果:{"success":true,msg:"success",attrs:{}}
+ * 璇剧▼id鏁扮粍
+ * @return 涓婁紶缁撴灉:{"success":true,msg:"success",attrs:{}}
*/
Result doCancel(String[] subjectIds);
/**
- * 更新课件数量
- *
+ * 鏇存柊璇句欢鏁伴噺
+ *
* @param subjectId
* @param count
* @return
@@ -76,121 +79,126 @@
Result addLectureCount(String subjectId, int count);
/**
- * 查询课程
- *
+ * 鏌ヨ璇剧▼
+ *
* @param text
- * 搜索文本
+ * 鎼滅储鏂囨湰
* @param pageSize
- * 页码
+ * 椤电爜
* @param pageNum
- * 每页显示行数
- * @return 返回课程列表
+ * 姣忛〉鏄剧ず琛屾暟
+ * @return 杩斿洖璇剧▼鍒楄〃
*/
List<Subject> list(String text, String teacherId, String status,Integer type, Integer pageSize, Integer pageNum);
/**
- * 查询课程个数
- *
+ * 鏌ヨ璇剧▼涓暟
+ *
* @param text
- * 搜索文本
- * @return 返回课程总数
+ * 鎼滅储鏂囨湰
+ * @return 杩斿洖璇剧▼鎬绘暟
*/
int listCount(String text, String teacherId, String status,Integer type);
/**
- * 读取课程
- *
+ * 璇诲彇璇剧▼
+ *
* @param subjectId
- * 课程ID
- * @return 返回课程列表
+ * 璇剧▼ID
+ * @return 杩斿洖璇剧▼鍒楄〃
*/
Subject read(String subjectId);
/**
- * 读取课程详情介绍
- *
+ * 璇诲彇璇剧▼璇︽儏浠嬬粛
+ *
* @param subjectId
- * 课程ID
- * @return 返回课程详情介绍
+ * 璇剧▼ID
+ * @return 杩斿洖璇剧▼璇︽儏浠嬬粛
*/
String readSubjectContent(String subjectId);
/**
- * 查询我的课程
- *
+ * 鏌ヨ鎴戠殑璇剧▼
+ *
* @param classId
- * 班级id
- * @return 返回课程列表
+ * 鐝骇id
+ * @return 杩斿洖璇剧▼鍒楄〃
*/
List<MySubjectV> listMySubjectV(String classId,String userId);
/**
- * 首页查询我的课程
+ * 鏌ヨ鍏紑璇剧▼
+ */
+ List<OpenSubjectV> listOpenSubjectV();
+
+ /**
+ * 棣栭〉鏌ヨ鎴戠殑璇剧▼
*/
List<Map<String, Object>> getMySubjectList();
/**
- * 查询我的课程
- *
+ * 鏌ヨ鎴戠殑璇剧▼
+ *
* @param classId
- * 班级id
- * @return 返回课程列表
+ * 鐝骇id
+ * @return 杩斿洖璇剧▼鍒楄〃
*/
MySubjectV getMy1stSubjectVById(String subjectId);
/**
- * 查询个人课程章节的学习进度
- *
+ * 鏌ヨ涓汉璇剧▼绔犺妭鐨勫涔犺繘搴�
+ *
* @param classId
- * 班级id
- * @return 返回章节学习进度列表
+ * 鐝骇id
+ * @return 杩斿洖绔犺妭瀛︿範杩涘害鍒楄〃
*/
List<Map<String, Object>> listChapterStudyProgress(String subjectId);
/**
- * 获取subject对象
+ * 鑾峰彇subject瀵硅薄
*/
Subject readSubject(String subjectId);
/**
- * 我的活动获取课程完成情况
- *
+ * 鎴戠殑娲诲姩鑾峰彇璇剧▼瀹屾垚鎯呭喌
+ *
* @return
*/
Result getPerformance4Subject();
/**
- * 首页获取课程详情列表
+ * 棣栭〉鑾峰彇璇剧▼璇︽儏鍒楄〃
*/
- Result lstSubjectDetail(String userId);
+ Result lstSubjectDetail();
/**
- * 获取数据排行
- *
+ * 鑾峰彇鏁版嵁鎺掕
+ *
* @return
*/
Result getDataDesc(String classId, String subjectId);
/**
- * 获取上次学习的位置
+ * 鑾峰彇涓婃瀛︿範鐨勪綅缃�
*/
Result lastStudied(String userId);
-
+
/**
- * 添加班级课程
+ * 娣诲姞鐝骇璇剧▼
* @param origSubjectId
* @param teacherId
* @param schoolYear
* @param term
* @return
- * @throws InvocationTargetException
- * @throws IllegalAccessException
+ * @throws InvocationTargetException
+ * @throws IllegalAccessException
*/
Result addClsSubject(String classId,String origSubjectId, String teacherId, Integer schoolYear, Integer term) throws IllegalAccessException, InvocationTargetException;
-
-
+
+
/**
- * 更新班级课程
+ * 鏇存柊鐝骇璇剧▼
* @param subjectId
* @param origSubjectId
* @param teacherId
@@ -199,155 +207,155 @@
* @return
*/
Result updateClsSubject(String classId,String subjectId, String origSubjectId, String teacherId, Integer schoolYear, Integer term);
-
+
/**
- * 删除班级课程
+ * 鍒犻櫎鐝骇璇剧▼
* @param classId
* @param subjectIds
* @return
*/
Result deleteClsSubject(String classId, String[] subjectIds);
-
+
/**
- * 查询班级课程
- *
+ * 鏌ヨ鐝骇璇剧▼
+ *
* @param classId
* @param schoolYear
* @param term
* @return
*/
public List<Map<String, Object>> clsSubjectlist(String classId, Integer schoolYear, Integer term);
-
+
/**
- * 获取班级学期
- *
+ * 鑾峰彇鐝骇瀛︽湡
+ *
* @param classId
* @return
*/
public List<Map<String,Object>> termList(String classId);
-
+
/**
- * 我的课程按学期分类
- *
+ * 鎴戠殑璇剧▼鎸夊鏈熷垎绫�
+ *
* @param classId
* @return
*/
public List<Map<String,Object>> myTermSubjectList(String classId);
-
+
/**
- * 我的课程，按时间排序
- *
+ * 鎴戠殑璇剧▼锛屾寜鏃堕棿鎺掑簭
+ *
* @param classId
* @return
*/
public List<Map<String,Object>> mySubjectList(String classId, Pager pager);
-
+
/**
- * 查询老师或管理员可用的课程ID和课程名字列表
- * @param teacherId 根据教师ID过滤
+ * 鏌ヨ鑰佸笀鎴栫鐞嗗憳鍙敤鐨勮绋婭D鍜岃绋嬪悕瀛楀垪琛�
+ * @param teacherId 鏍规嵁鏁欏笀ID杩囨护
* @return
*/
List<Map<String, Object>> queryAvailableSubjectIdAndName(String teacherId,Integer sbujectType);
-
+
/**
- * 我的班级信息
- *
+ * 鎴戠殑鐝骇淇℃伅
+ *
* @param classId
* @return
*/
public Map<String,Object> myClassInfo(String classId);
-
+
/**
- * 获取我的课程数量
- *
+ * 鑾峰彇鎴戠殑璇剧▼鏁伴噺
+ *
* @param classId
* @return
*/
public long myClsSubjectCount(String classId);
-
+
/**
- * 获取我的课程进度
- *
+ * 鑾峰彇鎴戠殑璇剧▼杩涘害
+ *
* @param classId
* @param userId
* @return
*/
public List<Map<String,Object>> myClsSubjectlist(String classId, String userId, Pager pager);
-
+
/**
- * 学员课程作业进度
- *
+ * 瀛﹀憳璇剧▼浣滀笟杩涘害
+ *
* @param classId
* @param subjectId
* @return
*/
public Map<String, Object> studentSubjectHomeworkProgress(String classId, String subjectId, String userId);
-
+
/**
- * 学员考试作业进度
- *
+ * 瀛﹀憳鑰冭瘯浣滀笟杩涘害
+ *
* @param classId
* @param subjectId
* @return
*/
public Map<String, Object> studentSubjectExamProgress(String classId, String subjectId, String studentId);
-
+
/**
- * 获取学员的课程进度
- *
+ * 鑾峰彇瀛﹀憳鐨勮绋嬭繘搴�
+ *
* @param classId
* @return
*/
public List<Map<String,Object>> studentSubjectProgress(String classId, Pager pager);
-
+
/**
- * 班级学员课件总体进度
- *
+ * 鐝骇瀛﹀憳璇句欢鎬讳綋杩涘害
+ *
* @param subjectId
* @param classId
* @return
*/
public List<Map<String, Object>> studentSubjectLectureProgress(String subjectId, String classId);
-
+
/**
- * 我的公开课列表
- *
+ * 鎴戠殑鍏紑璇惧垪琛�
+ *
* @param pageNum
* @param pageSize
* @param keyword
* @return
*/
public Map<String,Object> myOpenSubjectList(Integer pageNum, Integer pageSize, String keyword);
-
+
/**
- * 公开课列表
- *
+ * 鍏紑璇惧垪琛�
+ *
* @param pageNum
* @param pageSize
* @param keyword
* @return
*/
public Map<String,Object> openSubjectList(Integer pageNum, Integer pageSize, String keyword);
-
+
/**
- * 公开课详情
- *
+ * 鍏紑璇捐鎯�
+ *
* @param subjectId
* @return
*/
public Map<String,Object> openSubjectInfo(String subjectId);
-
+
/**
- * 我的课程详情
- *
+ * 鎴戠殑璇剧▼璇︽儏
+ *
* @param classId
* @return
*/
public Map<String,Object> mySubjectInfo(String subjectId, String classId);
-
+
/**
- * app教师端课程列表
- *
+ * app鏁欏笀绔绋嬪垪琛�
+ *
* @param text
* @param status
* @param type
@@ -356,28 +364,35 @@
* @return
*/
Result teacherSubjectList(Pager pager, String keyword, String status,Integer type);
-
+
/**
- * 课程按学期分类
- *
+ * 璇剧▼鎸夊鏈熷垎绫�
+ *
* @param classId
* @return
*/
List<Map<String,Object>> termSubjectList(String classId, List<Map<String,Object>> clsSubjectlist);
-
-
+
+
/**
- * 查询课程关联的班级信息
+ * 鏌ヨ璇剧▼鍏宠仈鐨勭彮绾т俊鎭�
* @param origSubjectId
* @return
*/
List<Map<String, Object>> querySubjectReClassInfos(String origSubjectId);
-
+
/**
- * 获取课件数量
- *
+ * 鑾峰彇璇句欢鏁伴噺
+ *
* @param subjectId
* @return
*/
public long getLectureCount(String subjectId);
+
+ /**
+ * 鑾峰彇璇剧▼鍚嶇О
+ * @param subjectId
+ * @return
+ */
+ String findSubjectName(String subjectId);
}
--
Gitblit v1.8.0