排课功能优化

backend/roomroot-jwgl/src/main/java/com/roomroot/jwgl/unit/conflict/TimetableConflictDimension.java

@@ -52,33 +52,48 @@ public enum TimetableConflictDimension {
 
     /**
      * 教员时间冲突检查。
-     * <p>检查逻辑：同一教员（主讲+辅讲统一在此维度）在同一日期同一节次被安排多门课程 → 冲突</p>
+     * <p>检查逻辑（两部分，均为硬冲突）：
+     *   <ol>
+     *     <li>同一教员（主讲+辅讲统一在此维度）在同一日期同一节次被安排多门课程 → 冲突</li>
+     *     <li>教员历（教员工作时间表）标记"可排课=0"的日期节次上，该教员仍有已排课次 → 冲突</li>
+     *   </ol>
+     * </p>
      * <p>涉及数据表：
      *   <ol>
      *     <li>实施_课程表 SSKCB —— 主表，日期/节次/年度/删除状态</li>
      *     <li>实施_课程表_辅助教员 SSKCBFZJY —— 课次与教员的关联表（含主讲ZJY=1 与辅讲ZJY=0），获取教员编号(FZJYBH)</li>
+     *     <li>教员历 JYL —— 获取教员"可排课"标记(可排课=0 表示不可排)</li>
      *     <li>教员表 JYB / 教研室人员 JYSX —— 翻译中文姓名展示</li>
      *   </ol>
      * </p>
+     * <p><b>口径说明：</b>排课窗口的硬冲突包含「教员历不可用」，为此本维度同样纳入教员历检查，
+     * 使批量冲突检查与排课窗口判断一致。实现方式与「场地历不可用」并入
+     * {@link #CLASSROOM_CONFLICT} 保持一致，不再单开卡片，避免同一事实被重复计数。</p>
      */
     TEACHER_CONFLICT("TEACHER_CONFLICT",
             "教员时间冲突检查",
-            "同一教员在同一时间段被安排多门课程"),
+            "同一教员在同一时间段被安排多门课程，或教员历不可排课时段已有课程"),
 
     /**
      * 教室时间冲突检查。
-     * <p>检查逻辑：同一教室（场地）在同一日期同一节次被多门课程占用 → 冲突</p>
+     * <p>检查逻辑（两部分，均为硬冲突）：
+     *   <ol>
+     *     <li>同一教室（场地）在同一日期同一节次被多门课程占用 → 冲突</li>
+     *     <li>教学场地历标记"可排课=0"的教室节次上仍有已排课次 → 冲突（场地历不可用）</li>
+     *   </ol>
+     * </p>
      * <p>涉及数据表：
      *   <ol>
      *     <li>实施_课程表 SSKCB —— 主表，日期/节次/年度/删除状态</li>
      *     <li>实施_课程表_教室 SSKCBJS —— 课次与教室的关联表，获取教室编号(JSBH)</li>
+     *     <li>教学场地历 JXCDL —— 获取场地"可排课"标记</li>
      *     <li>教室表 JSB —— 翻译中文名称（含容纳人数/设施等信息）</li>
      *   </ol>
      * </p>
      */
     CLASSROOM_CONFLICT("CLASSROOM_CONFLICT",
             "教室时间冲突检查",
-            "同一教室在同一时间段被多门课程占用"),
+            "同一教室在同一时间段被多门课程占用，或场地历不可用时段已有课程"),
 
     /**
      * 教学保障资源冲突检查（预留/按需开启）。