all-project/web/src/api/zsjy

招生就业管理模块 - API接口

📋 模块说明

• 模块名称: 招生就业管理 (Enrollment and Employment Management)
• 模块简称: zsjy
• 对应后端: backend/ruoyi-modules/ruoyi-zsjy/
• 对应前端: web/src/views/zsjy/

📁 目录结构

此目录用于存放招生就业管理模块的所有API接口定义，建议按功能模块细分：

📝 报名管理 (enrollment/)

• enrollment/index.ts - 报名信息管理API
• enrollment/types.ts - 报名信息类型定义
• 招生报名、信息管理、状态查询

📋 录取流程 (admission/)

• admission/index.ts - 录取流程管理API
• 审核流程、录取处理、状态跟踪

🏫 专业管理 (major/)

• major/index.ts - 专业信息管理API
• 专业设置、招生计划、专业介绍

👨‍🎓 学生管理 (student/)

• student/index.ts - 学生档案管理API
• 学生档案、入学管理、学籍管理

📊 数据统计 (statistics/)

• statistics/index.ts - 招生统计分析API
• 招生数据分析、报表生成、趋势分析

💼 就业管理 (employment/)

• employment/index.ts - 就业管理API
• 就业指导、企业合作、就业统计

🎯 API规范

• 统一使用TypeScript定义接口类型
• 请求路径前缀：/zsjy/
• 权限编码格式：zsjy:功能:操作
• 统一使用request工具发送请求
• 分页查询统一使用TableDataInfo响应格式

📝 接口示例

// 报名信息查询接口
export interface EnrollmentInfoQuery {
  pageNum?: number;
  pageSize?: number;
  name?: string;
  idCard?: string;
  gender?: string;
  enrollmentStatus?: string;
  appliedMajor?: string;
}

export interface EnrollmentInfoVO {
  id: string | number;
  name: string;
  idCard: string;
  gender: string;
  phone1: string;
  appliedMajor: string;
  enrollmentStatus: string;
  applicationTime: string;
  createTime: string;
}

// 获取报名信息列表
export function listEnrollmentInfo(query: EnrollmentInfoQuery) {
  return request({
    url: '/zsjy/enrollment/info/list',
    method: 'get',
    params: query
  });
}

📝 注意事项

• 所有接口类型定义需要与后端VO对象保持一致
• 分页查询统一使用TableDataInfo响应格式
• 招生相关数据需要严格的权限控制
• 学生隐私信息需要特别保护
• 权限控制使用@SaCheckPermission注解，权限编码格式：zsjy:功能:操作

🔗 相关模块

• 学工管理模块 (xg) - 学生档案管理
• 系统管理模块 (system) - 用户权限管理
• 工作流模块 (workflow) - 审核流程管理

📱 移动端支持

部分接口支持移动端访问，主要包括：

• 学生在线报名
• 报名状态查询
• 录取结果查询
• 就业信息填报

权限编码格式：zsjy:mobile:功能