教务系统相关接口

最新推荐文章于 2021-10-16 19:30:38 发布

ThereIsNoBugAnymore

最新推荐文章于 2021-10-16 19:30:38 发布

阅读量1.7k

点赞数 1

本文链接：https://blog.csdn.net/ysuprogrammer_li/article/details/105579291

版权

学生端

1. 登录

请求地址: http://localhost:8080/student/login

参数	描述
account	学生帐号
pwd	登录密码

返回值

{
    "status_code":200,
    "data":{
        "sex":"男",	//性别
        "name":"1",	//姓名
        "id":"student1",	//id
        "pwd":"1",	//密码
        "account":"1",	//账户
        "role": "student"
    },
    "message":null
}

2. 课程管理

2.1 获取当前未参加课程

请求地址：http://localhost:8080/student/getCourseNotJoin

参数	描述
studentId	学生id

返回值

{
    "status_code":200,
    "data":[
        {
            "day":"2",	//天
            "section": "1",	//节
            "teacherId":"teacher1",	//教师id
            "name":"2",	//课程名
            "id":"course2"	//课程Id
        }
    ],
    "message":null
}

2.2 参加课程

请求地址：http://localhost:8080/student/joinCourse

参数	描述
studentId	学生id
courseId	课程id

2.3 退课

请求地址：http://localhost:8080/student/quitCourse

参数	描述
studentId	学生id
courseId	课程id

2.4 获取已参加课程

请求地址：http://localhost:8080/student/getCourseByStudentId

参数	描述
id	学生id

返回值

{
    "status_code":200,
    "data":[
        {
            "day":"2",	//天
            "section": "1",	//节
            "teacherId":"teacher1",	//教师id
            "name":"1",	//课程名
            "id":"course1"	//课程id
        },
        {
            "day":"2",	//天
            "section": "1",	//节
            "teacherId":"teacher1",
            "name":"2",
            "id":"course2"
        }
    ],
    "message":null
}

2.5 课程搜索

请求地址：http://localhost:8080/student/searchCourse

参数	描述
studentId	学生id
key	查询关键字

返回值

{
    "status_code":200,
    "data":{
        "notJoin":[	//未参加课程列表
            {
                "name":"英语",
                "section":2,
                "id":"course1",
                "day":5
            }
        ],
        "hasJoin":[	//已参加课程列表
            {
                "name":"英语",
                "section":2,
                "id":"course2",
                "day":5
            }
        ]
    },
    "message":null
}

3. 成绩/评价

3.1 获取全部科目成绩/评价信息

请求地址：http://localhost:8080/student/getStudentScore

参数	描述
studentId	学生id

返回值

{
    "status_code":200,
    "data":[
        {
            "studentId":"student1",	//学生id
            "evaluation":"评价信息",	//评价信息
            "score":20,	//科目成绩
            "courseName":"1",	//课程名
            "studentName":"1",	//学生名
            "courseId":"course1"	//课程id
        },
        {
            "studentId":"student1",
            "evaluation":null,
            "score":0,
            "courseName":"2",
            "studentName":"1",
            "courseId":"course2"
        }
    ],
    "message":null
}

3.2 评教

请求地址：http://localhost:8080/student/setEvaluation

参数	描述
courseId	课程id
studentId	学生id
evaluation	评价信息

4. 签到考勤

4.1 获取未签到课程

请求地址：http://localhost:8080/student/getCourseNotSign

参数	描述
studentId	学生id

返回值

{
	"status_code":200,
	"data":[
		{
			"courseName":"1",	//课程名
			"courseId":"course1",	//课程id
			"hasSign":false,	//今日是否已签，已签则为true
			"status":null	//若今日已签，则表示签到状态（已签/请假）
		}
	],
	"message":null
}

4.2 课程签到

请求地址：http://localhost:8080/student/sign

参数	描述
courseId	课程id
studentId	学生id
status	签到状态（签到/请假）
place	地点
tips	请假理由

5. 课程表

请求地址：http://localhost:8080/student/getCourseTable

参数	描述
studentId	学生id

返回结果

{
    "status_code":200,
    "data":[
        {
            "courseName":"",	//课程名
            "section":1,	//节
            "place":"",	//地点
            "day":1	//天
        },
        {
            "courseName":"",
            "section":2,
            "place":"",
            "day":1
        },
        ......
    ],
    "message":null
}

教师端

1. 登录

请求地址: http://localhost:8080/teacher/login

参数	描述
account	教师帐号
pwd	登录密码

返回值

{
	"status_code":200,
	"data":{
		"sex":"女",	//性别
		"name":"1",	//姓名
		"id":"teacher1",	//id
		"pwd":"1",	//密码
		"account":"1",	//账号
		"role":"teacher"
	},
	"message":null
}

2. 成绩管理

2.1 查询教师所教授课程列表

请求地址：http://localhost:8080/teacher/getTeacherCourse

参数	描述
id	教师id

返回值

{
	"status_code":200,
	"data":[
	{
		"day":"2",	//天
        "section": "1",	//节
		"teacherId":"teacher1",	//教师id
		"name":"1",	//课程名称
		"id":"course1"	//课程id
	},
	{
		"day":"2",
        "section": "1",
		"teacherId":"teacher1",
		"name":"2",
		"id":"course2"
	}],
	"message":null
}

2.2 查询课程学生名单

请求地址：http://localhost:8080/teacher/getStudentList

参数	描述
courseId	课程id

返回值

{
	"status_code":200,
	"data":[
		{
		    "politics":"群众",
		    "nation":"汉族",
		    "subject":"软件工程",
		    "sex":"男",
		    "birth":"2020-04-28",
		    "score":0,
		    "phone":"13999999999",
		    "name":"1",
		    "id":"student1",
		    "pwd":"1",
		    "region":"北京市通州市",
		    "idNum":"123456789012345678",
		    "account":"1",
		    "email":"12345@qq.com"
		},
		......
	],
	"message":null
}

2.3 添加成绩

请求地址：http://localhost:8080/teacher/updateScore

参数	描述
courseId	课程id
studentId	学生id
score	成绩

3. 查看考勤状态

请求地址：http://localhost:8080/teacher/getSignStatus

参数	描述
courseId	课程id
date	日期（时间格式 yyyy-MM-dd）

返回值

{
	"status_code":200,
	"data":[
		{
			"date":"2020-04-16",	//签到日期
			"sex":"男",	//学生性别
			"name":"1",	//学生姓名
			"id":"student1",	//学生id
			"place":"xxx",	//签到地点
			"time":"13:49:04",	//签到时间
			"pwd":null,	//密码（为空）
			"account":"1",	//学生账户
			"tips":"xxx",	//请假理由
			"status":"请假"	//状态（签到/请假，为空时表示学生未签到）
		}
	],
	"message":null
}

4. 课程管理

4.1 查询教师所负责课程

同 2.1

4.2 查看课程学生名单

同 2.2

5. 查看评教

5.1 查询教师负责课程

同 2.1

5.2 查询课程评价

请求地址：http://localhost:8080/teacher/getEvaluation

参数	描述
courseId	课程id

返回值

{
	"status_code":200,
	"data":[
		{
			"studentId":"student1",	//学生id
			"evaluation":"评价信息",	//评价内容
			"score":20,	//学生成绩
			"id":"namelist1",	//数据库中namelistid
			"courseId":"course1"	//课程id
		}
	],
	"message":null
}

6. 课程表

请求地址：http://localhost:8080/teacher/getCourseTable
返回值：

参数	描述
teacherId	教师id

{
    "status_code":200,
    "data":[
        {
            "courseName":"",	//课程名
            "section":1,	//节
            "place":"",	//地点
            "day":1	//天
        },
        {
            "courseName":"",
            "section":2,
            "place":"",
            "day":1
        },
        ......
    ],
    "message":null
}

管理端

1. 登录

请求地址：http://localhost:8080/admin/login

参数	描述
account	管理员账户
pwd	登录密码

2. 信息管理

2.1 学生信息管理

2.1.1 查看全部学生

请求地址：http://localhost:8080/admin/getAllStudent
返回值

{
	"status_code":200,
	"data":[
		{
			"politics":"群众",	
            "nation":"汉族",
            "subject":"计算机",
            "sex":"男",
            "birth":"2020-05-06",
            "email":"101@qq.com",
            "name":"学生4",
            "id":"d3d61ef4-2a1f-43f2-9567-97e3d4cbd15d",
            "pwd":"4",
            "region":"北京市北京市东城区",
            "idNum":"123432",
            "account":"4",
            "phone":"18888888888"
		},
		......
	],
	"message":null
}

2.1.2 添加学生

请求地址：http://localhost:8080/admin/addStudent

参数	描述
account	注册账户
name	姓名
sex	性别
pwd	密码
birth	出生日期
region	籍贯
politics	政治面貌
nation	民族
subject	专业
idNum	身份证号
email	邮箱
phone	联系方式

2.1.3 修改学生

请求地址：http://localhost:8080/admin/updateStudent

参数	描述
studentId	学生id
account	账户
name	姓名
sex	性别
pwd	密码
birth	出生日期
region	籍贯
politics	政治面貌
nation	民族
subject	专业
idNum	身份证号
email	邮箱
phone	联系方式

2.1.4 删除学生

请求地址：http://localhost:8080/admin/delStudent

参数	描述
studentId	学生id

2.1.5 查找学生

请求地址：http://localhost:8080/admin/searchStudent

参数	描述
key	查询关键字

返回值

同2.1.1返回值

2.2 教师信息管理

2.2.1 查看全部教师

请求地址：http://localhost:8080/admin/getAllTeacher
返回值

{
    "status_code":200,
    "data":[
        {
            "politics":"党员",
            "sex":"女",
            "name":"1",
            "birth":"2020-04-28",
            "id":"teacher1",	//id
            "pwd":"1",
            "region":"北京市",
            "account":"1"	//工号
        }
        ......
    ],
    "message":null
}

2.2.2 添加教师

请求地址：http://localhost:8080/admin/addTeacher

参数	描述
account	注册账户
name	姓名
sex	性别
pwd	密码
birth	出生日期
region	籍贯
politics	政治面貌

2.2.3 修改教师

请求地址：http://localhost:8080/admin/updateTeacher

参数	描述
teacherId	教师id
account	账户
name	姓名
sex	性别
pwd	密码
birth	出生日期
region	籍贯
politics	政治面貌

2.2.4 删除教师

请求地址：http://localhost:8080/admin/delTeacher

参数	描述
teacherId	教师id

2.2.5 查找教师

请求地址：http://localhost:8080/admin/searchTeacher

参数	描述
key	查询关键字

返回值

同2.2.1返回值

2.3 课程管理

2.3.1 获取全部课程

请求地址：http://localhost:8080/admin/getAllCourse
返回值

{
    "status_code":200,
    "data":[
        {
            "teacherName":"5",	//教师
            "name":"测试课程",	//课程名
            "id":"0303ae3e-6f86-4ac3-be99-a6639d102b7d"	//课程id
        },
        {
            "teacherName":"1",
            "name":"1",
            "id":"course1"
        },
        {
            "teacherName":"1",
            "name":"2",
            "id":"course2"
        }
    ],
    "message":null
}

2.3.2 添加课程

请求地址：http://localhost:8080/admin/addCourse

参数	描述
name	课程名
teacherId	教师id
~~date~~	时间

2.3.3 修改课程

请求地址：http://localhost:8080/admin/updateCourse

参数	描述
courseId	课程id
name	课程名
teacherId	教师id
~~date~~	~~上课时间~~

2.2.4 删除课程

请求地址：http://localhost:8080/admin/delCourse

参数	描述
courseId	课程id

2.3.5 查找课程

请求地址：http://localhost:8080/admin/searchCourse

参数	描述
key	查询关键字

返回值

同2.3.1返回值

3. 考勤管理

3.1 获取全部课程

同2.3.1

3.2 获取课程签到状况

请求地址：http://localhost:8080/admin/getStudentSignStatus

参数	描述
courseId	课程id
date	日期（格式yyyy-MM-dd）

返回值

{
    "status_code":200,
    "data":[
    	//请假
        {
            "date":"2020-04-23",	//签到日期
            "name":"1",	//学生姓名
            "id":"student1",	//学生id
            "time":"10:56:07",	//签到时间
            "account":"1",	//账户
            "tips":"请假理由",	//请假理由
            "status":"请假",	//状态
            "isPassed": "通过"	//审核状态
        },
        // 签到
        {
            "date":"2020-04-23",
            "name":"1",
            "id":"student1",
            "time":"10:56:07",
            "account":"1",
            "status":"已签"
        },
        // 旷课
        {
            "name":"1",
            "id":"student1",
            "account":"1",
            "status":"旷课"
        }
    ],
    "message":null
}

3.3 修改课程签到状况

请求地址：http://localhost:8080/admin/updateSignStatus

参数	描述
courseId	课程id
studentId	学生id
date	日期（格式yyyy-MM-dd）
status	修改后状态

3.4 提交请假审核

请求地址：http://localhost:8080/admin/updatePassed

参数	描述
courseId	课程id
studentId	学生id
date	日期（格式yyyy-MM-dd）
isPassed	审核状态

4. 成绩及评教管理

4.1 获取全部课程

同2.3.1

4.2 获取某科目成绩及评价

请求地址：http://localhost:8080/admin/getScoreAndEvaluation

参数	描述
courseId	课程id

返回值

{
    "status_code":200,
    "data":[
        {
            "studentId":"student1",	//学生Id
            "evaluation":"评价信息",	//评价信息
            "score":20,	//成绩
            "studentName":"1",	//学生姓名
            "id":"namelist1",	//学生id
            "courseId":"course1",	//课程id
            "studentAccount":"1"	//学生账户
        }
    ],
    "message":null
}

5. 成绩管理

5.1 查看成绩

5.1.1 根据学生id查询

请求地址：http://localhost:8080/admin/getScore

参数	描述
studentId	学生id

返回值

{
    "status_code":200,
    "data":[
        {
            "score":"50",	//成绩
            "courseName":"2",	//课程名
            "courseId":"course2"	//课程id
        },
        {
            "score":"成绩未公布",
            "courseName":"测试课程",
            "courseId":"0303ae3e-6f86-4ac3-be99-a6639d102b7d"
        },
        {
            "score":"成绩未公布",
            "courseName":"1",
            "courseId":"course1"
        }
    ],
    "message":null
}

5.1.2 根据学生账户查询

请求地址：http://localhost:8080/admin/getScoreByStudentAccount

参数	描述
studentAccount	学生学号

返回值同上

5.2 修改成绩

请求地址：http://localhost:8080/admin/updateScore

参数	描述
courseId	课程id
studentId	学生id
score	分数

5.3 删除成绩

请求地址：http://localhost:8080/admin/delScore

参数	描述
courseId	课程id
studentId	学生id

6. 教室管理

6.1 添加教室

请求地址：http://localhost:8080/admin/addClassroom

参数	描述
place	地点
capcity	容量

6.2 修改教室

请求地址：http://localhost:8080/admin/updateClassroom

参数	描述
classroomId	教室id
place	新地点
capcity	新容量

6.3 删除教室

请求地址：http://localhost:8080/admin/delClassroom

参数	描述
classroomId	教室id

6.4 获取教室列表

请求地址：http://localhost:8080/admin/getAllClassroom
返回值

{
    "status_code":200,
    "data":[
        {
            "capcity":30,	//教室容量
            "id":"f456c767-dbc5-4b93-acc0-c92da41a279f",	//教室id
            "place":"一教223"	//教室地点
        },
        ......
    ],
    "message":null
}

6.5 查询教室

请求地址：http://localhost:8080/admin/searchClassroom
返回值

{
    "status_code":200,
    "data":[
        {
            "capcity":30,	//教室容量
            "id":"f456c767-dbc5-4b93-acc0-c92da41a279f",	//教室id
            "place":"一教223"	//教室地点
        },
        ......
    ],
    "message":null
}

7. 排课管理

7.1 获取排课状况

请求地址：http://localhost:8080/admin/getCourseSchedule
返回值

{
    "status_code":200,
    "data":{
        "hasSchedule":[	//已排课数据列表
            {
                "courseName":"测试课程",	//课程名
                "teacherName":"5",	//教师名
                "place":"信息楼302",	//上课地点
                "time":"周1 第6节",	//上课时间
                "courseId":"0303ae3e-6f86-4ac3-be99-a6639d102b7d"	//课程id
            },
            ......
        ],
        "notSchedule":[	//未排课数据列表
            {
                "courseName":"测试",	//课程名
                "teacherName":"1",	//教师名
                "courseId":"fbee9519-e040-4f43-a02a-31a1d189bb9d"	//课程id
            }
        ]
    },
    "message":null
}

7.2 排课/修改排课

请求地址：http://localhost:8080/admin/setCourseSchedule

参数	描述
courseId	课程id
day	天（1-5）
section	节（1-6）
classroomId	教室id

7.3 删除排课（重置）

请求地址：http://localhost:8080/admin/resetCourseSchedule

参数	描述
courseId	课程id

8. 选课情况

8.1 查看学生选课情况

请求地址：http://localhost:8080/admin/getCourseHasJoined

参数	描述
account	学号

返回值

{
    "status_code":200,
    "data":[
        {
            "courseName":"测试课程",	//课程名
            "teacherName":"教师5",	//教师
            "studentId":"1",	//学生id
            "studentName":"学生1",	//学生名
            "time":"周1 第4节",	//上课时间
            "courseId":"0303ae3e-6f86-4ac3-be99-a6639d102b7d",	//课程id
            "studentAccount":"1"	//学生账户
        }
    ],
    "message":null
}

8.2 退课

请求地址：http://localhost:8080/admin/quitCourse

参数	描述
studentId	学生id
courseId	课程id

ThereIsNoBugAnymore

关注

1
点赞
踩
6

收藏

觉得还不错? 一键收藏
0
评论
教务系统相关接口

学生端1. 登录请求地址: http://localhost:8080/studentLogin参数描述account学生学号pwd登录密码2. 课程管理2.1 获取当前未参加课程请求地址：http://localhost:8080/getCourseNotJoin参数描述id学生id2.2 参加课程请求地址：...
复制链接

扫一扫