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>

web/src/api/xg-xx/classInfo.ts

@@ -0,0 +1,287 @@
+import request from '@/utils/request'
+import { AxiosPromise } from 'axios'
+import { ClassInfoVO, ClassInfoQuery, ClassInfoForm, OptionData } from './classInfo/types'
+
+// 通用类型定义
+interface TableDataInfo<T> {
+  code: number;
+  msg: string;
+  rows: T[];
+  total: number;
+}
+
+interface R<T> {
+  code: number;
+  msg: string;
+  data: T;
+}
+
+/**
+ * 查询班级信息列表
+ */
+export const listClassInfo = (query: ClassInfoQuery): AxiosPromise<TableDataInfo<ClassInfoVO>> => {
+  return request({
+    url: '/xg/classInfo/list',
+    method: 'get',
+    params: query
+  })
+}
+
+/**
+ * 查询班级信息详细
+ */
+export const getClassInfo = (id: string | number): AxiosPromise<R<ClassInfoVO>> => {
+  return request({
+    url: '/xg/classInfo/' + id,
+    method: 'get'
+  })
+}
+
+/**
+ * 新增班级信息
+ */
+export const addClassInfo = (data: ClassInfoForm): AxiosPromise<R<void>> => {
+  return request({
+    url: '/xg/classInfo',
+    method: 'post',
+    data: data
+  })
+}
+
+/**
+ * 修改班级信息
+ */
+export const updateClassInfo = (data: ClassInfoForm): AxiosPromise<R<void>> => {
+  return request({
+    url: '/xg/classInfo',
+    method: 'put',
+    data: data
+  })
+}
+
+/**
+ * 删除班级信息
+ */
+export const delClassInfo = (id: string | number | Array<string | number>): AxiosPromise<R<void>> => {
+  return request({
+    url: '/xg/classInfo/' + id,
+    method: 'delete'
+  })
+}
+
+/**
+ * 导出班级信息
+ */
+export const exportClassInfo = (query: ClassInfoQuery): AxiosPromise<any> => {
+  return request({
+    url: '/xg/classInfo/export',
+    method: 'post',
+    data: query
+  })
+}
+
+/**
+ * 根据班级代码查询班级信息
+ */
+export const getClassInfoByCode = (classCode: string): AxiosPromise<R<ClassInfoVO>> => {
+  return request({
+    url: '/xg/classInfo/getByClassCode/' + classCode,
+    method: 'get'
+  })
+}
+
+/**
+ * 根据年级查询班级信息列表
+ */
+export const getClassInfoByGrade = (grade: string): AxiosPromise<R<ClassInfoVO[]>> => {
+  return request({
+    url: '/xg/classInfo/getByGrade/' + grade,
+    method: 'get'
+  })
+}
+
+/**
+ * 根据学院代码查询班级信息列表
+ */
+export const getClassInfoByCollege = (collegeCode: string): AxiosPromise<R<ClassInfoVO[]>> => {
+  return request({
+    url: '/xg/classInfo/getByCollegeCode/' + collegeCode,
+    method: 'get'
+  })
+}
+
+/**
+ * 根据专业代码查询班级信息列表
+ */
+export const getClassInfoByMajor = (majorCode: string): AxiosPromise<R<ClassInfoVO[]>> => {
+  return request({
+    url: '/xg/classInfo/getByMajorCode/' + majorCode,
+    method: 'get'
+  })
+}
+
+/**
+ * 根据辅导员ID查询班级信息列表
+ */
+export const getClassInfoByCounselor = (counselorId: number): AxiosPromise<R<ClassInfoVO[]>> => {
+  return request({
+    url: '/xg/classInfo/getByCounselorId/' + counselorId,
+    method: 'get'
+  })
+}
+
+/**
+ * 根据班主任ID查询班级信息列表
+ */
+export const getClassInfoByClassTeacher = (classTeacherId: number): AxiosPromise<R<ClassInfoVO[]>> => {
+  return request({
+    url: '/xg/classInfo/getByClassTeacherId/' + classTeacherId,
+    method: 'get'
+  })
+}
+
+/**
+ * 获取班级选项列表（用于下拉框）
+ */
+export const getClassOptions = (): AxiosPromise<R<ClassInfoVO[]>> => {
+  return request({
+    url: '/xg/classInfo/getClassOptions',  // 修正路径：从 /options 改为 /getClassOptions
+    method: 'get'
+  })
+}
+
+/**
+ * 更新班级学生统计
+ */
+export const updateStudentCount = (classId: number): AxiosPromise<R<void>> => {
+  return request({
+    url: '/xg/classInfo/updateStudentCount/' + classId,
+    method: 'post'  // 修正HTTP方法：从 put 改为 post
+  })
+}
+
+/**
+ * 批量更新班级学生统计
+ */
+export const batchUpdateStudentCount = (classIds: number[]): AxiosPromise<R<void>> => {
+  return request({
+    url: '/xg/classInfo/batchUpdateStudentCount',
+    method: 'post',  // 修正HTTP方法：从 put 改为 post
+    data: classIds
+  })
+}
+
+/**
+ * 启用班级
+ */
+export const enableClass = (id: number): AxiosPromise<R<void>> => {
+  return request({
+    url: '/xg/classInfo/enable/' + id,
+    method: 'post'  // 修正HTTP方法：从 put 改为 post
+  })
+}
+
+/**
+ * 禁用班级
+ */
+export const disableClass = (id: number): AxiosPromise<R<void>> => {
+  return request({
+    url: '/xg/classInfo/disable/' + id,
+    method: 'post'  // 修正HTTP方法：从 put 改为 post
+  })
+}
+
+// ================================
+// 统计数据接口 - 新增
+// ================================
+
+/**
+ * 获取班级信息统计概览
+ */
+export const getClassStatistics = (): AxiosPromise<R<any>> => {
+  return request({
+    url: '/xg/classInfo/statistics',
+    method: 'get'
+  })
+}
+
+/**
+ * 统计各学院班级数量
+ */
+export const countClassByCollege = (): AxiosPromise<R<any[]>> => {
+  return request({
+    url: '/xg/classInfo/statistics/college',
+    method: 'get'
+  })
+}
+
+/**
+ * 统计各年级班级数量
+ */
+export const countClassByGrade = (): AxiosPromise<R<any[]>> => {
+  return request({
+    url: '/xg/classInfo/statistics/grade',
+    method: 'get'
+  })
+}
+
+/**
+ * 统计各专业班级数量
+ */
+export const countClassByMajor = (): AxiosPromise<R<any[]>> => {
+  return request({
+    url: '/xg/classInfo/statistics/major',
+    method: 'get'
+  })
+}
+
+/**
+ * 统计班级状态分布
+ */
+export const countClassByStatus = (): AxiosPromise<R<any[]>> => {
+  return request({
+    url: '/xg/classInfo/statistics/status',
+    method: 'get'
+  })
+}
+
+/**
+ * 获取学院选项
+ */
+export const getCollegeOptions = (): AxiosPromise<R<any[]>> => {
+  return request({
+    url: '/xg/studentInfo/options/colleges',
+    method: 'get'
+  })
+}
+
+/**
+ * 获取专业选项
+ */
+export const getMajorOptions = (collegeCode?: string): AxiosPromise<R<any[]>> => {
+  return request({
+    url: '/xg/studentInfo/options/majors',
+    method: 'get',
+    params: { collegeCode }
+  })
+}
+
+/**
+ * 获取辅导员选项
+ */
+export const getCounselorOptions = (): AxiosPromise<R<any[]>> => {
+  return request({
+    url: '/xg/studentInfo/options/counselors',
+    method: 'get'
+  })
+}
+
+/**
+ * 获取班主任选项
+ */
+export const getClassTeacherOptions = (): AxiosPromise<R<any[]>> => {
+  return request({
+    url: '/xg/studentInfo/options/classTeachers',
+    method: 'get'
+  })
+}

web/src/api/xg-xx/classInfo/types.ts

@@ -0,0 +1,786 @@
+/**
+ * 班级信息管理模块 - 类型定义
+ */
+
+/**
+ * 班级信息 VO
+ */
+export interface ClassInfoVO {
+  /**
+   * 主键ID
+   */
+  id: string | number;
+
+  /**
+   * 租户编号
+   */
+  tenantId?: string;
+
+  /**
+   * 班级代码
+   */
+  classCode: string;
+
+  /**
+   * 班级名称
+   */
+  className: string;
+
+  /**
+   * 班级类型：regular-普通班级，honor-荣誉班级，experimental-实验班级，special-特殊班级
+   */
+  classType?: string;
+
+  /**
+   * 年级
+   */
+  grade: string;
+
+  /**
+   * 入学年份
+   */
+  enrollmentYear: number;
+
+  /**
+   * 毕业年份
+   */
+  graduationYear?: number;
+
+  /**
+   * 专业代码
+   */
+  majorCode?: string;
+
+  /**
+   * 专业名称
+   */
+  majorName?: string;
+
+  /**
+   * 培养方式：全日制、在职、函授、夜大等
+   */
+  trainingType?: string;
+
+  /**
+   * 学位类型：本科、专科、研究生等
+   */
+  degreeType?: string;
+
+  /**
+   * 学院代码
+   */
+  collegeCode?: string;
+
+  /**
+   * 学院名称
+   */
+  collegeName?: string;
+
+  /**
+   * 辅导员ID
+   */
+  counselorId?: string | number;
+
+  /**
+   * 辅导员姓名
+   */
+  counselorName?: string;
+
+  /**
+   * 班主任ID
+   */
+  classTeacherId?: string | number;
+
+  /**
+   * 班主任姓名
+   */
+  classTeacherName?: string;
+
+  /**
+   * 班级导师ID
+   */
+  classAdvisorId?: string | number;
+
+  /**
+   * 班级导师姓名
+   */
+  classAdvisorName?: string;
+
+  /**
+   * 班长ID
+   */
+  classMonitorId?: string | number;
+
+  /**
+   * 班长姓名
+   */
+  classMonitorName?: string;
+
+  /**
+   * 副班长ID
+   */
+  deputyMonitorId?: string | number;
+
+  /**
+   * 副班长姓名
+   */
+  deputyMonitorName?: string;
+
+  /**
+   * 班级状态：1-正常，2-暂停，3-毕业，4-解散
+   */
+  classStatus?: string;
+
+  /**
+   * 是否毕业：0-未毕业，1-已毕业
+   */
+  isGraduation?: number;
+
+  /**
+   * 毕业日期
+   */
+  graduationDate?: string;
+
+  /**
+   * 计划容量
+   */
+  plannedCapacity?: number;
+
+  /**
+   * 当前学生数量
+   */
+  currentStudentCount?: number;
+
+  /**
+   * 最大学生数量
+   */
+  maxStudentCount?: number;
+
+  /**
+   * 男生数量
+   */
+  maleCount?: number;
+
+  /**
+   * 女生数量
+   */
+  femaleCount?: number;
+
+  /**
+   * 在籍学生数量
+   */
+  activeCount?: number;
+
+  /**
+   * 转入学生数量
+   */
+  transferInCount?: number;
+
+  /**
+   * 转出学生数量
+   */
+  transferOutCount?: number;
+
+  /**
+   * 退学学生数量
+   */
+  dropoutCount?: number;
+
+  /**
+   * 毕业学生数量
+   */
+  graduateCount?: number;
+
+  /**
+   * 办公室位置
+   */
+  officeLocation?: string;
+
+  /**
+   * 教室位置
+   */
+  classLocation?: string;
+
+  /**
+   * 联系电话
+   */
+  contactPhone?: string;
+
+  /**
+   * QQ群号
+   */
+  qqGroup?: string;
+
+  /**
+   * 微信群
+   */
+  wechatGroup?: string;
+
+  /**
+   * 邮箱
+   */
+  email?: string;
+
+  /**
+   * 课程安排
+   */
+  classSchedule?: string;
+
+  /**
+   * 班级文化
+   */
+  classCulture?: string;
+
+  /**
+   * 班级规章制度
+   */
+  classRules?: string;
+
+  /**
+   * 班级描述
+   */
+  classDescription?: string;
+
+  /**
+   * 最后统计更新时间
+   */
+  lastCountUpdate?: string;
+
+  /**
+   * 扩展字段1
+   */
+  extField1?: string;
+
+  /**
+   * 扩展字段2
+   */
+  extField2?: string;
+
+  /**
+   * 扩展字段3
+   */
+  extField3?: string;
+
+  /**
+   * 备注
+   */
+  remark?: string;
+
+  /**
+   * 创建者
+   */
+  createBy?: string | number;
+
+  /**
+   * 创建时间
+   */
+  createTime?: string;
+
+  /**
+   * 更新者
+   */
+  updateBy?: string | number;
+
+  /**
+   * 更新时间
+   */
+  updateTime?: string;
+}
+
+/**
+ * 班级信息查询对象
+ */
+export interface ClassInfoQuery {
+  /**
+   * 当前页数
+   */
+  pageNum?: number;
+
+  /**
+   * 每页显示记录数
+   */
+  pageSize?: number;
+
+  /**
+   * 班级代码
+   */
+  classCode?: string;
+
+  /**
+   * 班级名称
+   */
+  className?: string;
+
+  /**
+   * 班级类型
+   */
+  classType?: string;
+
+  /**
+   * 年级
+   */
+  grade?: string;
+
+  /**
+   * 入学年份
+   */
+  enrollmentYear?: number;
+
+  /**
+   * 毕业年份
+   */
+  graduationYear?: number;
+
+  /**
+   * 学院代码
+   */
+  collegeCode?: string;
+
+  /**
+   * 学院名称
+   */
+  collegeName?: string;
+
+  /**
+   * 专业代码
+   */
+  majorCode?: string;
+
+  /**
+   * 专业名称
+   */
+  majorName?: string;
+
+  /**
+   * 班主任ID
+   */
+  classTeacherId?: string | number;
+
+  /**
+   * 班主任姓名
+   */
+  classTeacherName?: string;
+
+  /**
+   * 辅导员ID
+   */
+  counselorId?: string | number;
+
+  /**
+   * 辅导员姓名
+   */
+  counselorName?: string;
+
+  /**
+   * 班级状态
+   */
+  classStatus?: string;
+
+  /**
+   * 班级代码列表（批量查询）
+   */
+  classCodeList?: string[];
+
+  /**
+   * 班级状态列表（批量查询）
+   */
+  classStatusList?: string[];
+
+  /**
+   * 入学年份开始
+   */
+  enrollmentYearStart?: number;
+
+  /**
+   * 入学年份结束
+   */
+  enrollmentYearEnd?: number;
+
+  /**
+   * 创建时间开始
+   */
+  createTimeStart?: string;
+
+  /**
+   * 创建时间结束
+   */
+  createTimeEnd?: string;
+}
+
+/**
+ * 班级信息表单对象
+ */
+export interface ClassInfoForm {
+  /**
+   * 主键ID
+   */
+  id?: string | number;
+
+  /**
+   * 班级代码
+   */
+  classCode?: string;
+
+  /**
+   * 班级名称
+   */
+  className?: string;
+
+  /**
+   * 班级类型
+   */
+  classType?: string;
+
+  /**
+   * 年级
+   */
+  grade?: string;
+
+  /**
+   * 入学年份
+   */
+  enrollmentYear?: number;
+
+  /**
+   * 毕业年份
+   */
+  graduationYear?: number;
+
+  /**
+   * 专业代码
+   */
+  majorCode?: string;
+
+  /**
+   * 专业名称
+   */
+  majorName?: string;
+
+  /**
+   * 培养方式
+   */
+  trainingType?: string;
+
+  /**
+   * 学位类型
+   */
+  degreeType?: string;
+
+  /**
+   * 学院代码
+   */
+  collegeCode?: string;
+
+  /**
+   * 学院名称
+   */
+  collegeName?: string;
+
+  /**
+   * 辅导员ID
+   */
+  counselorId?: string | number;
+
+  /**
+   * 辅导员姓名
+   */
+  counselorName?: string;
+
+  /**
+   * 班主任ID
+   */
+  classTeacherId?: string | number;
+
+  /**
+   * 班主任姓名
+   */
+  classTeacherName?: string;
+
+  /**
+   * 班级导师ID
+   */
+  classAdvisorId?: string | number;
+
+  /**
+   * 班级导师姓名
+   */
+  classAdvisorName?: string;
+
+  /**
+   * 班长ID
+   */
+  classMonitorId?: string | number;
+
+  /**
+   * 班长姓名
+   */
+  classMonitorName?: string;
+
+  /**
+   * 副班长ID
+   */
+  deputyMonitorId?: string | number;
+
+  /**
+   * 副班长姓名
+   */
+  deputyMonitorName?: string;
+
+  /**
+   * 班级状态
+   */
+  classStatus?: string;
+
+  /**
+   * 是否毕业
+   */
+  isGraduation?: number;
+
+  /**
+   * 毕业日期
+   */
+  graduationDate?: string;
+
+  /**
+   * 计划容量
+   */
+  plannedCapacity?: number;
+
+  /**
+   * 当前学生数量
+   */
+  currentStudentCount?: number;
+
+  /**
+   * 最大学生数量
+   */
+  maxStudentCount?: number;
+
+  /**
+   * 男生数量
+   */
+  maleCount?: number;
+
+  /**
+   * 女生数量
+   */
+  femaleCount?: number;
+
+  /**
+   * 在籍学生数量
+   */
+  activeCount?: number;
+
+  /**
+   * 转入学生数量
+   */
+  transferInCount?: number;
+
+  /**
+   * 转出学生数量
+   */
+  transferOutCount?: number;
+
+  /**
+   * 退学学生数量
+   */
+  dropoutCount?: number;
+
+  /**
+   * 毕业学生数量
+   */
+  graduateCount?: number;
+
+  /**
+   * 办公室位置
+   */
+  officeLocation?: string;
+
+  /**
+   * 教室位置
+   */
+  classLocation?: string;
+
+  /**
+   * 联系电话
+   */
+  contactPhone?: string;
+
+  /**
+   * QQ群号
+   */
+  qqGroup?: string;
+
+  /**
+   * 微信群
+   */
+  wechatGroup?: string;
+
+  /**
+   * 邮箱
+   */
+  email?: string;
+
+  /**
+   * 课程安排
+   */
+  classSchedule?: string;
+
+  /**
+   * 班级文化
+   */
+  classCulture?: string;
+
+  /**
+   * 班级规章制度
+   */
+  classRules?: string;
+
+  /**
+   * 班级描述
+   */
+  classDescription?: string;
+
+  /**
+   * 最后统计更新时间
+   */
+  lastCountUpdate?: string;
+
+  /**
+   * 扩展字段1
+   */
+  extField1?: string;
+
+  /**
+   * 扩展字段2
+   */
+  extField2?: string;
+
+  /**
+   * 扩展字段3
+   */
+  extField3?: string;
+
+  /**
+   * 备注
+   */
+  remark?: string;
+}
+
+/**
+ * 班级统计数据
+ */
+export interface ClassStatisticsData {
+  /**
+   * 总班级数
+   */
+  totalCount: number;
+
+  /**
+   * 正常班级数
+   */
+  activeCount: number;
+
+  /**
+   * 已毕业班级数
+   */
+  graduatedCount: number;
+
+  /**
+   * 暂停班级数
+   */
+  suspendedCount: number;
+
+  /**
+   * 解散班级数
+   */
+  dissolvedCount: number;
+
+  /**
+   * 总学生数
+   */
+  totalStudentCount: number;
+
+  /**
+   * 平均班级人数
+   */
+  averageClassSize: number;
+}
+
+/**
+ * 班级选项数据
+ */
+export interface OptionData {
+  /**
+   * 值
+   */
+  value: string | number;
+
+  /**
+   * 标签
+   */
+  label: string;
+
+  /**
+   * 是否禁用
+   */
+  disabled?: boolean;
+
+  /**
+   * 扩展数据
+   */
+  data?: any;
+}
+
+/**
+ * 班级图表数据
+ */
+export interface ClassChartData {
+  /**
+   * 类别
+   */
+  category: string;
+
+  /**
+   * 数值
+   */
+  value: number;
+
+  /**
+   * 颜色
+   */
+  color?: string;
+
+  /**
+   * 百分比
+   */
+  percentage?: number;
+}
+
+/**
+ * 批量操作结果
+ */
+export interface BatchOperationResult {
+  /**
+   * 总数
+   */
+  total: number;
+
+  /**
+   * 成功数
+   */
+  success: number;
+
+  /**
+   * 失败数
+   */
+  failed: number;
+
+  /**
+   * 失败的记录
+   */
+  failedRecords?: Array<{
+    id: string | number;
+    reason: string;
+  }>;
+}

web/src/views/xg-xx/classInfo/README.md

@@ -0,0 +1,217 @@
+# 班级信息管理模块
+
+## 📋 模块说明
+
+- **模块名称**: 班级信息管理 (Class Information Management)
+- **模块简称**: classInfo
+- **对应后端**: backend/ruoyi-modules/ruoyi-xg-xx/
+- **对应API**: web/src/api/xg-xx/classInfo.ts
+
+## 🎯 功能概述
+
+班级信息管理模块提供完整的班级信息管理功能，包括：
+
+### 📊 统计概览
+- 总班级数统计
+- 正常班级数统计
+- 总学生数统计
+- 平均学生数统计
+
+### 🔍 查询功能
+- 班级代码、班级名称模糊查询
+- 年级、学院、专业级联查询
+- 班级类型、班级状态筛选
+- 班主任姓名查询
+
+### 📝 基础管理
+- 班级信息新增、修改、删除
+- 班级信息详情查看
+- 班级信息批量导出
+
+### 👥 人员配置
+- 班主任、辅导员配置
+- 班干部信息管理（班长、学习委员、生活委员等）
+- 联系方式管理
+
+### 📈 统计功能
+- 学生数量统计更新
+- 批量统计刷新
+- 实时数据同步
+
+## 🎨 页面设计
+
+### 页面布局
+- **搜索区域**: 8个搜索条件，支持组合查询
+- **统计卡片**: 4个统计指标，渐变色彩设计
+- **表格区域**: 完整的班级信息展示
+- **操作按钮**: 查看、编辑、删除、统计更新
+
+### 对话框设计
+- **新增/编辑**: 分页签设计（基本信息、人员配置、联系方式）
+- **详情查看**: 描述列表展示完整信息
+- **响应式布局**: 适配不同屏幕尺寸
+
+## 🔧 技术特性
+
+### 前端技术
+- **Vue 3.5.13** + **TypeScript 5.8.3**
+- **Element Plus** UI组件库
+- **Composition API** 组合式API
+- **响应式设计** 适配多端
+
+### 样式设计
+- **参考后勤管理模块** 保持风格一致
+- **渐变色卡片** 美观的统计展示
+- **悬停效果** 良好的交互体验
+- **操作按钮** 图标化设计
+
+### 数据处理
+- **级联选择** 学院-专业联动
+- **表单验证** 完整的输入校验
+- **状态管理** 响应式数据更新
+- **错误处理** 友好的错误提示
+
+## 📋 API接口
+
+### 16个标准API接口
+
+#### 基础CRUD接口
+1. `GET /list` - 查询班级信息列表
+2. `POST /export` - 导出班级信息列表
+3. `GET /{id}` - 获取班级信息详情
+4. `POST /` - 新增班级信息
+5. `PUT /` - 修改班级信息
+6. `DELETE /{ids}` - 删除班级信息
+
+#### 业务查询接口
+7. `GET /getByClassCode/{classCode}` - 根据班级代码查询
+8. `GET /getByGrade/{grade}` - 根据年级查询
+9. `GET /getByCollegeCode/{collegeCode}` - 根据学院代码查询
+10. `GET /getByMajorCode/{majorCode}` - 根据专业代码查询
+11. `GET /getByCounselorId/{counselorId}` - 根据辅导员ID查询
+12. `GET /getByClassTeacherId/{classTeacherId}` - 根据班主任ID查询
+
+#### 辅助功能接口
+13. `GET /getClassOptions` - 获取班级选项列表
+14. `POST /updateStudentCount/{id}` - 更新班级学生统计
+15. `POST /batchUpdateStudentCount` - 批量更新学生统计
+16. `POST /enable/{id}` 和 `POST /disable/{id}` - 启用/禁用班级
+
+## 🎯 权限控制
+
+### 权限编码
+- `xg:classInfo:list` - 班级信息查询
+- `xg:classInfo:query` - 班级信息详情
+- `xg:classInfo:add` - 班级信息新增
+- `xg:classInfo:edit` - 班级信息修改
+- `xg:classInfo:remove` - 班级信息删除
+- `xg:classInfo:export` - 班级信息导出
+
+### 按钮权限
+- 所有操作按钮都配置了对应的权限控制
+- 使用 `v-hasPermi` 指令进行权限验证
+- 无权限时自动隐藏相关按钮
+
+## 📊 数据字典
+
+### 班级类型 (xg_class_type)
+- `regular` - 普通班级
+- `honor` - 荣誉班级
+- `experimental` - 实验班级
+- `special` - 特殊班级
+
+### 班级状态 (xg_class_status)
+- `1` - 正常
+- `2` - 暂停
+- `3` - 毕业
+- `4` - 解散
+
+### 年级选项 (xg_grade_options)
+- 支持动态配置年级选项
+- 适配不同学制需求
+
+## 🔄 数据流程
+
+### 查询流程
+1. 用户输入查询条件
+2. 前端组装查询参数
+3. 调用列表查询API
+4. 后端返回分页数据
+5. 前端渲染表格和统计
+
+### 新增/修改流程
+1. 用户填写表单信息
+2. 前端表单验证
+3. 调用新增/修改API
+4. 后端业务处理
+5. 返回操作结果
+6. 刷新列表和统计
+
+### 统计更新流程
+1. 用户点击统计更新
+2. 调用统计更新API
+3. 后端重新计算学生数
+4. 更新班级统计信息
+5. 返回最新统计数据
+
+## 🎨 样式规范
+
+### 色彩设计
+- **主色调**: 蓝色系 (#409eff)
+- **统计卡片**: 渐变色设计
+- **状态标签**: 语义化颜色
+- **交互效果**: 悬停和点击反馈
+
+### 布局规范
+- **页面间距**: 8px 外边距
+- **组件间距**: 10px 组件间距
+- **表格样式**: 斑马纹和悬停效果
+- **按钮样式**: 图标化小按钮
+
+### 响应式设计
+- **搜索区域**: 4列布局，支持响应式
+- **统计卡片**: 4列布局，移动端自适应
+- **表格列**: 固定宽度和自适应结合
+- **对话框**: 固定宽度，内容自适应
+
+## 📝 使用说明
+
+### 基本操作
+1. **查询班级**: 使用搜索条件筛选班级信息
+2. **新增班级**: 点击"新增班级"按钮，填写班级信息
+3. **修改班级**: 点击表格行的"编辑"按钮
+4. **查看详情**: 双击表格行或点击"查看"按钮
+5. **删除班级**: 选择班级后点击"删除"按钮
+
+### 高级功能
+1. **批量操作**: 选择多个班级进行批量删除
+2. **导出数据**: 根据查询条件导出Excel文件
+3. **统计更新**: 手动更新班级学生统计数据
+4. **级联查询**: 学院-专业联动查询
+
+### 注意事项
+- 班级代码必须唯一，系统会自动校验
+- 删除班级前请确认该班级下无学生信息
+- 统计数据会定期自动更新，也可手动刷新
+- 导出功能会根据当前查询条件生成文件
+
+## 🚀 扩展功能
+
+### 计划功能
+- 班级学生管理集成
+- 班级活动管理
+- 班级成绩统计
+- 班级考勤管理
+
+### 技术优化
+- 虚拟滚动优化大数据量
+- 缓存机制提升查询性能
+- 实时数据推送
+- 移动端适配优化
+
+---
+
+**📅 创建时间**: 2025-01-01  
+**👨‍💻 开发者**: Cursor AI  
+**📝 版本**: v1.0.0  
+**🔄 更新**: 持续迭代中