commit

src/main/java/com/yunhai/acaclassassign/model/bsch/ClassTreeNodeVo.java

@@ -0,0 +1,29 @@
+package com.yunhai.acaclassassign.model.bsch;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * 年级→班级树节点（对齐前端 ClassTreeNode；叶子=班级，附学生数）。
+ */
+@Data
+public class ClassTreeNodeVo {
+    private Integer id;
+    private String name;
+    /** 前端固定字段名 isParent */
+    @JsonProperty("isParent")
+    private boolean parent;
+    /** 叶子（班级）附学生数 */
+    private Integer studentCount;
+    private List<ClassTreeNodeVo> children;
+
+    public void setParent(boolean parent) {
+        this.parent = parent;
+    }
+
+    public boolean isParent() {
+        return parent;
+    }
+}

src/main/java/com/yunhai/acaclassassign/model/bsch/NowYearTermVo.java

@@ -0,0 +1,50 @@
+package com.yunhai.acaclassassign.model.bsch;
+
+import lombok.Data;
+
+/**
+ * 当前学年学期（班级服务 GET /oapi/sch/getNowYearTerm 返回）。
+ * 日期字段为源服务序列化的 yyyy-MM-dd 字符串。
+ */
+@Data
+public class NowYearTermVo {
+
+    /** 学年学期记录ID（base_year_term.id） */
+    private Integer id;
+
+    /** 学年（如 2026） */
+    private Integer year;
+
+    /** 当前学期（1第一学期 2第二学期），按当前日期落在学期区间判定 */
+    private Integer term;
+
+    /** 学年起始日期 */
+    private String yearStartDate;
+
+    /** 学年结束日期 */
+    private String yearEndDate;
+
+    /** 第一学期开始日期 */
+    private String firstTermStartDate;
+
+    /** 第一学期结束日期 */
+    private String firstTermEndDate;
+
+    /** 第二学期开始日期 */
+    private String secondTermStartDate;
+
+    /** 第二学期结束日期 */
+    private String secondTermEndDate;
+
+    /** 升级日期（上学年→本学年的切换日） */
+    private String upgradeDate;
+
+    /** 当前学期开始日期（按 term 取一/二学期开始日期） */
+    private String termStartDate;
+
+    /** 当前学期结束日期（按 term 取一/二学期结束日期） */
+    private String termEndDate;
+
+    /** 是否当前学年学期，恒为 true */
+    private Boolean nowYear;
+}

src/main/java/com/yunhai/acaclassassign/model/bsch/SubjectVo.java

@@ -0,0 +1,19 @@
+package com.yunhai.acaclassassign.model.bsch;
+
+import lombok.Data;
+
+/**
+ * 学校学科（班级服务 sch_dic_subject 派生）。
+ */
+@Data
+public class SubjectVo {
+
+    /** 学科ID（sch_dic_subject.id） */
+    private Integer id;
+
+    /** 学科编码 */
+    private String code;
+
+    /** 学科名称 */
+    private String name;
+}

src/main/java/com/yunhai/acaclassassign/model/bsch/SyncClassModels.java

@@ -0,0 +1,67 @@
+package com.yunhai.acaclassassign.model.bsch;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * 班级管理 /oapi/class 推送接口出参（反序列化用）。
+ * 与 UserclassService 的 SyncClassResultVO / SyncStudentResultVO 字段对齐。
+ */
+public class SyncClassModels {
+
+    /** POST /oapi/class/AddClass 出参：本地班号→平台 classId 映射 */
+    @Data
+    @JsonIgnoreProperties(ignoreUnknown = true)
+    public static class SyncClassResult {
+
+        private Integer gradeId;
+
+        private Integer gradeGroupId;
+
+        private List<ClassItem> classes;
+    }
+
+    @Data
+    @JsonIgnoreProperties(ignoreUnknown = true)
+    public static class ClassItem {
+
+        /** 班号（=分班侧 sort_order） */
+        private Integer sort;
+
+        /** 平台班级id（班级组id） */
+        private Integer classId;
+
+        private String code;
+
+        private String name;
+
+        /** true=本次新建；false=按 code 查重复用（幂等重推） */
+        private Boolean created;
+    }
+
+    /** POST /oapi/class/AddClassStudent 出参：逐生成败 */
+    @Data
+    @JsonIgnoreProperties(ignoreUnknown = true)
+    public static class SyncStudentResult {
+
+        private List<StudentItem> results;
+    }
+
+    @Data
+    @JsonIgnoreProperties(ignoreUnknown = true)
+    public static class StudentItem {
+
+        private String name;
+
+        private String account;
+
+        private Boolean ok;
+
+        private Integer stuId;
+
+        /** 失败原因 / 幂等命中说明 */
+        private String reason;
+    }
+}

src/main/java/com/yunhai/acaclassassign/model/bsch/YearTermItemVo.java

@@ -0,0 +1,19 @@
+package com.yunhai.acaclassassign.model.bsch;
+
+import lombok.Data;
+
+/**
+ * 学年选项（班级服务 GET /oapi/sch/getYearTermList 返回项，按学年倒序）。
+ */
+@Data
+public class YearTermItemVo {
+
+    /** 学年学期记录ID（base_year_term.id） */
+    private Integer id;
+
+    /** 学年（起始年，如 2026） */
+    private Integer year;
+
+    /** 是否当前学年 */
+    private Boolean nowYear;
+}