wuzhen 班级管理功能提交

backend/ruoyi-modules/ruoyi-xg-xx/src/main/java/org/dromara/xg/controller/XgClassInfoController.java

@@ -0,0 +1,265 @@
+package org.dromara.xg.controller;
+
+import java.util.List;
+import java.util.Map;
+
+import lombok.RequiredArgsConstructor;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.constraints.*;
+import cn.dev33.satoken.annotation.SaCheckPermission;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.validation.annotation.Validated;
+import org.dromara.common.idempotent.annotation.RepeatSubmit;
+import org.dromara.common.log.annotation.Log;
+import org.dromara.common.web.core.BaseController;
+import org.dromara.common.mybatis.core.page.PageQuery;
+import org.dromara.common.core.domain.R;
+import org.dromara.common.core.validate.AddGroup;
+import org.dromara.common.core.validate.EditGroup;
+import org.dromara.common.log.enums.BusinessType;
+import org.dromara.common.excel.utils.ExcelUtil;
+import org.dromara.xg.domain.vo.XgClassInfoVo;
+import org.dromara.xg.domain.bo.XgClassInfoBo;
+import org.dromara.xg.service.IXgClassInfoService;
+import org.dromara.common.mybatis.core.page.TableDataInfo;
+
+/**
+ * 班级信息管理
+ *
+ * @author Cursor AI
+ * @date 2025-01-21
+ */
+@Validated
+@RequiredArgsConstructor
+@RestController
+@RequestMapping("/xg/classInfo")
+public class XgClassInfoController extends BaseController {
+
+    private final IXgClassInfoService xgClassInfoService;
+
+    /**
+     * 查询班级信息列表
+     */
+    @SaCheckPermission("xg:classInfo:list")
+    @GetMapping("/list")
+    public TableDataInfo<XgClassInfoVo> list(XgClassInfoBo bo, PageQuery pageQuery) {
+        return xgClassInfoService.queryPageList(bo, pageQuery);
+    }
+
+    /**
+     * 导出班级信息列表
+     */
+    @SaCheckPermission("xg:classInfo:export")
+    @Log(title = "班级信息", businessType = BusinessType.EXPORT)
+    @PostMapping("/export")
+    public void export(XgClassInfoBo bo, HttpServletResponse response) {
+        List<XgClassInfoVo> list = xgClassInfoService.queryList(bo);
+        ExcelUtil.exportExcel(list, "班级信息", XgClassInfoVo.class, response);
+    }
+
+    /**
+     * 获取班级信息详细信息
+     */
+    @SaCheckPermission("xg:classInfo:query")
+    @GetMapping("/{id}")
+    public R<XgClassInfoVo> getInfo(@NotNull(message = "主键不能为空")
+                                     @PathVariable Long id) {
+        return R.ok(xgClassInfoService.queryById(id));
+    }
+
+    /**
+     * 新增班级信息
+     */
+    @SaCheckPermission("xg:classInfo:add")
+    @Log(title = "班级信息", businessType = BusinessType.INSERT)
+    @RepeatSubmit()
+    @PostMapping()
+    public R<Void> add(@Validated(AddGroup.class) @RequestBody XgClassInfoBo bo) {
+        return toAjax(xgClassInfoService.insertByBo(bo));
+    }
+
+    /**
+     * 修改班级信息
+     */
+    @SaCheckPermission("xg:classInfo:edit")
+    @Log(title = "班级信息", businessType = BusinessType.UPDATE)
+    @RepeatSubmit()
+    @PutMapping()
+    public R<Void> edit(@Validated(EditGroup.class) @RequestBody XgClassInfoBo bo) {
+        return toAjax(xgClassInfoService.updateByBo(bo));
+    }
+
+    /**
+     * 删除班级信息
+     */
+    @SaCheckPermission("xg:classInfo:remove")
+    @Log(title = "班级信息", businessType = BusinessType.DELETE)
+    @DeleteMapping("/{ids}")
+    public R<Void> remove(@NotEmpty(message = "主键不能为空")
+                          @PathVariable Long[] ids) {
+        return toAjax(xgClassInfoService.deleteWithValidByIds(List.of(ids), true));
+    }
+
+    /**
+     * 根据班级代码查询班级信息
+     */
+    @SaCheckPermission("xg:classInfo:query")
+    @GetMapping("/getByClassCode/{classCode}")
+    public R<XgClassInfoVo> getByClassCode(@NotBlank(message = "班级代码不能为空")
+                                           @PathVariable String classCode) {
+        return R.ok(xgClassInfoService.queryByClassCode(classCode));
+    }
+
+    /**
+     * 根据年级查询班级信息列表
+     */
+    @SaCheckPermission("xg:classInfo:query")
+    @GetMapping("/getByGrade/{grade}")
+    public R<List<XgClassInfoVo>> getByGrade(@NotBlank(message = "年级不能为空")
+                                             @PathVariable String grade) {
+        return R.ok(xgClassInfoService.queryByGrade(grade));
+    }
+
+    /**
+     * 根据学院代码查询班级信息列表
+     */
+    @SaCheckPermission("xg:classInfo:query")
+    @GetMapping("/getByCollegeCode/{collegeCode}")
+    public R<List<XgClassInfoVo>> getByCollegeCode(@NotBlank(message = "学院代码不能为空")
+                                                   @PathVariable String collegeCode) {
+        return R.ok(xgClassInfoService.queryByCollegeCode(collegeCode));
+    }
+
+    /**
+     * 根据专业代码查询班级信息列表
+     */
+    @SaCheckPermission("xg:classInfo:query")
+    @GetMapping("/getByMajorCode/{majorCode}")
+    public R<List<XgClassInfoVo>> getByMajorCode(@NotBlank(message = "专业代码不能为空")
+                                                 @PathVariable String majorCode) {
+        return R.ok(xgClassInfoService.queryByMajorCode(majorCode));
+    }
+
+    /**
+     * 根据辅导员ID查询班级信息列表
+     */
+    @SaCheckPermission("xg:classInfo:query")
+    @GetMapping("/getByCounselorId/{counselorId}")
+    public R<List<XgClassInfoVo>> getByCounselorId(@NotNull(message = "辅导员ID不能为空")
+                                                   @PathVariable Long counselorId) {
+        return R.ok(xgClassInfoService.queryByCounselorId(counselorId));
+    }
+
+    /**
+     * 根据班主任ID查询班级信息列表
+     */
+    @SaCheckPermission("xg:classInfo:query")
+    @GetMapping("/getByClassTeacherId/{classTeacherId}")
+    public R<List<XgClassInfoVo>> getByClassTeacherId(@NotNull(message = "班主任ID不能为空")
+                                                      @PathVariable Long classTeacherId) {
+        return R.ok(xgClassInfoService.queryByClassTeacherId(classTeacherId));
+    }
+
+    /**
+     * 获取班级可用选项列表（用于下拉框）
+     */
+    @SaCheckPermission("xg:classInfo:query")
+    @GetMapping("/getClassOptions")
+    public R<List<XgClassInfoVo>> getClassOptions() {
+        return R.ok(xgClassInfoService.getClassOptions());
+    }
+
+    /**
+     * 更新班级学生统计数据
+     */
+    @SaCheckPermission("xg:classInfo:edit")
+    @Log(title = "班级信息", businessType = BusinessType.UPDATE)
+    @PostMapping("/updateStudentCount/{id}")
+    public R<Void> updateStudentCount(@NotNull(message = "班级ID不能为空")
+                                      @PathVariable Long id) {
+        return toAjax(xgClassInfoService.updateStudentCount(id));
+    }
+
+    /**
+     * 批量更新班级学生统计数据
+     */
+    @SaCheckPermission("xg:classInfo:edit")
+    @Log(title = "班级信息", businessType = BusinessType.UPDATE)
+    @PostMapping("/batchUpdateStudentCount")
+    public R<Void> batchUpdateStudentCount(@NotEmpty(message = "班级ID列表不能为空")
+                                           @RequestBody List<Long> ids) {
+        return toAjax(xgClassInfoService.batchUpdateStudentCount(ids));
+    }
+
+    /**
+     * 启用班级
+     */
+    @SaCheckPermission("xg:classInfo:edit")
+    @Log(title = "班级信息", businessType = BusinessType.UPDATE)
+    @PostMapping("/enable/{id}")
+    public R<Void> enable(@NotNull(message = "班级ID不能为空")
+                          @PathVariable Long id) {
+        return toAjax(xgClassInfoService.enableClass(id));
+    }
+
+    /**
+     * 禁用班级
+     */
+    @SaCheckPermission("xg:classInfo:edit")
+    @Log(title = "班级信息", businessType = BusinessType.UPDATE)
+    @PostMapping("/disable/{id}")
+    public R<Void> disable(@NotNull(message = "班级ID不能为空")
+                           @PathVariable Long id) {
+        return toAjax(xgClassInfoService.disableClass(id));
+    }
+
+    // ================================
+    // 统计数据接口 - 新增
+    // ================================
+
+    /**
+     * 获取班级信息统计概览
+     */
+    @SaCheckPermission("xg:classInfo:statistics")
+    @GetMapping("/statistics")
+    public R<Map<String, Object>> getStatistics() {
+        return R.ok(xgClassInfoService.getStatistics());
+    }
+
+    /**
+     * 统计各学院班级数量
+     */
+    @SaCheckPermission("xg:classInfo:statistics")
+    @GetMapping("/statistics/college")
+    public R<List<Map<String, Object>>> countByCollege() {
+        return R.ok(xgClassInfoService.countByCollege());
+    }
+
+    /**
+     * 统计各年级班级数量
+     */
+    @SaCheckPermission("xg:classInfo:statistics")
+    @GetMapping("/statistics/grade")
+    public R<List<Map<String, Object>>> countByGrade() {
+        return R.ok(xgClassInfoService.countByGrade());
+    }
+
+    /**
+     * 统计各专业班级数量
+     */
+    @SaCheckPermission("xg:classInfo:statistics")
+    @GetMapping("/statistics/major")
+    public R<List<Map<String, Object>>> countByMajor() {
+        return R.ok(xgClassInfoService.countByMajor());
+    }
+
+    /**
+     * 统计班级状态分布
+     */
+    @SaCheckPermission("xg:classInfo:statistics")
+    @GetMapping("/statistics/status")
+    public R<List<Map<String, Object>>> countByStatus() {
+        return R.ok(xgClassInfoService.countByStatus());
+    }
+
+}

backend/ruoyi-modules/ruoyi-xg-xx/src/main/java/org/dromara/xg/domain/XgClassInfo.java

@@ -0,0 +1,346 @@
+package org.dromara.xg.domain;
+
+import com.baomidou.mybatisplus.annotation.*;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.dromara.common.mybatis.core.domain.BaseEntity;
+
+import java.io.Serial;
+import java.io.Serializable;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+/**
+ * 班级信息对象 xg_class_info
+ *
+ * @author Cursor AI
+ * @date 2025-01-21
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@TableName("xg_class_info")
+public class XgClassInfo extends BaseEntity implements Serializable {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /**
+     * 班级ID
+     */
+    @TableId(value = "id", type = IdType.ASSIGN_ID)
+    private Long id;
+
+    /**
+     * 租户编号
+     */
+    @TableField("tenant_id")
+    private String tenantId;
+
+    /**
+     * 班级代码
+     */
+    @TableField("class_code")
+    private String classCode;
+
+    /**
+     * 班级名称
+     */
+    @TableField("class_name")
+    private String className;
+
+    /**
+     * 班级类型：regular-普通班级，honor-荣誉班级，experimental-实验班级，special-特殊班级
+     */
+    @TableField("class_type")
+    private String classType;
+
+    /**
+     * 年级
+     */
+    @TableField("grade")
+    private String grade;
+
+    /**
+     * 入学年份
+     */
+    @TableField("enrollment_year")
+    private Integer enrollmentYear;
+
+    /**
+     * 毕业年份
+     */
+    @TableField("graduation_year")
+    private Integer graduationYear;
+
+    /**
+     * 专业代码
+     */
+    @TableField("major_code")
+    private String majorCode;
+
+    /**
+     * 专业名称
+     */
+    @TableField("major_name")
+    private String majorName;
+
+    /**
+     * 培养方式：全日制、在职、函授、夜大等
+     */
+    @TableField("training_type")
+    private String trainingType;
+
+    /**
+     * 学位类型：本科、专科、研究生等
+     */
+    @TableField("degree_type")
+    private String degreeType;
+
+    /**
+     * 学院代码
+     */
+    @TableField("college_code")
+    private String collegeCode;
+
+    /**
+     * 学院名称
+     */
+    @TableField("college_name")
+    private String collegeName;
+
+    /**
+     * 辅导员ID
+     */
+    @TableField("counselor_id")
+    private Long counselorId;
+
+    /**
+     * 辅导员姓名
+     */
+    @TableField("counselor_name")
+    private String counselorName;
+
+    /**
+     * 班主任ID
+     */
+    @TableField("class_teacher_id")
+    private Long classTeacherId;
+
+    /**
+     * 班主任姓名
+     */
+    @TableField("class_teacher_name")
+    private String classTeacherName;
+
+    /**
+     * 班级导师ID
+     */
+    @TableField("class_advisor_id")
+    private Long classAdvisorId;
+
+    /**
+     * 班级导师姓名
+     */
+    @TableField("class_advisor_name")
+    private String classAdvisorName;
+
+    /**
+     * 班长ID
+     */
+    @TableField("class_monitor_id")
+    private Long classMonitorId;
+
+    /**
+     * 班长姓名
+     */
+    @TableField("class_monitor_name")
+    private String classMonitorName;
+
+    /**
+     * 副班长ID
+     */
+    @TableField("deputy_monitor_id")
+    private Long deputyMonitorId;
+
+    /**
+     * 副班长姓名
+     */
+    @TableField("deputy_monitor_name")
+    private String deputyMonitorName;
+
+    /**
+     * 班级状态：1-正常，2-暂停，3-毕业，4-解散
+     */
+    @TableField("class_status")
+    private String classStatus;
+
+    /**
+     * 是否毕业：0-未毕业，1-已毕业
+     */
+    @TableField("is_graduation")
+    private Integer isGraduation;
+
+    /**
+     * 毕业日期
+     */
+    @TableField("graduation_date")
+    private LocalDate graduationDate;
+
+    /**
+     * 计划容量
+     */
+    @TableField("planned_capacity")
+    private Integer plannedCapacity;
+
+    /**
+     * 当前学生数量
+     */
+    @TableField("current_student_count")
+    private Integer currentStudentCount;
+
+    /**
+     * 最大学生数量
+     */
+    @TableField("max_student_count")
+    private Integer maxStudentCount;
+
+    /**
+     * 男生数量
+     */
+    @TableField("male_count")
+    private Integer maleCount;
+
+    /**
+     * 女生数量
+     */
+    @TableField("female_count")
+    private Integer femaleCount;
+
+    /**
+     * 在籍学生数量
+     */
+    @TableField("active_count")
+    private Integer activeCount;
+
+    /**
+     * 转入学生数量
+     */
+    @TableField("transfer_in_count")
+    private Integer transferInCount;
+
+    /**
+     * 转出学生数量
+     */
+    @TableField("transfer_out_count")
+    private Integer transferOutCount;
+
+    /**
+     * 退学学生数量
+     */
+    @TableField("dropout_count")
+    private Integer dropoutCount;
+
+    /**
+     * 毕业学生数量
+     */
+    @TableField("graduate_count")
+    private Integer graduateCount;
+
+    /**
+     * 办公室位置
+     */
+    @TableField("office_location")
+    private String officeLocation;
+
+    /**
+     * 教室位置
+     */
+    @TableField("class_location")
+    private String classLocation;
+
+    /**
+     * 联系电话
+     */
+    @TableField("contact_phone")
+    private String contactPhone;
+
+    /**
+     * QQ群号
+     */
+    @TableField("qq_group")
+    private String qqGroup;
+
+    /**
+     * 微信群
+     */
+    @TableField("wechat_group")
+    private String wechatGroup;
+
+    /**
+     * 邮箱
+     */
+    @TableField("email")
+    private String email;
+
+    /**
+     * 课程安排
+     */
+    @TableField("class_schedule")
+    private String classSchedule;
+
+    /**
+     * 班级文化
+     */
+    @TableField("class_culture")
+    private String classCulture;
+
+    /**
+     * 班级规章制度
+     */
+    @TableField("class_rules")
+    private String classRules;
+
+    /**
+     * 班级描述
+     */
+    @TableField("class_description")
+    private String classDescription;
+
+    /**
+     * 最后统计更新时间
+     */
+    @TableField("last_count_update")
+    private LocalDateTime lastCountUpdate;
+
+    /**
+     * 扩展字段1
+     */
+    @TableField("ext_field1")
+    private String extField1;
+
+    /**
+     * 扩展字段2
+     */
+    @TableField("ext_field2")
+    private String extField2;
+
+    /**
+     * 扩展字段3
+     */
+    @TableField("ext_field3")
+    private String extField3;
+
+    /**
+     * 备注
+     */
+    @TableField("remark")
+    private String remark;
+
+    /**
+     * 删除标志（0代表存在 1代表删除）
+     */
+    @TableField("deleted")
+    @TableLogic
+    private Integer deleted;
+
+}

backend/ruoyi-modules/ruoyi-xg-xx/src/main/java/org/dromara/xg/domain/bo/XgClassInfoBo.java

@@ -0,0 +1,378 @@
+package org.dromara.xg.domain.bo;
+
+import org.dromara.xg.domain.XgClassInfo;
+import org.dromara.common.mybatis.core.domain.BaseEntity;
+import org.dromara.common.core.validate.AddGroup;
+import org.dromara.common.core.validate.EditGroup;
+import io.github.linpeilie.annotations.AutoMapper;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import jakarta.validation.constraints.*;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * 班级信息业务对象 xg_class_info
+ *
+ * @author Cursor AI
+ * @date 2025-01-21
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@AutoMapper(target = XgClassInfo.class, reverseConvertGenerate = false)
+public class XgClassInfoBo extends BaseEntity {
+
+    /**
+     * 班级ID
+     */
+    @NotNull(message = "班级ID不能为空", groups = { EditGroup.class })
+    private Long id;
+
+    /**
+     * 班级代码
+     */
+    @NotBlank(message = "班级代码不能为空", groups = { AddGroup.class, EditGroup.class })
+    @Size(max = 32, message = "班级代码长度不能超过32个字符")
+    private String classCode;
+
+    /**
+     * 班级名称
+     */
+    @NotBlank(message = "班级名称不能为空", groups = { AddGroup.class, EditGroup.class })
+    @Size(max = 100, message = "班级名称长度不能超过100个字符")
+    private String className;
+
+    /**
+     * 班级类型：regular-普通班级，honor-荣誉班级，experimental-实验班级，special-特殊班级
+     */
+    private String classType;
+
+    /**
+     * 年级
+     */
+    @NotBlank(message = "年级不能为空", groups = { AddGroup.class, EditGroup.class })
+    @Size(max = 10, message = "年级长度不能超过10个字符")
+    private String grade;
+
+    /**
+     * 入学年份
+     */
+    @NotNull(message = "入学年份不能为空", groups = { AddGroup.class, EditGroup.class })
+    @Min(value = 1900, message = "入学年份不能小于1900")
+    @Max(value = 2100, message = "入学年份不能大于2100")
+    private Integer enrollmentYear;
+
+    /**
+     * 毕业年份
+     */
+    @Min(value = 1900, message = "毕业年份不能小于1900")
+    @Max(value = 2100, message = "毕业年份不能大于2100")
+    private Integer graduationYear;
+
+    /**
+     * 专业代码
+     */
+    @Size(max = 20, message = "专业代码长度不能超过20个字符")
+    private String majorCode;
+
+    /**
+     * 专业名称
+     */
+    @Size(max = 100, message = "专业名称长度不能超过100个字符")
+    private String majorName;
+
+    /**
+     * 培养方式：全日制、在职、函授、夜大等
+     */
+    @Size(max = 20, message = "培养方式长度不能超过20个字符")
+    private String trainingType;
+
+    /**
+     * 学位类型：本科、专科、研究生等
+     */
+    @Size(max = 20, message = "学位类型长度不能超过20个字符")
+    private String degreeType;
+
+    /**
+     * 学院代码
+     */
+    @Size(max = 20, message = "学院代码长度不能超过20个字符")
+    private String collegeCode;
+
+    /**
+     * 学院名称
+     */
+    @Size(max = 100, message = "学院名称长度不能超过100个字符")
+    private String collegeName;
+
+    /**
+     * 辅导员ID
+     */
+    private Long counselorId;
+
+    /**
+     * 辅导员姓名
+     */
+    @Size(max = 50, message = "辅导员姓名长度不能超过50个字符")
+    private String counselorName;
+
+    /**
+     * 班主任ID
+     */
+    private Long classTeacherId;
+
+    /**
+     * 班主任姓名
+     */
+    @Size(max = 50, message = "班主任姓名长度不能超过50个字符")
+    private String classTeacherName;
+
+    /**
+     * 班级导师ID
+     */
+    private Long classAdvisorId;
+
+    /**
+     * 班级导师姓名
+     */
+    @Size(max = 50, message = "班级导师姓名长度不能超过50个字符")
+    private String classAdvisorName;
+
+    /**
+     * 班长ID
+     */
+    private Long classMonitorId;
+
+    /**
+     * 班长姓名
+     */
+    @Size(max = 50, message = "班长姓名长度不能超过50个字符")
+    private String classMonitorName;
+
+    /**
+     * 副班长ID
+     */
+    private Long deputyMonitorId;
+
+    /**
+     * 副班长姓名
+     */
+    @Size(max = 50, message = "副班长姓名长度不能超过50个字符")
+    private String deputyMonitorName;
+
+    /**
+     * 班级状态：1-正常，2-暂停，3-毕业，4-解散
+     */
+    private String classStatus;
+
+    /**
+     * 是否毕业：0-未毕业，1-已毕业
+     */
+    private Integer isGraduation;
+
+    /**
+     * 毕业日期
+     */
+    private LocalDate graduationDate;
+
+    /**
+     * 计划容量
+     */
+    @Min(value = 1, message = "计划容量不能小于1")
+    @Max(value = 200, message = "计划容量不能大于200")
+    private Integer plannedCapacity;
+
+    /**
+     * 当前学生数量
+     */
+    private Integer currentStudentCount;
+
+    /**
+     * 最大学生数量
+     */
+    @Min(value = 1, message = "最大学生数量不能小于1")
+    @Max(value = 200, message = "最大学生数量不能大于200")
+    private Integer maxStudentCount;
+
+    /**
+     * 男生数量
+     */
+    private Integer maleCount;
+
+    /**
+     * 女生数量
+     */
+    private Integer femaleCount;
+
+    /**
+     * 在籍学生数量
+     */
+    private Integer activeCount;
+
+    /**
+     * 转入学生数量
+     */
+    private Integer transferInCount;
+
+    /**
+     * 转出学生数量
+     */
+    private Integer transferOutCount;
+
+    /**
+     * 退学学生数量
+     */
+    private Integer dropoutCount;
+
+    /**
+     * 毕业学生数量
+     */
+    private Integer graduateCount;
+
+    /**
+     * 办公室位置
+     */
+    @Size(max = 200, message = "办公室位置长度不能超过200个字符")
+    private String officeLocation;
+
+    /**
+     * 教室位置
+     */
+    @Size(max = 100, message = "教室位置长度不能超过100个字符")
+    private String classLocation;
+
+    /**
+     * 联系电话
+     */
+    @Size(max = 20, message = "联系电话长度不能超过20个字符")
+    private String contactPhone;
+
+    /**
+     * QQ群号
+     */
+    @Size(max = 20, message = "QQ群号长度不能超过20个字符")
+    private String qqGroup;
+
+    /**
+     * 微信群
+     */
+    @Size(max = 100, message = "微信群长度不能超过100个字符")
+    private String wechatGroup;
+
+    /**
+     * 邮箱
+     */
+    @Email(message = "邮箱格式不正确")
+    @Size(max = 100, message = "邮箱长度不能超过100个字符")
+    private String email;
+
+    /**
+     * 课程安排
+     */
+    private String classSchedule;
+
+    /**
+     * 班级文化
+     */
+    private String classCulture;
+
+    /**
+     * 班级规章制度
+     */
+    private String classRules;
+
+    /**
+     * 班级描述
+     */
+    @Size(max = 500, message = "班级描述长度不能超过500个字符")
+    private String classDescription;
+
+    /**
+     * 最后统计更新时间
+     */
+    private LocalDateTime lastCountUpdate;
+
+    /**
+     * 扩展字段1
+     */
+    @Size(max = 200, message = "扩展字段1长度不能超过200个字符")
+    private String extField1;
+
+    /**
+     * 扩展字段2
+     */
+    @Size(max = 200, message = "扩展字段2长度不能超过200个字符")
+    private String extField2;
+
+    /**
+     * 扩展字段3
+     */
+    @Size(max = 200, message = "扩展字段3长度不能超过200个字符")
+    private String extField3;
+
+    /**
+     * 备注
+     */
+    @Size(max = 500, message = "备注长度不能超过500个字符")
+    private String remark;
+
+    // ========== 查询条件字段 ==========
+
+    /**
+     * 入学年份开始
+     */
+    private Integer enrollmentYearStart;
+
+    /**
+     * 入学年份结束
+     */
+    private Integer enrollmentYearEnd;
+
+    /**
+     * 班级代码列表（用于批量查询）
+     */
+    private List<String> classCodeList;
+
+    /**
+     * 班级状态列表（用于批量查询）
+     */
+    private List<String> classStatusList;
+
+    /**
+     * 学院代码列表（用于批量查询）
+     */
+    private List<String> collegeCodeList;
+
+    /**
+     * 专业代码列表（用于批量查询）
+     */
+    private List<String> majorCodeList;
+
+    /**
+     * 年级列表（用于批量查询）
+     */
+    private List<String> gradeList;
+
+    /**
+     * 辅导员ID列表（用于批量查询）
+     */
+    private List<Long> counselorIdList;
+
+    /**
+     * 班主任ID列表（用于批量查询）
+     */
+    private List<Long> classTeacherIdList;
+
+    /**
+     * 创建时间开始
+     */
+    private String createTimeStart;
+
+    /**
+     * 创建时间结束
+     */
+    private String createTimeEnd;
+
+}

backend/ruoyi-modules/ruoyi-xg-xx/src/main/java/org/dromara/xg/domain/vo/XgClassInfoVo.java

@@ -0,0 +1,355 @@
+package org.dromara.xg.domain.vo;
+
+import org.dromara.xg.domain.XgClassInfo;
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import org.dromara.common.excel.annotation.ExcelDictFormat;
+import org.dromara.common.excel.convert.ExcelDictConvert;
+import io.github.linpeilie.annotations.AutoMapper;
+import lombok.Data;
+import com.fasterxml.jackson.annotation.JsonFormat;
+
+import java.io.Serial;
+import java.io.Serializable;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+/**
+ * 班级信息视图对象 xg_class_info
+ *
+ * @author Cursor AI
+ * @date 2025-01-21
+ */
+@Data
+@ExcelIgnoreUnannotated
+@AutoMapper(target = XgClassInfo.class)
+public class XgClassInfoVo implements Serializable {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /**
+     * 班级ID
+     */
+    @ExcelProperty(value = "班级ID")
+    private Long id;
+
+    /**
+     * 班级代码
+     */
+    @ExcelProperty(value = "班级代码")
+    private String classCode;
+
+    /**
+     * 班级名称
+     */
+    @ExcelProperty(value = "班级名称")
+    private String className;
+
+    /**
+     * 班级类型：regular-普通班级，honor-荣誉班级，experimental-实验班级，special-特殊班级
+     */
+    @ExcelProperty(value = "班级类型", converter = ExcelDictConvert.class)
+    @ExcelDictFormat(dictType = "xg_class_type")
+    private String classType;
+
+    /**
+     * 年级
+     */
+    @ExcelProperty(value = "年级")
+    private String grade;
+
+    /**
+     * 入学年份
+     */
+    @ExcelProperty(value = "入学年份")
+    private Integer enrollmentYear;
+
+    /**
+     * 毕业年份
+     */
+    @ExcelProperty(value = "毕业年份")
+    private Integer graduationYear;
+
+    /**
+     * 专业代码
+     */
+    @ExcelProperty(value = "专业代码")
+    private String majorCode;
+
+    /**
+     * 专业名称
+     */
+    @ExcelProperty(value = "专业名称")
+    private String majorName;
+
+    /**
+     * 培养方式：全日制、在职、函授、夜大等
+     */
+    @ExcelProperty(value = "培养方式")
+    private String trainingType;
+
+    /**
+     * 学位类型：本科、专科、研究生等
+     */
+    @ExcelProperty(value = "学位类型")
+    private String degreeType;
+
+    /**
+     * 学院代码
+     */
+    @ExcelProperty(value = "学院代码")
+    private String collegeCode;
+
+    /**
+     * 学院名称
+     */
+    @ExcelProperty(value = "学院名称")
+    private String collegeName;
+
+    /**
+     * 辅导员ID
+     */
+    private Long counselorId;
+
+    /**
+     * 辅导员姓名
+     */
+    @ExcelProperty(value = "辅导员姓名")
+    private String counselorName;
+
+    /**
+     * 班主任ID
+     */
+    private Long classTeacherId;
+
+    /**
+     * 班主任姓名
+     */
+    @ExcelProperty(value = "班主任姓名")
+    private String classTeacherName;
+
+    /**
+     * 班级导师ID
+     */
+    private Long classAdvisorId;
+
+    /**
+     * 班级导师姓名
+     */
+    @ExcelProperty(value = "班级导师姓名")
+    private String classAdvisorName;
+
+    /**
+     * 班长ID
+     */
+    private Long classMonitorId;
+
+    /**
+     * 班长姓名
+     */
+    @ExcelProperty(value = "班长姓名")
+    private String classMonitorName;
+
+    /**
+     * 副班长ID
+     */
+    private Long deputyMonitorId;
+
+    /**
+     * 副班长姓名
+     */
+    @ExcelProperty(value = "副班长姓名")
+    private String deputyMonitorName;
+
+    /**
+     * 班级状态：1-正常，2-暂停，3-毕业，4-解散
+     */
+    @ExcelProperty(value = "班级状态", converter = ExcelDictConvert.class)
+    @ExcelDictFormat(dictType = "xg_class_status")
+    private String classStatus;
+
+    /**
+     * 是否毕业：0-未毕业，1-已毕业
+     */
+    @ExcelProperty(value = "是否毕业", converter = ExcelDictConvert.class)
+    @ExcelDictFormat(readConverterExp = "0=未毕业,1=已毕业")
+    private Integer isGraduation;
+
+    /**
+     * 毕业日期
+     */
+    @ExcelProperty(value = "毕业日期")
+    @JsonFormat(pattern = "yyyy-MM-dd")
+    private LocalDate graduationDate;
+
+    /**
+     * 计划容量
+     */
+    @ExcelProperty(value = "计划容量")
+    private Integer plannedCapacity;
+
+    /**
+     * 当前学生数量
+     */
+    @ExcelProperty(value = "当前学生数量")
+    private Integer currentStudentCount;
+
+    /**
+     * 最大学生数量
+     */
+    @ExcelProperty(value = "最大学生数量")
+    private Integer maxStudentCount;
+
+    /**
+     * 男生数量
+     */
+    @ExcelProperty(value = "男生数量")
+    private Integer maleCount;
+
+    /**
+     * 女生数量
+     */
+    @ExcelProperty(value = "女生数量")
+    private Integer femaleCount;
+
+    /**
+     * 在籍学生数量
+     */
+    @ExcelProperty(value = "在籍学生数量")
+    private Integer activeCount;
+
+    /**
+     * 转入学生数量
+     */
+    @ExcelProperty(value = "转入学生数量")
+    private Integer transferInCount;
+
+    /**
+     * 转出学生数量
+     */
+    @ExcelProperty(value = "转出学生数量")
+    private Integer transferOutCount;
+
+    /**
+     * 退学学生数量
+     */
+    @ExcelProperty(value = "退学学生数量")
+    private Integer dropoutCount;
+
+    /**
+     * 毕业学生数量
+     */
+    @ExcelProperty(value = "毕业学生数量")
+    private Integer graduateCount;
+
+    /**
+     * 办公室位置
+     */
+    @ExcelProperty(value = "办公室位置")
+    private String officeLocation;
+
+    /**
+     * 教室位置
+     */
+    @ExcelProperty(value = "教室位置")
+    private String classLocation;
+
+    /**
+     * 联系电话
+     */
+    @ExcelProperty(value = "联系电话")
+    private String contactPhone;
+
+    /**
+     * QQ群号
+     */
+    @ExcelProperty(value = "QQ群号")
+    private String qqGroup;
+
+    /**
+     * 微信群
+     */
+    @ExcelProperty(value = "微信群")
+    private String wechatGroup;
+
+    /**
+     * 邮箱
+     */
+    @ExcelProperty(value = "邮箱")
+    private String email;
+
+    /**
+     * 课程安排
+     */
+    private String classSchedule;
+
+    /**
+     * 班级文化
+     */
+    private String classCulture;
+
+    /**
+     * 班级规章制度
+     */
+    private String classRules;
+
+    /**
+     * 班级描述
+     */
+    @ExcelProperty(value = "班级描述")
+    private String classDescription;
+
+    /**
+     * 最后统计更新时间
+     */
+    @ExcelProperty(value = "最后统计更新时间")
+    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
+    private LocalDateTime lastCountUpdate;
+
+    /**
+     * 扩展字段1
+     */
+    private String extField1;
+
+    /**
+     * 扩展字段2
+     */
+    private String extField2;
+
+    /**
+     * 扩展字段3
+     */
+    private String extField3;
+
+    /**
+     * 备注
+     */
+    @ExcelProperty(value = "备注")
+    private String remark;
+
+    /**
+     * 创建者
+     */
+    private Long createBy;
+
+    /**
+     * 创建时间
+     */
+    @ExcelProperty(value = "创建时间")
+    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
+    private LocalDateTime createTime;
+
+    /**
+     * 更新者
+     */
+    private Long updateBy;
+
+    /**
+     * 更新时间
+     */
+    @ExcelProperty(value = "更新时间")
+    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
+    private LocalDateTime updateTime;
+
+}

backend/ruoyi-modules/ruoyi-xg-xx/src/main/java/org/dromara/xg/mapper/XgClassInfoMapper.java

@@ -0,0 +1,106 @@
+package org.dromara.xg.mapper;
+
+import org.dromara.xg.domain.XgClassInfo;
+import org.dromara.xg.domain.vo.XgClassInfoVo;
+import org.dromara.common.mybatis.core.mapper.BaseMapperPlus;
+import com.baomidou.mybatisplus.core.conditions.Wrapper;
+import com.baomidou.mybatisplus.core.metadata.IPage;
+import org.apache.ibatis.annotations.Param;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 班级信息Mapper接口
+ *
+ * @author Cursor AI
+ * @date 2025-01-21
+ */
+public interface XgClassInfoMapper extends BaseMapperPlus<XgClassInfo, XgClassInfoVo> {
+
+    /**
+     * 重写分页查询方法，使用自定义ResultMap
+     *
+     * @param page    分页参数
+     * @param wrapper 查询条件
+     * @return 分页结果
+     */
+    <P extends IPage<XgClassInfoVo>> P selectVoPage(IPage<XgClassInfo> page, @Param("ew") Wrapper<XgClassInfo> wrapper);
+
+    /**
+     * 根据班级代码查询班级信息
+     *
+     * @param classCode 班级代码
+     * @return 班级信息
+     */
+    XgClassInfoVo selectByClassCode(String classCode);
+
+    /**
+     * 查询指定年级的班级列表
+     *
+     * @param grade 年级
+     * @return 班级列表
+     */
+    List<XgClassInfoVo> selectByGrade(String grade);
+
+    /**
+     * 查询指定学院的班级列表
+     *
+     * @param collegeCode 学院代码
+     * @return 班级列表
+     */
+    List<XgClassInfoVo> selectByCollegeCode(String collegeCode);
+
+    /**
+     * 查询指定专业的班级列表
+     *
+     * @param majorCode 专业代码
+     * @return 班级列表
+     */
+    List<XgClassInfoVo> selectByMajorCode(String majorCode);
+
+    /**
+     * 查询指定辅导员的班级列表
+     *
+     * @param counselorId 辅导员ID
+     * @return 班级列表
+     */
+    List<XgClassInfoVo> selectByCounselorId(Long counselorId);
+
+    /**
+     * 查询指定班主任的班级列表
+     *
+     * @param classTeacherId 班主任ID
+     * @return 班级列表
+     */
+    List<XgClassInfoVo> selectByClassTeacherId(Long classTeacherId);
+
+    /**
+     * 统计各学院班级数量
+     *
+     * @return 学院班级数量统计
+     */
+    List<Map<String, Object>> countByCollege();
+
+    /**
+     * 统计各年级班级数量
+     *
+     * @return 年级班级数量统计
+     */
+    List<Map<String, Object>> countByGrade();
+
+    /**
+     * 统计各专业班级数量
+     *
+     * @return 专业班级数量统计
+     */
+    List<Map<String, Object>> countByMajor();
+
+    /**
+     * 统计班级状态分布
+     *
+     * @return 班级状态统计
+     */
+    List<Map<String, Object>> countByClassStatus();
+
+}

backend/ruoyi-modules/ruoyi-xg-xx/src/main/java/org/dromara/xg/service/IXgClassInfoService.java

@@ -0,0 +1,195 @@
+package org.dromara.xg.service;
+
+import org.dromara.xg.domain.vo.XgClassInfoVo;
+import org.dromara.xg.domain.bo.XgClassInfoBo;
+import org.dromara.common.mybatis.core.page.TableDataInfo;
+import org.dromara.common.mybatis.core.page.PageQuery;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 班级信息Service接口
+ *
+ * @author Cursor AI
+ * @date 2025-01-21
+ */
+public interface IXgClassInfoService {
+
+    /**
+     * 查询班级信息
+     *
+     * @param id 班级信息主键
+     * @return 班级信息
+     */
+    XgClassInfoVo queryById(Long id);
+
+    /**
+     * 查询班级信息列表
+     *
+     * @param bo 班级信息
+     * @return 班级信息集合
+     */
+    TableDataInfo<XgClassInfoVo> queryPageList(XgClassInfoBo bo, PageQuery pageQuery);
+
+    /**
+     * 查询班级信息列表
+     *
+     * @param bo 班级信息
+     * @return 班级信息集合
+     */
+    List<XgClassInfoVo> queryList(XgClassInfoBo bo);
+
+    /**
+     * 新增班级信息
+     *
+     * @param bo 班级信息
+     * @return 结果
+     */
+    Boolean insertByBo(XgClassInfoBo bo);
+
+    /**
+     * 修改班级信息
+     *
+     * @param bo 班级信息
+     * @return 结果
+     */
+    Boolean updateByBo(XgClassInfoBo bo);
+
+    /**
+     * 校验并批量删除班级信息信息
+     *
+     * @param ids 需要删除的班级信息主键集合
+     * @param isValid 是否校验,true-删除前校验,false-不校验
+     * @return 结果
+     */
+    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
+
+    /**
+     * 根据班级代码查询班级信息
+     *
+     * @param classCode 班级代码
+     * @return 班级信息
+     */
+    XgClassInfoVo queryByClassCode(String classCode);
+
+    /**
+     * 根据年级查询班级信息列表
+     *
+     * @param grade 年级
+     * @return 班级信息集合
+     */
+    List<XgClassInfoVo> queryByGrade(String grade);
+
+    /**
+     * 根据学院代码查询班级信息列表
+     *
+     * @param collegeCode 学院代码
+     * @return 班级信息集合
+     */
+    List<XgClassInfoVo> queryByCollegeCode(String collegeCode);
+
+    /**
+     * 根据专业代码查询班级信息列表
+     *
+     * @param majorCode 专业代码
+     * @return 班级信息集合
+     */
+    List<XgClassInfoVo> queryByMajorCode(String majorCode);
+
+    /**
+     * 根据辅导员ID查询班级信息列表
+     *
+     * @param counselorId 辅导员ID
+     * @return 班级信息集合
+     */
+    List<XgClassInfoVo> queryByCounselorId(Long counselorId);
+
+    /**
+     * 根据班主任ID查询班级信息列表
+     *
+     * @param classTeacherId 班主任ID
+     * @return 班级信息集合
+     */
+    List<XgClassInfoVo> queryByClassTeacherId(Long classTeacherId);
+
+    /**
+     * 获取班级可用选项列表（用于下拉框）
+     *
+     * @return 班级选项集合
+     */
+    List<XgClassInfoVo> getClassOptions();
+
+    /**
+     * 更新班级学生统计数据
+     *
+     * @param classId 班级ID
+     * @return 结果
+     */
+    Boolean updateStudentCount(Long classId);
+
+    /**
+     * 批量更新班级学生统计数据
+     *
+     * @param classIds 班级ID集合
+     * @return 结果
+     */
+    Boolean batchUpdateStudentCount(Collection<Long> classIds);
+
+    /**
+     * 启用班级
+     *
+     * @param id 班级ID
+     * @return 结果
+     */
+    Boolean enableClass(Long id);
+
+    /**
+     * 禁用班级
+     *
+     * @param id 班级ID
+     * @return 结果
+     */
+    Boolean disableClass(Long id);
+
+    // ================================
+    // 统计数据接口 - 新增
+    // ================================
+
+    /**
+     * 获取班级信息统计概览
+     *
+     * @return 统计概览数据
+     */
+    Map<String, Object> getStatistics();
+
+    /**
+     * 统计各学院班级数量
+     *
+     * @return 学院班级数量统计
+     */
+    List<Map<String, Object>> countByCollege();
+
+    /**
+     * 统计各年级班级数量
+     *
+     * @return 年级班级数量统计
+     */
+    List<Map<String, Object>> countByGrade();
+
+    /**
+     * 统计各专业班级数量
+     *
+     * @return 专业班级数量统计
+     */
+    List<Map<String, Object>> countByMajor();
+
+    /**
+     * 统计班级状态分布
+     *
+     * @return 班级状态统计
+     */
+    List<Map<String, Object>> countByStatus();
+
+}

backend/ruoyi-modules/ruoyi-xg-xx/src/main/java/org/dromara/xg/service/impl/XgClassInfoServiceImpl.java

@@ -0,0 +1,513 @@
+package org.dromara.xg.service.impl;
+
+import org.dromara.common.core.utils.MapstructUtils;
+import org.dromara.common.core.utils.StringUtils;
+import org.dromara.common.mybatis.core.page.TableDataInfo;
+import org.dromara.common.mybatis.core.page.PageQuery;
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.baomidou.mybatisplus.core.toolkit.Wrappers;
+import lombok.RequiredArgsConstructor;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.stereotype.Service;
+import org.dromara.xg.domain.bo.XgClassInfoBo;
+import org.dromara.xg.domain.vo.XgClassInfoVo;
+import org.dromara.xg.domain.XgClassInfo;
+import org.dromara.xg.mapper.XgClassInfoMapper;
+import org.dromara.xg.service.IXgClassInfoService;
+
+import java.util.List;
+import java.util.Map;
+import java.util.Collection;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.time.LocalDateTime;
+
+/**
+ * 班级信息Service业务层处理
+ *
+ * @author Cursor AI
+ * @date 2025-01-21
+ */
+@RequiredArgsConstructor
+@Service
+public class XgClassInfoServiceImpl implements IXgClassInfoService {
+
+    private static final Logger log = LoggerFactory.getLogger(XgClassInfoServiceImpl.class);
+
+    private final XgClassInfoMapper baseMapper;
+
+    /**
+     * 查询班级信息
+     */
+    @Override
+    public XgClassInfoVo queryById(Long id) {
+        return baseMapper.selectVoById(id);
+    }
+
+    /**
+     * 查询班级信息列表
+     */
+    @Override
+    public TableDataInfo<XgClassInfoVo> queryPageList(XgClassInfoBo bo, PageQuery pageQuery) {
+        log.info("=== 班级信息分页查询开始 ===");
+        log.info("查询条件: {}", bo);
+        log.info("分页参数: {}", pageQuery);
+
+        // 构建查询条件
+        LambdaQueryWrapper<XgClassInfo> lqw = buildQueryWrapper(bo);
+        log.info("Service构建的Lambda查询条件: {}", lqw.getTargetSql());
+
+        // 执行分页查询
+        Page<XgClassInfoVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
+        log.info("Mapper查询结果 - 总数: {}, 当前页记录数: {}", result.getTotal(), result.getRecords().size());
+
+        if (!result.getRecords().isEmpty()) {
+            log.info("第一条记录详情: {}", result.getRecords().get(0));
+        } else {
+            log.warn("Mapper查询结果为空！");
+        }
+
+        TableDataInfo<XgClassInfoVo> tableDataInfo = TableDataInfo.build(result);
+        log.info("最终返回结果 - 总数: {}, 行数: {}", tableDataInfo.getTotal(), tableDataInfo.getRows().size());
+        log.info("=== 班级信息分页查询结束 ===");
+
+        return tableDataInfo;
+    }
+
+    /**
+     * 查询班级信息列表
+     */
+    @Override
+    public List<XgClassInfoVo> queryList(XgClassInfoBo bo) {
+        LambdaQueryWrapper<XgClassInfo> lqw = buildQueryWrapper(bo);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    private LambdaQueryWrapper<XgClassInfo> buildQueryWrapper(XgClassInfoBo bo) {
+        Map<String, Object> params = bo.getParams();
+        LambdaQueryWrapper<XgClassInfo> lqw = Wrappers.lambdaQuery();
+        lqw.eq(StringUtils.isNotBlank(bo.getClassCode()), XgClassInfo::getClassCode, bo.getClassCode());
+        lqw.like(StringUtils.isNotBlank(bo.getClassName()), XgClassInfo::getClassName, bo.getClassName());
+        lqw.eq(StringUtils.isNotBlank(bo.getClassType()), XgClassInfo::getClassType, bo.getClassType());
+        lqw.eq(StringUtils.isNotBlank(bo.getGrade()), XgClassInfo::getGrade, bo.getGrade());
+        lqw.eq(bo.getEnrollmentYear() != null, XgClassInfo::getEnrollmentYear, bo.getEnrollmentYear());
+        lqw.ge(bo.getEnrollmentYearStart() != null, XgClassInfo::getEnrollmentYear, bo.getEnrollmentYearStart());
+        lqw.le(bo.getEnrollmentYearEnd() != null, XgClassInfo::getEnrollmentYear, bo.getEnrollmentYearEnd());
+        lqw.eq(bo.getGraduationYear() != null, XgClassInfo::getGraduationYear, bo.getGraduationYear());
+        lqw.eq(StringUtils.isNotBlank(bo.getMajorCode()), XgClassInfo::getMajorCode, bo.getMajorCode());
+        lqw.like(StringUtils.isNotBlank(bo.getMajorName()), XgClassInfo::getMajorName, bo.getMajorName());
+        lqw.eq(StringUtils.isNotBlank(bo.getTrainingType()), XgClassInfo::getTrainingType, bo.getTrainingType());
+        lqw.eq(StringUtils.isNotBlank(bo.getDegreeType()), XgClassInfo::getDegreeType, bo.getDegreeType());
+        lqw.eq(StringUtils.isNotBlank(bo.getCollegeCode()), XgClassInfo::getCollegeCode, bo.getCollegeCode());
+        lqw.like(StringUtils.isNotBlank(bo.getCollegeName()), XgClassInfo::getCollegeName, bo.getCollegeName());
+        lqw.eq(bo.getCounselorId() != null, XgClassInfo::getCounselorId, bo.getCounselorId());
+        lqw.like(StringUtils.isNotBlank(bo.getCounselorName()), XgClassInfo::getCounselorName, bo.getCounselorName());
+        lqw.eq(bo.getClassTeacherId() != null, XgClassInfo::getClassTeacherId, bo.getClassTeacherId());
+        lqw.like(StringUtils.isNotBlank(bo.getClassTeacherName()), XgClassInfo::getClassTeacherName, bo.getClassTeacherName());
+        lqw.eq(StringUtils.isNotBlank(bo.getClassStatus()), XgClassInfo::getClassStatus, bo.getClassStatus());
+        lqw.eq(bo.getIsGraduation() != null, XgClassInfo::getIsGraduation, bo.getIsGraduation());
+
+        // 批量查询条件
+        lqw.in(bo.getClassCodeList() != null && !bo.getClassCodeList().isEmpty(), XgClassInfo::getClassCode, bo.getClassCodeList());
+        lqw.in(bo.getClassStatusList() != null && !bo.getClassStatusList().isEmpty(), XgClassInfo::getClassStatus, bo.getClassStatusList());
+        lqw.in(bo.getCollegeCodeList() != null && !bo.getCollegeCodeList().isEmpty(), XgClassInfo::getCollegeCode, bo.getCollegeCodeList());
+        lqw.in(bo.getMajorCodeList() != null && !bo.getMajorCodeList().isEmpty(), XgClassInfo::getMajorCode, bo.getMajorCodeList());
+        lqw.in(bo.getGradeList() != null && !bo.getGradeList().isEmpty(), XgClassInfo::getGrade, bo.getGradeList());
+        lqw.in(bo.getCounselorIdList() != null && !bo.getCounselorIdList().isEmpty(), XgClassInfo::getCounselorId, bo.getCounselorIdList());
+        lqw.in(bo.getClassTeacherIdList() != null && !bo.getClassTeacherIdList().isEmpty(), XgClassInfo::getClassTeacherId, bo.getClassTeacherIdList());
+
+        // 时间范围查询
+        lqw.between(params.get("beginCreateTime") != null && params.get("endCreateTime") != null,
+            XgClassInfo::getCreateTime, params.get("beginCreateTime"), params.get("endCreateTime"));
+
+        return lqw;
+    }
+
+    /**
+     * 新增班级信息
+     */
+    @Override
+    public Boolean insertByBo(XgClassInfoBo bo) {
+        XgClassInfo add = MapstructUtils.convert(bo, XgClassInfo.class);
+        validEntityBeforeSave(add);
+        boolean flag = baseMapper.insert(add) > 0;
+        if (flag) {
+            bo.setId(add.getId());
+        }
+        return flag;
+    }
+
+    /**
+     * 修改班级信息
+     */
+    @Override
+    public Boolean updateByBo(XgClassInfoBo bo) {
+        XgClassInfo update = MapstructUtils.convert(bo, XgClassInfo.class);
+        validEntityBeforeSave(update);
+        return baseMapper.updateById(update) > 0;
+    }
+
+    /**
+     * 保存前的数据校验
+     */
+    private void validEntityBeforeSave(XgClassInfo entity) {
+        // 校验班级代码唯一性
+        if (StringUtils.isNotBlank(entity.getClassCode())) {
+            LambdaQueryWrapper<XgClassInfo> lqw = Wrappers.lambdaQuery();
+            lqw.eq(XgClassInfo::getClassCode, entity.getClassCode());
+            lqw.ne(entity.getId() != null, XgClassInfo::getId, entity.getId());
+            XgClassInfo existEntity = baseMapper.selectOne(lqw);
+            if (existEntity != null) {
+                throw new RuntimeException("班级代码已存在，请重新输入");
+            }
+        }
+
+        // 设置默认值
+        if (entity.getClassType() == null) {
+            entity.setClassType("regular");
+        }
+        if (entity.getClassStatus() == null) {
+            entity.setClassStatus("1");
+        }
+        if (entity.getIsGraduation() == null) {
+            entity.setIsGraduation(0);
+        }
+        if (entity.getPlannedCapacity() == null) {
+            entity.setPlannedCapacity(50);
+        }
+        if (entity.getMaxStudentCount() == null) {
+            entity.setMaxStudentCount(entity.getPlannedCapacity());
+        }
+        if (entity.getCurrentStudentCount() == null) {
+            entity.setCurrentStudentCount(0);
+        }
+        if (entity.getMaleCount() == null) {
+            entity.setMaleCount(0);
+        }
+        if (entity.getFemaleCount() == null) {
+            entity.setFemaleCount(0);
+        }
+        if (entity.getActiveCount() == null) {
+            entity.setActiveCount(0);
+        }
+        if (entity.getTransferInCount() == null) {
+            entity.setTransferInCount(0);
+        }
+        if (entity.getTransferOutCount() == null) {
+            entity.setTransferOutCount(0);
+        }
+        if (entity.getDropoutCount() == null) {
+            entity.setDropoutCount(0);
+        }
+        if (entity.getGraduateCount() == null) {
+            entity.setGraduateCount(0);
+        }
+    }
+
+    /**
+     * 批量删除班级信息
+     */
+    @Override
+    public Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid) {
+        if (isValid) {
+            // 校验是否存在学生关联
+            // TODO: 添加学生关联校验逻辑
+        }
+        return baseMapper.deleteBatchIds(ids) > 0;
+    }
+
+    /**
+     * 根据班级代码查询班级信息
+     */
+    @Override
+    public XgClassInfoVo queryByClassCode(String classCode) {
+        LambdaQueryWrapper<XgClassInfo> lqw = Wrappers.lambdaQuery();
+        lqw.eq(XgClassInfo::getClassCode, classCode);
+        return baseMapper.selectVoOne(lqw);
+    }
+
+    /**
+     * 根据年级查询班级信息列表
+     */
+    @Override
+    public List<XgClassInfoVo> queryByGrade(String grade) {
+        LambdaQueryWrapper<XgClassInfo> lqw = Wrappers.lambdaQuery();
+        lqw.eq(XgClassInfo::getGrade, grade);
+        lqw.eq(XgClassInfo::getClassStatus, "1");
+        lqw.orderByAsc(XgClassInfo::getClassCode);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    /**
+     * 根据学院代码查询班级信息列表
+     */
+    @Override
+    public List<XgClassInfoVo> queryByCollegeCode(String collegeCode) {
+        LambdaQueryWrapper<XgClassInfo> lqw = Wrappers.lambdaQuery();
+        lqw.eq(XgClassInfo::getCollegeCode, collegeCode);
+        lqw.eq(XgClassInfo::getClassStatus, "1");
+        lqw.orderByAsc(XgClassInfo::getGrade, XgClassInfo::getClassCode);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    /**
+     * 根据专业代码查询班级信息列表
+     */
+    @Override
+    public List<XgClassInfoVo> queryByMajorCode(String majorCode) {
+        LambdaQueryWrapper<XgClassInfo> lqw = Wrappers.lambdaQuery();
+        lqw.eq(XgClassInfo::getMajorCode, majorCode);
+        lqw.eq(XgClassInfo::getClassStatus, "1");
+        lqw.orderByAsc(XgClassInfo::getGrade, XgClassInfo::getClassCode);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    /**
+     * 根据辅导员ID查询班级信息列表
+     */
+    @Override
+    public List<XgClassInfoVo> queryByCounselorId(Long counselorId) {
+        LambdaQueryWrapper<XgClassInfo> lqw = Wrappers.lambdaQuery();
+        lqw.eq(XgClassInfo::getCounselorId, counselorId);
+        lqw.eq(XgClassInfo::getClassStatus, "1");
+        lqw.orderByAsc(XgClassInfo::getGrade, XgClassInfo::getClassCode);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    /**
+     * 根据班主任ID查询班级信息列表
+     */
+    @Override
+    public List<XgClassInfoVo> queryByClassTeacherId(Long classTeacherId) {
+        LambdaQueryWrapper<XgClassInfo> lqw = Wrappers.lambdaQuery();
+        lqw.eq(XgClassInfo::getClassTeacherId, classTeacherId);
+        lqw.eq(XgClassInfo::getClassStatus, "1");
+        lqw.orderByAsc(XgClassInfo::getGrade, XgClassInfo::getClassCode);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    /**
+     * 获取班级可用选项列表（用于下拉框）
+     */
+    @Override
+    public List<XgClassInfoVo> getClassOptions() {
+        LambdaQueryWrapper<XgClassInfo> lqw = Wrappers.lambdaQuery();
+        lqw.eq(XgClassInfo::getClassStatus, "1");
+        lqw.select(XgClassInfo::getId, XgClassInfo::getClassCode, XgClassInfo::getClassName,
+                   XgClassInfo::getGrade, XgClassInfo::getMajorName, XgClassInfo::getCollegeName);
+        lqw.orderByAsc(XgClassInfo::getGrade, XgClassInfo::getClassCode);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    /**
+     * 更新班级学生统计数据
+     */
+    @Override
+    public Boolean updateStudentCount(Long classId) {
+        // TODO: 实现学生统计数据更新逻辑
+        // 1. 查询班级下的学生数量
+        // 2. 统计男女学生数量
+        // 3. 统计在籍学生数量
+        // 4. 更新班级统计字段
+
+        XgClassInfo classInfo = baseMapper.selectById(classId);
+        if (classInfo != null) {
+            classInfo.setLastCountUpdate(LocalDateTime.now());
+            return baseMapper.updateById(classInfo) > 0;
+        }
+        return false;
+    }
+
+    /**
+     * 批量更新班级学生统计数据
+     */
+    @Override
+    public Boolean batchUpdateStudentCount(Collection<Long> classIds) {
+        boolean result = true;
+        for (Long classId : classIds) {
+            result = result && updateStudentCount(classId);
+        }
+        return result;
+    }
+
+    /**
+     * 启用班级
+     */
+    @Override
+    public Boolean enableClass(Long id) {
+        XgClassInfo classInfo = baseMapper.selectById(id);
+        if (classInfo != null) {
+            classInfo.setClassStatus("1");
+            return baseMapper.updateById(classInfo) > 0;
+        }
+        return false;
+    }
+
+    /**
+     * 禁用班级
+     */
+    @Override
+    public Boolean disableClass(Long id) {
+        XgClassInfo classInfo = baseMapper.selectById(id);
+        if (classInfo != null) {
+            classInfo.setClassStatus("0");
+            return baseMapper.updateById(classInfo) > 0;
+        }
+        return false;
+    }
+
+    // ================================
+    // 统计数据接口实现 - 新增
+    // ================================
+
+    /**
+     * 获取班级信息统计概览
+     */
+    @Override
+    public Map<String, Object> getStatistics() {
+        Map<String, Object> result = new HashMap<>();
+
+        // 总班级数
+        LambdaQueryWrapper<XgClassInfo> totalLqw = Wrappers.lambdaQuery();
+        long totalCount = baseMapper.selectCount(totalLqw);
+        result.put("totalCount", totalCount);
+
+        // 正常班级数
+        LambdaQueryWrapper<XgClassInfo> activeLqw = Wrappers.lambdaQuery();
+        activeLqw.eq(XgClassInfo::getClassStatus, "1");
+        long activeCount = baseMapper.selectCount(activeLqw);
+        result.put("activeCount", activeCount);
+
+        // 暂停班级数
+        LambdaQueryWrapper<XgClassInfo> pausedLqw = Wrappers.lambdaQuery();
+        pausedLqw.eq(XgClassInfo::getClassStatus, "2");
+        long pausedCount = baseMapper.selectCount(pausedLqw);
+        result.put("pausedCount", pausedCount);
+
+        // 已毕业班级数
+        LambdaQueryWrapper<XgClassInfo> graduatedLqw = Wrappers.lambdaQuery();
+        graduatedLqw.eq(XgClassInfo::getClassStatus, "3");
+        long graduatedCount = baseMapper.selectCount(graduatedLqw);
+        result.put("graduatedCount", graduatedCount);
+
+        // 总学生数（统计当前学生数量字段的总和）
+        LambdaQueryWrapper<XgClassInfo> studentLqw = Wrappers.lambdaQuery();
+        studentLqw.select(XgClassInfo::getCurrentStudentCount);
+        List<XgClassInfo> classList = baseMapper.selectList(studentLqw);
+        long totalStudents = classList.stream()
+            .mapToLong(c -> c.getCurrentStudentCount() != null ? c.getCurrentStudentCount() : 0)
+            .sum();
+        result.put("totalStudents", totalStudents);
+
+        return result;
+    }
+
+    /**
+     * 统计各学院班级数量
+     */
+    @Override
+    public List<Map<String, Object>> countByCollege() {
+        LambdaQueryWrapper<XgClassInfo> lqw = Wrappers.lambdaQuery();
+        lqw.select(XgClassInfo::getCollegeCode, XgClassInfo::getCollegeName)
+           .groupBy(XgClassInfo::getCollegeCode, XgClassInfo::getCollegeName);
+
+        List<XgClassInfo> list = baseMapper.selectList(lqw);
+        List<Map<String, Object>> result = new ArrayList<>();
+
+        for (XgClassInfo item : list) {
+            LambdaQueryWrapper<XgClassInfo> countLqw = Wrappers.lambdaQuery();
+            countLqw.eq(XgClassInfo::getCollegeCode, item.getCollegeCode());
+            long count = baseMapper.selectCount(countLqw);
+
+            Map<String, Object> map = new HashMap<>();
+            map.put("collegeCode", item.getCollegeCode());
+            map.put("collegeName", item.getCollegeName());
+            map.put("count", count);
+            result.add(map);
+        }
+
+        return result;
+    }
+
+    /**
+     * 统计各年级班级数量
+     */
+    @Override
+    public List<Map<String, Object>> countByGrade() {
+        LambdaQueryWrapper<XgClassInfo> lqw = Wrappers.lambdaQuery();
+        lqw.select(XgClassInfo::getGrade)
+           .groupBy(XgClassInfo::getGrade);
+
+        List<XgClassInfo> list = baseMapper.selectList(lqw);
+        List<Map<String, Object>> result = new ArrayList<>();
+
+        for (XgClassInfo item : list) {
+            LambdaQueryWrapper<XgClassInfo> countLqw = Wrappers.lambdaQuery();
+            countLqw.eq(XgClassInfo::getGrade, item.getGrade());
+            long count = baseMapper.selectCount(countLqw);
+
+            Map<String, Object> map = new HashMap<>();
+            map.put("grade", item.getGrade());
+            map.put("count", count);
+            result.add(map);
+        }
+
+        return result;
+    }
+
+    /**
+     * 统计各专业班级数量
+     */
+    @Override
+    public List<Map<String, Object>> countByMajor() {
+        LambdaQueryWrapper<XgClassInfo> lqw = Wrappers.lambdaQuery();
+        lqw.select(XgClassInfo::getMajorCode, XgClassInfo::getMajorName)
+           .groupBy(XgClassInfo::getMajorCode, XgClassInfo::getMajorName);
+
+        List<XgClassInfo> list = baseMapper.selectList(lqw);
+        List<Map<String, Object>> result = new ArrayList<>();
+
+        for (XgClassInfo item : list) {
+            LambdaQueryWrapper<XgClassInfo> countLqw = Wrappers.lambdaQuery();
+            countLqw.eq(XgClassInfo::getMajorCode, item.getMajorCode());
+            long count = baseMapper.selectCount(countLqw);
+
+            Map<String, Object> map = new HashMap<>();
+            map.put("majorCode", item.getMajorCode());
+            map.put("majorName", item.getMajorName());
+            map.put("count", count);
+            result.add(map);
+        }
+
+        return result;
+    }
+
+    /**
+     * 统计班级状态分布
+     */
+    @Override
+    public List<Map<String, Object>> countByStatus() {
+        List<Map<String, Object>> result = new ArrayList<>();
+
+        // 状态码对应的名称
+        String[] statusCodes = {"1", "2", "3", "4"};
+        String[] statusNames = {"正常", "暂停", "毕业", "解散"};
+
+        for (int i = 0; i < statusCodes.length; i++) {
+            LambdaQueryWrapper<XgClassInfo> lqw = Wrappers.lambdaQuery();
+            lqw.eq(XgClassInfo::getClassStatus, statusCodes[i]);
+            long count = baseMapper.selectCount(lqw);
+
+            Map<String, Object> map = new HashMap<>();
+            map.put("statusCode", statusCodes[i]);
+            map.put("statusName", statusNames[i]);
+            map.put("count", count);
+            result.add(map);
+        }
+
+        return result;
+    }
+
+}

backend/ruoyi-modules/ruoyi-xg-xx/src/main/resources/mapper/xg/XgClassInfoMapper.xml

@@ -0,0 +1,239 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE mapper
+        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
+        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="org.dromara.xg.mapper.XgClassInfoMapper">
+
+    <resultMap type="org.dromara.xg.domain.vo.XgClassInfoVo" id="XgClassInfoVoResult">
+        <result property="id" column="id"/>
+        <result property="classCode" column="class_code"/>
+        <result property="className" column="class_name"/>
+        <result property="classType" column="class_type"/>
+        <result property="grade" column="grade"/>
+        <result property="enrollmentYear" column="enrollment_year"/>
+        <result property="graduationYear" column="graduation_year"/>
+        <result property="majorCode" column="major_code"/>
+        <result property="majorName" column="major_name"/>
+        <result property="trainingType" column="training_type"/>
+        <result property="degreeType" column="degree_type"/>
+        <result property="collegeCode" column="college_code"/>
+        <result property="collegeName" column="college_name"/>
+        <result property="counselorId" column="counselor_id"/>
+        <result property="counselorName" column="counselor_name"/>
+        <result property="classTeacherId" column="class_teacher_id"/>
+        <result property="classTeacherName" column="class_teacher_name"/>
+        <result property="classAdvisorId" column="class_advisor_id"/>
+        <result property="classAdvisorName" column="class_advisor_name"/>
+        <result property="classMonitorId" column="class_monitor_id"/>
+        <result property="classMonitorName" column="class_monitor_name"/>
+        <result property="deputyMonitorId" column="deputy_monitor_id"/>
+        <result property="deputyMonitorName" column="deputy_monitor_name"/>
+        <result property="classStatus" column="class_status"/>
+        <result property="isGraduation" column="is_graduation"/>
+        <result property="graduationDate" column="graduation_date"/>
+        <result property="plannedCapacity" column="planned_capacity"/>
+        <result property="currentStudentCount" column="current_student_count"/>
+        <result property="maxStudentCount" column="max_student_count"/>
+        <result property="maleCount" column="male_count"/>
+        <result property="femaleCount" column="female_count"/>
+        <result property="activeCount" column="active_count"/>
+        <result property="transferInCount" column="transfer_in_count"/>
+        <result property="transferOutCount" column="transfer_out_count"/>
+        <result property="dropoutCount" column="dropout_count"/>
+        <result property="graduateCount" column="graduate_count"/>
+        <result property="officeLocation" column="office_location"/>
+        <result property="classLocation" column="class_location"/>
+        <result property="contactPhone" column="contact_phone"/>
+        <result property="qqGroup" column="qq_group"/>
+        <result property="wechatGroup" column="wechat_group"/>
+        <result property="email" column="email"/>
+        <result property="classSchedule" column="class_schedule"/>
+        <result property="classCulture" column="class_culture"/>
+        <result property="classRules" column="class_rules"/>
+        <result property="classDescription" column="class_description"/>
+        <result property="lastCountUpdate" column="last_count_update"/>
+        <result property="extField1" column="ext_field1"/>
+        <result property="extField2" column="ext_field2"/>
+        <result property="extField3" column="ext_field3"/>
+        <result property="remark" column="remark"/>
+        <result property="createBy" column="create_by"/>
+        <result property="createTime" column="create_time"/>
+        <result property="updateBy" column="update_by"/>
+        <result property="updateTime" column="update_time"/>
+    </resultMap>
+
+    <!-- 自定义分页查询方法 - 移除tenant_id字段查询，但保留WHERE条件 -->
+    <select id="selectVoPage" resultMap="XgClassInfoVoResult">
+        <!-- 调试信息：开始执行班级信息自定义分页查询 -->
+        SELECT
+            id, class_code, class_name, class_type, grade, enrollment_year, graduation_year,
+            major_code, major_name, training_type, degree_type, college_code, college_name,
+            counselor_id, counselor_name, class_teacher_id, class_teacher_name,
+            class_advisor_id, class_advisor_name, class_monitor_id, class_monitor_name,
+            deputy_monitor_id, deputy_monitor_name, class_status, is_graduation, graduation_date,
+            planned_capacity, current_student_count, max_student_count, male_count, female_count,
+            active_count, transfer_in_count, transfer_out_count, dropout_count, graduate_count,
+            office_location, class_location, contact_phone, qq_group, wechat_group, email,
+            class_schedule, class_culture, class_rules, class_description, last_count_update,
+            ext_field1, ext_field2, ext_field3, remark,
+            create_by, create_time, update_by, update_time
+        FROM xg_class_info
+        WHERE deleted = 0 AND tenant_id = '000000'
+        <if test="ew != null and ew.sqlSegment != null and ew.sqlSegment != '' and !ew.sqlSegment.trim().toUpperCase().startsWith('ORDER BY')">
+            AND ${ew.sqlSegment}
+        </if>
+        <if test="ew != null and ew.sqlSegment != null and ew.sqlSegment != '' and ew.sqlSegment.trim().toUpperCase().startsWith('ORDER BY')">
+            ${ew.sqlSegment}
+        </if>
+    </select>
+
+    <!-- 自定义详情查询方法 - 移除tenant_id字段查询，但保留WHERE条件 -->
+    <select id="selectVoById" parameterType="java.io.Serializable" resultMap="XgClassInfoVoResult">
+        SELECT
+            id, class_code, class_name, class_type, grade, enrollment_year, graduation_year,
+            major_code, major_name, training_type, degree_type, college_code, college_name,
+            counselor_id, counselor_name, class_teacher_id, class_teacher_name,
+            class_advisor_id, class_advisor_name, class_monitor_id, class_monitor_name,
+            deputy_monitor_id, deputy_monitor_name, class_status, is_graduation, graduation_date,
+            planned_capacity, current_student_count, max_student_count, male_count, female_count,
+            active_count, transfer_in_count, transfer_out_count, dropout_count, graduate_count,
+            office_location, class_location, contact_phone, qq_group, wechat_group, email,
+            class_schedule, class_culture, class_rules, class_description, last_count_update,
+            ext_field1, ext_field2, ext_field3, remark,
+            create_by, create_time, update_by, update_time
+        FROM xg_class_info
+        WHERE id = #{id}
+        AND deleted = 0
+        AND tenant_id = '000000'
+    </select>
+
+    <sql id="selectXgClassInfoVo">
+        select id, class_code, class_name, class_type, grade, enrollment_year, graduation_year,
+               major_code, major_name, training_type, degree_type, college_code, college_name,
+               counselor_id, counselor_name, class_teacher_id, class_teacher_name,
+               class_advisor_id, class_advisor_name, class_monitor_id, class_monitor_name,
+               deputy_monitor_id, deputy_monitor_name, class_status, is_graduation, graduation_date,
+               planned_capacity, current_student_count, max_student_count, male_count, female_count,
+               active_count, transfer_in_count, transfer_out_count, dropout_count, graduate_count,
+               office_location, class_location, contact_phone, qq_group, wechat_group, email,
+               class_schedule, class_culture, class_rules, class_description, last_count_update,
+               ext_field1, ext_field2, ext_field3, remark, create_by, create_time, update_by, update_time
+        from xg_class_info
+    </sql>
+
+    <!-- 根据班级代码查询班级信息 -->
+    <select id="selectByClassCode" parameterType="String" resultMap="XgClassInfoVoResult">
+        SELECT * FROM xg_class_info
+        WHERE class_code = #{classCode}
+        AND deleted = 0
+        AND tenant_id = '000000'
+    </select>
+
+    <!-- 查询指定年级的班级列表 -->
+    <select id="selectByGrade" parameterType="String" resultMap="XgClassInfoVoResult">
+        SELECT * FROM xg_class_info
+        WHERE grade = #{grade}
+        AND deleted = 0
+        AND tenant_id = '000000'
+        AND class_status = '1'
+        ORDER BY class_code
+    </select>
+
+    <!-- 查询指定学院的班级列表 -->
+    <select id="selectByCollegeCode" parameterType="String" resultMap="XgClassInfoVoResult">
+        SELECT * FROM xg_class_info
+        WHERE college_code = #{collegeCode}
+        AND deleted = 0
+        AND tenant_id = '000000'
+        AND class_status = '1'
+        ORDER BY grade, class_code
+    </select>
+
+    <!-- 查询指定专业的班级列表 -->
+    <select id="selectByMajorCode" parameterType="String" resultMap="XgClassInfoVoResult">
+        SELECT * FROM xg_class_info
+        WHERE major_code = #{majorCode}
+        AND deleted = 0
+        AND tenant_id = '000000'
+        AND class_status = '1'
+        ORDER BY grade, class_code
+    </select>
+
+    <!-- 查询指定辅导员的班级列表 -->
+    <select id="selectByCounselorId" parameterType="Long" resultMap="XgClassInfoVoResult">
+        SELECT * FROM xg_class_info
+        WHERE counselor_id = #{counselorId}
+        AND deleted = 0
+        AND tenant_id = '000000'
+        AND class_status = '1'
+        ORDER BY grade, class_code
+    </select>
+
+    <!-- 查询指定班主任的班级列表 -->
+    <select id="selectByClassTeacherId" parameterType="Long" resultMap="XgClassInfoVoResult">
+        SELECT * FROM xg_class_info
+        WHERE class_teacher_id = #{classTeacherId}
+        AND deleted = 0
+        AND tenant_id = '000000'
+        AND class_status = '1'
+        ORDER BY grade, class_code
+    </select>
+
+    <!-- 统计各学院班级数量 -->
+    <select id="countByCollege" resultType="java.util.Map">
+        SELECT
+            college_code,
+            college_name,
+            COUNT(*) as count
+        FROM xg_class_info
+        WHERE deleted = 0
+        AND tenant_id = '000000'
+        GROUP BY college_code, college_name
+        ORDER BY count DESC
+    </select>
+
+    <!-- 统计各年级班级数量 -->
+    <select id="countByGrade" resultType="java.util.Map">
+        SELECT
+            grade,
+            COUNT(*) as count
+        FROM xg_class_info
+        WHERE deleted = 0
+        AND tenant_id = '000000'
+        GROUP BY grade
+        ORDER BY grade
+    </select>
+
+    <!-- 统计各专业班级数量 -->
+    <select id="countByMajor" resultType="java.util.Map">
+        SELECT
+            major_code,
+            major_name,
+            COUNT(*) as count
+        FROM xg_class_info
+        WHERE deleted = 0
+        AND tenant_id = '000000'
+        GROUP BY major_code, major_name
+        ORDER BY count DESC
+    </select>
+
+    <!-- 统计班级状态分布 -->
+    <select id="countByClassStatus" resultType="java.util.Map">
+        SELECT
+            class_status,
+            CASE
+                WHEN class_status = '1' THEN '正常'
+                WHEN class_status = '2' THEN '暂停'
+                WHEN class_status = '3' THEN '毕业'
+                WHEN class_status = '4' THEN '解散'
+                ELSE '未知'
+            END as status_name,
+            COUNT(*) as count
+        FROM xg_class_info
+        WHERE deleted = 0
+        AND tenant_id = '000000'
+        GROUP BY class_status
+        ORDER BY class_status
+    </select>
+
+</mapper>