Merge branch 'main' of https://gitea.fengyingkj.top/zhaichao/education

frontend/src/api/teachBusiness/courseRunning.js

@@ -0,0 +1,110 @@
+import request from '@/utils/request'
+
+// 课程教学运行管理（CourseRunningController /course-running）
+// 接口依据：course-running 控制器（前端 baseURL 为 /api，此处不重复 /api 前缀）
+
+/**
+ * 分页查询教学实施计划课次列表
+ * GET /course-running/plan/list
+ * 查询参数（TeachingPlanQueryDTO）：
+ *   sskcbh 实施_课程编号、nd 年度、jxff 教学方法、
+ *   rqStart 日期范围开始、rqEnd 日期范围结束（均传 ISO 格式，如 2026-08-23T00:00:00）、
+ *   txzt 填写状态（0-未填写 1-已填写 2-已提交）、pageNum、pageSize
+ * 返回：PageResult<TeachingPlanLessonVO>（records/total）
+ */
+export function listTeachingPlan(params) {
+  return request({
+    url: '/course-running/plan/list',
+    method: 'get',
+    params
+  })
+}
+
+// ==================== 调课申请管理 /course-running/adjust ====================
+// 接口依据：CourseRunningController（类上 @RequestMapping("/course-running")，前端 baseURL 为 /api，此处不重复 /api 前缀）
+
+/**
+ * 分页查询调课申请列表
+ * GET /course-running/adjust/list
+ * 查询参数（ScheduleAdjustQueryDTO）：sskcbbh 课次编号、sqjybh 申请教员编号、nd 年度、
+ *   jyspzzt 教研室审批状态、jyscszt 教研室查收状态、sczt 删除状态、
+ *   cjsjStart/cjsjEnd 申请日期范围（ISO 格式）、pageNum、pageSize
+ * 返回：PageResult<ScheduleAdjustApplyVO>（records/total）
+ */
+export function listScheduleAdjust(params) {
+  return request({
+    url: '/course-running/adjust/list',
+    method: 'get',
+    params
+  })
+}
+
+/**
+ * 查询当前教员可供调课的课次
+ * GET /course-running/adjust/lessons
+ * 查询参数：nd 年度（可选）
+ * 返回：List<AdjustableLessonVO>，包含提交所需的课次主字段及教室、教员、学员队、保障明细。
+ */
+export function listAdjustableLessons(params) {
+  return request({
+    url: '/course-running/adjust/lessons',
+    method: 'get',
+    params
+  })
+}
+
+/**
+ * 查询调课申请详情
+ * GET /course-running/adjust/detail
+ * @param ssdksqbh 调课申请编号
+ * 返回：ScheduleAdjustDetailVO
+ */
+export function getScheduleAdjustDetail(ssdksqbh) {
+  return request({
+    url: '/course-running/adjust/detail',
+    method: 'get',
+    params: { ssdksqbh }
+  })
+}
+
+/**
+ * 提交调课申请
+ * POST /course-running/adjust/submit
+ * 请求体（ScheduleAdjustApplyDTO）核心字段：sskcbbh 课次编号、sy 调课事由、rq 调课后新日期、
+ *   jc 调课后新节次、nd 年度；sqjybh/xydrwbh/kbh/kcbbh/xjsbh 为可选关联字段，
+ *   roomList/teacherList/teamList/supportList 为调整后的关联明细。
+ */
+export function submitScheduleAdjust(data) {
+  return request({
+    url: '/course-running/adjust/submit',
+    method: 'post',
+    data
+  })
+}
+
+/**
+ * 教研室审批调课申请
+ * POST /course-running/adjust/audit/jys
+ * 请求体（ScheduleAdjustAuditDTO）：ssdksqbh（必填）、spzt（1同意/2发回/3拒绝）、
+ *   fhyj（审批意见，发回时填写）、sprbh（审批人编号，不传时取当前登录人；点审批即已查收）
+ */
+export function auditByTeachingOffice(data) {
+  return request({
+    url: '/course-running/adjust/audit/jys',
+    method: 'post',
+    data
+  })
+}
+
+/**
+ * 撤销调课申请
+ * DELETE /course-running/adjust/cancel
+ * @param params { ssdksqbh, sqjybh }
+ */
+export function cancelScheduleAdjust(params) {
+  return request({
+    url: '/course-running/adjust/cancel',
+    method: 'delete',
+    params
+  })
+}

frontend/src/api/teachBusiness/timetable.js

@@ -7,7 +7,7 @@ import request from '@/utils/request'
 /**
  * 今日课表
  * GET /kcb/today/list
- * @param params TimetableQuery：nd、xydbh（均可选）
+ * @param params offset 日期偏移量、rq 基准日期（yyyy-MM-dd）
  * 返回：今日课表记录（实体字段 bh/sksj/kc/zrdw/bc/jy/cd/jxnrxff/bz）
  */
 export function listToday(data) {
@@ -21,7 +21,7 @@ export function listToday(data) {
 /**
  * 本周课表
  * GET /kcb/week/list
- * @param params TimetableQuery：nd、xydbh（均可选）
+ * @param params offset 周偏移量、rq 基准日期（yyyy-MM-dd）
  * 返回：本周课表记录
  */
 export function listWeek(data) {
@@ -86,4 +86,4 @@ export function exportClassCourses(data) {
     params: data,
     responseType: 'blob'
   })
-}
+}