Halaman utama Jelajahi Bantuan
Daftar Masuk
hzdyjs-xg
/
all-project
2
0
Fork 0
Berkas Masalah 0 Permintaan Tarik 0 Wiki
Pohon: 08fbb49e89
Ranting Tag
all-project
/
docs
/
开发文档
/
API
/
招生录取流程API.md

招生录取流程API.md 11 KB
Riwayat Mentahan

招生录取流程API文档

基本信息

  • 模块名称: 招生录取流程管理
  • 接口前缀: /zsjy/enrollment/process
  • 开发负责人: wuzhen
  • 创建日期: 2025-07-01
  • 最后更新: 2025-07-01

接口列表

序号 接口名称 接口路径 请求方式 权限标识 接口说明
1 获取流程列表 /list GET zsjy:enrollment:process:list 获取所有录取流程状态列表
2 获取流程详情 /{id} GET zsjy:enrollment:process:query 获取单个录取流程状态详情
3 新增流程 / POST zsjy:enrollment:process:add 新增录取流程状态
4 修改流程 / PUT zsjy:enrollment:process:edit 修改录取流程状态
5 删除流程 /{id} DELETE zsjy:enrollment:process:remove 删除录取流程状态
6 导出流程 /export POST zsjy:enrollment:process:export 导出录取流程状态
7 信息审核 /infoAudit POST zsjy:enrollment:process:audit 执行信息审核操作
8 录取处理 /admissionProcess POST zsjy:enrollment:process:audit 执行录取处理操作
9 确认缴费 /confirmPayment POST zsjy:enrollment:process:audit 确认学生缴费状态
10 最终审核 /finalConfirm POST zsjy:enrollment:process:audit 执行最终审核操作
11 完成流程 /complete POST zsjy:enrollment:process:audit 完成录取流程
12 驳回流程 /reject POST zsjy:enrollment:process:audit 驳回录取流程
13 重置流程 /reset POST zsjy:enrollment:process:reset 重置录取流程状态
14 待我审核列表 /myAudit GET zsjy:enrollment:process:audit 获取当前用户待审核的列表
15 按状态查询 /status/{status} GET zsjy:enrollment:process:list 根据状态查询流程列表
16 按报名ID查询 /enrollment/{enrollmentId} GET zsjy:enrollment:process:query 根据报名ID查询流程状态

数据结构

录取流程状态实体 (ZsjyEnrollmentProcess)

{
  "id": 1,                          // 主键ID
  "enrollmentId": 1001,             // 报名信息ID，关联zsjy_enrollment_info.id
  "studentName": "张三",            // 学生姓名
  "idCard": "110101200001010101",   // 身份证号
  "currentStatus": "0",             // 当前状态（0-待审核 1-信息审核中 2-录取处理中 3-待最终确认 4-录取完成 9-已驳回）
  "currentHandler": 101,            // 当前处理人ID
  "currentHandlerName": "李老师",   // 当前处理人姓名
  "infoAuditStatus": "0",           // 信息审核状态（0-待审核 1-审核通过 9-审核驳回）
  "infoAuditUser": 101,             // 信息审核人ID
  "infoAuditUserName": "李老师",    // 信息审核人姓名
  "infoAuditTime": "2025-07-01 10:00:00", // 信息审核时间
  "infoAuditOpinion": "信息完整",   // 信息审核意见
  "admissionStatus": "0",           // 录取处理状态（0-待处理 1-处理完成 9-处理驳回）
  "admissionUser": 102,             // 录取处理人ID
  "admissionUserName": "王老师",    // 录取处理人姓名
  "admissionTime": "2025-07-01 14:00:00", // 录取处理时间
  "paymentStatus": "0",             // 缴费状态（0-未缴费 1-已缴费）
  "paymentConfirmTime": "2025-07-01 16:00:00", // 缴费确认时间
  "noticeNumber": "ZS2025001",      // 录取通知书号码
  "admissionOpinion": "符合录取条件", // 录取处理意见
  "finalAuditStatus": "0",          // 最终审核状态（0-待确认 1-确认通过 9-确认驳回）
  "finalAuditUser": 103,            // 最终审核人ID
  "finalAuditUserName": "赵主任",   // 最终审核人姓名
  "finalAuditTime": "2025-07-02 09:00:00", // 最终审核时间
  "finalAuditOpinion": "同意录取",  // 最终审核意见
  "isCompleted": 0,                 // 是否完成录取（0-未完成 1-已完成）
  "completionTime": "2025-07-02 10:00:00", // 录取完成时间
  "remark": "优秀学生",             // 备注
  "createTime": "2025-07-01 09:00:00", // 创建时间
  "updateTime": "2025-07-02 10:00:00"  // 更新时间
}

接口详情

1. 获取流程列表

  • 接口路径: /zsjy/enrollment/process/list
  • 请求方式: GET
  • 权限标识: zsjy:enrollment:process:list
  • 请求参数:
参数名 类型 必填 描述 示例值
pageNum int 是 页码 1
pageSize int 是 每页记录数 10
studentName string 否 学生姓名 张三
idCard string 否 身份证号 110101200001010101
currentStatus string 否 当前状态 0
infoAuditStatus string 否 信息审核状态 0
admissionStatus string 否 录取处理状态 0
finalAuditStatus string 否 最终审核状态 0
isCompleted int 否 是否完成录取 0
  • 响应结果:
{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "total": 100,
    "rows": [
      {
        "id": 1,
        "enrollmentId": 1001,
        "studentName": "张三",
        "idCard": "110101200001010101",
        "currentStatus": "0",
        "currentHandler": 101,
        "currentHandlerName": "李老师",
        "infoAuditStatus": "0",
        "admissionStatus": "0",
        "finalAuditStatus": "0",
        "isCompleted": 0,
        "createTime": "2025-07-01 09:00:00"
      },
      // 更多数据...
    ]
  }
}

14. 待我审核列表

  • 接口路径: /zsjy/enrollment/process/myAudit
  • 请求方式: GET
  • 权限标识: zsjy:enrollment:process:audit
  • 接口说明: 根据当前用户角色权限，获取需要该用户审核的录取流程数据
  • 请求参数:
参数名 类型 必填 描述 示例值
pageNum int 是 页码 1
pageSize int 是 每页记录数 10
studentName string 否 学生姓名 张三
idCard string 否 身份证号 110101200001010101
  • 响应结果:
{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "total": 5,
    "rows": [
      {
        "id": 1,
        "enrollmentId": 1001,
        "studentName": "张三",
        "idCard": "110101200001010101",
        "currentStatus": "1",
        "currentHandler": 101,
        "currentHandlerName": "李老师",
        "infoAuditStatus": "0",
        "admissionStatus": "0",
        "finalAuditStatus": "0",
        "isCompleted": 0,
        "createTime": "2025-07-01 09:00:00"
      },
      // 更多数据...
    ]
  }
}

7. 信息审核

  • 接口路径: /zsjy/enrollment/process/infoAudit
  • 请求方式: POST
  • 权限标识: zsjy:enrollment:process:audit
  • 请求参数:
参数名 类型 必填 描述 示例值
processId int 是 流程ID 1
auditResult string 是 审核结果（1-通过 9-驳回） 1
auditOpinion string 否 审核意见 信息完整
  • 响应结果:
{
  "code": 200,
  "msg": "审核操作成功",
  "data": null
}

角色权限说明

角色与权限对应关系

角色 权限标识 说明
信息审核员 zsjy:enrollment:process:audit 负责信息审核环节
录取处理员 zsjy:enrollment:process:audit 负责录取处理环节
最终确认员 zsjy:enrollment:process:audit 负责最终确认环节
管理员 所有权限 可执行所有操作

待我审核功能权限逻辑

  1. 信息审核员:

    • 可以看到当前状态为"待审核(0)"或"信息审核中(1)"且信息审核状态为"待审核(0)"的数据
    • 可以执行信息审核操作

  2. 录取处理员:

    • 可以看到当前状态为"录取处理中(2)"且录取处理状态为"待处理(0)"的数据
    • 可以执行录取处理操作和缴费确认操作

  3. 最终确认员:

    • 可以看到当前状态为"待最终确认(3)"且最终审核状态为"待确认(0)"的数据
    • 可以执行最终确认操作和完成录取操作

错误码说明

错误码 错误信息 说明
500 系统内部错误 服务器内部错误
400 请求参数错误 请求参数不符合要求
401 未授权 用户未登录或token已过期
403 没有权限 用户没有操作权限
404 资源不存在 请求的资源不存在
1001 流程状态错误 当前流程状态不允许执行该操作
1002 用户角色权限不足 当前用户角色没有执行该操作的权限
1003 流程已被其他用户处理 流程已被其他用户处理

更新记录

版本号 更新日期 更新人 更新内容
1.0.0 2025-07-01 wuzhen 初始版本，包含基本的流程管理接口
1.1.0 2025-07-01 wuzhen 新增待我审核接口，支持按用户角色过滤数据