all-project/docs/开发文档/API/新生录取管理API.md

新生录取管理API文档

文档信息

项目名称	校园管理系统
模块名称	招生就业 - 新生录取管理
文档作者	Claude
编写日期	2025-07-25
文档状态	初稿
适用版本	v1.0.0
模块路径	/zsjy/admissionManagement

功能概述

新生录取管理功能提供对录取处理中的学生进行统一管理，支持查看学生信息、进行录取审核、确认缴费状态、填写录取通知书号等操作。支持批量处理，可以为多名学生填写连续编号的录取通知书号码。

API接口列表

序号	接口名称	接口路径	接口描述
1	查询录取学生列表	GET /zsjy/enrollment/process/list	获取当前处于录取处理中的学生列表
2	获取录取统计数据	GET /zsjy/enrollment/process/statistics	获取录取相关的统计数据
3	录取处理	POST /zsjy/enrollment/process/admissionProcess	进行单个学生的录取处理
4	确认缴费	POST /zsjy/enrollment/process/confirmPayment	确认学生的缴费状态
5	导出录取学生	POST /zsjy/enrollment/process/export	导出录取学生数据

API接口详情

1. 查询录取学生列表

接口信息

• 接口路径: GET /zsjy/enrollment/process/list
• 功能描述: 获取当前处于录取处理中的学生列表
• 请求方式: GET
• 权限标识: zsjy:admission:query

请求参数

参数名称	参数类型	是否必须	参数说明	默认值	取值范围
pageNum	Integer	否	当前页码	1	≥1
pageSize	Integer	否	每页记录数	10	1-100
studentName	String	否	学生姓名	-	-
idCard	String	否	身份证号	-	-
currentStatus	String	否	当前状态	2	2
paymentStatus	String	否	缴费状态	-	0,1

响应结果

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "rows": [
      {
        "id": 1946510098494091300,
        "enrollmentId": 1001,
        "studentName": "张三",
        "idCard": "330101200501010001",
        "currentStatus": "2",
        "infoAuditStatus": "1",
        "admissionStatus": "0",
        "finalAuditStatus": "0",
        "paymentStatus": "0",
        "isCompleted": 0,
        "createTime": "2025-07-20 10:28:09"
      }
    ],
    "total": 1
  }
}

返回参数说明

参数名称	参数类型	参数说明
rows	Array	录取流程列表
rows[0].id	Long	流程ID
rows[0].enrollmentId	Long	报名信息ID
rows[0].studentName	String	学生姓名
rows[0].idCard	String	身份证号
rows[0].currentStatus	String	当前状态（2-录取处理中）
rows[0].infoAuditStatus	String	信息审核状态（0-待审核 1-审核通过 9-审核驳回）
rows[0].admissionStatus	String	录取处理状态（0-待处理 1-处理完成 9-处理驳回）
rows[0].finalAuditStatus	String	最终审核状态（0-待确认 1-确认通过 9-确认驳回）
rows[0].paymentStatus	String	缴费状态（0-未缴费 1-已缴费）
rows[0].noticeNumber	String	录取通知书号码
rows[0].isCompleted	Integer	是否完成录取（0-未完成 1-已完成）
rows[0].createTime	String	创建时间
total	Integer	总记录数

2. 获取录取统计数据

接口信息

• 接口路径: GET /zsjy/enrollment/process/statistics
• 功能描述: 获取录取相关的统计数据
• 请求方式: GET
• 权限标识: zsjy:admission:query

请求参数

无

响应结果

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "total": 100,
    "pending": 35,
    "completed": 65
  }
}

返回参数说明

参数名称	参数类型	参数说明
total	Integer	总录取数
pending	Integer	待处理数量
completed	Integer	已完成数量

3. 录取处理

接口信息

• 接口路径: POST /zsjy/enrollment/process/admissionProcess
• 功能描述: 进行单个学生的录取处理
• 请求方式: POST
• 权限标识: zsjy:admission:process

请求参数

参数名称	参数类型	是否必须	参数说明	默认值	取值范围
processId	Long	是	流程ID	-	-
admissionResult	String	是	处理结果	-	1-处理通过, 9-处理驳回
noticeNumber	String	否	录取通知书号码	-	处理通过时必填
admissionOpinion	String	否	处理意见	-	最多500字符

响应结果

{
  "code": 200,
  "msg": "操作成功",
  "data": null
}

4. 确认缴费

接口信息

• 接口路径: POST /zsjy/enrollment/process/confirmPayment
• 功能描述: 确认学生的缴费状态
• 请求方式: POST
• 权限标识: zsjy:admission:payment

请求参数

参数名称	参数类型	是否必须	参数说明	默认值	取值范围
processId	Long	是	流程ID	-	-

响应结果

{
  "code": 200,
  "msg": "操作成功",
  "data": null
}

5. 导出录取学生

接口信息

• 接口路径: POST /zsjy/enrollment/process/export
• 功能描述: 导出录取学生数据
• 请求方式: POST
• 权限标识: zsjy:admission:export

请求参数

参数名称	参数类型	是否必须	参数说明	默认值	取值范围
studentName	String	否	学生姓名	-	-
idCard	String	否	身份证号	-	-
currentStatus	String	否	当前状态	2	2
paymentStatus	String	否	缴费状态	-	0,1

响应结果

返回Excel文件下载流

数据字典

1. 当前状态(zsjy_enrollment_status)

编码	名称	说明
0	待审核	流程刚创建的状态
1	信息审核中	正在审核基本信息
2	录取处理中	正在进行录取处理
3	待最终确认	等待最终审批确认
4	录取完成	已完成整个录取流程
9	已驳回	流程已被驳回

2. 缴费状态(zsjy_payment_status)

编码	名称	说明
0	未缴费	尚未完成缴费
1	已缴费	已确认缴费完成

3. 录取处理状态(zsjy_process_status)

编码	名称	说明
0	待处理	尚未进行录取处理
1	处理完成	已完成录取处理
9	处理驳回	录取处理被驳回

移动端实现

新生录取管理功能主要在Web端管理系统中使用，暂无移动端实现计划。

变更记录

版本号	变更日期	变更人	变更内容
v1.0.0	2025-07-25	Claude	初次创建API文档

相关文档

• 招生就业模块设计文档
• 录取流程管理API文档