提交学生花名册

docs/开发文档/API/学生信息管理API.md

@@ -296,6 +296,82 @@
 #### 响应数据
 返回Excel文件流
 
+### 2.8.1 高级检索导出学生信息
+- **接口路径**: POST `/studentMsg/studentMsg/advancedSearchExport`
+- **权限标识**: `studentMsg:studentMsg:export`
+- **功能描述**: 根据高级检索条件导出学生信息列表，支持多维度复合查询条件
+- **版本**: 1.2.1 (2025-01-07修复MapStruct转换错误)
+- **修复**: 解决 `XgStudentMsgVo` 到 `XgStudentMsgExportVo` 转换器缺失问题
+
+#### 请求参数
+支持以下高级检索条件：
+
+**基础信息检索**
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| studentNo | string | 否 | 学号（模糊查询） |
+| name | string | 否 | 姓名（模糊查询） |
+| idCard | string | 否 | 身份证号（模糊查询） |
+| phone | string | 否 | 手机号码（模糊查询） |
+| email | string | 否 | 邮箱（模糊查询） |
+| gender | array | 否 | 性别数组：0-男，1-女 |
+| nationality | array | 否 | 民族数组 |
+| politicalStatus | array | 否 | 政治面貌数组 |
+| birthDateStart | string | 否 | 出生日期开始：yyyy-MM-dd |
+| birthDateEnd | string | 否 | 出生日期结束：yyyy-MM-dd |
+
+**学籍信息检索**
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| studentStatus | array | 否 | 学籍状态数组：1-在籍，2-休学，3-复学，4-退学，5-毕业 |
+| enrollmentYearStart | integer | 否 | 入学年份开始 |
+| enrollmentYearEnd | integer | 否 | 入学年份结束 |
+| admissionCategory | array | 否 | 录取类别数组 |
+
+**学院专业班级检索**
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| collegeName | string | 否 | 学院名称（模糊查询） |
+| majorName | string | 否 | 专业名称（模糊查询） |
+| className | string | 否 | 班级名称（模糊查询） |
+| grade | array | 否 | 年级数组 |
+| counselorName | string | 否 | 辅导员姓名（模糊查询） |
+| classTeacherName | string | 否 | 班主任姓名（模糊查询） |
+
+**家庭信息检索**
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| fatherName | string | 否 | 父亲姓名（模糊查询） |
+| motherName | string | 否 | 母亲姓名（模糊查询） |
+| familyEconomicStatus | array | 否 | 家庭经济状况数组 |
+| familyIncomeMin | number | 否 | 家庭收入最小值 |
+| familyIncomeMax | number | 否 | 家庭收入最大值 |
+
+**特殊身份检索**
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| isPoorStudent | array | 否 | 是否贫困生：0-否，1-是 |
+| isMinority | array | 否 | 是否少数民族：0-否，1-是 |
+| isDisabled | array | 否 | 是否残疾：0-否，1-是 |
+| isOrphan | array | 否 | 是否孤儿：0-否，1-是 |
+
+**权限范围**
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| deptIds | array | 否 | 部门ID数组，用于权限控制 |
+
+#### 响应数据
+返回Excel文件流，包含完整的学生信息数据
+
+#### 修复记录
+- **2025-01-07 v1.2.1**: 修复MapStruct转换错误，解决 `XgStudentMsgVo` 到 `XgStudentMsgExportVo` 转换器缺失问题
+  - **问题**: `MapstructUtils.convert()` 无法找到两个VO类之间的转换器，导致导出功能报错
+  - **解决**: 在Controller中添加手动转换方法 `convertToExportVo()` 和 `convertToExportVoList()`
+  - **影响**: 导出功能正常工作，所有字段完整映射
+- **2025-01-07 v1.2.0**: 修复分页限制问题，导出时pageSize设置为50000，确保能导出所有符合条件的记录
+  - **问题**: 之前由于BO类默认pageSize=10，导致只能导出10条记录
+  - **解决**: 取消注释Controller中的分页参数设置代码
+
 ### 2.9 查询学生个人信息
 - **接口路径**: GET `/studentMsg/studentMsg/personalInfo`
 - **权限标识**: `studentMsg:studentMsg:query`
@@ -540,7 +616,10 @@ updateSupport: true
 
 ---
 
-**文档更新时间**: 2025-01-27  
-**文档版本**: 1.1.0  
+**文档更新时间**: 2025-01-07  
+**文档版本**: 1.2.0  
 **维护人员**: Cursor AI  
-**更新说明**: 新增学生信息导入功能，完善学生信息管理API文档 
+**更新说明**: 
+- 新增高级检索导出接口文档
+- 修复高级检索导出分页限制问题
+- 之前版本：新增学生信息导入功能，完善学生信息管理API文档