Skip to content

Latest commit

 

History

History
166 lines (134 loc) · 5.16 KB

接口.md

File metadata and controls

166 lines (134 loc) · 5.16 KB
Raw

接口命名规范

localhost\API\\ api\book\get_one api\book\get_by_key

接下来按功能重要性排序

注意：斜体标注的为我认为本次几乎可以不用考虑的功能

管理员

  1. 登录 (沿用龙哥方式，直接登录，后端判断用户类型) interface commit \ login function: login() parameter: { id, password } return: { (一个登陆状态值，前端解析成功失败用户身份), name, adminID }

  2. 添加课程 interface commit \ add_course_arrange function: addCourseArrange() parameter: { id, name, year, semester, weeks, maxnum, building, roommember, ?timeslot, credits, maxnum, description } return: {(一个状态值)}——用于描述各种冲突

  3. 修改课程 interface revise \ edit_course_arrange function: editCourseArrange() parameter: { id, name, year, semester, weeks, maxnum, building, roommember, ?timeslot, credits, maxnum, description } return: { (一个状态值) }——用于描述各种冲突

  4. 删除课程 interface: revise \ del_course_arrange function: deleteCourseArrange() parameter: { id, name, year, semester, weeks, maxnum, building, roommember, ?timeslot, credits, maxnum } ---确定---> secID return: { (一个状态值) }——用于描述各种冲突

  5. 排课——上传课表(推荐课表选课，与核心需求关系不大因且需要完成课程表项目) interface：commit\course_arrange function: addCourseArrange() parameter: return: int/str

  6. 删除、修改课表(同上) interface：revise\course_arrange function: editCourseArrange() parameter: return:

  7. 确定、拒绝老师课程申请信息(因为需要新建数据表，且与项目着与核心需求关系不大改为上方添加课程) interface：confirm\course_info function: dealCourseInfo() parameter: return:

  8. 查询学生的GPA(又是一个和选课没啥关系的功能) interface：query\student_gpa function: getStudentGPA(map) parameter: {} return: map

  9. 确定、拒绝学生中期退课申请 interface：confirm\mid_drop function: dealMidDrop() / confirmMidDrop() 待定 parameter: return:

老师

提供给教师的服务和选课有交集吗？？？

学生

  1. 登录 (沿用龙哥方式，直接登录，后端判断用户类型) interface： commit \ login function:  login() parameter:  { id, password } return:  { (一个登陆状态值，前端解析成功失败用户身份), name, studentId }

  2. 选课01——获取可选课程列表 interface： query \ course_to_select function:  getCourseToSelect() parameter:  null(现阶段直接获取全部课程数据) return:  { courseID, coursename, year, section, credits, timeslotID, day, starttime, endtime, weeks, building, roomnumber, maxnum, currentnum }

  3. 选课02——提交选课列表(本次我们只做自主选课) interface： commit \ course_select function:  selectCourse() parameter:  { studentID, secID, semester, year, timeslotID, courseID } return:  { (一个状态值) }

  4. 退课 interface： commit \ course_drop function:  dropCourse() parameter:  { studentID, secID, semester, year, timeslotID, courseID } return:  { (一个状态值) }

  5. 查询当前已选课程 interface： query \ course_list function:  getCourseList() parameter:  { studentID } return:  { courseID, coursename, year, section, credits, timeslotID, day, starttime, endtime, weeks, building, roomnumber, maxnum, currentnum }

  6. 查询当前课表 interface： query \ course_list function:  getCourseList() parameter:  { studentID } return:  { courseID, coursename, year, section, credits, timeslotID, day, starttime, endtime, weeks, building, roomnumber, maxnum, currentnum }

  7. 查询课程成绩 intserface: query\student_grade

  8. 查询自己某学期的GPA interface：query\student_gpa function: getGPA() parameter: return:

  9. 评教 interface：commit\course_eval function: addCourseEval() parameter: return:

  10. 中期退课申请（竖着的steps interface：commit\mid_drop function: addMidDrop() parameter: return:

  11. 导出课表（前端

  12. 导出考试记录（前端