校历编辑

frontend/src/views/teachBusiness/calendar/components/SchoolCalendarEditor.vue

@@ -91,7 +91,7 @@
 
 <script>
 import { getSemester } from '@/api/teachBusiness/semester'
-import { listXqxlb, updateXqxlb } from '@/api/teachBusiness/xqxlb'
+import { listXqxlb, addXqxlb, updateXqxlb } from '@/api/teachBusiness/xqxlb'
 
 // 节次定义：12/34/56 常显，78/晚上/夜间由开关控制可见
 const SLOT_DEFS = [
@@ -182,8 +182,11 @@ export default {
       })
       return cols
     },
-    // xqxlb 的年度（nd）为年份（如 2026），由 6 位学期代号（如 202601）截取前 4 位得出
+    // xqxlb 的 nd 存的是「年份」，必须与某条记录的 jqsj 实际日期同一年，
+    // 按「学期代号前4位」取会与格子真实年月脱节（如 2027 春学期首周落在 2026 年）。
+    // 这里统一以「日历起点 calendarStart 所在年」作为年度口径。
     xqxlbNd() {
+      if (this.calendarStart) return this.calendarStart.getFullYear()
       return Number(String(this.nd).slice(0, 4))
     }
   },
@@ -260,16 +263,39 @@ export default {
         })
     },
     // 从后端拉取本学期校历事件，渲染到对应时间格（年度由 6 位学期代号截取前 4 位）
+    // XQXLB 的 nd 存的是「年份」（如 2026），春/夏/秋三学期共用同一批年度记录；
+    // 后端 updateById 只能改已存在的 bh，所以每个格子必须有预生成的记录才能存。
+    // 若本学期日期区间 [kxrq, jsrq] 内还没有任何占位记录（首次进入该学期），
+    // 调用 /xqxlb/add 只按本学期 kxrq/jsrq 预生成这一张网格，再重新拉取，
+    // 这样后续 /xqxlb/update 的 updateById 才能命中每一格。（区间有覆盖则跳过，幂等）
     loadXqxlbEvents() {
-      listXqxlb({ nd: this.xqxlbNd }).then(res => {
-        const data = res.data
-        const list = Array.isArray(data) ? data : (data && data.records) || []
-        return list
-      }).then(list => {
-        const loaded = {}
+      const fetchList = () => {
+        console.warn('[校历编辑] 查询nd=', this.xqxlbNd, '学期nd=', this.nd)
+        return listXqxlb({ nd: this.xqxlbNd }).then(res => {
+          const data = res.data
+          const arr = Array.isArray(data) ? data : (data && data.records) || []
+          console.warn('[校历编辑] 返回条数=', arr.length, '含事件名=', arr.filter(it => it.jqmc).map(it => ({ nd: it.nd, jqsj: it.jqsj, jqmc: it.jqmc, courseClass: it.courseClass })).slice(0, 10))
+          return arr
+        })
+      }
+      const render = (list) => {
+        // 后端 add() 的按「月日」去重对已存的全量日期不生效，同一年度多次打开/刷新会
+        // 积累同一格的重复占位记录（各带不同 bh）。updateById 只改其中一行，其余空记录
+        // 会在重新拉取时把刚保存的事件名覆盖掉。故这里按「周-星期-节次」先去重：
+        // 同一格保留有事件名(jqmc非空)的一条；都没有则保留最后一条兜底（保证有 bh）。
+        const unique = {}
         list.forEach(item => {
           const pos = this.locateXqxlb(item)
           if (!pos) return
+          const stable = this.cellStableKey(pos.wIdx, pos.dayIndex, pos.slotKey)
+          const prev = unique[stable]
+          if (!prev || (item.jqmc && !prev.item.jqmc)) {
+            unique[stable] = { item: item, pos: pos }
+          }
+        })
+        const loaded = {}
+        Object.keys(unique).forEach(stable => {
+          const { item, pos } = unique[stable]
           const ev = {
             bh: item.bh,
             name: item.jqmc || '',
@@ -289,10 +315,27 @@ export default {
         })
         // 合并到现有格子（后端数据覆盖已有状态）
         this.events = Object.assign({}, this.events, loaded)
-      }).catch(() => {
+      }
+      fetchList().then(list => {
+        const hasCoverage = list.some(item => this.isInRange(item.jqsj))
+        if (!hasCoverage && this.startDate && this.endDate) {
+          // 本学期区间尚无占位记录：仅用本期 kxrq/jsrq 预生成整张网格
+          const startStr = fmtDate(this.startDate)
+          const endStr = fmtDate(this.endDate)
+          return addXqxlb(startStr, endStr).then(() => fetchList())
+        }
+        return list
+      }).then(render).catch(() => {
         this.$message.warning('校历事件加载失败')
       })
     },
+    // 判断某条记录（jqsj 日期）是否落在本学期 [startDate, endDate] 区间内
+    isInRange(jqsj) {
+      if (!this.startDate || !this.endDate || !jqsj) return false
+      const d = new Date(String(jqsj).slice(0, 10).replace(/-/g, '/'))
+      if (isNaN(d.getTime())) return false
+      return d >= this.startDate && d <= this.endDate
+    },
     // 根据假期记录反推时间格位置（jqsj 日期 + courseClass 节次），与列是否可见无关
     locateXqxlb(item) {
       if (!this.calendarStart || !item.jqsj) return null
@@ -485,7 +528,9 @@ export default {
       keys.forEach(key => {
         const prev = this.events[key]
         this.$set(this.events, key, {
-          bh: prev ? prev.bh : undefined,
+          // 编辑已有事件：沿用后端返回的 bh；新增事件：bh 由 loadXqxlbEvents
+          // 通过 /xqxlb/add 预生成的占位行提供（首次进入学期时已落库）
+          bh: prev && prev.bh ? prev.bh : undefined,
           name: name,
           bold: this.toolbar.bold,
           schedulable: this.toolbar.schedulable,
@@ -615,7 +660,9 @@ export default {
       return {
         delFlag: 0,
         bh: ev.bh || undefined,
-        nd: this.xqxlbNd,
+        // nd 必须与 jqsj 同一年：取本条记录真实日期的年份，
+        // 不能沿用学派代号前4位（如 2027 春学期首周可能落在 2026 年，会存错年度、查不到）。
+        nd: d.getFullYear(),
         jqsj: fmtDate(d),
         jqmc: ev.name || '',
         jc: !!ev.bold,