通过AI比对原操作文档,生成系统功能完善方案,根据方案进行增补,完善从学期新增到最终的排课功能

This commit is contained in:
2026-09-15 14:42:43 +08:00
parent 5187435285
commit e8a58b19fe
54 changed files with 4577 additions and 134 deletions
@@ -0,0 +1,29 @@
package com.roomroot.jwgl.service;
import com.roomroot.jwgl.entity.JYL;
import com.roomroot.jwgl.unit.PageQuery;
import com.roomroot.jwgl.unit.PageResult;
import java.util.List;
/**
* 教员历 Service(阶段 5.1)。排课冲突除教员双占外,同时读教员历不可排课格。
*/
public interface JYLService {
void add(JYL row);
void delete(String bh);
void update(JYL row);
JYL getById(String bh);
PageResult<JYL> pageList(PageQuery query, JYL condition);
List<JYL> list(JYL condition);
List<JYL> listByJybh(String jybh);
List<JYL> listByRq(String rq);
}
@@ -0,0 +1,25 @@
package com.roomroot.jwgl.service;
/**
* 运行课表批量发布/撤回(阶段 5.2)。
*
* <p>发布规则:班次下全部课程 责任教员、默认场地均已指定,否则整批失败并列出缺项;
* 只写 实施_课程 和 实施_课程学员队,不插 实施_课程表。
* 停用 convertToLessons 作为发布路径(不生成空壳课次)。</p>
*/
public interface RunningCoursePublishService {
/**
* 批量发布某班次学期的全部课程任务为运行课程。
*
* @return 发布的 实施_课程 条数
*/
int publish(String xydxqbh);
/**
* 撤回:删除该班次已发布的 实施_课程 及其课次、教室、教员关联。
*
* @return 删除的 实施_课程 条数
*/
int withdraw(String xydxqbh);
}
@@ -0,0 +1,39 @@
package com.roomroot.jwgl.service;
import com.roomroot.jwgl.dto.scheduling.SchedulingArrangeRequest;
import com.roomroot.jwgl.dto.scheduling.SchedulingCellOpRequest;
import com.roomroot.jwgl.vo.scheduling.SchedulingViewVO;
import java.util.List;
import java.util.Map;
/**
* 实施排课窗口(阶段 5.3)。
*
* <p>组合查询 + 写操作:安排所选节次 / 删除所选节次 / 删除课程全部节次 / 彻底删除运行课程。
* 硬冲突格忽略(双占、三类历不可排);软提示(配当周次不符、非正课)随返回值给出。</p>
*/
public interface SchedulingWindowService {
/** 排课窗组合视图:班次头 + 课程列表(排满标绿)+ 周次×星期×节次格子 */
SchedulingViewVO view(String xydxqbh);
/**
* 安排所选节次。硬冲突格忽略并列出,软提示格照常安排并给出提示。
*
* @return {arranged: 安排格数, ignored: [{rq,jc,reason}], warnings: [{rq,jc,reason}]}
*/
Map<String, Object> arrange(SchedulingArrangeRequest request);
/** 删除所选节次:仅删除该课程在这些格上的课次 */
int deleteCells(SchedulingCellOpRequest request);
/** 删除课程全部节次(课程仍留在列表) */
int clearCourse(String sskcbh);
/** 彻底删除运行课程:课次与列表项一起删,编制侧任务保留 */
int deleteCourse(String sskcbh);
/** 排课日志查询:按课程(可叠加操作类型) */
List<Map<String, Object>> logs(String sskcbh, String czlx);
}
@@ -92,17 +92,19 @@ public interface StudentTeamTaskService {
/**
* 自动生成必修课程
* <p>
* 根据学员队编号从学员队表获取专业代号,
* 再根据专业代号和学期第次查询专业教学计划表,
* 为当前班次自动生成必修课程,插入到学员队任务表。
* 按「学员队学期编号」定位唯一的目标班次学期,由该班次学期反查学员队编号与学期第次,
* 再按专业代号 + 学期第次查专业教学计划表补齐必修课程。
* 已存在的课程(按课编号判断)不会重复添加。
* </p>
* <p>
* 不再用「学员队编号 + 学期第次」定位:同一学员队在多个年度会有学期第次相同的班次学期
* (例如 2025 第3学期 与 2026 第3学期),按 (学员队, 学期第次) 查找会写错学年。
* </p>
*
* @param xydbh 学员队编号
* @param xqdc 学期第次
* @param xydxqbh 学员队学期编号(班次学期主键)
* @return 新增数量
*/
int autoGenerateRequiredCourses(String xydbh, Integer xqdc);
int autoGenerateRequiredCourses(String xydxqbh);
/**
* 批量复制课程
@@ -0,0 +1,77 @@
package com.roomroot.jwgl.service;
import com.roomroot.jwgl.dto.taskbook.TaskBookBhListRequest;
import com.roomroot.jwgl.dto.taskbook.TaskBookFillRequest;
import com.roomroot.jwgl.dto.taskbook.TaskBookRoomRequest;
import com.roomroot.jwgl.dto.taskbook.TaskBookTeacherRequest;
import com.roomroot.jwgl.vo.taskbook.TaskBookRowVO;
import java.util.List;
import java.util.Map;
/**
* 教研室任务书填报(阶段 4)。
*
* <p>把已生成的课程任务确认成「可以排课的运行对象」:合班、责任教员、默认场地。</p>
*
* <p>口径约定:
* <ul>
* <li>合班分组号用已有列 学员队任务表.编组(bz2),0=未合班;不复用 预设编班号 和 课次序号。</li>
* <li>发布门禁:仅「已发布且未结束」的教学任务可填报;结束后只读(TeachingTaskWriteGuard)。</li>
* <li>责任教员 / 场地修改时,同合班组(同编组,非 0)的行同步。</li>
* <li>已发布到运行课表的行须先撤回才能拆班(运行课表属阶段 5,当前先拦截有排课数据的行)。</li>
* </ul></p>
*/
public interface TaskBookFillService {
/**
* 任务书填报列表:某教学任务下全部课程任务行(排序 课程 → 责任教员 → 课次)。
*/
List<TaskBookRowVO> list(String jxrwbh);
/**
* 手动合班:所选行写入同一编组(新组号 = 现有最大编组 + 1)。
* 校验 科目、学时、课类型、成绩分制 相同,任一不同则拒绝并说明。
*
* @return 编组号
*/
Integer merge(TaskBookBhListRequest request);
/**
* 按预设合班:所选行按课程科目分组,组内按 班次学期.预设编班号 写入同一编组;
* 没有预设编班号的行各成一组(不与别人强并)。
*
* @return 每组合班结果:groupNo / kbh / ysbbh / 行数
*/
List<Map<String, Object>> mergeByPreset(TaskBookBhListRequest request);
/**
* 拆班:所选行编组置 0。
*
* @return 实际拆开行数
*/
int split(TaskBookBhListRequest request);
/**
* 责任教员指定(unit=责任单位教员 / academy=全院教员 / plan=应用教研室计划教员)。
* 该行编组非 0 时,同合班组其它行同步 jybh。
*
* @return 实际更新行数
*/
int setTeacher(TaskBookTeacherRequest request);
/**
* 场地指定:其它教室(useSpecial=false,jsbh 必传)或 班次专用教室(useSpecial=true)。
* 该行编组非 0 时,同合班组其它行同步 jsbh。
*
* @return 实际更新行数
*/
int setRoom(TaskBookRoomRequest request);
/**
* 填报字段:计划教员(jysjhjybh)、场地(jsbh,同合班同步)、排课建议(jysjhbz)。
*
* @return 实际更新行数
*/
int fill(TaskBookFillRequest request);
}
@@ -0,0 +1,56 @@
package com.roomroot.jwgl.service;
import com.roomroot.jwgl.dto.allocation.AllocationGroupRequest;
import com.roomroot.jwgl.dto.allocation.AllocationSaveItem;
import com.roomroot.jwgl.vo.allocation.AllocationViewVO;
import jakarta.servlet.http.HttpServletResponse;
import java.util.List;
import java.util.Map;
/**
* 教学配当(阶段 3)。
*
* <p>给出「哪一周上多少学时、谁和谁同开同结」,作为排课的粗约束;
* 不直接写实施课程表(SSKCB)日期节次。</p>
*/
public interface TeachingAllocationService {
/**
* 打开某班次学期的配当编辑器视图:周轴(每周可排正课)+ 任务行(含铺学时结果)。
*/
AllocationViewVO view(String xydxqbh);
/**
* 保存配档字段:单条(列表 1 个元素)或多选批量。
* 元素 saveGroup=true 时按「同科目+同配档编组+同学期代号」整组一起改(同开同结)。
*
* @return 实际更新的任务行数
*/
int save(List<AllocationSaveItem> items);
/**
* 优选序数上移/下移。先把该班次学期的配档序号按当前展示顺序归一化为 1..n,
* 再交换相邻两条。direction: up / down。
*
* @return 归一化后的任务编号顺序(供前端刷新)
*/
List<String> move(String xydxqbh, String bh, String direction);
/**
* 编组管理面板:同科目全部开课班次(跨班次学期)。
*/
List<Map<String, Object>> groups(String kbh);
/**
* 编组管理:把所选任务统一改编组号。
*
* @return 实际更新行数
*/
int setGroup(AllocationGroupRequest request);
/**
* 导出配当 Excel(批量:每行一个任务,含班次名称与学期代号列)。
*/
void exportExcel(List<String> xydxqbhList, HttpServletResponse response) throws Exception;
}
@@ -241,8 +241,10 @@ public class ClassEventCalendarServiceImpl implements ClassEventCalendarService
.eq(JQB::getJqsj, source.getJqsj())
.eq(JQB::getCourseClass, source.getCourseClass()));
if (matched.isEmpty()) {
// 目标班次该格没有记录时按源格新建。可排课必须沿用源格:
// 之前固定传 0 会把「可排课」丢掉,使目标班次凭空多出不可排的格子。
insertCell(target, day, source.getCourseClass(), source.getJqmc(),
source.getJc(), 0, source.getBzxs(), source.getZdpk(), source.getZk(), source.getBz());
source.getJc(), source.getKpk(), source.getBzxs(), source.getZdpk(), source.getZk(), source.getBz());
return true;
}
for (JQB row : matched) {
@@ -371,27 +371,17 @@ public class CourseRunningImportServiceImpl implements CourseRunningImportServic
// 步骤2:遍历课程列表,逐个处理导入
for (SSKC course : courseList) {
try {
// 步骤3:将课程转换为课次列表(根据总学时计算课次数)
List<SSKCB> lessonList = convertToLessons(course, nd);
// 阶段 5.2 停用 convertToLessons:导入不再自动生成课次(实施_课程表),
// 课次改由排课窗口按节次安排(SchedulingWindowService.arrange)。
// 实施_课程 与 实施_课程学员队 数据在导入前已存在,此处仅记录导入日志。
// 步骤4:遍历课次列表,写入数据库
for (SSKCB lesson : lessonList) {
// 写入实施_课程表主记录
sskcbMapper.insert(lesson);
// 写入关联数据:学员队、教室、教员
insertSSKCBXYD(lesson, course.getBh(), nd);
insertSSKCBJS(lesson, nd);
insertSSKCBFZJY(lesson, nd);
}
// 步骤5:记录导入操作日志
// 步骤3:记录导入操作日志
recordOperationLog(course.getBh(), "导入", "导入课程:" + course.getKmbh());
// 步骤6:更新成功计数
// 步骤4:更新成功计数
successCount++;
} catch (Exception e) {
// 步骤7:记录失败的课程编号
// 步骤5:记录失败的课程编号
failedList.add(course.getBh());
}
}
@@ -26,6 +26,7 @@ import com.roomroot.jwgl.mapper.XYDQBMapper;
import com.roomroot.jwgl.service.ElectiveCourseService;
import com.roomroot.jwgl.unit.PageQuery;
import com.roomroot.jwgl.unit.PageResult;
import com.roomroot.jwgl.utils.SemesterCodeUtil;
import com.roomroot.jwgl.utils.UuidUtil;
import com.roomroot.jwgl.vo.jys.ElectiveCourseStudentVO;
import com.roomroot.jwgl.vo.jys.ElectiveCourseVO;
@@ -106,7 +107,10 @@ public class ElectiveCourseServiceImpl implements ElectiveCourseService {
XYDRWB task = new XYDRWB();
task.setBh(UuidUtil.getOriginalUUID());
task.setDelFlag(0);
task.setNd(dto.getNd() != null ? dto.getNd() : LocalDate.now().getYear());
// 任务表/实施/课程表的「年度」口径是 6 位学期代号(见 SemesterCodeUtil 类注释);
// 前端不传 nd 时按当前日期推断春/夏/秋学期,避免落成 4 位年份导致年度连接断裂
task.setNd(dto.getNd() != null ? dto.getNd()
: SemesterCodeUtil.resolve(LocalDate.now().getYear(), SemesterCodeUtil.periodOf(LocalDate.now())));
task.setXydbh(xydbh);
task.setKbh(course.getKbh());
task.setXqdc(dto.getXqdc());
@@ -245,7 +249,7 @@ public class ElectiveCourseServiceImpl implements ElectiveCourseService {
XYDRWB task = new XYDRWB();
task.setBh(UuidUtil.getOriginalUUID());
task.setDelFlag(0);
task.setNd(LocalDate.now().getYear());
task.setNd(SemesterCodeUtil.resolve(LocalDate.now().getYear(), SemesterCodeUtil.periodOf(LocalDate.now())));
task.setXydbh(xydbh);
task.setKbh(course.getKbh());
task.setJybh(jybh);
@@ -12,6 +12,7 @@ import com.roomroot.jwgl.service.ElectiveService;
import com.roomroot.jwgl.unit.BusinessException;
import com.roomroot.jwgl.unit.PageQuery;
import com.roomroot.jwgl.unit.PageResult;
import com.roomroot.jwgl.utils.SemesterCodeUtil;
import com.roomroot.jwgl.utils.UuidUtil;
import com.roomroot.jwgl.vo.elective.*;
import jakarta.annotation.Resource;
@@ -238,11 +239,16 @@ public class ElectiveServiceImpl implements ElectiveService {
// 判断学制是否半年以内
boolean halfYear = isHalfYear(rx, by);
// 学期第次:半年以内固定第一学期;半年以上优先用窗口已选学期第次,否则按入学日期推断
// 学期第次:半年以内固定第一学期;半年以上优先用窗口已选学期第次,
// 未选/非法时按开学日期推断「学年内学期类别」(1 春季 / 2 夏季 / 3 秋季)。
// 注意:学期第次不是「专业总第几学期」——人培(专业教学计划表)的学期第次才是专业总学期口径,
// 不能把按半年推算出的 4~8 写进班次学期,否则学期代号(年度×100+学期第次)会越过 1/2/3 契约。
if (halfYear) {
xqdc = 1;
} else if (xqdc == null || xqdc < 1 || xqdc > 3) {
xqdc = inferXqdc(rx, by, LocalDate.now());
LocalDate preset = parseDate(presetKxrq);
LocalDate ref = preset != null ? preset : (rx != null ? rx : LocalDate.now());
xqdc = SemesterCodeUtil.periodOf(ref);
}
// 人才培养方案总学期数(半年一学期,向上取整)
Integer totalXqdc = calcTotalXqdc(rx, by);
@@ -294,7 +300,10 @@ public class ElectiveServiceImpl implements ElectiveService {
LocalDate by = clazz.getByrq() != null ? clazz.getByrq().toLocalDate() : null;
boolean halfYear = isHalfYear(rx, by);
// 学期第次:半年以内只能第一学期;半年以上为空时智能推断
// 学期第次:半年以内只能第一学期;半年以上为空时按开学日期推断学年内学期类别,
// 传入值必须是 1/2/3(与 ClassSemesterServiceImpl.assertXqdc 同一契约)。
// 注意:学期第次是学年内学期类别(1 春季 / 2 夏季 / 3 秋季),
// 不能用「半年一学期」推算出的专业总学期(可达 6~8)写入,否则会生成非法学期代号。
Integer xqdc = xydndxqjbxxb.getXqdc();
if (halfYear) {
if (xqdc != null && xqdc != 1) {
@@ -302,7 +311,10 @@ public class ElectiveServiceImpl implements ElectiveService {
}
xqdc = 1;
} else if (xqdc == null) {
xqdc = inferXqdc(rx, by, LocalDate.now());
LocalDate ref = xydndxqjbxxb.getKxrq() != null ? xydndxqjbxxb.getKxrq() : rx;
xqdc = SemesterCodeUtil.periodOf(ref);
} else if (xqdc < 1 || xqdc > 3) {
throw new BusinessException("学期第次只能是 1(春季)、2(夏季)、3(秋季),当前传入:" + xqdc);
}
xydndxqjbxxb.setXqdc(xqdc);
@@ -382,31 +394,6 @@ public class ElectiveServiceImpl implements ElectiveService {
return Math.max(1, (int) ((totalMonths + 5) / 6));
}
/**
* 根据班次入学日期智能推断指定日期所在的学期第次(每半年为一个学期)
* <p>
* 半年以内的班次返回 1;半年以上的班次按 入学日期 到 指定日期 经过的月份
* 每 6 个月为 1 个学期递增,且不超过人才培养方案总学期数。
* </p>
*/
private Integer inferXqdc(LocalDate rx, LocalDate by, LocalDate target) {
if (rx == null) {
return 1;
}
if (target.isBefore(rx)) {
return 1;
}
// 半年以内固定第一学期
if (by != null && isHalfYear(rx, by)) {
return 1;
}
long months = ChronoUnit.MONTHS.between(rx, target);
int xqdc = (int) (months / 6) + 1;
// 不超过总学期数
Integer total = calcTotalXqdc(rx, by);
return Math.min(xqdc, total);
}
/**
* 获取某班次指定学期第次的上一学期专用教室(用于第二以上学期的默认预设)
*
@@ -0,0 +1,109 @@
package com.roomroot.jwgl.service.impl;
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.roomroot.common.utils.StringUtils;
import com.roomroot.jwgl.entity.JYL;
import com.roomroot.jwgl.mapper.JYLMapper;
import com.roomroot.jwgl.service.JYLService;
import com.roomroot.jwgl.unit.PageQuery;
import com.roomroot.jwgl.unit.PageResult;
import org.springframework.stereotype.Service;
import jakarta.annotation.Resource;
import java.time.LocalDateTime;
import java.util.List;
import java.util.UUID;
/**
* 教员历 Service 实现。交互口径与教学场地历一致:新增生成编号 + delFlag=0,删除为软删。
*/
@Service
public class JYLServiceImpl implements JYLService {
@Resource
private JYLMapper jylMapper;
@Override
public void add(JYL row) {
if (row.getJybh() == null || row.getJybh().isEmpty()) {
throw new IllegalArgumentException("请指定教员");
}
row.setBh(UUID.randomUUID().toString());
if (row.getKpk() == null) {
row.setKpk(0);
}
row.setCjsj(LocalDateTime.now());
row.setDelFlag(0);
jylMapper.insert(row);
}
@Override
public void delete(String bh) {
JYL row = jylMapper.selectById(bh);
if (row != null) {
row.setDelFlag(1);
jylMapper.updateById(row);
}
}
@Override
public void update(JYL row) {
row.setDelFlag(null);
jylMapper.updateById(row);
}
@Override
public JYL getById(String bh) {
return jylMapper.selectById(bh);
}
@Override
public PageResult<JYL> pageList(PageQuery query, JYL condition) {
PageQuery q = query == null ? new PageQuery() : query;
int pageNum = q.getPageNum() == null ? 1 : q.getPageNum();
int pageSize = q.getPageSize() == null ? 10 : q.getPageSize();
com.baomidou.mybatisplus.extension.plugins.pagination.Page<JYL> page =
new com.baomidou.mybatisplus.extension.plugins.pagination.Page<>(pageNum, pageSize);
jylMapper.selectPage(page, buildWrapper(condition));
return new PageResult<>(page.getRecords(), page.getTotal(), pageNum, pageSize);
}
@Override
public List<JYL> list(JYL condition) {
return jylMapper.selectList(buildWrapper(condition));
}
@Override
public List<JYL> listByJybh(String jybh) {
return jylMapper.selectList(new LambdaQueryWrapper<JYL>()
.eq(JYL::getJybh, jybh)
.eq(JYL::getDelFlag, 0)
.orderByAsc(JYL::getRq)
.orderByAsc(JYL::getJc));
}
@Override
public List<JYL> listByRq(String rq) {
return jylMapper.selectList(new LambdaQueryWrapper<JYL>()
.apply("DATE(rq) = {0}", rq)
.eq(JYL::getDelFlag, 0));
}
private LambdaQueryWrapper<JYL> buildWrapper(JYL condition) {
LambdaQueryWrapper<JYL> qw = new LambdaQueryWrapper<>();
qw.eq(JYL::getDelFlag, 0);
if (condition != null) {
if (StringUtils.isNotEmpty(condition.getJybh())) {
qw.eq(JYL::getJybh, condition.getJybh());
}
if (StringUtils.isNotEmpty(condition.getMc())) {
qw.like(JYL::getMc, condition.getMc());
}
if (condition.getKpk() != null) {
qw.eq(JYL::getKpk, condition.getKpk());
}
}
qw.orderByAsc(JYL::getRq).orderByAsc(JYL::getJc);
return qw;
}
}
@@ -0,0 +1,255 @@
package com.roomroot.jwgl.service.impl;
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.roomroot.common.exception.ServiceException;
import com.roomroot.jwgl.entity.JXRW;
import com.roomroot.jwgl.entity.SSKC;
import com.roomroot.jwgl.entity.SSKCB;
import com.roomroot.jwgl.entity.SSKCBFZJY;
import com.roomroot.jwgl.entity.SSKCBJS;
import com.roomroot.jwgl.entity.SSKCBXYD;
import com.roomroot.jwgl.entity.SSKCXYD;
import com.roomroot.jwgl.entity.XYDB;
import com.roomroot.jwgl.entity.XYDNDXQJBXXB;
import com.roomroot.jwgl.entity.XYDRWB;
import com.roomroot.jwgl.mapper.ClassSemesterMapper;
import com.roomroot.jwgl.mapper.SSKCBFZJYMapper;
import com.roomroot.jwgl.mapper.SSKCBJSMapper;
import com.roomroot.jwgl.mapper.SSKCBMapper;
import com.roomroot.jwgl.mapper.SSKCBXYDMapper;
import com.roomroot.jwgl.mapper.SSKCMapper;
import com.roomroot.jwgl.mapper.SSKCXYDMapper;
import com.roomroot.jwgl.mapper.TeachingTaskMapper;
import com.roomroot.jwgl.mapper.XYDBMapper;
import com.roomroot.jwgl.service.RunningCoursePublishService;
import com.roomroot.jwgl.utils.SemesterCodeUtil;
import com.roomroot.jwgl.utils.TeachingTaskStatus;
import com.roomroot.jwgl.utils.UuidUtil;
import jakarta.annotation.Resource;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import java.time.LocalDateTime;
import java.util.ArrayList;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.Objects;
import static com.roomroot.jwgl.utils.BasicManagementConstants.BAD_REQUEST;
import static com.roomroot.jwgl.utils.BasicManagementConstants.NOT_FOUND;
/**
* 运行课表批量发布/撤回实现(阶段 5.2)。
*
* <p>发布 = 班次学期的课程任务(学员队任务表)按 合班组(编组 bz2)聚合写成
* 实施_课程 + 实施_课程学员队;不生成 实施_课程表 空壳课次。
* 课次由阶段 5.3 排课窗逐格安排。</p>
*/
@Slf4j
@Service
public class RunningCoursePublishServiceImpl implements RunningCoursePublishService {
@Resource
private ClassSemesterMapper classSemesterMapper;
@Resource
private com.roomroot.jwgl.mapper.StudentTeamTaskMapper studentTeamTaskMapper;
@Resource
private TeachingTaskMapper jxrwMapper;
@Resource
private XYDBMapper xydbMapper;
@Resource
private SSKCMapper sskcMapper;
@Resource
private SSKCXYDMapper sskcxydMapper;
@Resource
private SSKCBMapper sskcbMapper;
@Resource
private SSKCBXYDMapper sskcbxydMapper;
@Resource
private SSKCBJSMapper sskcbjsMapper;
@Resource
private SSKCBFZJYMapper sskcbfzjyMapper;
@Override
@Transactional(rollbackFor = Exception.class)
public int publish(String xydxqbh) {
XYDNDXQJBXXB semester = requireSemester(xydxqbh);
Integer ndCode = SemesterCodeUtil.resolve(semester.getNd(), semester.getXqdc());
XYDB team = xydbMapper.selectById(semester.getXydbh());
// 门禁:任务书已发布且未结束
assertTaskBookPublished(semester);
List<XYDRWB> tasks = studentTeamTaskMapper.selectList(new LambdaQueryWrapper<XYDRWB>()
.eq(XYDRWB::getXydxqbh, semester.getBh())
.eq(XYDRWB::getDelFlag, 0));
if (tasks.isEmpty()) {
throw new ServiceException("该班次学期没有课程任务可发布", NOT_FOUND);
}
// 幂等:已有发布记录则拒绝
List<SSKCXYD> published = sskcxydMapper.selectList(new LambdaQueryWrapper<SSKCXYD>()
.eq(SSKCXYD::getXydbh, semester.getXydbh())
.eq(SSKCXYD::getNd, ndCode));
if (!published.isEmpty()) {
throw new ServiceException("该班次学期已发布 " + published.size() + " 条运行课程,请先撤回再重新发布", BAD_REQUEST);
}
// 整批校验:责任教员、默认场地非空,缺项全部列出
List<String> missing = new ArrayList<>();
for (XYDRWB task : tasks) {
List<String> lack = new ArrayList<>();
if (task.getJybh() == null || task.getJybh().isEmpty()) {
lack.add("责任教员");
}
if (task.getJsbh() == null || task.getJsbh().isEmpty()) {
lack.add("默认场地");
}
if (!lack.isEmpty()) {
missing.add(task.getJc() + "(" + teamName(team) + ")缺 " + String.join("、", lack));
}
}
if (!missing.isEmpty()) {
throw new ServiceException("发布失败,以下课程缺项:" + String.join(";", missing), BAD_REQUEST);
}
// 按合班组聚合:bz2 非 0 同组一条实施课程,未合班每任务一条
Map<String, List<XYDRWB>> groups = new LinkedHashMap<>();
for (XYDRWB task : tasks) {
String key = task.getBz2() != null && task.getBz2() != 0
? "G" + task.getBz2() + "|" + task.getKbh()
: "S" + task.getBh();
groups.computeIfAbsent(key, k -> new ArrayList<>()).add(task);
}
LocalDateTime now = LocalDateTime.now();
int count = 0;
for (List<XYDRWB> group : groups.values()) {
XYDRWB head = group.get(0);
SSKC sskc = new SSKC();
sskc.setBh(UuidUtil.getUUID());
sskc.setNd(ndCode);
sskc.setJybh(head.getJybh());
sskc.setKmbh(head.getKbh());
sskc.setJsbh(head.getJsbh());
sskc.setXs(head.getXs());
sskc.setKlx(head.getKlx());
sskc.setCjfz(head.getCjfz());
sskc.setZks(head.getZks());
sskc.setXf(head.getXf());
sskc.setLlxs(head.getLlxs());
sskc.setSjxs(head.getSjxs());
sskc.setBjrxypjf(head.getBjrxypjf());
sskc.setCjsj(now);
sskc.setBdsj(now);
sskcMapper.insert(sskc);
for (XYDRWB task : group) {
SSKCXYD link = new SSKCXYD();
link.setBh(UuidUtil.getUUID());
link.setSskcbh(sskc.getBh());
link.setXydbh(task.getXydbh());
link.setJc(team != null ? team.getJc() : null);
link.setRs(team != null ? team.getXydrs() : null);
link.setNd(ndCode);
link.setXqdc(semester.getXqdc());
link.setXf(task.getXf());
sskcxydMapper.insert(link);
}
count++;
}
return count;
}
@Override
@Transactional(rollbackFor = Exception.class)
public int withdraw(String xydxqbh) {
XYDNDXQJBXXB semester = requireSemester(xydxqbh);
Integer ndCode = SemesterCodeUtil.resolve(semester.getNd(), semester.getXqdc());
// 该班次学期的发布关联
List<SSKCXYD> links = sskcxydMapper.selectList(new LambdaQueryWrapper<SSKCXYD>()
.eq(SSKCXYD::getXydbh, semester.getXydbh())
.eq(SSKCXYD::getNd, ndCode));
if (links.isEmpty()) {
throw new ServiceException("该班次学期没有已发布的运行课程", NOT_FOUND);
}
List<String> sskcBhs = links.stream().map(SSKCXYD::getSskcbh).distinct().toList();
int removed = 0;
for (String sskcbh : sskcBhs) {
// 删除该课程的课次及其教室/教员/学员队关联
List<SSKCB> lessons = sskcbMapper.selectList(new LambdaQueryWrapper<SSKCB>()
.eq(SSKCB::getSskcbh, sskcbh));
for (SSKCB lesson : lessons) {
sskcbxydMapper.delete(new LambdaQueryWrapper<SSKCBXYD>()
.eq(SSKCBXYD::getSskcbbh, lesson.getBh()));
sskcbjsMapper.delete(new LambdaQueryWrapper<SSKCBJS>()
.eq(SSKCBJS::getSskcbbh, lesson.getBh()));
sskcbfzjyMapper.delete(new LambdaQueryWrapper<SSKCBFZJY>()
.eq(SSKCBFZJY::getSskcbbh, lesson.getBh()));
}
sskcbMapper.delete(new LambdaQueryWrapper<SSKCB>()
.eq(SSKCB::getSskcbh, sskcbh));
// TODO(业务确认):课次已有调课/请假记录时应先确认,当前直接随撤回删除
// 删除本班次的关联行
sskcxydMapper.delete(new LambdaQueryWrapper<SSKCXYD>()
.eq(SSKCXYD::getSskcbh, sskcbh)
.eq(SSKCXYD::getXydbh, semester.getXydbh())
.eq(SSKCXYD::getNd, ndCode));
// 合班课程可能仍被其它班次引用:仅当不再有任何关联时删除 实施_课程 本体
Long remain = sskcxydMapper.selectCount(new LambdaQueryWrapper<SSKCXYD>()
.eq(SSKCXYD::getSskcbh, sskcbh));
if (remain == null || remain == 0) {
sskcMapper.deleteById(sskcbh);
}
removed++;
}
return removed;
}
// ==================== 公共 ====================
private XYDNDXQJBXXB requireSemester(String xydxqbh) {
if (xydxqbh == null || xydxqbh.isEmpty()) {
throw new ServiceException("请指定班次学期", BAD_REQUEST);
}
XYDNDXQJBXXB semester = classSemesterMapper.selectById(xydxqbh);
if (semester == null) {
throw new ServiceException("班次学期不存在:" + xydxqbh, NOT_FOUND);
}
return semester;
}
private void assertTaskBookPublished(XYDNDXQJBXXB semester) {
if (semester.getJxrwbh() == null || semester.getJxrwbh().isEmpty()) {
throw new ServiceException("该班次学期没有关联教学任务,不能发布", BAD_REQUEST);
}
JXRW jxrw = jxrwMapper.selectById(semester.getJxrwbh());
if (jxrw == null || Integer.valueOf(1).equals(jxrw.getDelFlag())) {
throw new ServiceException("关联教学任务不存在,不能发布", BAD_REQUEST);
}
if (!TeachingTaskStatus.isPublished(jxrw.getZt())) {
throw new ServiceException("教学任务尚未发布,不能发布运行课表", BAD_REQUEST);
}
if (TeachingTaskStatus.isEnded(jxrw.getZt())) {
throw new ServiceException("教学任务已结束,不能发布运行课表", BAD_REQUEST);
}
}
private String teamName(XYDB team) {
return team != null && team.getXydmc() != null ? team.getXydmc() : "-";
}
}
@@ -0,0 +1,808 @@
package com.roomroot.jwgl.service.impl;
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.roomroot.common.exception.ServiceException;
import com.roomroot.common.utils.SecurityUtils;
import com.roomroot.jwgl.dto.scheduling.SchedulingArrangeRequest;
import com.roomroot.jwgl.dto.scheduling.SchedulingCellOpRequest;
import com.roomroot.jwgl.entity.JQB;
import com.roomroot.jwgl.entity.JYB;
import com.roomroot.jwgl.entity.JXCDL;
import com.roomroot.jwgl.entity.JYL;
import com.roomroot.jwgl.entity.KCJXYX_CZRZ;
import com.roomroot.jwgl.entity.SSKC;
import com.roomroot.jwgl.entity.SSKCB;
import com.roomroot.jwgl.entity.SSKCBFZJY;
import com.roomroot.jwgl.entity.SSKCBJS;
import com.roomroot.jwgl.entity.SSKCBXYD;
import com.roomroot.jwgl.entity.SSKCXYD;
import com.roomroot.jwgl.entity.XYDB;
import com.roomroot.jwgl.entity.XYDNDXQJBXXB;
import com.roomroot.jwgl.entity.XQXLB;
import com.roomroot.jwgl.mapper.XYDBMapper;
import com.roomroot.jwgl.mapper.ClassRoomCalendarMapper;
import com.roomroot.jwgl.mapper.ClassSemesterMapper;
import com.roomroot.jwgl.mapper.JQBMapper;
import com.roomroot.jwgl.mapper.JYBMapper;
import com.roomroot.jwgl.mapper.JYLMapper;
import com.roomroot.jwgl.mapper.KBMapper;
import com.roomroot.jwgl.mapper.KCJXYX_CZRZMapper;
import com.roomroot.jwgl.mapper.SSKCBFZJYMapper;
import com.roomroot.jwgl.mapper.SSKCBJSMapper;
import com.roomroot.jwgl.mapper.SSKCBMapper;
import com.roomroot.jwgl.mapper.SSKCBXYDMapper;
import com.roomroot.jwgl.mapper.SSKCMapper;
import com.roomroot.jwgl.mapper.SSKCXYDMapper;
import com.roomroot.jwgl.mapper.SemesterCalendarMapper;
import com.roomroot.jwgl.service.SchedulingWindowService;
import com.roomroot.jwgl.utils.JwglRoleHelper;
import com.roomroot.jwgl.utils.SemesterCodeUtil;
import com.roomroot.jwgl.utils.UuidUtil;
import com.roomroot.jwgl.vo.scheduling.SchedulingViewVO;
import jakarta.annotation.Resource;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import java.time.DayOfWeek;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.util.ArrayList;
import java.util.Comparator;
import java.util.HashMap;
import java.util.HashSet;
import java.util.List;
import java.util.Map;
import java.util.Objects;
import java.util.Set;
import java.util.stream.Collectors;
import static com.roomroot.jwgl.utils.BasicManagementConstants.BAD_REQUEST;
import static com.roomroot.jwgl.utils.BasicManagementConstants.FORBIDDEN;
import static com.roomroot.jwgl.utils.BasicManagementConstants.NOT_FOUND;
/**
* 实施排课窗口实现(阶段 5.3)。
*
* <p>冲突口径:硬冲突(格忽略)= 教员/教室/班次双占、校历/班历/场地历/教员历不可排;
* 软提示(照常安排)= 非正课、配当周次不符。</p>
*/
@Slf4j
@Service
public class SchedulingWindowServiceImpl implements SchedulingWindowService {
/** 默认一节 2 学时 */
private static final int HOURS_PER_LESSON = 2;
@Resource
private ClassSemesterMapper classSemesterMapper;
@Resource
private KBMapper kbMapper;
@Resource
private com.roomroot.jwgl.service.TeachingAllocationService teachingAllocationService;
@Resource
private JYBMapper jybMapper;
@Resource
private XYDBMapper xydbMapper;
@Resource
private SSKCMapper sskcMapper;
@Resource
private SSKCXYDMapper sskcxydMapper;
@Resource
private SSKCBMapper sskcbMapper;
@Resource
private SSKCBXYDMapper sskcbxydMapper;
@Resource
private SSKCBJSMapper sskcbjsMapper;
@Resource
private SSKCBFZJYMapper sskcbfzjyMapper;
@Resource
private SemesterCalendarMapper semesterCalendarMapper;
@Resource
private JQBMapper jqbMapper;
@Resource
private ClassRoomCalendarMapper classRoomCalendarMapper;
@Resource
private JYLMapper jylMapper;
@Resource
private KCJXYX_CZRZMapper czrzMapper;
@Resource
private JwglRoleHelper roleHelper;
@Resource
private com.roomroot.jwgl.mapper.StudentTeamTaskMapper studentTeamTaskMapper;
// ==================== 视图 ====================
@Override
public SchedulingViewVO view(String xydxqbh) {
Ctx ctx = loadCtx(xydxqbh);
SchedulingViewVO vo = new SchedulingViewVO();
vo.setXydxqbh(ctx.semester.getBh());
vo.setXydmc(ctx.team != null ? ctx.team.getXydmc() : ctx.semester.getXydbh());
vo.setZyjsbh(ctx.semester.getZyjsbh());
vo.setNdCode(ctx.ndCode);
vo.setKxrq(ctx.semester.getKxrq());
vo.setJsrq(ctx.semester.getJsrq());
// 课程列表(本班次已发布的运行课程)
List<SSKCXYD> links = ctx.links;
List<String> sskcIds = links.stream().map(SSKCXYD::getSskcbh).distinct().toList();
Map<String, SSKC> courses = sskcIds.isEmpty() ? Map.of()
: sskcMapper.selectBatchIds(sskcIds).stream().collect(Collectors.toMap(SSKC::getBh, c -> c, (a, b) -> a));
List<SSKCB> lessons = ctx.lessons;
Map<String, List<SSKCB>> lessonsByCourse = lessons.stream()
.collect(Collectors.groupingBy(SSKCB::getSskcbh));
for (String sskcbh : sskcIds) {
SSKC course = courses.get(sskcbh);
if (course == null) continue;
SchedulingViewVO.Course c = new SchedulingViewVO.Course();
c.setSskcbh(course.getBh());
c.setKbh(course.getKmbh());
c.setKcmc(resolveCourseName(course.getKmbh()));
c.setKlx(course.getKlx());
c.setXs(course.getXs());
c.setZks(course.getZks());
c.setJybh(course.getJybh());
c.setJsbh(course.getJsbh());
List<SSKCB> cl = lessonsByCourse.getOrDefault(sskcbh, List.of());
c.setScheduledHours(cl.stream().mapToInt(l -> HOURS_PER_LESSON + (l.getJcdj() == null ? 0 : l.getJcdj())).sum());
c.setFull(course.getXs() != null && c.getScheduledHours() >= course.getXs());
c.setEditable(canEdit(course, ctx));
vo.getCourses().add(c);
}
// 时间格
buildGrid(ctx, vo);
return vo;
}
/** 周次×星期×节次格子:叠加校历/班历不可排标记与已排课次 */
private void buildGrid(Ctx ctx, SchedulingViewVO vo) {
LocalDate kxrq = ctx.semester.getKxrq();
LocalDate jsrq = ctx.semester.getJsrq();
if (kxrq == null || jsrq == null) {
throw new ServiceException("班次学期缺少开学/结束日期,无法生成排课时间区", BAD_REQUEST);
}
// 历表不可排数据(本学期代号范围内)
Set<String> schoolHard = new HashSet<>(); // 校历不可排 date#jc
Set<String> schoolSoft = new HashSet<>(); // 非正课
List<XQXLB> schoolRows = semesterCalendarMapper.selectList(new LambdaQueryWrapper<XQXLB>()
.eq(XQXLB::getNd, ctx.ndCode));
for (XQXLB row : schoolRows) {
if (row.getJqsj() == null) continue;
for (Integer jc : parsePeriods(row.getCourseClass())) {
String key = row.getJqsj() + "#" + jc;
if (Boolean.FALSE.equals(row.getKpk())) schoolHard.add(key);
else if (Boolean.FALSE.equals(row.getZk())) schoolSoft.add(key);
}
}
Set<String> classHard = new HashSet<>();
Set<String> classSoft = new HashSet<>();
List<JQB> classRows = jqbMapper.selectList(new LambdaQueryWrapper<JQB>()
.eq(JQB::getXydxqbh, ctx.semester.getBh()));
for (JQB row : classRows) {
if (row.getJqsj() == null) continue;
String date = intDate(row.getJqsj());
for (Integer jc : parsePeriods(row.getCourseClass())) {
String key = date + "#" + jc;
if (row.getKpk() != null && row.getKpk() == 0) classHard.add(key);
else if (row.getZk() != null && row.getZk() == 0) classSoft.add(key);
}
}
// 已排课次
Map<String, List<SSKCB>> lessonsByGrid = ctx.lessons.stream()
.filter(l -> l.getRq() != null && l.getJc() != null)
.collect(Collectors.groupingBy(l -> l.getRq().toLocalDate().toString() + "#" + l.getJc()));
Map<String, String> courseNames = new HashMap<>();
Map<String, String> courseTeachers = new HashMap<>();
for (SSKC course : sskcMapper.selectBatchIds(ctx.links.stream().map(SSKCXYD::getSskcbh).distinct().toList())) {
courseNames.put(course.getBh(), resolveCourseName(course.getKmbh()));
courseTeachers.put(course.getBh(), safe(course.getJybh()));
}
LocalDate weekStart = kxrq.with(DayOfWeek.MONDAY);
int weekNo = 1;
int[] periodCount = {8};
while (!weekStart.isAfter(jsrq)) {
SchedulingViewVO.Week week = new SchedulingViewVO.Week();
week.setWeekNo(weekNo);
week.setStartDate(weekStart);
week.setEndDate(weekStart.plusDays(6).isAfter(jsrq) ? jsrq : weekStart.plusDays(6));
for (int d = 0; d < 7; d++) {
LocalDate date = weekStart.plusDays(d);
if (date.isBefore(kxrq) || date.isAfter(jsrq)) continue;
SchedulingViewVO.Day day = new SchedulingViewVO.Day();
day.setDate(date);
day.setWeekday(date.getDayOfWeek().getValue());
for (int jc = 1; jc <= periodCount[0]; jc++) {
SchedulingViewVO.Cell cell = new SchedulingViewVO.Cell();
cell.setJc(jc);
String key = date.toString() + "#" + jc;
if (schoolHard.contains(key) || classHard.contains(key)) {
cell.setUnavailable(true);
cell.setReason("不可排课(" + (schoolHard.contains(key) ? "校历" : "班历") + ")");
} else {
if (schoolSoft.contains(key) || classSoft.contains(key)) {
cell.setWarning("非正课时段");
}
cell.setUnavailable(false);
}
for (SSKCB lesson : lessonsByGrid.getOrDefault(key, List.of())) {
SchedulingViewVO.Lesson l = new SchedulingViewVO.Lesson();
l.setBh(lesson.getBh());
l.setSskcbh(lesson.getSskcbh());
l.setKcmc(courseNames.getOrDefault(lesson.getSskcbh(), "-"));
l.setJxnr(lesson.getJxnr());
l.setJxff(lesson.getJxff());
l.setJcdj(lesson.getJcdj());
l.setYcxx(lesson.getYcxx());
l.setJyxm(courseTeachers.getOrDefault(lesson.getSskcbh(), "-"));
cell.getLessons().add(l);
}
day.getCells().add(cell);
}
week.getDays().add(day);
}
vo.getWeeks().add(week);
weekNo++;
weekStart = weekStart.plusDays(7);
}
vo.setTotalWeeks(weekNo - 1);
}
// ==================== 安排所选节次 ====================
@Override
@Transactional(rollbackFor = Exception.class)
public Map<String, Object> arrange(SchedulingArrangeRequest request) {
if (request == null || request.getSskcbh() == null || request.getCells() == null || request.getCells().isEmpty()) {
throw new ServiceException("请指定课程与要安排的节次", BAD_REQUEST);
}
SSKC course = requireCourse(request.getSskcbh());
Ctx ctx = loadCtxForCourse(course);
if (!canEdit(course, ctx)) {
throw new ServiceException("没有该课程的排课权限", FORBIDDEN);
}
String jsbh = request.getJsbh() != null && !request.getJsbh().isEmpty() ? request.getJsbh() : course.getJsbh();
if (jsbh == null || jsbh.isEmpty()) {
throw new ServiceException("请指定场地(课程未设置默认场地)", BAD_REQUEST);
}
String jybh = request.getJybh() != null && !request.getJybh().isEmpty() ? request.getJybh() : course.getJybh();
// 硬冲突判定所需数据
List<SSKCB> semesterLessons = ctx.lessons;
Map<String, List<SSKCB>> byGrid = semesterLessons.stream()
.filter(l -> l.getRq() != null && l.getJc() != null)
.collect(Collectors.groupingBy(l -> l.getRq().toLocalDate().toString() + "#" + l.getJc()));
// 课次 → 学员队 / 教室 / 教员(无占用课次时跳过,避免空 IN())
Map<String, List<String>> teamsOfLesson = new HashMap<>();
Map<String, List<String>> roomsOfLesson = new HashMap<>();
Map<String, List<String>> teachersOfLesson = new HashMap<>();
List<String> occupantIds = byGrid.values().stream().flatMap(List::stream)
.map(SSKCB::getBh).distinct().toList();
if (!occupantIds.isEmpty()) {
for (SSKCBXYD l : sskcbxydMapper.selectList(new LambdaQueryWrapper<SSKCBXYD>()
.in(SSKCBXYD::getSskcbbh, occupantIds))) {
teamsOfLesson.computeIfAbsent(l.getSskcbbh(), k -> new ArrayList<>()).add(l.getXydbh());
}
for (SSKCBJS l : sskcbjsMapper.selectList(new LambdaQueryWrapper<SSKCBJS>()
.in(SSKCBJS::getSskcbbh, occupantIds))) {
roomsOfLesson.computeIfAbsent(l.getSskcbbh(), k -> new ArrayList<>()).add(l.getJsbh());
}
for (SSKCBFZJY l : sskcbfzjyMapper.selectList(new LambdaQueryWrapper<SSKCBFZJY>()
.in(SSKCBFZJY::getSskcbbh, occupantIds))) {
teachersOfLesson.computeIfAbsent(l.getSskcbbh(), k -> new ArrayList<>()).add(l.getFzjybh());
}
}
// 场地历 / 教员历 不可排
Map<String, String> roomBlocked = new HashMap<>();
for (JXCDL row : classRoomCalendarMapper.selectList(new LambdaQueryWrapper<JXCDL>()
.eq(JXCDL::getKpk, false).eq(JXCDL::getDelFlag, 0))) {
if (row.getRq() != null && row.getJsbh() != null) {
roomBlocked.put(row.getRq().toLocalDate().toString() + "#" + row.getJc() + "#" + row.getJsbh(), "场地历不可用");
}
}
Map<String, String> teacherBlocked = new HashMap<>();
for (JYL row : jylMapper.selectList(new LambdaQueryWrapper<JYL>()
.eq(JYL::getKpk, 0).eq(JYL::getDelFlag, 0))) {
if (row.getRq() != null && row.getJybh() != null) {
teacherBlocked.put(row.getRq().toLocalDate().toString() + "#" + row.getJc() + "#" + row.getJybh(), "教员历不可用");
}
}
// 校历/班历不可排(节次级)
Set<String> schoolHard = calendarHardKeys(ctx, true);
Set<String> classHard = calendarHardKeys(ctx, false);
// 配当周次(软提示):该课程配当分布覆盖的周
Set<Integer> allocatedWeeks = allocatedWeeks(ctx, course);
LocalDateTime now = LocalDateTime.now();
int arranged = 0;
List<Map<String, Object>> ignored = new ArrayList<>();
List<Map<String, Object>> warnings = new ArrayList<>();
for (SchedulingArrangeRequest.Cell cell : request.getCells()) {
if (cell.getRq() == null || cell.getJc() == null) continue;
String key = cell.getRq() + "#" + cell.getJc();
List<SSKCB> occupants = byGrid.getOrDefault(key, List.of());
// 硬冲突:不可排课
if (schoolHard.contains(key)) {
ignored.add(ignoredCell(cell, "校历不可排课"));
continue;
}
if (classHard.contains(key)) {
ignored.add(ignoredCell(cell, "班历不可排课"));
continue;
}
String roomKey = key + "#" + jsbh;
if (roomBlocked.containsKey(roomKey)) {
ignored.add(ignoredCell(cell, "场地历不可用"));
continue;
}
if (jybh != null && teacherBlocked.containsKey(key + "#" + jybh)) {
ignored.add(ignoredCell(cell, "教员历不可用"));
continue;
}
// 硬冲突:双占(本课程的已有课次视为可覆盖)
boolean ownOccupied = false;
boolean busy = false;
String busyReason = null;
for (SSKCB occupant : occupants) {
boolean own = occupant.getSskcbh().equals(course.getBh());
if (own) {
ownOccupied = true;
continue;
}
if (teamsOfLesson.getOrDefault(occupant.getBh(), List.of()).stream()
.anyMatch(t -> Objects.equals(t, ctx.semester.getXydbh()))) {
busy = true; busyReason = "班次该节已有其它课程";
break;
}
if (roomsOfLesson.getOrDefault(occupant.getBh(), List.of()).contains(jsbh)) {
busy = true; busyReason = "教室该节已被占用";
break;
}
if (jybh != null && teachersOfLesson.getOrDefault(occupant.getBh(), List.of()).contains(jybh)) {
busy = true; busyReason = "教员该节已有课";
break;
}
}
if (busy) {
ignored.add(ignoredCell(cell, busyReason));
continue;
}
// 软提示
LocalDate date = LocalDate.parse(cell.getRq());
int weekNo = weekNoOf(ctx, date);
if (allocatedWeeks != null && !allocatedWeeks.isEmpty() && !allocatedWeeks.contains(weekNo)) {
warnings.add(warnCell(cell, "配当周次不符(第 " + weekNo + " 周不在该课配当范围)"));
}
if (!ownOccupied) {
SSKCB lesson = new SSKCB();
lesson.setBh(UuidUtil.getUUID());
lesson.setSskcbh(course.getBh());
lesson.setJhsjap(0);
lesson.setJxnr(request.getJxnr());
lesson.setJxyd(request.getJxyd());
lesson.setJxff(request.getJxff() == null || request.getJxff().isEmpty() ? "理论讲授" : request.getJxff());
lesson.setRq(date.atStartOfDay());
lesson.setJc(cell.getJc());
lesson.setNd(ctx.ndCode);
lesson.setSczt(0);
lesson.setJcdj(request.getJcdj() == null ? 0 : request.getJcdj());
lesson.setJxbzbz(request.getJxbzbz());
lesson.setYcxx(request.getYcxx());
lesson.setBzms(request.getBzms());
lesson.setCjsj(now);
lesson.setBdsj(now);
sskcbMapper.insert(lesson);
// 学员队 / 教室 / 主讲教员
for (SSKCXYD link : ctx.links) {
if (!course.getBh().equals(link.getSskcbh())) continue;
SSKCBXYD lxyd = new SSKCBXYD();
lxyd.setBh(UuidUtil.getUUID());
lxyd.setSskcbbh(lesson.getBh());
lxyd.setXydbh(link.getXydbh());
lxyd.setRs(link.getRs());
lxyd.setJc(link.getJc());
lxyd.setNd(ctx.ndCode);
lxyd.setRq(lesson.getRq());
lxyd.setJc2(cell.getJc());
sskcbxydMapper.insert(lxyd);
}
SSKCBJS ljs = new SSKCBJS();
ljs.setBh(UuidUtil.getUUID());
ljs.setSskcbbh(lesson.getBh());
ljs.setJsbh(jsbh);
ljs.setNd(ctx.ndCode);
ljs.setRq(lesson.getRq());
ljs.setJc(cell.getJc());
sskcbjsMapper.insert(ljs);
if (jybh != null) {
SSKCBFZJY lfz = new SSKCBFZJY();
lfz.setBh(UuidUtil.getUUID());
lfz.setSskcbbh(lesson.getBh());
lfz.setFzjybh(jybh);
lfz.setZjy(1);
lfz.setNd(ctx.ndCode);
lfz.setRq(lesson.getRq());
lfz.setJc(cell.getJc());
sskcbfzjyMapper.insert(lfz);
}
arranged++;
logOperation(course, "安排", "安排 " + cell.getRq() + " 第" + cell.getJc() + "节"
+ (ownOccupied ? "(覆盖原课次)" : ""),
request);
} else {
// 覆盖本课程已有课次的内容
for (SSKCB occupant : occupants) {
if (!occupant.getSskcbh().equals(course.getBh())) continue;
occupant.setJxnr(request.getJxnr());
occupant.setJxyd(request.getJxyd());
occupant.setJxff(request.getJxff());
occupant.setJcdj(request.getJcdj() == null ? 0 : request.getJcdj());
occupant.setJxbzbz(request.getJxbzbz());
occupant.setBdsj(now);
sskcbMapper.updateById(occupant);
arranged++;
}
}
}
Map<String, Object> result = new HashMap<>();
result.put("arranged", arranged);
result.put("ignored", ignored);
result.put("warnings", warnings);
return result;
}
// ==================== 删除 ====================
@Override
@Transactional(rollbackFor = Exception.class)
public int deleteCells(SchedulingCellOpRequest request) {
if (request == null || request.getSskcbh() == null || request.getCells() == null || request.getCells().isEmpty()) {
throw new ServiceException("请指定课程与要删除的节次", BAD_REQUEST);
}
SSKC course = requireCourse(request.getSskcbh());
Ctx ctx = loadCtxForCourse(course);
if (!canEdit(course, ctx)) {
throw new ServiceException("没有该课程的排课权限", FORBIDDEN);
}
Set<String> keys = request.getCells().stream()
.filter(c -> c.getRq() != null && c.getJc() != null)
.map(c -> c.getRq() + "#" + c.getJc())
.collect(Collectors.toSet());
int count = 0;
for (SSKCB lesson : sskcbMapper.selectList(new LambdaQueryWrapper<SSKCB>()
.eq(SSKCB::getSskcbh, course.getBh()))) {
if (lesson.getRq() == null || lesson.getJc() == null) continue;
String key = lesson.getRq().toLocalDate().toString() + "#" + lesson.getJc();
if (!keys.contains(key)) continue;
// 已提交实施计划的课次不在排课窗直改
if (lesson.getJhsjap() != null && lesson.getJhsjap() == 1) {
throw new ServiceException(lesson.getRq().toLocalDate() + " 第" + lesson.getJc()
+ "节已提交实施计划,请走调课申请", BAD_REQUEST);
}
deleteLessonChildren(lesson.getBh());
sskcbMapper.deleteById(lesson.getBh());
logOperation(course, "删除", "删除课次 " + key, null);
count++;
}
return count;
}
@Override
@Transactional(rollbackFor = Exception.class)
public int clearCourse(String sskcbh) {
SSKC course = requireCourse(sskcbh);
Ctx ctx = loadCtxForCourse(course);
if (!canEdit(course, ctx)) {
throw new ServiceException("没有该课程的排课权限", FORBIDDEN);
}
List<SSKCB> lessons = sskcbMapper.selectList(new LambdaQueryWrapper<SSKCB>()
.eq(SSKCB::getSskcbh, course.getBh()));
for (SSKCB lesson : lessons) {
if (lesson.getJhsjap() != null && lesson.getJhsjap() == 1) {
throw new ServiceException("课程存在已提交实施计划的课次,请先通过调课流程处理", BAD_REQUEST);
}
}
for (SSKCB lesson : lessons) {
deleteLessonChildren(lesson.getBh());
sskcbMapper.deleteById(lesson.getBh());
}
logOperation(course, "删除", "清空课程全部节次(" + lessons.size() + " 节)", null);
return lessons.size();
}
@Override
@Transactional(rollbackFor = Exception.class)
public int deleteCourse(String sskcbh) {
if (roleHelper.isTeacher()) {
throw new ServiceException("教员不能彻底删除运行课程", FORBIDDEN);
}
SSKC course = requireCourse(sskcbh);
Ctx ctx = loadCtxForCourse(course);
if (!canEdit(course, ctx)) {
throw new ServiceException("没有该课程的排课权限", FORBIDDEN);
}
for (SSKCB lesson : sskcbMapper.selectList(new LambdaQueryWrapper<SSKCB>()
.eq(SSKCB::getSskcbh, course.getBh()))) {
deleteLessonChildren(lesson.getBh());
sskcbMapper.deleteById(lesson.getBh());
}
sskcxydMapper.delete(new LambdaQueryWrapper<SSKCXYD>()
.eq(SSKCXYD::getSskcbh, course.getBh()));
sskcMapper.deleteById(course.getBh());
logOperation(course, "删除", "彻底删除运行课程", null);
return 1;
}
@Override
public List<Map<String, Object>> logs(String sskcbh, String czlx) {
LambdaQueryWrapper<KCJXYX_CZRZ> qw = new LambdaQueryWrapper<>();
qw.eq(KCJXYX_CZRZ::getTybh, sskcbh);
if (czlx != null && !czlx.isEmpty()) {
qw.eq(KCJXYX_CZRZ::getCzlx, czlx);
}
qw.orderByDesc(KCJXYX_CZRZ::getCzsj);
return czrzMapper.selectList(qw).stream().limit(200)
.map(r -> {
Map<String, Object> m = new HashMap<String, Object>();
m.put("czlx", r.getCzlx());
m.put("cznr", r.getCznr());
m.put("czrbh", r.getCzrbh());
m.put("czsj", r.getCzsj());
return m;
}).collect(Collectors.toList());
}
// ==================== 公共 ====================
/** 上下文:班次学期 + 学员队 + 6 位代号 + 本班次已发布课程与课次 */
private class Ctx {
XYDNDXQJBXXB semester;
XYDB team;
Integer ndCode;
List<SSKCXYD> links;
List<SSKCB> lessons;
}
private Ctx loadCtx(String xydxqbh) {
if (xydxqbh == null || xydxqbh.isEmpty()) {
throw new ServiceException("请指定班次学期", BAD_REQUEST);
}
XYDNDXQJBXXB semester = classSemesterMapper.selectById(xydxqbh);
if (semester == null) {
throw new ServiceException("班次学期不存在:" + xydxqbh, NOT_FOUND);
}
Ctx ctx = new Ctx();
ctx.semester = semester;
ctx.team = xydbMapper.selectById(semester.getXydbh());
ctx.ndCode = SemesterCodeUtil.resolve(semester.getNd(), semester.getXqdc());
ctx.links = sskcxydMapper.selectList(new LambdaQueryWrapper<SSKCXYD>()
.eq(SSKCXYD::getXydbh, semester.getXydbh())
.eq(SSKCXYD::getNd, ctx.ndCode));
List<String> ids = ctx.links.stream().map(SSKCXYD::getSskcbh).distinct().toList();
ctx.lessons = ids.isEmpty() ? new ArrayList<>() : sskcbMapper.selectList(new LambdaQueryWrapper<SSKCB>()
.in(SSKCB::getSskcbh, ids)
.eq(SSKCB::getSczt, 0));
return ctx;
}
private Ctx loadCtxForCourse(SSKC course) {
// 通过任一关联学员队反查班次学期
List<SSKCXYD> links = sskcxydMapper.selectList(new LambdaQueryWrapper<SSKCXYD>()
.eq(SSKCXYD::getSskcbh, course.getBh()));
if (links.isEmpty()) {
throw new ServiceException("该运行课程没有关联学员队", NOT_FOUND);
}
Ctx ctx = loadCtxByTeam(links.get(0).getXydbh(), links.get(0).getNd());
if (ctx.semester == null) {
throw new ServiceException("未找到该课程所属班次学期", NOT_FOUND);
}
// 冲突判定需要全班次本学期全部课次(含其它课程),仅课程自身课次会漏判双占
List<SSKCXYD> teamLinks = sskcxydMapper.selectList(new LambdaQueryWrapper<SSKCXYD>()
.eq(SSKCXYD::getXydbh, ctx.semester.getXydbh())
.eq(SSKCXYD::getNd, ctx.ndCode));
ctx.links = teamLinks;
List<String> ids = teamLinks.stream().map(SSKCXYD::getSskcbh).distinct().toList();
ctx.lessons = ids.isEmpty() ? new ArrayList<>() : sskcbMapper.selectList(new LambdaQueryWrapper<SSKCB>()
.in(SSKCB::getSskcbh, ids)
.eq(SSKCB::getSczt, 0));
return ctx;
}
private Ctx loadCtxByTeam(String xydbh, Integer ndCode) {
List<XYDNDXQJBXXB> semesters = classSemesterMapper.selectList(new LambdaQueryWrapper<XYDNDXQJBXXB>()
.eq(XYDNDXQJBXXB::getXydbh, xydbh)
.eq(XYDNDXQJBXXB::getDelFlag, 0));
XYDNDXQJBXXB match = semesters.stream()
.filter(s -> ndCode.equals(SemesterCodeUtil.resolve(s.getNd(), s.getXqdc())))
.findFirst().orElse(null);
Ctx ctx = new Ctx();
ctx.semester = match;
ctx.team = xydbMapper.selectById(xydbh);
ctx.ndCode = ndCode;
return ctx;
}
private SSKC requireCourse(String sskcbh) {
if (sskcbh == null || sskcbh.isEmpty()) {
throw new ServiceException("请指定运行课程", BAD_REQUEST);
}
SSKC course = sskcMapper.selectById(sskcbh);
if (course == null) {
throw new ServiceException("运行课程不存在:" + sskcbh, NOT_FOUND);
}
return course;
}
/**
* 排课权限:管理员/机关全部;教研室主任=责任教员属本室;教员=本人责任课程且班次开放教员排课。
*/
private boolean canEdit(SSKC course, Ctx ctx) {
if (roleHelper.isAdmin() || roleHelper.isDepartmentPersonnel()) {
return true;
}
if (roleHelper.isResearchOffice()) {
String officeId = roleHelper.findResearchOfficeId();
if (officeId == null) return false;
return course.getJybh() != null && jyInOffice(course.getJybh(), officeId);
}
if (roleHelper.isTeacher()) {
if (ctx.semester != null && ctx.semester.getKfjypk() != null && ctx.semester.getKfjypk() == 0) {
return false; // 开放教员排课关闭,教员只读
}
String teacherId = roleHelper.findTeacherId();
return teacherId != null && teacherId.equals(course.getJybh());
}
return false;
}
/** 教员是否属指定教研室(教员表.教研室代号) */
private boolean jyInOffice(String jybh, String officeId) {
JYB teacher = jybMapper.selectById(jybh);
return teacher != null && officeId.equals(teacher.getJysdh());
}
private void deleteLessonChildren(String sskcbbh) {
sskcbxydMapper.delete(new LambdaQueryWrapper<SSKCBXYD>().eq(SSKCBXYD::getSskcbbh, sskcbbh));
sskcbjsMapper.delete(new LambdaQueryWrapper<SSKCBJS>().eq(SSKCBJS::getSskcbbh, sskcbbh));
sskcbfzjyMapper.delete(new LambdaQueryWrapper<SSKCBFZJY>().eq(SSKCBFZJY::getSskcbbh, sskcbbh));
}
/** 校历/班历不可排格键集合 */
private Set<String> calendarHardKeys(Ctx ctx, boolean school) {
Set<String> keys = new HashSet<>();
if (school) {
for (XQXLB row : semesterCalendarMapper.selectList(new LambdaQueryWrapper<XQXLB>()
.eq(XQXLB::getNd, ctx.ndCode).eq(XQXLB::getKpk, false))) {
if (row.getJqsj() == null) continue;
for (Integer jc : parsePeriods(row.getCourseClass())) keys.add(row.getJqsj() + "#" + jc);
}
} else {
for (JQB row : jqbMapper.selectList(new LambdaQueryWrapper<JQB>()
.eq(JQB::getXydxqbh, ctx.semester.getBh())
.eq(JQB::getKpk, 0))) {
if (row.getJqsj() == null) continue;
String date = intDate(row.getJqsj());
for (Integer jc : parsePeriods(row.getCourseClass())) keys.add(date + "#" + jc);
}
}
return keys;
}
/** 该课程配当分布覆盖的周号集合(无配当返回 null = 不提示) */
private Set<Integer> allocatedWeeks(Ctx ctx, SSKC course) {
try {
var view = teachingAllocationService.view(ctx.semester.getBh());
for (var task : view.getTasks()) {
if (Objects.equals(task.getKbh(), course.getKmbh()) && task.getDistribution() != null
&& !task.getDistribution().isEmpty()) {
return task.getDistribution().stream().map(d -> d.getWeek()).collect(Collectors.toSet());
}
}
} catch (Exception e) {
log.debug("[排课窗] 读取配当失败,忽略软提示: {}", e.getMessage());
}
return null;
}
private int weekNoOf(Ctx ctx, LocalDate date) {
LocalDate start = ctx.semester.getKxrq().with(DayOfWeek.MONDAY);
int week = 1;
while (!start.isAfter(date)) {
if (!date.isBefore(start) && !date.isAfter(start.plusDays(6))) return week;
start = start.plusDays(7);
week++;
}
return week;
}
private Map<String, Object> ignoredCell(SchedulingArrangeRequest.Cell cell, String reason) {
Map<String, Object> m = new HashMap<>();
m.put("rq", cell.getRq());
m.put("jc", cell.getJc());
m.put("reason", reason);
return m;
}
private Map<String, Object> warnCell(SchedulingArrangeRequest.Cell cell, String reason) {
Map<String, Object> m = new HashMap<>();
m.put("rq", cell.getRq());
m.put("jc", cell.getJc());
m.put("reason", reason);
return m;
}
private void logOperation(SSKC course, String czlx, String cznr, SchedulingArrangeRequest ignored) {
try {
KCJXYX_CZRZ row = new KCJXYX_CZRZ();
row.setBh(UuidUtil.getUUID());
row.setTybh(course.getBh());
row.setCzlx(czlx);
row.setCznr(cznr);
try {
row.setCzrbh(SecurityUtils.getUsername());
} catch (Exception ignore) {
row.setCzrbh("harness");
}
row.setCzsj(LocalDateTime.now());
czrzMapper.insert(row);
} catch (Exception e) {
log.warn("[排课窗] 写排课日志失败: {}", e.getMessage());
}
}
private String resolveCourseName(String kbh) {
if (kbh == null) return "";
var kb = kbMapper.selectById(kbh);
return kb != null && kb.getKmc() != null ? kb.getKmc() : kbh;
}
private static String intDate(Integer d) {
String s = String.valueOf(d);
return s.length() == 8 ? s.substring(0, 4) + "-" + s.substring(4, 6) + "-" + s.substring(6, 8) : s;
}
private List<Integer> parsePeriods(String label) {
List<Integer> out = new ArrayList<>();
if (label == null) return out;
for (String token : label.split("[,,]")) {
String t = token.trim();
if (t.contains("-")) {
String[] parts = t.split("-");
try {
int a = Integer.parseInt(parts[0].trim());
int b = Integer.parseInt(parts[1].trim());
for (int i = Math.min(a, b); i <= Math.max(a, b); i++) out.add(i);
} catch (Exception ignored) { }
} else {
try {
out.add(Integer.parseInt(t));
} catch (Exception ignored) { }
}
}
return out;
}
private static String safe(String s) {
return s == null || s.isEmpty() ? "-" : s;
}
}
@@ -22,6 +22,7 @@ import com.roomroot.jwgl.mapper.XYDBMapper;
import com.roomroot.jwgl.mapper.ZYJXJHBMapper;
import com.roomroot.jwgl.service.StudentTeamTaskService;
import com.roomroot.jwgl.service.TeachingTaskWriteGuard;
import com.roomroot.jwgl.utils.SemesterCodeUtil;
import com.roomroot.jwgl.utils.TeachingTaskStatus;
import com.roomroot.jwgl.utils.UuidUtil;
import com.roomroot.jwgl.vo.PlanCourseVO;
@@ -75,12 +76,16 @@ public class StudentTeamTaskServiceImpl implements StudentTeamTaskService {
private SSKCXYDMapper sskcxydMapper;
@Override
@Transactional(rollbackFor = Exception.class)
public void add(XYDRWB xydrwb) {
if (xydrwb != null) {
teachingTaskWriteGuard.assertCourseTaskWritable(xydrwb.getXydxqbh());
}
xydrwb.setBh(UuidUtil.getUUID());
xydrwb.setDelFlag(0);
// 新增表单允许留空「计划课次序号 / 序号标识 / 编组」等列,这里统一补齐非空约束,
// 否则最小表单直接插入会违反库中的非空约束而报错。
applyRequiredDefaults(xydrwb, nextSequence(xydrwb.getXydxqbh()));
xydrwbMapper.insert(xydrwb);
}
@@ -186,50 +191,41 @@ public class StudentTeamTaskServiceImpl implements StudentTeamTaskService {
@Transactional(rollbackFor = Exception.class)
@Override
public int autoGenerateRequiredCourses(String xydbh, Integer xqdc) {
// 1. 根据学员队编号查询学员队表,获取专业代号
XYDB xydb = xydbMapper.selectById(xydbh);
if (xydb == null || xydb.getZydh() == null) {
public int autoGenerateRequiredCourses(String xydxqbh) {
// 1. 按班次学期主键定位目标学期:它在库里唯一,不会跨学年串写
if (xydxqbh == null || xydxqbh.isEmpty()) {
return 0;
}
String zydh = xydb.getZydh();
// 2. 根据专业代号和学期第次查询专业教学计划表(停用=0)
LambdaQueryWrapper<ZYJXJHB> planWrapper = new LambdaQueryWrapper<>();
planWrapper.eq(ZYJXJHB::getZydh, zydh)
.eq(ZYJXJHB::getXqdc, xqdc)
.eq(ZYJXJHB::getTy, 0);
List<ZYJXJHB> planList = zyjxjhbMapper.selectList(planWrapper);
if (CollectionUtils.isEmpty(planList)) {
return 0;
}
// 3. 根据学员队编号和学期第次查询学员队期表,获取年度和学员队学期编号
LambdaQueryWrapper<XYDNDXQJBXXB> semesterWrapper = new LambdaQueryWrapper<>();
semesterWrapper.eq(XYDNDXQJBXXB::getXydbh, xydbh)
.eq(XYDNDXQJBXXB::getXqdc, xqdc)
.eq(XYDNDXQJBXXB::getDelFlag, 0)
.orderByDesc(XYDNDXQJBXXB::getNd)
.last("LIMIT 1");
XYDNDXQJBXXB semester = classSemesterMapper.selectOne(semesterWrapper);
XYDNDXQJBXXB semester = classSemesterMapper.selectById(xydxqbh);
if (semester == null) {
return 0;
}
Integer nd = semester.getNd();
String xydxqbh = semester.getBh();
String xydbh = semester.getXydbh();
Integer xqdc = semester.getXqdc();
if (xydbh == null || xqdc == null) {
return 0;
}
// 任务表/实施/课程表的「年度」口径是 6 位学期代号(见 SemesterCodeUtil 类注释),
// 不能直接落班次学期的 4 位年份,否则与实施链路、选修课程映射的年度连接全部断裂
Integer nd = SemesterCodeUtil.resolve(semester.getNd(), xqdc);
teachingTaskWriteGuard.assertCourseTaskWritable(xydxqbh);
// 2. 匹配人培:匹配不到时给出明确原因,而不是静默返回 0 被当成「本学期无必修课」
PlanMatch planMatch = matchPlanCourses(xydbh, xqdc);
if (planMatch.problem() != null) {
throw new ServiceException("自动生成必修课程失败:" + planMatch.problem(), BAD_REQUEST);
}
List<ZYJXJHB> planList = planMatch.matched();
if (planList.isEmpty()) {
return 0;
}
// 4. 查询当前班次已存在的课程编号集合
LambdaQueryWrapper<XYDRWB> existWrapper = new LambdaQueryWrapper<>();
existWrapper.eq(XYDRWB::getXydxqbh, xydxqbh)
.eq(XYDRWB::getDelFlag, 0);
List<XYDRWB> existList = xydrwbMapper.selectList(existWrapper);
List<String> existKbhs = existList.stream()
.map(XYDRWB::getKbh)
.filter(kbh -> kbh != null)
.collect(Collectors.toList());
Set<String> existKbhs = currentCourseCodes(xydxqbh);
// 5. 只添加缺少的课程
int seq = nextSequence(xydxqbh);
int count = 0;
for (ZYJXJHB plan : planList) {
if (existKbhs.contains(plan.getKbh())) {
@@ -242,6 +238,8 @@ public class StudentTeamTaskServiceImpl implements StudentTeamTaskService {
newRecord.setXydbh(xydbh);
newRecord.setKbh(plan.getKbh());
newRecord.setXqdc(xqdc);
// 阶段 4:新建任务默认写入班次专用教室作为场地
newRecord.setJsbh(semester.getZyjsbh());
newRecord.setKlx(plan.getKlx());
newRecord.setXs(plan.getXs());
newRecord.setJc(plan.getJc());
@@ -255,14 +253,16 @@ public class StudentTeamTaskServiceImpl implements StudentTeamTaskService {
newRecord.setKsksbxs(plan.getKsksbxs());
newRecord.setJysdh(plan.getJysdh());
newRecord.setXydxqbh(xydxqbh);
newRecord.setJhkcxh(count+1);
newRecord.setXhbs(count+1);
newRecord.setBz2(0);
newRecord.setPdtbykxxbz(1);
newRecord.setPdqyzdyxs(0);
newRecord.setJhkcxh(seq);
newRecord.setXhbs(seq);
newRecord.setDelFlag(0);
// 补齐全表的非空约束列(编组、配当同班异课选修编组、配档启用自定义学时等),
// 一次到位,避免遗漏导致插入时违反非空约束。
applyRequiredDefaults(newRecord, seq);
xydrwbMapper.insert(newRecord);
existKbhs.add(plan.getKbh());
seq++;
count++;
}
return count;
@@ -282,6 +282,7 @@ public class StudentTeamTaskServiceImpl implements StudentTeamTaskService {
source.setXydbh(newXydbh);
source.setDelFlag(0);
teachingTaskWriteGuard.assertCourseTaskWritable(source.getXydxqbh());
applyRequiredDefaults(source, nextSequence(source.getXydxqbh()));
xydrwbMapper.insert(source);
newBhList.add(newBh);
}
@@ -294,17 +295,80 @@ public class StudentTeamTaskServiceImpl implements StudentTeamTaskService {
if (CollectionUtils.isEmpty(xydxqbhList)) {
return 0;
}
int count = 0;
// 先统一预检,任何一个班次匹配不到人培课程都直接报错,
// 避免部分写入后因异常被整体回滚、却又没有留下任何提示。
List<String> problems = new ArrayList<>();
for (String xydxqbh : xydxqbhList) {
XYDNDXQJBXXB semester = classSemesterMapper.selectById(xydxqbh);
if (semester == null || semester.getXydbh() == null || semester.getXqdc() == null) {
problems.add("班次学期 " + xydxqbh + " 不存在或缺少学员队编号/学期第次");
continue;
}
count += autoGenerateRequiredCourses(semester.getXydbh(), semester.getXqdc());
PlanMatch match = matchPlanCourses(semester.getXydbh(), semester.getXqdc());
if (match.problem() != null) {
problems.add(semesterLabel(semester) + ":" + match.problem());
}
}
if (!problems.isEmpty()) {
throw new ServiceException("自动生成必修课程未执行,以下班次无法匹配到人培课程:"
+ String.join(";", problems), BAD_REQUEST);
}
int count = 0;
for (String xydxqbh : xydxqbhList) {
// 直接按班次学期编号生成,避免再按 (学员队, 学期第次) 反查时落到别的学年
count += autoGenerateRequiredCourses(xydxqbh);
}
return count;
}
/** 人培匹配结果:matched 为匹配到的课程;problem 非空表示无法生成的原因。 */
private record PlanMatch(List<ZYJXJHB> matched, String problem) {
static PlanMatch ok(List<ZYJXJHB> list) { return new PlanMatch(list, null); }
static PlanMatch fail(String why) { return new PlanMatch(List.of(), why); }
}
/** 班次学期在报错信息里的可读标签(学员队名称 + 年度/学期第次)。 */
private String semesterLabel(XYDNDXQJBXXB semester) {
XYDB clazz = xydbMapper.selectById(semester.getXydbh());
String name = clazz != null && clazz.getXydmc() != null ? clazz.getXydmc() : semester.getXydbh();
return name + " " + semester.getNd() + " 年度学期第次 " + semester.getXqdc();
}
/**
* 按专业代号 + 学期第次匹配人培(专业教学计划表,停用=0)。
*
* <p>口径说明(经业务确认保留等值匹配):人培的「学期第次」是专业总第几学期
* (1..学期数,学期数 = 学年制 × 2,见专业表);而班次学期的「学期第次」是
* 学年内学期类别(1 春季 / 2 夏季 / 3 秋季,见 ClassSemesterServiceImpl.assertXqdc)。
* 两者口径不同,因此匹配不到时必须把原因讲清楚,不能静默返回 0。</p>
*/
private PlanMatch matchPlanCourses(String xydbh, Integer xqdc) {
XYDB clazz = xydbMapper.selectById(xydbh);
String zydh = clazz == null ? null : clazz.getZydh();
if (zydh == null || zydh.isEmpty()) {
return PlanMatch.fail("学员队 " + xydbh + " 未关联专业");
}
List<ZYJXJHB> allEnabled = zyjxjhbMapper.selectList(new LambdaQueryWrapper<ZYJXJHB>()
.eq(ZYJXJHB::getZydh, zydh)
.eq(ZYJXJHB::getTy, 0));
if (allEnabled.isEmpty()) {
return PlanMatch.fail("专业 " + zydh + " 尚无启用状态的人才培养方案数据");
}
List<ZYJXJHB> matched = new ArrayList<>();
for (ZYJXJHB plan : allEnabled) {
if (xqdc != null && xqdc.equals(plan.getXqdc())) {
matched.add(plan);
}
}
if (matched.isEmpty()) {
return PlanMatch.fail(String.format(
"专业 %s 的人培中没有「学期第次 = %d」的课程(人培的学期第次是专业总第几学期 1..学期数,"
+ "而班次学期的学期第次是学年内学期类别 1 春季 / 2 夏季 / 3 秋季,两者口径不同,"
+ "请核对人培数据或改用「计划内必修添加」手动选取)", zydh, xqdc));
}
return PlanMatch.ok(matched);
}
@Override
public List<PlanCourseVO> listPlanCourses(String xydxqbh, boolean otherOnly) {
XYDNDXQJBXXB semester = requireSemester(xydxqbh);
@@ -350,10 +414,12 @@ public class StudentTeamTaskServiceImpl implements StudentTeamTaskService {
}
XYDRWB row = new XYDRWB();
row.setBh(UuidUtil.getUUID());
row.setNd(semester.getNd());
row.setNd(SemesterCodeUtil.resolve(semester.getNd(), semester.getXqdc()));
row.setXydbh(semester.getXydbh());
row.setXydxqbh(xydxqbh);
row.setXqdc(semester.getXqdc());
// 阶段 4:新建任务默认写入班次专用教室作为场地
row.setJsbh(semester.getZyjsbh());
row.setKbh(course.getKbh());
row.setJc(course.getJc());
row.setXs(course.getXs());
@@ -366,6 +432,7 @@ public class StudentTeamTaskServiceImpl implements StudentTeamTaskService {
row.setKsks(course.getKsks());
row.setJysdh(course.getJysdh());
row.setDelFlag(0);
applyRequiredDefaults(row, nextSequence(xydxqbh));
xydrwbMapper.insert(row);
}
@@ -380,7 +447,9 @@ public class StudentTeamTaskServiceImpl implements StudentTeamTaskService {
if (currentCourseCodes(xydxqbh).contains(plan.getKbh())) {
throw new ServiceException("当前学期已有该课程", CONFLICT);
}
xydrwbMapper.insert(fromPlan(semester, plan));
XYDRWB row = fromPlan(semester, plan);
applyRequiredDefaults(row, nextSequence(xydxqbh));
xydrwbMapper.insert(row);
}
@Transactional(rollbackFor = Exception.class)
@@ -443,6 +512,7 @@ public class StudentTeamTaskServiceImpl implements StudentTeamTaskService {
return 0;
}
int count = 0;
int seq = nextSequence(targetXydxqbh);
for (String bh : bhList) {
XYDRWB source = xydrwbMapper.selectById(bh);
if (source == null) {
@@ -451,10 +521,15 @@ public class StudentTeamTaskServiceImpl implements StudentTeamTaskService {
source.setBh(UuidUtil.getUUID());
source.setXydbh(semester.getXydbh());
source.setXydxqbh(semester.getBh());
source.setNd(semester.getNd());
source.setNd(SemesterCodeUtil.resolve(semester.getNd(), semester.getXqdc()));
source.setXqdc(semester.getXqdc());
source.setDelFlag(0);
// 粘贴到新班次后应排在末尾,不复用源班的课次序号,避免与目标班次已有行重号
source.setJhkcxh(seq);
source.setXhbs(seq);
applyRequiredDefaults(source, seq);
xydrwbMapper.insert(source);
seq++;
count++;
}
return count;
@@ -463,10 +538,12 @@ public class StudentTeamTaskServiceImpl implements StudentTeamTaskService {
private XYDRWB fromPlan(XYDNDXQJBXXB semester, ZYJXJHB plan) {
XYDRWB row = new XYDRWB();
row.setBh(UuidUtil.getUUID());
row.setNd(semester.getNd());
row.setNd(SemesterCodeUtil.resolve(semester.getNd(), semester.getXqdc()));
row.setXydbh(semester.getXydbh());
row.setXydxqbh(semester.getBh());
row.setXqdc(semester.getXqdc());
// 阶段 4:新建任务默认写入班次专用教室作为场地
row.setJsbh(semester.getZyjsbh());
row.setKbh(plan.getKbh());
row.setKlx(plan.getKlx());
row.setXs(plan.getXs());
@@ -540,6 +617,65 @@ public class StudentTeamTaskServiceImpl implements StudentTeamTaskService {
.collect(Collectors.toCollection(HashSet::new));
}
/**
* 补齐学员队任务表里「非空且无库默认值」的列。
* <p>
* 这些列漏填时插入会直接违反非空约束:计划课次序号、序号标识、编组、
* 配当同班异课选修编组、配档启用自定义学时、学时、课类型、教研室代号。
* 其余非空列在库里有默认值,交给库处理。
*/
private void applyRequiredDefaults(XYDRWB row, Integer sequence) {
if (row == null) {
return;
}
if (row.getJhkcxh() == null) {
row.setJhkcxh(sequence == null ? 1 : sequence);
}
if (row.getXhbs() == null) {
row.setXhbs(row.getJhkcxh());
}
if (row.getBz2() == null) {
row.setBz2(0);
}
if (row.getPdtbykxxbz() == null) {
row.setPdtbykxxbz(1);
}
if (row.getPdqyzdyxs() == null) {
row.setPdqyzdyxs(0);
}
if (row.getXs() == null) {
row.setXs(0);
}
if (row.getKlx() == null) {
row.setKlx("");
}
if (row.getJysdh() == null) {
row.setJysdh("");
}
}
/**
* 取该班次学期下一个可用的课次序号。计划课次序号与序号标识都要非空,故取两者较大值 +1。
*/
private int nextSequence(String xydxqbh) {
if (xydxqbh == null || xydxqbh.isEmpty()) {
return 1;
}
int max = 0;
List<XYDRWB> rows = xydrwbMapper.selectList(new LambdaQueryWrapper<XYDRWB>()
.eq(XYDRWB::getXydxqbh, xydxqbh)
.eq(XYDRWB::getDelFlag, 0));
for (XYDRWB r : rows) {
if (r.getJhkcxh() != null && r.getJhkcxh() > max) {
max = r.getJhkcxh();
}
if (r.getXhbs() != null && r.getXhbs() > max) {
max = r.getXhbs();
}
}
return max + 1;
}
private XYDNDXQJBXXB requireSemester(String xydxqbh) {
XYDNDXQJBXXB semester = classSemesterMapper.selectById(xydxqbh);
if (semester == null) {
@@ -0,0 +1,378 @@
package com.roomroot.jwgl.service.impl;
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.roomroot.common.exception.ServiceException;
import com.roomroot.jwgl.dto.taskbook.TaskBookBhListRequest;
import com.roomroot.jwgl.dto.taskbook.TaskBookFillRequest;
import com.roomroot.jwgl.dto.taskbook.TaskBookRoomRequest;
import com.roomroot.jwgl.dto.taskbook.TaskBookTeacherRequest;
import com.roomroot.jwgl.entity.JYB;
import com.roomroot.jwgl.entity.JXRW;
import com.roomroot.jwgl.entity.XYDNDXQJBXXB;
import com.roomroot.jwgl.entity.XYDRWB;
import com.roomroot.jwgl.mapper.ClassSemesterMapper;
import com.roomroot.jwgl.mapper.JYBMapper;
import com.roomroot.jwgl.mapper.StudentTeamTaskMapper;
import com.roomroot.jwgl.mapper.TeachingTaskMapper;
import com.roomroot.jwgl.service.TaskBookFillService;
import com.roomroot.jwgl.service.TeachingTaskWriteGuard;
import com.roomroot.jwgl.utils.SemesterCodeUtil;
import com.roomroot.jwgl.utils.TeachingTaskStatus;
import com.roomroot.jwgl.vo.taskbook.TaskBookRowVO;
import jakarta.annotation.Resource;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import java.time.LocalDateTime;
import java.util.ArrayList;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.Objects;
import static com.roomroot.jwgl.utils.BasicManagementConstants.BAD_REQUEST;
import static com.roomroot.jwgl.utils.BasicManagementConstants.CONFLICT;
import static com.roomroot.jwgl.utils.BasicManagementConstants.NOT_FOUND;
/**
* 教研室任务书填报实现(阶段 4)。
*/
@Service
public class TaskBookFillServiceImpl implements TaskBookFillService {
@Resource
private StudentTeamTaskMapper taskMapper;
@Resource
private ClassSemesterMapper classSemesterMapper;
@Resource
private TeachingTaskMapper jxrwMapper;
@Resource
private JYBMapper jybMapper;
@Resource
private TeachingTaskWriteGuard guard;
// ==================== 列表 ====================
@Override
public List<TaskBookRowVO> list(String jxrwbh) {
if (jxrwbh == null || jxrwbh.isEmpty()) {
throw new ServiceException("请指定教学任务", BAD_REQUEST);
}
JXRW jxrw = jxrwMapper.selectById(jxrwbh);
if (jxrw == null || Integer.valueOf(1).equals(jxrw.getDelFlag())) {
throw new ServiceException("教学任务不存在:" + jxrwbh, NOT_FOUND);
}
List<TaskBookRowVO> rows = jxrwMapper.selectTaskBookRows(jxrwbh);
boolean frozen = isFrozen(jxrw);
rows.forEach(r -> r.setFrozen(frozen));
return rows;
}
/** 填报门禁:仅「已发布且未结束」的教学任务可填报,其余只读 */
private boolean isFrozen(JXRW jxrw) {
return !TeachingTaskStatus.isPublished(jxrw.getZt()) || TeachingTaskStatus.isEnded(jxrw.getZt());
}
// ==================== 合班 / 拆班 ====================
@Transactional(rollbackFor = Exception.class)
@Override
public Integer merge(TaskBookBhListRequest request) {
List<XYDRWB> rows = loadRows(request);
assertAllFillable(rows);
assertSameXq(rows);
assertMergeCompatible(rows);
int groupNo = nextGroupNo();
LocalDateTime now = LocalDateTime.now();
for (XYDRWB row : rows) {
row.setBz2(groupNo);
row.setBdsj(now);
taskMapper.updateById(row);
}
return groupNo;
}
/** 合班只允许同一学期(6 位学期代号相同):跨学期合班没有业务意义 */
private void assertSameXq(List<XYDRWB> rows) {
Integer first = xqCodeOf(rows.get(0));
for (XYDRWB row : rows) {
if (!Objects.equals(xqCodeOf(row), first)) {
throw new ServiceException("任务 " + row.getBh() + "(" + row.getXydbh() + ")与第一行不在同一学期,不能合班",
BAD_REQUEST);
}
}
}
private Integer xqCodeOf(XYDRWB row) {
XYDNDXQJBXXB semester = requireSemester(row.getXydxqbh());
return SemesterCodeUtil.resolve(semester.getNd(), semester.getXqdc());
}
/** 手动合班校验:科目、学时、课类型、成绩分制必须相同 */
private void assertMergeCompatible(List<XYDRWB> rows) {
XYDRWB first = rows.get(0);
for (XYDRWB row : rows) {
List<String> diff = new ArrayList<>();
if (!Objects.equals(row.getKbh(), first.getKbh())) {
diff.add("科目(" + row.getKbh() + " ≠ " + first.getKbh() + ")");
}
if (!Objects.equals(row.getXs(), first.getXs())) {
diff.add("学时(" + row.getXs() + " ≠ " + first.getXs() + ")");
}
if (!Objects.equals(row.getKlx(), first.getKlx())) {
diff.add("课类型(" + row.getKlx() + " ≠ " + first.getKlx() + ")");
}
if (!Objects.equals(norm(row.getCjfz()), norm(first.getCjfz()))) {
diff.add("成绩分制(" + row.getCjfz() + " ≠ " + first.getCjfz() + ")");
}
if (!diff.isEmpty()) {
throw new ServiceException("任务 " + row.getBh() + "(" + row.getXydbh() + ")与第一行不合班:" + String.join("、", diff),
BAD_REQUEST);
}
}
}
private static String norm(String s) {
return s == null || s.isEmpty() ? "" : s.trim();
}
private int nextGroupNo() {
int max = 0;
for (Integer bz2 : taskMapper.selectList(new LambdaQueryWrapper<XYDRWB>()
.isNotNull(XYDRWB::getBz2)).stream().map(XYDRWB::getBz2).toList()) {
if (bz2 != null && bz2 > max) {
max = bz2;
}
}
return max + 1;
}
@Transactional(rollbackFor = Exception.class)
@Override
public List<Map<String, Object>> mergeByPreset(TaskBookBhListRequest request) {
List<XYDRWB> rows = loadRows(request);
assertAllFillable(rows);
assertSameXq(rows);
// 行按 课程科目(kbh) → 预设编班号(ysbbh,空则各班次学期独立) 分组
Map<String, List<XYDRWB>> groups = new LinkedHashMap<>();
for (XYDRWB row : rows) {
XYDNDXQJBXXB semester = requireSemester(row.getXydxqbh());
Integer ysbbh = semester.getYsbbh();
String key = row.getKbh() + "|" + (ysbbh == null ? "row:" + row.getXydxqbh() : ysbbh);
groups.computeIfAbsent(key, k -> new ArrayList<>()).add(row);
}
LocalDateTime now = LocalDateTime.now();
int groupNo = nextGroupNo();
List<Map<String, Object>> result = new ArrayList<>();
for (Map.Entry<String, List<XYDRWB>> entry : groups.entrySet()) {
List<XYDRWB> group = entry.getValue();
for (XYDRWB row : group) {
row.setBz2(groupNo);
row.setBdsj(now);
taskMapper.updateById(row);
}
Map<String, Object> item = new LinkedHashMap<>();
item.put("groupNo", groupNo);
item.put("kbh", group.get(0).getKbh());
item.put("ysbbh", requireSemester(group.get(0).getXydxqbh()).getYsbbh());
item.put("count", group.size());
result.add(item);
groupNo++;
}
return result;
}
@Transactional(rollbackFor = Exception.class)
@Override
public int split(TaskBookBhListRequest request) {
List<XYDRWB> rows = loadRows(request);
assertAllFillable(rows);
// TODO(阶段 5):行已发布到运行课表的须先撤回,再拆班。阶段 5 落地后在此校验。
LocalDateTime now = LocalDateTime.now();
int count = 0;
for (XYDRWB row : rows) {
if (row.getBz2() != null && row.getBz2() != 0) {
row.setBz2(0);
row.setBdsj(now);
taskMapper.updateById(row);
count++;
}
}
return count;
}
// ==================== 责任教员 / 场地 / 填报 ====================
@Transactional(rollbackFor = Exception.class)
@Override
public int setTeacher(TaskBookTeacherRequest request) {
if (request == null || request.getBh() == null || request.getBh().isEmpty()) {
throw new ServiceException("请指定课程任务", BAD_REQUEST);
}
XYDRWB row = requireRow(request.getBh());
assertFillable(row);
String mode = request.getMode() == null ? "" : request.getMode();
String jybh;
if ("plan".equalsIgnoreCase(mode)) {
// 应用教研室计划教员:jybh ← 该行 jysjhjybh
jybh = row.getJysjhjybh();
if (jybh == null || jybh.isEmpty()) {
throw new ServiceException("该行没有教研室计划教员,请先在填报字段中指定", BAD_REQUEST);
}
} else if ("unit".equalsIgnoreCase(mode) || "academy".equalsIgnoreCase(mode)) {
jybh = request.getJybh();
if (jybh == null || jybh.isEmpty()) {
throw new ServiceException("请选择教员", BAD_REQUEST);
}
JYB teacher = jybMapper.selectById(jybh);
if (teacher == null) {
throw new ServiceException("教员不存在:" + jybh, NOT_FOUND);
}
if ("unit".equalsIgnoreCase(mode)) {
if (row.getJysdh() == null || row.getJysdh().isEmpty()) {
throw new ServiceException("该行没有归属教研室,无法按责任单位指定", BAD_REQUEST);
}
if (!row.getJysdh().equals(teacher.getJysdh())) {
throw new ServiceException("教员 " + teacher.getJyxm() + " 不属于该行教研室,不能按责任单位指定", BAD_REQUEST);
}
}
} else {
throw new ServiceException("指定方式只支持 unit / academy / plan", BAD_REQUEST);
}
return updateGroupField(row, "jybh", jybh);
}
@Transactional(rollbackFor = Exception.class)
@Override
public int setRoom(TaskBookRoomRequest request) {
if (request == null || request.getBh() == null || request.getBh().isEmpty()) {
throw new ServiceException("请指定课程任务", BAD_REQUEST);
}
XYDRWB row = requireRow(request.getBh());
assertFillable(row);
String jsbh;
if (Boolean.TRUE.equals(request.getUseSpecial())) {
XYDNDXQJBXXB semester = requireSemester(row.getXydxqbh());
jsbh = semester.getZyjsbh();
if (jsbh == null || jsbh.isEmpty()) {
throw new ServiceException("该班次学期没有专用教室,请改选其它教室", BAD_REQUEST);
}
} else {
jsbh = request.getJsbh();
if (jsbh == null || jsbh.isEmpty()) {
throw new ServiceException("请选择教室,或选择使用班次专用教室", BAD_REQUEST);
}
}
return updateGroupField(row, "jsbh", jsbh);
}
@Transactional(rollbackFor = Exception.class)
@Override
public int fill(TaskBookFillRequest request) {
if (request == null || request.getBh() == null || request.getBh().isEmpty()) {
throw new ServiceException("请指定课程任务", BAD_REQUEST);
}
XYDRWB row = requireRow(request.getBh());
assertFillable(row);
LocalDateTime now = LocalDateTime.now();
int count;
if (request.getJysjhjybh() != null) {
row.setJysjhjybh(request.getJysjhjybh());
}
if (request.getJysjhbz() != null) {
row.setJysjhbz(request.getJysjhbz());
}
row.setBdsj(now);
taskMapper.updateById(row);
count = 1;
// 场地按合班组同步
if (request.getJsbh() != null) {
count = updateGroupField(row, "jsbh", request.getJsbh());
}
return count;
}
/**
* 同合班组联动更新:行编组非 0 时,同编组全部行(全局组号唯一)同步该字段;
* 编组为 0(未合班)只改本行。
*/
private int updateGroupField(XYDRWB row, String field, String value) {
List<XYDRWB> targets;
if (row.getBz2() != null && row.getBz2() != 0) {
targets = taskMapper.selectList(new LambdaQueryWrapper<XYDRWB>()
.eq(XYDRWB::getBz2, row.getBz2())
.eq(XYDRWB::getDelFlag, 0));
} else {
targets = List.of(row);
}
LocalDateTime now = LocalDateTime.now();
for (XYDRWB target : targets) {
if ("jybh".equals(field)) {
target.setJybh(value);
} else if ("jsbh".equals(field)) {
target.setJsbh(value);
} else {
throw new ServiceException("不支持同步字段:" + field, BAD_REQUEST);
}
target.setBdsj(now);
taskMapper.updateById(target);
}
return targets.size();
}
// ==================== 公共 ====================
private List<XYDRWB> loadRows(TaskBookBhListRequest request) {
if (request == null || request.getBhList() == null || request.getBhList().isEmpty()) {
throw new ServiceException("请先选择课程任务行", BAD_REQUEST);
}
List<XYDRWB> rows = new ArrayList<>();
for (String bh : request.getBhList()) {
rows.add(requireRow(bh));
}
return rows;
}
private XYDRWB requireRow(String bh) {
XYDRWB row = taskMapper.selectById(bh);
if (row == null || Integer.valueOf(1).equals(row.getDelFlag())) {
throw new ServiceException("课程任务不存在:" + bh, NOT_FOUND);
}
return row;
}
private XYDNDXQJBXXB requireSemester(String xydxqbh) {
XYDNDXQJBXXB semester = classSemesterMapper.selectById(xydxqbh);
if (semester == null) {
throw new ServiceException("班次学期不存在:" + xydxqbh, NOT_FOUND);
}
return semester;
}
/** 填报门禁:仅「已发布且未结束」的教学任务可填报 */
private void assertFillable(XYDRWB row) {
XYDNDXQJBXXB semester = requireSemester(row.getXydxqbh());
JXRW jxrw = semester.getJxrwbh() == null || semester.getJxrwbh().isEmpty()
? null : jxrwMapper.selectById(semester.getJxrwbh());
if (jxrw == null || Integer.valueOf(1).equals(jxrw.getDelFlag())) {
throw new ServiceException("该行所属教学任务不存在,不能填报", BAD_REQUEST);
}
if (TeachingTaskStatus.isEnded(jxrw.getZt())) {
throw new ServiceException("教学任务已结束,不能再修改任务书或课程任务", CONFLICT);
}
if (!TeachingTaskStatus.isPublished(jxrw.getZt())) {
throw new ServiceException("教学任务尚未发布,不能填报", BAD_REQUEST);
}
guard.assertTaskWritable(semester.getJxrwbh());
}
private void assertAllFillable(List<XYDRWB> rows) {
for (XYDRWB row : rows) {
assertFillable(row);
}
}
}
@@ -0,0 +1,655 @@
package com.roomroot.jwgl.service.impl;
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.roomroot.common.exception.ServiceException;
import com.roomroot.jwgl.dto.allocation.AllocationGroupRequest;
import com.roomroot.jwgl.dto.allocation.AllocationSaveItem;
import com.roomroot.jwgl.entity.JQB;
import com.roomroot.jwgl.entity.KB;
import com.roomroot.jwgl.entity.XQXLB;
import com.roomroot.jwgl.entity.XYDB;
import com.roomroot.jwgl.entity.XYDNDXQJBXXB;
import com.roomroot.jwgl.entity.XYDRWB;
import com.roomroot.jwgl.mapper.JQBMapper;
import com.roomroot.jwgl.mapper.KBMapper;
import com.roomroot.jwgl.mapper.SemesterCalendarMapper;
import com.roomroot.jwgl.mapper.StudentTeamTaskMapper;
import com.roomroot.jwgl.mapper.XYDBMapper;
import com.roomroot.jwgl.service.TeachingAllocationService;
import com.roomroot.jwgl.service.TeachingTaskWriteGuard;
import com.roomroot.jwgl.mapper.ClassSemesterMapper;
import com.roomroot.jwgl.utils.ExcelExportUtil;
import com.roomroot.jwgl.utils.SemesterCodeUtil;
import com.roomroot.jwgl.vo.allocation.AllocationTaskVO;
import com.roomroot.jwgl.vo.allocation.AllocationViewVO;
import com.roomroot.jwgl.vo.allocation.AllocationWeekVO;
import jakarta.annotation.Resource;
import jakarta.servlet.http.HttpServletResponse;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import java.time.DayOfWeek;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.util.ArrayList;
import java.util.Comparator;
import java.util.HashMap;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.Objects;
import static com.roomroot.jwgl.utils.BasicManagementConstants.BAD_REQUEST;
import static com.roomroot.jwgl.utils.BasicManagementConstants.NOT_FOUND;
/**
* 教学配当 Service 实现。
*
* <p>口径约定(详见各方法注释):
* <ul>
* <li>「是否连排课」不新增列,用已有 配档按周 pdaz:0=连排(单科独进)、1=按周(非连排);
* 周课时 ≥ 20 默认 0,否则默认 1。</li>
* <li>「每周可排正课」= 该周 可排课=1 且 正课=1 的格数 × 2 学时;
* 数据源优先级 班历 &gt; 校历 &gt; 默认(15 格 = 30 学时)。</li>
* <li>铺学时只是粗约束建议:非连排各自成组按起始周+优选序数独立铺;
* 连排课合成一组串行铺且优先级低于非连排;不写实施课程表。</li>
* <li>「保存整个编组」限定 同科目+同配档编组+同学期代号(6 位),防止跨学期串改。</li>
* </ul></p>
*/
@Service
public class TeachingAllocationServiceImpl implements TeachingAllocationService {
/** 双节次一格按 2 学时计 */
private static final int HOURS_PER_CELL = 2;
/** 班历/校历都没有时的默认每周可排正课:周一~五 1-2/3-4/5-6 共 15 格 */
private static final int DEFAULT_WEEKLY_MAIN_CELLS = 15;
/** 周课时达到该值默认按连排(配档按周=0) */
private static final int CONTINUOUS_ZKS_THRESHOLD = 20;
/** 默认每周学时 */
private static final int DEFAULT_WEEKLY_HOURS = DEFAULT_WEEKLY_MAIN_CELLS * HOURS_PER_CELL;
@Resource
private StudentTeamTaskMapper xydrwbMapper;
@Resource
private ClassSemesterMapper classSemesterMapper;
@Resource
private XYDBMapper xydbMapper;
@Resource
private JQBMapper jqbMapper;
@Resource
private SemesterCalendarMapper semesterCalendarMapper;
@Resource
private KBMapper kbMapper;
@Resource
private TeachingTaskWriteGuard teachingTaskWriteGuard;
// ==================== 视图 ====================
@Override
public AllocationViewVO view(String xydxqbh) {
XYDNDXQJBXXB semester = requireSemester(xydxqbh);
XYDB clazz = xydbMapper.selectById(semester.getXydbh());
AllocationViewVO vo = new AllocationViewVO();
vo.setXydxqbh(xydxqbh);
vo.setXydbh(semester.getXydbh());
vo.setXydmc(clazz != null ? clazz.getXydmc() : semester.getXydbh());
vo.setNdCode(SemesterCodeUtil.resolve(semester.getNd(), semester.getXqdc()));
vo.setKxrq(semester.getKxrq());
vo.setJsrq(semester.getJsrq());
vo.setFrozen(isFrozen(xydxqbh));
List<AllocationWeekVO> weeks = buildWeeks(semester);
vo.setWeeks(weeks);
vo.setTotalWeeks(weeks.size());
List<XYDRWB> tasks = listTasks(xydxqbh);
Map<String, AllocationTaskVO> voMap = new LinkedHashMap<>();
for (XYDRWB task : tasks) {
voMap.put(task.getBh(), toVO(task));
}
allocate(weeks, tasks, voMap);
vo.setTasks(new ArrayList<>(voMap.values()));
return vo;
}
private boolean isFrozen(String xydxqbh) {
try {
teachingTaskWriteGuard.assertCourseTaskWritable(xydxqbh);
return false;
} catch (Exception e) {
return true;
}
}
private List<XYDRWB> listTasks(String xydxqbh) {
List<XYDRWB> tasks = xydrwbMapper.selectList(new LambdaQueryWrapper<XYDRWB>()
.eq(XYDRWB::getXydxqbh, xydxqbh)
.eq(XYDRWB::getDelFlag, 0));
for (XYDRWB task : tasks) {
// 连排缺省:周课时 >= 20 默认连排(配档按周=0),否则按周
if (task.getPdaz() == null) {
task.setPdaz(defaultPdaz(task.getZks()));
}
if (task.getPdbz() == null) {
task.setPdbz(0);
}
}
tasks.sort(Comparator
.comparing((XYDRWB t) -> t.getPdxh() == null ? Integer.MAX_VALUE : t.getPdxh())
.thenComparing(XYDRWB::getBh));
return tasks;
}
private int defaultPdaz(Integer zks) {
return zks != null && zks >= CONTINUOUS_ZKS_THRESHOLD ? 0 : 1;
}
private AllocationTaskVO toVO(XYDRWB task) {
AllocationTaskVO vo = new AllocationTaskVO();
vo.setBh(task.getBh());
vo.setKbh(task.getKbh());
vo.setKcmc(resolveCourseName(task));
vo.setKlx(task.getKlx());
vo.setXs(task.getXs());
vo.setZks(task.getZks());
vo.setPdxh(task.getPdxh());
vo.setPdqsz(task.getPdqsz());
vo.setPdaz(task.getPdaz());
vo.setPdzzksj(task.getPdzzksj());
vo.setPdbz(task.getPdbz());
vo.setJysdh(task.getJysdh());
return vo;
}
private String resolveCourseName(XYDRWB task) {
if (task.getJc() != null && !task.getJc().isEmpty()) {
return task.getJc();
}
if (task.getKbh() == null) {
return "";
}
KB kb = kbMapper.selectById(task.getKbh());
return kb != null && kb.getKmc() != null ? kb.getKmc() : task.getKbh();
}
// ==================== 周轴与每周可排正课 ====================
/**
* 学期起止按周切分(周一为周界,覆盖 [开学日期, 结束日期]),并统计每周可排正课。
*/
private List<AllocationWeekVO> buildWeeks(XYDNDXQJBXXB semester) {
LocalDate kxrq = semester.getKxrq();
LocalDate jsrq = semester.getJsrq();
if (kxrq == null || jsrq == null) {
throw new ServiceException("班次学期缺少开学/结束日期,无法生成配当周轴", BAD_REQUEST);
}
boolean hasClassCalendar = jqbMapper.selectCount(new LambdaQueryWrapper<JQB>()
.eq(JQB::getXydxqbh, semester.getBh())) > 0;
Integer schoolNd = SemesterCodeUtil.resolve(semester.getNd(), semester.getXqdc());
List<AllocationWeekVO> weeks = new ArrayList<>();
LocalDate weekStart = kxrq.with(DayOfWeek.MONDAY);
int weekNo = 1;
while (!weekStart.isAfter(jsrq)) {
LocalDate weekEnd = weekStart.plusDays(6);
AllocationWeekVO week = new AllocationWeekVO();
week.setWeekNo(weekNo);
week.setStartDate(weekStart);
week.setEndDate(weekEnd.isAfter(jsrq) ? jsrq : weekEnd);
int hours;
String source;
if (hasClassCalendar) {
hours = countClassMainHours(semester.getBh(), weekStart, weekEnd) * HOURS_PER_CELL;
source = "class";
if (hours <= 0) {
// 班历未覆盖该周时按默认容量兜底,避免连排计算被卡死
hours = DEFAULT_WEEKLY_HOURS;
source = "default";
}
} else {
int cells = countSchoolMainCells(schoolNd, weekStart, weekEnd);
if (cells > 0) {
hours = cells * HOURS_PER_CELL;
source = "school";
} else {
hours = DEFAULT_WEEKLY_HOURS;
source = "default";
}
}
week.setAvailableHours(hours);
week.setSource(source);
weeks.add(week);
weekNo++;
weekStart = weekStart.plusDays(7);
}
return weeks;
}
/** 班历:该周 可排课=1 且 正课=1 的格数 */
private int countClassMainHours(String xydxqbh, LocalDate start, LocalDate end) {
List<JQB> rows = jqbMapper.selectList(new LambdaQueryWrapper<JQB>()
.eq(JQB::getXydxqbh, xydxqbh)
.ge(JQB::getJqsj, toIntDay(start))
.le(JQB::getJqsj, toIntDay(end)));
return (int) rows.stream()
.filter(r -> Integer.valueOf(1).equals(r.getKpk()) && Integer.valueOf(1).equals(r.getZk()))
.count();
}
/** 校历:该周 可排课=1 且 正课=1 的格数 */
private int countSchoolMainCells(Integer schoolNd, LocalDate start, LocalDate end) {
if (schoolNd == null) {
return 0;
}
List<XQXLB> rows = semesterCalendarMapper.selectList(new LambdaQueryWrapper<XQXLB>()
.eq(XQXLB::getNd, schoolNd)
.ge(XQXLB::getJqsj, start.toString())
.le(XQXLB::getJqsj, end.toString()));
return (int) rows.stream()
.filter(r -> Boolean.TRUE.equals(r.getKpk()) && Boolean.TRUE.equals(r.getZk()))
.count();
}
private static Integer toIntDay(LocalDate day) {
return Integer.valueOf(day.toString().replace("-", ""));
}
// ==================== 铺学时 ====================
/**
* 铺学时(粗约束建议,不落库):
* 非连排(pdaz=1)各自成组,从配档起始周起每周铺周课时,按优选序数排序依次铺;
* 连排(pdaz=0)合成一组串行铺(单科独进,每周占满剩余容量),优先级低于非连排。
*/
private void allocate(List<AllocationWeekVO> weeks, List<XYDRWB> tasks, Map<String, AllocationTaskVO> voMap) {
int totalWeeks = weeks.size();
int[] capacity = new int[Math.max(totalWeeks, 1)];
for (int i = 0; i < totalWeeks; i++) {
capacity[i] = weeks.get(i).getAvailableHours() == null ? 0 : weeks.get(i).getAvailableHours();
}
Map<Integer, Integer> continuousUsed = new HashMap<>();
List<XYDRWB> nonContinuous = new ArrayList<>();
List<XYDRWB> continuous = new ArrayList<>();
for (XYDRWB task : tasks) {
(Integer.valueOf(0).equals(task.getPdaz()) ? continuous : nonContinuous).add(task);
}
nonContinuous.sort(Comparator
.comparing((XYDRWB t) -> t.getPdqsz() == null ? 1 : t.getPdqsz())
.thenComparing(t -> t.getPdxh() == null ? Integer.MAX_VALUE : t.getPdxh())
.thenComparing(XYDRWB::getBh));
continuous.sort(Comparator
.comparing((XYDRWB t) -> t.getPdxh() == null ? Integer.MAX_VALUE : t.getPdxh())
.thenComparing(t -> t.getPdqsz() == null ? 1 : t.getPdqsz())
.thenComparing(XYDRWB::getBh));
for (XYDRWB task : nonContinuous) {
fillByWeek(voMap.get(task.getBh()), task, capacity, totalWeeks, null);
}
int cursor = 1;
for (XYDRWB task : continuous) {
cursor = fillContinuous(voMap.get(task.getBh()), task, capacity, totalWeeks, continuousUsed, cursor);
}
}
/** 非连排:各自独立铺,不与其它任务抢容量(粗约束) */
private void fillByWeek(AllocationTaskVO vo, XYDRWB task, int[] capacity, int totalWeeks, Map<Integer, Integer> used) {
if (vo == null) {
return;
}
int zks = task.getZks() != null && task.getZks() > 0 ? task.getZks() : 2;
int remaining = task.getXs() != null ? task.getXs() : 0;
int week = task.getPdqsz() != null && task.getPdqsz() > 0 ? task.getPdqsz() : 1;
while (remaining > 0 && week <= totalWeeks) {
int hours = Math.min(remaining, zks);
vo.getDistribution().add(new AllocationTaskVO.WeekHours(week, hours));
if (used != null) {
used.merge(week, hours, Integer::sum);
}
remaining -= hours;
week++;
}
finish(vo, remaining, totalWeeks);
}
/** 连排:串行铺,每周占满剩余容量(单科独进),组内不重叠 */
private int fillContinuous(AllocationTaskVO vo, XYDRWB task, int[] capacity, int totalWeeks,
Map<Integer, Integer> used, int cursor) {
if (vo == null) {
return cursor;
}
int remaining = task.getXs() != null ? task.getXs() : 0;
int week = Math.max(cursor, task.getPdqsz() != null && task.getPdqsz() > 0 ? task.getPdqsz() : 1);
while (remaining > 0 && week <= totalWeeks) {
int left = capacity[week - 1] - used.getOrDefault(week, 0);
if (left <= 0) {
week++;
continue;
}
int hours = Math.min(remaining, left);
vo.getDistribution().add(new AllocationTaskVO.WeekHours(week, hours));
used.merge(week, hours, Integer::sum);
remaining -= hours;
week++;
}
finish(vo, remaining, totalWeeks);
return Math.max(cursor, vo.getEndWeek() == null ? cursor : vo.getEndWeek());
}
private void finish(AllocationTaskVO vo, int overflow, int totalWeeks) {
List<AllocationTaskVO.WeekHours> dist = vo.getDistribution();
if (!dist.isEmpty()) {
vo.setStartWeek(dist.get(0).getWeek());
vo.setEndWeek(dist.get(dist.size() - 1).getWeek());
}
if (overflow > 0) {
vo.setOverflowHours(overflow);
}
}
// ==================== 保存 / 排序 / 编组 ====================
@Transactional(rollbackFor = Exception.class)
@Override
public int save(List<AllocationSaveItem> items) {
if (items == null || items.isEmpty()) {
throw new ServiceException("请先选择要保存的配当行", BAD_REQUEST);
}
int count = 0;
for (AllocationSaveItem item : items) {
count += saveOne(item);
}
return count;
}
private int saveOne(AllocationSaveItem item) {
if (item == null || item.getBh() == null || item.getBh().isEmpty()) {
throw new ServiceException("保存项缺少任务编号", BAD_REQUEST);
}
validate(item);
XYDRWB task = xydrwbMapper.selectById(item.getBh());
if (task == null || Integer.valueOf(1).equals(task.getDelFlag())) {
throw new ServiceException("课程任务不存在:" + item.getBh(), NOT_FOUND);
}
teachingTaskWriteGuard.assertCourseTaskWritable(task.getXydxqbh());
List<XYDRWB> targets;
if (Boolean.TRUE.equals(item.getSaveGroup())) {
Integer pdbz = task.getPdbz() == null ? 0 : task.getPdbz();
// 同科目 + 同配档编组 + 同学期代号:同开同结;限定学期代号防止跨学期串改
targets = xydrwbMapper.selectList(new LambdaQueryWrapper<XYDRWB>()
.eq(XYDRWB::getKbh, task.getKbh())
.eq(XYDRWB::getPdbz, pdbz)
.eq(XYDRWB::getNd, task.getNd())
.eq(XYDRWB::getDelFlag, 0));
} else {
targets = List.of(task);
}
LocalDateTime now = LocalDateTime.now();
for (XYDRWB t : targets) {
if (item.getPdxh() != null) {
t.setPdxh(item.getPdxh());
}
if (item.getPdqsz() != null) {
t.setPdqsz(item.getPdqsz());
}
if (item.getPdaz() != null) {
t.setPdaz(item.getPdaz());
}
if (item.getPdzzksj() != null) {
t.setPdzzksj(item.getPdzzksj());
}
if (item.getPdbz() != null) {
t.setPdbz(item.getPdbz());
}
t.setBdsj(now);
xydrwbMapper.updateById(t);
}
return targets.size();
}
private void validate(AllocationSaveItem item) {
if (item.getPdxh() != null && item.getPdxh() < 1) {
throw new ServiceException("配档序号必须 ≥ 1", BAD_REQUEST);
}
if (item.getPdqsz() != null && item.getPdqsz() < 1) {
throw new ServiceException("配档起始周必须 ≥ 1", BAD_REQUEST);
}
if (item.getPdaz() != null && item.getPdaz() != 0 && item.getPdaz() != 1) {
throw new ServiceException("配档按周只能为 0(连排)或 1(按周)", BAD_REQUEST);
}
if (item.getPdzzksj() != null && item.getPdzzksj() != 0 && item.getPdzzksj() != 1) {
throw new ServiceException("配档占正课时间只能为 0 或 1", BAD_REQUEST);
}
if (item.getPdbz() != null && item.getPdbz() < 0) {
throw new ServiceException("配档编组必须 ≥ 0", BAD_REQUEST);
}
}
@Transactional(rollbackFor = Exception.class)
@Override
public List<String> move(String xydxqbh, String bh, String direction) {
teachingTaskWriteGuard.assertCourseTaskWritable(xydxqbh);
boolean up = "up".equalsIgnoreCase(direction);
if (!up && !"down".equalsIgnoreCase(direction)) {
throw new ServiceException("方向只支持 up / down", BAD_REQUEST);
}
List<XYDRWB> tasks = listTasks(xydxqbh);
if (tasks.isEmpty()) {
throw new ServiceException("该班次学期没有课程任务", NOT_FOUND);
}
// 归一化优选序数 1..n(与展示顺序一致)
LocalDateTime now = LocalDateTime.now();
int idx = -1;
for (int i = 0; i < tasks.size(); i++) {
XYDRWB t = tasks.get(i);
if (!Objects.equals(t.getPdxh(), i + 1)) {
t.setPdxh(i + 1);
t.setBdsj(now);
xydrwbMapper.updateById(t);
}
if (t.getBh().equals(bh)) {
idx = i;
}
}
if (idx < 0) {
throw new ServiceException("课程任务不属于该班次学期:" + bh, NOT_FOUND);
}
int other = up ? idx - 1 : idx + 1;
if (other < 0) {
throw new ServiceException("已经是最前面了", BAD_REQUEST);
}
if (other >= tasks.size()) {
throw new ServiceException("已经是最后面了", BAD_REQUEST);
}
XYDRWB a = tasks.get(idx);
XYDRWB b = tasks.get(other);
Integer tmp = a.getPdxh();
a.setPdxh(b.getPdxh());
b.setPdxh(tmp);
a.setBdsj(now);
b.setBdsj(now);
xydrwbMapper.updateById(a);
xydrwbMapper.updateById(b);
// 返回顺序必须反映交换后的新顺序(供前端直接刷新),而不是归一化时的旧顺序
java.util.Collections.swap(tasks, idx, other);
return tasks.stream().map(XYDRWB::getBh).toList();
}
@Override
public List<Map<String, Object>> groups(String kbh) {
if (kbh == null || kbh.isEmpty()) {
throw new ServiceException("请指定课编号", BAD_REQUEST);
}
List<XYDRWB> tasks = xydrwbMapper.selectList(new LambdaQueryWrapper<XYDRWB>()
.eq(XYDRWB::getKbh, kbh)
.eq(XYDRWB::getDelFlag, 0));
tasks.sort(Comparator
.comparing((XYDRWB t) -> t.getNd() == null ? 0 : t.getNd())
.thenComparing(t -> t.getPdbz() == null ? 0 : t.getPdbz())
.thenComparing(XYDRWB::getBh));
List<Map<String, Object>> rows = new ArrayList<>();
for (XYDRWB task : tasks) {
Map<String, Object> row = new LinkedHashMap<>();
row.put("bh", task.getBh());
row.put("kbh", task.getKbh());
row.put("kcmc", resolveCourseName(task));
row.put("nd", task.getNd());
XYDB clazz = task.getXydbh() == null ? null : xydbMapper.selectById(task.getXydbh());
row.put("xydbh", task.getXydbh());
row.put("xydmc", clazz != null ? clazz.getXydmc() : task.getXydbh());
row.put("xs", task.getXs());
row.put("zks", task.getZks());
row.put("pdxh", task.getPdxh());
row.put("pdqsz", task.getPdqsz());
row.put("pdaz", task.getPdaz() == null ? defaultPdaz(task.getZks()) : task.getPdaz());
row.put("pdbz", task.getPdbz() == null ? 0 : task.getPdbz());
rows.add(row);
}
return rows;
}
@Transactional(rollbackFor = Exception.class)
@Override
public int setGroup(AllocationGroupRequest request) {
if (request == null || request.getBhList() == null || request.getBhList().isEmpty()) {
throw new ServiceException("请先选择要改编组的任务", BAD_REQUEST);
}
if (request.getPdbz() == null || request.getPdbz() < 0) {
throw new ServiceException("配档编组必须 ≥ 0", BAD_REQUEST);
}
int count = 0;
LocalDateTime now = LocalDateTime.now();
for (String bh : request.getBhList()) {
XYDRWB task = xydrwbMapper.selectById(bh);
if (task == null || Integer.valueOf(1).equals(task.getDelFlag())) {
continue;
}
teachingTaskWriteGuard.assertCourseTaskWritable(task.getXydxqbh());
if (!Objects.equals(task.getPdbz(), request.getPdbz())) {
task.setPdbz(request.getPdbz());
task.setBdsj(now);
xydrwbMapper.updateById(task);
count++;
}
}
return count;
}
// ==================== 导出 ====================
/** 导出行(固定列,便于 ExcelExportUtil 取值) */
public static class AllocationExportRow {
private final String xydmc;
private final Integer ndCode;
private final String kbh;
private final String kcmc;
private final String klx;
private final Integer xs;
private final Integer zks;
private final Integer pdxh;
private final Integer pdqsz;
private final String pdazText;
private final Integer pdzzksj;
private final Integer pdbz;
private final Integer startWeek;
private final Integer endWeek;
private final Integer overflowHours;
AllocationExportRow(String xydmc, Integer ndCode, XYDRWB task, AllocationTaskVO vo) {
this.xydmc = xydmc;
this.ndCode = ndCode;
this.kbh = task.getKbh();
this.kcmc = vo.getKcmc();
this.klx = task.getKlx();
this.xs = task.getXs();
this.zks = task.getZks();
this.pdxh = task.getPdxh();
this.pdqsz = task.getPdqsz();
this.pdazText = Objects.equals(task.getPdaz(), 0) ? "连排" : "按周";
this.pdzzksj = task.getPdzzksj();
this.pdbz = task.getPdbz() == null ? 0 : task.getPdbz();
this.startWeek = vo.getStartWeek();
this.endWeek = vo.getEndWeek();
this.overflowHours = vo.getOverflowHours();
}
public String getXydmc() { return xydmc; }
public Integer getNdCode() { return ndCode; }
public String getKbh() { return kbh; }
public String getKcmc() { return kcmc; }
public String getKlx() { return klx; }
public Integer getXs() { return xs; }
public Integer getZks() { return zks; }
public Integer getPdxh() { return pdxh; }
public Integer getPdqsz() { return pdqsz; }
public String getPdazText() { return pdazText; }
public Integer getPdzzksj() { return pdzzksj; }
public Integer getPdbz() { return pdbz; }
public Integer getStartWeek() { return startWeek; }
public Integer getEndWeek() { return endWeek; }
public Integer getOverflowHours() { return overflowHours; }
}
@Override
public void exportExcel(List<String> xydxqbhList, HttpServletResponse response) throws Exception {
if (xydxqbhList == null || xydxqbhList.isEmpty()) {
throw new ServiceException("请先选择要导出的班次学期", BAD_REQUEST);
}
List<AllocationExportRow> rows = new ArrayList<>();
for (String xydxqbh : xydxqbhList) {
XYDNDXQJBXXB semester = classSemesterMapper.selectById(xydxqbh);
if (semester == null) {
continue;
}
XYDB clazz = xydbMapper.selectById(semester.getXydbh());
String xydmc = clazz != null ? clazz.getXydmc() : semester.getXydbh();
Integer ndCode = SemesterCodeUtil.resolve(semester.getNd(), semester.getXqdc());
AllocationViewVO view = view(xydxqbh);
Map<String, AllocationTaskVO> voMap = new HashMap<>();
view.getTasks().forEach(t -> voMap.put(t.getBh(), t));
for (XYDRWB task : listTasks(xydxqbh)) {
rows.add(new AllocationExportRow(xydmc, ndCode, task, voMap.get(task.getBh())));
}
}
if (rows.isEmpty()) {
throw new ServiceException("所选班次学期没有课程任务可导出", NOT_FOUND);
}
String[] headers = {"班次名称", "学期代号", "课编号", "课程", "课类型", "学时", "周课时",
"配档序号", "配档起始周", "连排/按周", "占正课时间", "配档编组", "计算起始周", "计算结束周", "溢出学时"};
byte[] bytes = ExcelExportUtil.export("教学配当", headers, rows,
AllocationExportRow::getXydmc, AllocationExportRow::getNdCode, AllocationExportRow::getKbh,
AllocationExportRow::getKcmc, AllocationExportRow::getKlx, AllocationExportRow::getXs,
AllocationExportRow::getZks, AllocationExportRow::getPdxh, AllocationExportRow::getPdqsz,
AllocationExportRow::getPdazText, AllocationExportRow::getPdzzksj, AllocationExportRow::getPdbz,
AllocationExportRow::getStartWeek, AllocationExportRow::getEndWeek, AllocationExportRow::getOverflowHours);
response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
response.setCharacterEncoding("utf-8");
String fileName = java.net.URLEncoder.encode("教学配当.xlsx", java.nio.charset.StandardCharsets.UTF_8);
response.setHeader("Content-Disposition", "attachment; filename=" + fileName);
response.getOutputStream().write(bytes);
response.getOutputStream().flush();
}
// ==================== 公共 ====================
private XYDNDXQJBXXB requireSemester(String xydxqbh) {
if (xydxqbh == null || xydxqbh.isEmpty()) {
throw new ServiceException("请指定班次学期", BAD_REQUEST);
}
XYDNDXQJBXXB semester = classSemesterMapper.selectById(xydxqbh);
if (semester == null) {
throw new ServiceException("班次学期不存在:" + xydxqbh, NOT_FOUND);
}
return semester;
}
}
@@ -379,7 +379,7 @@ public class TeachingTaskManageServiceImpl implements TeachingTaskManageService
continue;
}
try {
studentTeamTaskService.autoGenerateRequiredCourses(squad.getXydbh(), squad.getXqdc());
studentTeamTaskService.autoGenerateRequiredCourses(squad.getBh());
} catch (Exception ignored) {
// 课程任务已存在或计划缺失时,仍继续生成教研室任务书
}
@@ -2,11 +2,26 @@ package com.roomroot.jwgl.service.impl;
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.roomroot.jwgl.entity.JQB;
import com.roomroot.jwgl.entity.JXCDL;
import com.roomroot.jwgl.entity.SSKC;
import com.roomroot.jwgl.entity.SSKCB;
import com.roomroot.jwgl.entity.SSKCXYD;
import com.roomroot.jwgl.entity.TimetableConflictResult;
import com.roomroot.jwgl.entity.XYDB;
import com.roomroot.jwgl.entity.XQXLB;
import com.roomroot.jwgl.mapper.ClassRoomCalendarMapper;
import com.roomroot.jwgl.mapper.JQBMapper;
import com.roomroot.jwgl.mapper.KBMapper;
import com.roomroot.jwgl.mapper.SSKCBFZJYMapper;
import com.roomroot.jwgl.mapper.SSKCBJSMapper;
import com.roomroot.jwgl.mapper.SSKCBMapper;
import com.roomroot.jwgl.mapper.SSKCBXYDMapper;
import com.roomroot.jwgl.mapper.SSKCMapper;
import com.roomroot.jwgl.mapper.SSKCXYDMapper;
import com.roomroot.jwgl.mapper.SemesterCalendarMapper;
import com.roomroot.jwgl.mapper.TimetableConflictResultMapper;
import com.roomroot.jwgl.mapper.XYDBMapper;
import com.roomroot.jwgl.service.TimetableConflictService;
import com.roomroot.jwgl.unit.PageResult;
import com.roomroot.jwgl.unit.conflict.TimetableConflictDimension;
@@ -17,6 +32,7 @@ import jakarta.annotation.Resource;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Service;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.ZoneId;
import java.time.format.DateTimeFormatter;
@@ -47,6 +63,10 @@ public class TimetableConflictServiceImpl implements TimetableConflictService {
@Resource
private SSKCBXYDMapper sskcbxydMapper;
/** 实施_课程学员队(注意与 SSKCBXYDMapper=实施_课程表_学员队 是两张表) */
@Resource
private com.roomroot.jwgl.mapper.SSKCXYDMapper sskcxydMapper;
@Resource
private SSKCBFZJYMapper sskcbfzjyMapper;
@@ -59,6 +79,28 @@ public class TimetableConflictServiceImpl implements TimetableConflictService {
@Resource
private TimetableConflictResultMapper conflictResultMapper;
// 阶段 5.1:EVENT_CONFLICT / 场地历不可用 需要读取的表
@Resource
private SemesterCalendarMapper semesterCalendarMapper;
@Resource
private JQBMapper jqbMapper;
@Resource
private ClassRoomCalendarMapper classRoomCalendarMapper;
@Resource
private SSKCBMapper sskcbMapper;
@Resource
private SSKCMapper sskcMapper;
@Resource
private XYDBMapper xydbMapper;
@Resource
private KBMapper kbMapper;
// =====================================================================
// 内存缓存(不需要持久化到数据库,临时保存每次检查结果)
// Key 格式:"<年度>_<维度编码>" 例:"2026_TEACHER_CONFLICT"
@@ -210,9 +252,19 @@ public class TimetableConflictServiceImpl implements TimetableConflictService {
case TEAM_CONFLICT -> sskcbxydMapper.selectTeamConflictDetails(nd);
case ELECTIVE_REQUIRED_CONFLICT -> sskcbxydMapper.selectElectiveRequiredConflictDetails(nd);
case TEACHER_CONFLICT -> sskcbfzjyMapper.selectTeacherConflictDetails(nd);
case CLASSROOM_CONFLICT -> sskcbjsMapper.selectClassroomConflictDetails(nd);
case GUARANTEE_CONFLICT, EVENT_CONFLICT -> Collections.emptyList();
case CLASSROOM_CONFLICT -> {
// 阶段 5.1:教室重复占用 + 场地历不可用
List<TimetableConflictDetailVO> dup = sskcbjsMapper.selectClassroomConflictDetails(nd);
dup.addAll(checkClassroomCalendarConflicts(nd));
yield dup;
}
case EVENT_CONFLICT -> checkEventConflicts(nd);
case GUARANTEE_CONFLICT -> Collections.emptyList();
};
// 本检查器的维度全部为硬冲突(双占 / 三类历不可排);软提示由排课窗实时计算
if (details != null) {
details.forEach(d -> d.setLevel("hard"));
}
} catch (Exception e) {
log.error("[课表冲突检查][维度:{}][年度:{}] 执行SQL失败: {}",
dimension.getCode(), nd, e.getMessage(), e);
@@ -435,4 +487,195 @@ public class TimetableConflictServiceImpl implements TimetableConflictService {
return Collections.emptyList();
}
}
// =====================================================================
// 阶段 5.1:EVENT_CONFLICT(校历/班历不可排课格)与场地历不可用
// =====================================================================
/**
* EVENT_CONFLICT:读取 学期校历表、假期表 的不可排课格,与已排课次求交。
* 校历不可排课格上有已排课次 → 硬冲突;班历对某学员队不可排课格上有该队已排课次 → 硬冲突。
*/
private List<TimetableConflictDetailVO> checkEventConflicts(Integer nd) {
List<TimetableConflictDetailVO> result = new ArrayList<>();
// 已排课次(未删除、有日期)
List<SSKCB> lessons = sskcbMapper.selectList(new LambdaQueryWrapper<SSKCB>()
.eq(SSKCB::getNd, nd)
.eq(SSKCB::getSczt, 0)
.isNotNull(SSKCB::getRq));
if (lessons.isEmpty()) {
return result;
}
Map<String, String> courseNames = loadCourseNames(nd);
// ---- 校历:可排课=0 的格 ----
Map<String, List<SSKCB>> byGrid = lessons.stream()
.filter(l -> l.getRq() != null && l.getJc() != null)
.collect(Collectors.groupingBy(l -> l.getRq().toLocalDate().toString() + "#" + l.getJc()));
List<XQXLB> schoolUnavailable = semesterCalendarMapper.selectList(new LambdaQueryWrapper<XQXLB>()
.eq(XQXLB::getNd, nd)
.eq(XQXLB::getKpk, false));
for (XQXLB grid : schoolUnavailable) {
for (Integer jc : parsePeriods(grid.getCourseClass())) {
List<SSKCB> hits = byGrid.get(grid.getJqsj() + "#" + jc);
if (hits != null && !hits.isEmpty()) {
result.add(buildEventDetail("SCHOOL|" + grid.getJqsj() + "#" + jc, "校历不可排课格",
grid.getJqsj(), jc, hits, courseNames,
"校历标记该日期节次不可排课(" + safeName(grid.getJqmc()) + "),但已有课次安排"));
}
}
}
// ---- 班历:对某学员队可排课=0 的格 ----
List<JQB> classUnavailable = jqbMapper.selectList(new LambdaQueryWrapper<JQB>()
.eq(JQB::getNd, nd)
.eq(JQB::getKpk, 0));
if (!classUnavailable.isEmpty()) {
Map<String, SSKCB> lessonByBh = lessons.stream()
.collect(Collectors.toMap(SSKCB::getBh, l -> l, (a, b) -> a));
List<SSKCXYD> links = sskcxydMapper.selectList(new LambdaQueryWrapper<SSKCXYD>()
.in(SSKCXYD::getSskcbh, lessonByBh.keySet()));
Map<String, String> teamNames = xydbMapper.selectList(new LambdaQueryWrapper<>()).stream()
.collect(Collectors.toMap(XYDB::getXydbh, XYDB::getXydmc, (a, b) -> a));
Map<String, List<String>> teamsOfLesson = new HashMap<>();
for (SSKCXYD link : links) {
teamsOfLesson.computeIfAbsent(link.getSskcbh(), k -> new ArrayList<>()).add(link.getXydbh());
}
for (JQB grid : classUnavailable) {
if (grid.getJqsj() == null || grid.getCourseClass() == null) continue;
String dateStr = intDateToString(grid.getJqsj());
for (Integer jc : parsePeriods(grid.getCourseClass())) {
for (Map.Entry<String, List<String>> e : teamsOfLesson.entrySet()) {
if (!e.getValue().contains(grid.getXydbh())) continue;
SSKCB lesson = lessonByBh.get(e.getKey());
if (lesson == null || lesson.getRq() == null || lesson.getJc() == null) continue;
if (!dateStr.equals(lesson.getRq().toLocalDate().toString()) || lesson.getJc() != jc) continue;
TimetableConflictDetailVO d = buildEventDetail(
"CLASS|" + grid.getXydbh() + "|" + dateStr + "#" + jc, "班历不可排课格",
dateStr, jc, List.of(lesson), courseNames,
"班历标记该日期节次对该学员队不可排课,但已有课次安排");
d.setXydNames(teamNames.getOrDefault(grid.getXydbh(), grid.getXydbh()));
result.add(d);
}
}
}
}
return result;
}
/** CLASSROOM_CONFLICT 追加:教学场地历 标记不可排课(可排课=0)但该教室该格已有课次 */
private List<TimetableConflictDetailVO> checkClassroomCalendarConflicts(Integer nd) {
List<TimetableConflictDetailVO> result = new ArrayList<>();
List<SSKCB> lessons = sskcbMapper.selectList(new LambdaQueryWrapper<SSKCB>()
.eq(SSKCB::getNd, nd)
.eq(SSKCB::getSczt, 0)
.isNotNull(SSKCB::getRq));
if (lessons.isEmpty()) {
return result;
}
Map<String, SSKCB> lessonByBh = lessons.stream()
.collect(Collectors.toMap(SSKCB::getBh, l -> l, (a, b) -> a));
List<JXCDL> unavailable = classRoomCalendarMapper.selectList(new LambdaQueryWrapper<JXCDL>()
.eq(JXCDL::getKpk, false)
.eq(JXCDL::getDelFlag, 0)
.isNotNull(JXCDL::getRq));
if (unavailable.isEmpty()) {
return result;
}
Map<String, List<String>> roomsOfLesson = new HashMap<>();
for (var link : sskcbjsMapper.selectList(new LambdaQueryWrapper<com.roomroot.jwgl.entity.SSKCBJS>()
.in(com.roomroot.jwgl.entity.SSKCBJS::getSskcbbh, lessonByBh.keySet()))) {
roomsOfLesson.computeIfAbsent(link.getSskcbbh(), k -> new ArrayList<>()).add(link.getJsbh());
}
Map<String, String> courseNames = loadCourseNames(nd);
Map<String, String> roomNames = new HashMap<>();
for (JXCDL row : unavailable) {
if (row.getRq() == null || row.getJsbh() == null) continue;
String dateStr = row.getRq().toLocalDate().toString();
roomNames.put(row.getJsbh(), safeName(row.getMc()));
for (Map.Entry<String, List<String>> e : roomsOfLesson.entrySet()) {
if (!e.getValue().contains(row.getJsbh())) continue;
SSKCB lesson = lessonByBh.get(e.getKey());
if (lesson.getRq() == null || lesson.getJc() == null) continue;
if (!dateStr.equals(lesson.getRq().toLocalDate().toString()) || lesson.getJc() != row.getJc()) continue;
TimetableConflictDetailVO d = buildEventDetail(
"ROOMCAL|" + row.getJsbh() + "|" + dateStr + "#" + row.getJc(), "场地历不可用",
dateStr, row.getJc(), List.of(lesson), courseNames,
"教学场地历标记该教室该格不可排课,但已有课次安排");
d.setClassroomNames(safeName(row.getMc()));
result.add(d);
}
}
return result;
}
/** 构建 不可排课格 类冲突明细 */
private TimetableConflictDetailVO buildEventDetail(String resourceId, String resourceName,
String dateStr, Integer jc, List<SSKCB> lessons,
Map<String, String> courseNames, String reason) {
String courses = lessons.stream()
.map(l -> courseNames.getOrDefault(l.getSskcbh(), l.getSskcbh()))
.distinct()
.collect(Collectors.joining(";"));
return TimetableConflictDetailVO.builder()
.dimensionCode("EVENT_CONFLICT")
.dimensionTitle("日历冲突")
.resourceId(resourceId)
.resourceName(resourceName)
.rq(LocalDate.parse(dateStr).atStartOfDay())
.jc(jc)
.occupiedLessonCount(lessons.size())
.courseNames(courses)
.conflictSskcbBhs(lessons.stream().map(SSKCB::getBh).collect(Collectors.joining(",")))
.reason(reason)
.level("hard")
.build();
}
/** 实施_课程编号 → 课程名称(经 实施_课程.科目编号 → 课表.课名称) */
private Map<String, String> loadCourseNames(Integer nd) {
Map<String, String> names = new HashMap<>();
List<SSKC> courses = sskcMapper.selectList(new LambdaQueryWrapper<SSKC>().eq(SSKC::getNd, nd));
if (courses.isEmpty()) return names;
Set<String> kbhs = courses.stream().map(SSKC::getKmbh).collect(Collectors.toSet());
Map<String, String> kbhNames = kbMapper.selectBatchIds(kbhs).stream()
.collect(Collectors.toMap(com.roomroot.jwgl.entity.KB::getKbh, k -> safeName(k.getKmc()), (a, b) -> a));
for (SSKC c : courses) {
names.put(c.getBh(), kbhNames.getOrDefault(c.getKmbh(), c.getKmbh()));
}
return names;
}
/** 解析历表「节次」标签为节次号集合:"1-2"→[1,2],"3"→[3],无法解析返回空 */
private List<Integer> parsePeriods(String label) {
List<Integer> out = new ArrayList<>();
if (label == null) return out;
for (String token : label.split("[,,]")) {
String t = token.trim();
if (t.contains("-")) {
String[] parts = t.split("-");
try {
int a = Integer.parseInt(parts[0].trim());
int b = Integer.parseInt(parts[1].trim());
for (int i = Math.min(a, b); i <= Math.max(a, b); i++) out.add(i);
} catch (Exception ignored) { }
} else {
try {
out.add(Integer.parseInt(t));
} catch (Exception ignored) { }
}
}
return out;
}
private static String intDateToString(Integer d) {
if (d == null) return null;
String s = String.valueOf(d);
if (s.length() == 8) return s.substring(0, 4) + "-" + s.substring(4, 6) + "-" + s.substring(6, 8);
return s;
}
private static String safeName(String s) {
return s == null || s.isEmpty() ? "-" : s;
}
}