招生就业开发备份@wuzhen

This commit is contained in:
wuzhen committed 2025-07-19 18:56:47 +08:00
1 parent ccffeb3eff
commit 4a7021226e
61 files changed
+15656 -819

No files matched your search

+65 -50
View File
@@ -2,7 +2,7 @@
## 📋 模块说明
- **模块名称**: 招生就业管理 (Enrollment & Employment Management)
- **模块名称**: 招生就业管理 (Enrollment and Employment Management)
- **模块简称**: zsjy
- **对应后端**: backend/ruoyi-modules/ruoyi-zsjy/
- **对应前端**: web/src/views/zsjy/
@@ -11,35 +11,36 @@
此目录用于存放招生就业管理模块的所有API接口定义,建议按功能模块细分:
### 📋 招生管理 (enrollment/)
### 📝 报名管理 (enrollment/)
- `enrollment/index.ts` - 招生管理API
- 招生计划、报名管理、考试安排、录取管理
- `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
- 就业信息发布、就业指导、就业跟踪
### 🏢 企业管理 (enterprise/)
- `enterprise/index.ts` - 企业管理API
- 合作企业、招聘信息、校企合作
### 🎯 职业规划 (career/)
- `career/index.ts` - 职业规划API
- 职业测评、简历管理、面试指导
### 🤝 校企合作 (cooperation/)
- `cooperation/index.ts` - 校企合作API
- 实习基地、合作项目、实习管理
### 📊 统计分析 (statistics/)
- `statistics/index.ts` - 招生就业统计API
- 招生统计、就业率统计、质量分析
- 就业指导、企业合作、就业统计
## 🎯 API规范
@@ -47,40 +48,38 @@
- 请求路径前缀:`/zsjy/`
- 权限编码格式:`zsjy:功能:操作`
- 统一使用request工具发送请求
- 分页查询统一使用TableDataInfo响应格式
## 📝 接口示例
```typescript
// 招生计划查询接口
export interface EnrollmentPlanQuery {
// 报名信息查询接口
export interface EnrollmentInfoQuery {
pageNum?: number;
pageSize?: number;
planName?: string;
major?: string;
enrollmentYear?: number;
status?: string;
name?: string;
idCard?: string;
gender?: string;
enrollmentStatus?: string;
appliedMajor?: string;
}
export interface EnrollmentPlanVO {
id: number;
planName: string;
planCode: string;
major: string;
majorCode: string;
enrollmentYear: number;
plannedNumber: number;
actualNumber: number;
remainingNumber: number;
startDate: string;
endDate: string;
status: 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 listEnrollmentPlan(query: EnrollmentPlanQuery) {
// 获取报名信息列表
export function listEnrollmentInfo(query: EnrollmentInfoQuery) {
return request({
url: '/zsjy/enrollment/plan/list',
url: '/zsjy/enrollment/info/list',
method: 'get',
params: query
});
@@ -91,6 +90,22 @@ export function listEnrollmentPlan(query: EnrollmentPlanQuery) {
- 所有接口类型定义需要与后端VO对象保持一致
- 分页查询统一使用TableDataInfo响应格式
- 非分页接口使用R类型响应格式
- 招生和就业数据需要确保准确性和时效性
- 学生和企业信息需要适当的隐私保护
- 招生相关数据需要严格的权限控制
- 学生隐私信息需要特别保护
- 权限控制使用@SaCheckPermission注解,权限编码格式:zsjy:功能:操作
## 🔗 相关模块
- 学工管理模块 (xg) - 学生档案管理
- 系统管理模块 (system) - 用户权限管理
- 工作流模块 (workflow) - 审核流程管理
## 📱 移动端支持
部分接口支持移动端访问,主要包括:
- 学生在线报名
- 报名状态查询
- 录取结果查询
- 就业信息填报
权限编码格式:`zsjy:mobile:功能`
+124
View File
@@ -0,0 +1,124 @@
import request from '@/utils/request';
import { AxiosPromise } from 'axios';
import { EnrollmentInfoVO, EnrollmentInfoForm, EnrollmentInfoQuery } from './types';
/**
* 查询招生报名信息列表
* @param query
* @returns {*}
*/
export const listEnrollmentInfo = (query: EnrollmentInfoQuery): AxiosPromise<EnrollmentInfoVO[]> => {
return request({
url: '/zsjy/enrollment/info/list',
method: 'get',
params: query
});
};
/**
* 查询招生报名信息详细
* @param id
*/
export const getEnrollmentInfo = (id: string | number): AxiosPromise<EnrollmentInfoVO> => {
return request({
url: '/zsjy/enrollment/info/' + id,
method: 'get'
});
};
/**
* 新增招生报名信息
* @param data
*/
export const addEnrollmentInfo = (data: EnrollmentInfoForm) => {
return request({
url: '/zsjy/enrollment/info',
method: 'post',
data: data
});
};
/**
* 修改招生报名信息
* @param data
*/
export const updateEnrollmentInfo = (data: EnrollmentInfoForm) => {
return request({
url: '/zsjy/enrollment/info',
method: 'put',
data: data
});
};
/**
* 删除招生报名信息
* @param id
*/
export const delEnrollmentInfo = (id: string | number | Array<string | number>) => {
return request({
url: '/zsjy/enrollment/info/' + id,
method: 'delete'
});
};
/**
* 根据身份证号和准考证号查询报名信息
* @param idCard 身份证号
* @param examNumber 准考证号
*/
export const queryEnrollmentByInfo = (idCard?: string, examNumber?: string): AxiosPromise<EnrollmentInfoVO> => {
return request({
url: '/zsjy/enrollment/info/query',
method: 'get',
params: {
idCard,
examNumber
}
});
};
/**
* 导出招生报名信息
* @param query
*/
export const exportEnrollmentInfo = (query: EnrollmentInfoQuery) => {
return request({
url: '/zsjy/enrollment/info/export',
method: 'post',
data: query
});
};
/**
* 获取可用的招生报名信息选项
*/
export const getEnrollmentInfoOptions = (): AxiosPromise<EnrollmentInfoVO[]> => {
return request({
url: '/zsjy/enrollment/info/options',
method: 'get'
});
};
/**
* 提交报名信息(供学生端使用)
* @param data
*/
export const submitEnrollmentApplication = (data: EnrollmentInfoForm) => {
return request({
url: '/zsjy/enrollment/info/submit',
method: 'post',
data: data
});
};
/**
* 查询我的报名状态(供学生端使用)
* @param params 查询参数
*/
export const queryMyEnrollmentStatus = (params: { idCard?: string, examNumber?: string }): AxiosPromise<EnrollmentInfoVO> => {
return request({
url: '/zsjy/enrollment/info/myStatus',
method: 'get',
params: params
});
};
+375
View File
@@ -0,0 +1,375 @@
export interface EnrollmentInfoVO {
/**
* 主键ID
*/
id: string | number;
/**
* 姓名
*/
name: string;
/**
* 身份证号
*/
idCard: string;
/**
* 性别(M-男 F-女)
*/
gender: string;
/**
* 是否住校(0-否 1-是)
*/
isBoarding: number;
/**
* 出生年月
*/
birthDate: string;
/**
* 联系手机号码1
*/
phone1: string;
/**
* 联系手机号码2
*/
phone2: string;
/**
* 民族
*/
nation: string;
/**
* 家庭地址
*/
homeAddress: string;
/**
* 初中毕业学校
*/
middleSchool: string;
/**
* 准考证号码
*/
examNumber: string;
/**
* 参加中考地区
*/
examRegion: string;
/**
* 当地中考满分
*/
totalScoreFull: number;
/**
* 考生中考成绩(含体育)
*/
totalScore: number;
/**
* 语文成绩
*/
chineseScore: number;
/**
* 数学成绩
*/
mathScore: number;
/**
* 英语成绩
*/
englishScore: number;
/**
* 科学成绩
*/
scienceScore: number;
/**
* 社会成绩
*/
socialScore: number;
/**
* 体育成绩
*/
peScore: number;
/**
* 报考专业
*/
appliedMajor: string;
/**
* 专业代码
*/
majorCode: string;
/**
* 校服尺码
*/
uniformSize: string;
/**
* 健康情况
*/
healthStatus: string;
/**
* 特长
*/
specialties: string;
/**
* 奖惩情况
*/
awards: string;
/**
* 报名状态(0-待审核 1-信息审核中 2-录取处理中 3-待最终确认 4-录取完成 9-已驳回)
*/
enrollmentStatus: string;
/**
* 报名时间
*/
applicationTime: string;
/**
* 二维码来源标识
*/
qrCodeSource: string;
/**
* 创建者
*/
createBy: number;
/**
* 创建时间
*/
createTime: string;
/**
* 更新者
*/
updateBy: number;
/**
* 更新时间
*/
updateTime: string;
}
export interface EnrollmentInfoForm extends BaseEntity {
/**
* 主键ID
*/
id?: string | number;
/**
* 姓名
*/
name?: string;
/**
* 身份证号
*/
idCard?: string;
/**
* 性别(M-男 F-女)
*/
gender?: string;
/**
* 是否住校(0-否 1-是)
*/
isBoarding?: number;
/**
* 出生年月
*/
birthDate?: string;
/**
* 联系手机号码1
*/
phone1?: string;
/**
* 联系手机号码2
*/
phone2?: string;
/**
* 民族
*/
nation?: string;
/**
* 家庭地址
*/
homeAddress?: string;
/**
* 初中毕业学校
*/
middleSchool?: string;
/**
* 准考证号码
*/
examNumber?: string;
/**
* 参加中考地区
*/
examRegion?: string;
/**
* 当地中考满分
*/
totalScoreFull?: number;
/**
* 考生中考成绩(含体育)
*/
totalScore?: number;
/**
* 语文成绩
*/
chineseScore?: number;
/**
* 数学成绩
*/
mathScore?: number;
/**
* 英语成绩
*/
englishScore?: number;
/**
* 科学成绩
*/
scienceScore?: number;
/**
* 社会成绩
*/
socialScore?: number;
/**
* 体育成绩
*/
peScore?: number;
/**
* 报考专业
*/
appliedMajor?: string;
/**
* 专业代码
*/
majorCode?: string;
/**
* 校服尺码
*/
uniformSize?: string;
/**
* 健康情况
*/
healthStatus?: string;
/**
* 特长
*/
specialties?: string;
/**
* 奖惩情况
*/
awards?: string;
/**
* 报名状态(0-待审核 1-信息审核中 2-录取处理中 3-待最终确认 4-录取完成 9-已驳回)
*/
enrollmentStatus?: string;
/**
* 报名时间
*/
applicationTime?: string;
/**
* 二维码来源标识
*/
qrCodeSource?: string;
}
export interface EnrollmentInfoQuery extends PageQuery {
/**
* 姓名
*/
name?: string;
/**
* 身份证号
*/
idCard?: string;
/**
* 性别(M-男 F-女)
*/
gender?: string;
/**
* 准考证号码
*/
examNumber?: string;
/**
* 报考专业
*/
appliedMajor?: string;
/**
* 专业代码
*/
majorCode?: string;
/**
* 报名状态
*/
enrollmentStatus?: string;
/**
* 联系手机号码1
*/
phone1?: string;
/**
* 参加中考地区
*/
examRegion?: string;
/**
* 报名时间范围
*/
params?: any;
}
+454
View File
@@ -0,0 +1,454 @@
import request from '@/utils/request'
import { AxiosPromise } from 'axios'
export interface EnrollmentProcessVO {
/**
* 主键ID
*/
id: string | number
/**
* 报名信息ID,关联zsjy_enrollment_info.id
*/
enrollmentId: number
/**
* 学生姓名
*/
studentName: string
/**
* 身份证号
*/
idCard: string
/**
* 当前状态(0-待审核 1-信息审核中 2-录取处理中 3-待最终确认 4-录取完成 9-已驳回)
*/
currentStatus: string
/**
* 当前处理人ID
*/
currentHandler: number
/**
* 当前处理人姓名
*/
currentHandlerName: string
/**
* 信息审核状态(0-待审核 1-审核通过 9-审核驳回)
*/
infoAuditStatus: string
/**
* 信息审核人ID
*/
infoAuditUser: number
/**
* 信息审核人姓名
*/
infoAuditUserName: string
/**
* 信息审核时间
*/
infoAuditTime: string
/**
* 信息审核意见
*/
infoAuditOpinion: string
/**
* 录取处理状态(0-待处理 1-处理完成 9-处理驳回)
*/
admissionStatus: string
/**
* 录取处理人ID
*/
admissionUser: number
/**
* 录取处理人姓名
*/
admissionUserName: string
/**
* 录取处理时间
*/
admissionTime: string
/**
* 缴费状态(0-未缴费 1-已缴费)
*/
paymentStatus: string
/**
* 缴费确认时间
*/
paymentConfirmTime: string
/**
* 录取通知书号码
*/
noticeNumber: string
/**
* 录取处理意见
*/
admissionOpinion: string
/**
* 最终审核状态(0-待确认 1-确认通过 9-确认驳回)
*/
finalAuditStatus: string
/**
* 最终审核人ID
*/
finalAuditUser: number
/**
* 最终审核人姓名
*/
finalAuditUserName: string
/**
* 最终审核时间
*/
finalAuditTime: string
/**
* 最终审核意见
*/
finalAuditOpinion: string
/**
* 是否完成录取(0-未完成 1-已完成)
*/
isCompleted: number
/**
* 录取完成时间
*/
completionTime: string
/**
* 备注
*/
remark: string
/**
* 创建时间
*/
createTime: string
/**
* 更新时间
*/
updateTime: string
}
export interface EnrollmentProcessForm extends BaseEntity {
/**
* 主键ID
*/
id?: string | number
/**
* 报名信息ID,关联zsjy_enrollment_info.id
*/
enrollmentId?: number
/**
* 学生姓名
*/
studentName?: string
/**
* 身份证号
*/
idCard?: string
/**
* 当前状态(0-待审核 1-信息审核中 2-录取处理中 3-待最终确认 4-录取完成 9-已驳回)
*/
currentStatus?: string
/**
* 当前处理人ID
*/
currentHandler?: number
/**
* 当前处理人姓名
*/
currentHandlerName?: string
/**
* 信息审核状态(0-待审核 1-审核通过 9-审核驳回)
*/
infoAuditStatus?: string
/**
* 信息审核意见
*/
infoAuditOpinion?: string
/**
* 录取处理状态(0-待处理 1-处理完成 9-处理驳回)
*/
admissionStatus?: string
/**
* 缴费状态(0-未缴费 1-已缴费)
*/
paymentStatus?: string
/**
* 录取通知书号码
*/
noticeNumber?: string
/**
* 录取处理意见
*/
admissionOpinion?: string
/**
* 最终审核状态(0-待确认 1-确认通过 9-确认驳回)
*/
finalAuditStatus?: string
/**
* 最终审核意见
*/
finalAuditOpinion?: string
/**
* 是否完成录取(0-未完成 1-已完成)
*/
isCompleted?: number
/**
* 备注
*/
remark?: string
}
export interface EnrollmentProcessQuery extends PageQuery {
/**
* 报名信息ID,关联zsjy_enrollment_info.id
*/
enrollmentId?: number
/**
* 学生姓名
*/
studentName?: string
/**
* 身份证号
*/
idCard?: string
/**
* 当前状态(0-待审核 1-信息审核中 2-录取处理中 3-待最终确认 4-录取完成 9-已驳回)
*/
currentStatus?: string
/**
* 当前处理人ID
*/
currentHandler?: number
/**
* 信息审核状态(0-待审核 1-审核通过 9-审核驳回)
*/
infoAuditStatus?: string
/**
* 录取处理状态(0-待处理 1-处理完成 9-处理驳回)
*/
admissionStatus?: string
/**
* 最终审核状态(0-待确认 1-确认通过 9-确认驳回)
*/
finalAuditStatus?: string
/**
* 是否完成录取(0-未完成 1-已完成)
*/
isCompleted?: number
/**
* 日期范围参数
*/
params?: any
}
// 查询录取流程状态列表
export const listEnrollmentProcess = (query: EnrollmentProcessQuery): AxiosPromise<EnrollmentProcessVO[]> => {
return request({
url: '/zsjy/enrollmentProcess/list',
method: 'get',
params: query
})
}
// 查询录取流程状态详细
export const getEnrollmentProcess = (id: string | number): AxiosPromise<EnrollmentProcessVO> => {
return request({
url: '/zsjy/enrollmentProcess/' + id,
method: 'get'
})
}
// 新增录取流程状态
export const addEnrollmentProcess = (data: EnrollmentProcessForm) => {
return request({
url: '/zsjy/enrollmentProcess',
method: 'post',
data: data
})
}
// 修改录取流程状态
export const updateEnrollmentProcess = (data: EnrollmentProcessForm) => {
return request({
url: '/zsjy/enrollmentProcess',
method: 'put',
data: data
})
}
// 删除录取流程状态
export const delEnrollmentProcess = (id: string | number | Array<string | number>) => {
return request({
url: '/zsjy/enrollmentProcess/' + id,
method: 'delete'
})
}
// 根据报名信息ID查询流程状态
export const getProcessByEnrollmentId = (enrollmentId: number): AxiosPromise<EnrollmentProcessVO> => {
return request({
url: '/zsjy/enrollmentProcess/enrollment/' + enrollmentId,
method: 'get'
})
}
// 查询我的待处理流程
export const getPendingProcessList = (): AxiosPromise<EnrollmentProcessVO[]> => {
return request({
url: '/zsjy/enrollmentProcess/pending',
method: 'get'
})
}
// 根据流程状态查询流程列表
export const getProcessByStatus = (status: string): AxiosPromise<EnrollmentProcessVO[]> => {
return request({
url: '/zsjy/enrollmentProcess/status/' + status,
method: 'get'
})
}
// 统计各状态的流程数量
export const getProcessStatistics = (): AxiosPromise<any[]> => {
return request({
url: '/zsjy/enrollmentProcess/statistics',
method: 'get'
})
}
// 根据关键词搜索流程
export const searchProcess = (keyword: string): AxiosPromise<EnrollmentProcessVO[]> => {
return request({
url: '/zsjy/enrollmentProcess/search',
method: 'get',
params: { keyword }
})
}
// 信息审核
export const infoAudit = (data: { id: number; auditResult: string; auditOpinion?: string }) => {
return request({
url: '/zsjy/enrollmentProcess/infoAudit',
method: 'post',
data: data
})
}
// 录取处理
export const admissionProcess = (data: {
id: number;
processResult: string;
processOpinion?: string;
noticeNumber?: string
}) => {
return request({
url: '/zsjy/enrollmentProcess/admissionProcess',
method: 'post',
data: data
})
}
// 缴费确认
export const confirmPayment = (id: number) => {
return request({
url: '/zsjy/enrollmentProcess/confirmPayment',
method: 'post',
data: { id }
})
}
// 最终审核
export const finalAudit = (data: { id: number; auditResult: string; auditOpinion?: string }) => {
return request({
url: '/zsjy/enrollmentProcess/finalAudit',
method: 'post',
data: data
})
}
// 完成录取
export const completeEnrollment = (id: number) => {
return request({
url: '/zsjy/enrollmentProcess/complete',
method: 'post',
data: { id }
})
}
// 驳回流程
export const rejectProcess = (data: { id: number; rejectReason: string }) => {
return request({
url: '/zsjy/enrollmentProcess/reject',
method: 'post',
data: data
})
}
// 重置流程状态
export const resetProcess = (id: number) => {
return request({
url: '/zsjy/enrollmentProcess/reset',
method: 'post',
data: { id }
})
}
// 导出录取流程状态
export const exportEnrollmentProcess = (query: EnrollmentProcessQuery) => {
return request({
url: '/zsjy/enrollmentProcess/export',
method: 'post',
data: query
})
}