diff --git a/frontend/src/api/exam.js b/frontend/src/api/exam.js index d954c27..1344922 100644 --- a/frontend/src/api/exam.js +++ b/frontend/src/api/exam.js @@ -1,12 +1,14 @@ -// 考试相关的接口,包括考试、问题、选项和评分等接口 +/** + * @description: 考试模块接口,包括考试、问题、选项和评分等接口 + */ import api from './index' import { axios } from '../utils/request' /** - * 获取问题列表 - * @param parameter - * @returns {AxiosPromise} + * @description: 根据传入的参数获取问题列表 + * @param {Object} parameter - 查询参数 + * @returns {Promise} - 返回问题列表的Promise对象 */ export function getQuestionList (parameter) { return axios({ @@ -17,8 +19,8 @@ export function getQuestionList (parameter) { } /** - * 获取所有问题 - * @returns {AxiosPromise} + * @description: 获取所有问题 + * @returns {Promise} - 返回所有问题的Promise对象 */ export function getQuestionAll () { return axios({ @@ -28,9 +30,9 @@ export function getQuestionAll () { } /** - * 更新问题 - * @param parameter - * @returns {AxiosPromise} + * @description: 更新问题信息 + * @param {Object} parameter - 问题更新参数 + * @returns {Promise} - 返回更新操作的Promise对象 */ export function questionUpdate (parameter) { console.log(parameter) @@ -42,8 +44,8 @@ export function questionUpdate (parameter) { } /** - * 获取问题选项 - * @returns {AxiosPromise} + * @description: 获取问题的选项 + * @returns {Promise} - 返回问题选项的Promise对象 */ export function getQuestionSelection () { return axios({ @@ -56,9 +58,9 @@ export function getQuestionSelection () { } /** - * 创建问题 - * @param parameter - * @returns {AxiosPromise} + * @description: 创建新问题 + * @param {Object} parameter - 问题创建参数 + * @returns {Promise} - 返回创建操作的Promise对象 */ export function questionCreate (parameter) { console.log(parameter) @@ -70,9 +72,9 @@ export function questionCreate (parameter) { } /** - * 获取考试列表 - * @param parameter - * @returns {AxiosPromise} + * @description: 根据传入的参数获取考试列表 + * @param {Object} parameter - 查询参数 + * @returns {Promise} - 返回考试列表的Promise对象 */ export function getExamList (parameter) { return axios({ @@ -83,8 +85,8 @@ export function getExamList (parameter) { } /** - * 获取所有考试 - * @returns {AxiosPromise} + * @description: 获取所有考试 + * @returns {Promise} - 返回所有考试的Promise对象 */ export function getExamAll () { return axios({ @@ -93,7 +95,10 @@ export function getExamAll () { }) } -// 获取所有问题,按照单选、多选和判断进行分类 +/** + * @description: 获取所有问题,并按单选、多选和判断进行分类 + * @returns {Promise} - 返回分类问题列表的Promise对象 + */ export function getExamQuestionTypeList () { return axios({ url: api.ExamQuestionTypeList, @@ -105,10 +110,9 @@ export function getExamQuestionTypeList () { } /** - * 获取考试卡片列表 - * @returns {AxiosPromise} + * @description: 获取考试卡片列表 + * @returns {Promise} - 返回考试卡片列表的Promise对象 */ - export function getExamCardList () { return axios({ url: api.ExamCardList, @@ -120,9 +124,9 @@ export function getExamCardList () { } /** - * 创建考试 - * @param parameter - * @returns {AxiosPromise} + * @description: 创建新考试 + * @param {Object} parameter - 考试创建参数 + * @returns {Promise} - 返回创建操作的Promise对象 */ export function examCreate (parameter) { console.log(parameter) @@ -133,6 +137,11 @@ export function examCreate (parameter) { }) } +/** + * @description: 更新考试信息 + * @param {Object} parameter - 考试更新参数 + * @returns {Promise} - 返回更新操作的Promise对象 + */ export function examUpdate (parameter) { console.log(parameter) return axios({ @@ -143,9 +152,9 @@ export function examUpdate (parameter) { } /** - * 获取考试详情 - * @param examId - * @returns {AxiosPromise} + * @description: 根据考试ID获取考试详情 + * @param {String} examId - 考试ID + * @returns {Promise} - 返回考试详情的Promise对象 */ export function getExamDetail (examId) { return axios({ @@ -158,9 +167,9 @@ export function getExamDetail (examId) { } /** - * 获取考试记录详情 - * @param recordId - * @returns {AxiosPromise} + * @description: 根据记录ID获取考试记录详情 + * @param {String} recordId - 记录ID + * @returns {Promise} - 返回考试记录详情的Promise对象 */ export function getExamRecordDetail (recordId) { return axios({ @@ -173,9 +182,9 @@ export function getExamRecordDetail (recordId) { } /** - * 获取考试问题详情 - * @param questionId - * @returns {AxiosPromise} + * @description: 根据问题ID获取问题详情 + * @param {String} questionId - 问题ID + * @returns {Promise} - 返回问题详情的Promise对象 */ export function getQuestionDetail (questionId) { return axios({ @@ -188,12 +197,11 @@ export function getQuestionDetail (questionId) { } /** - * 完成考试 - * @param examId - * @param answersMap - * @returns {AxiosPromise} + * @description: 提交考试答案,完成考试 + * @param {String} examId - 考试ID + * @param {Object} answersMap - 答案映射 + * @returns {Promise} - 返回完成考试的Promise对象 */ - export function finishExam (examId, answersMap) { console.log(answersMap) return axios({ @@ -207,8 +215,8 @@ export function finishExam (examId, answersMap) { } /** - * 获取考试记录列表 - * @returns {AxiosPromise} + * @description: 获取所有考试记录 + * @returns {Promise} - 返回所有考试记录的Promise对象 */ export function getExamRecordList () { return axios({ diff --git a/frontend/src/api/index.js b/frontend/src/api/index.js index 32bdb54..6867621 100644 --- a/frontend/src/api/index.js +++ b/frontend/src/api/index.js @@ -1,42 +1,117 @@ /** - * api接口列表 - * @type {{ExamQuestionList: string, SendSmsErr: string, ExamCardList: string, UserInfo: string, UserRegister: string, ExamRecordList: string, ExamQuestionCreate: string, Logout: string, ExamCreate: string, ExamQuestionAll: string, FinishExam: string, UserLogin: string, ForgePassword: string, ExamQuestionTypeList: string, SendSms: string, Login: string, twoStepCode: string, QuestionDetail: string, recordDetail: string, Register: string, ExamUpdate: string, ExamDetail: string, ExamQuestionSelection: string, ExamList: string, ExamQuestionUpdate: string, ExamAll: string}} + * @description: api接口统一管理 */ const api = { + /** + * @description: 用户登录的接口 + */ Login: '/auth/login', + /** + * @description: 用户注销的接口 + */ Logout: '/auth/logout', + /** + * @description: 重置密码的接口 + */ ForgePassword: '/auth/forge-password', + /** + * @description: 用户注册的接口 + */ Register: '/auth/register', + /** + * @description: 两步验证码的接口 + */ twoStepCode: '/auth/2step-code', + /** + * @description: 发送短信的接口 + */ SendSms: '/account/sms', + /** + * @description: 发送短信错误的接口 + */ SendSmsErr: '/account/sms_err', - // get my info + /** + * @description: 获取用户信息的接口 + */ UserInfo: '/user/info', // 下面是自己的用户认证的接口 + /** + * @description: 用户注册(自定义)的接口 + */ UserRegister: '/user/register', + /** + * @description: 用户登录(自定义)的接口 + */ UserLogin: '/user/login', // 考试的接口 + /** + * @description: 获取考试问题列表的接口 + */ ExamQuestionList: '/exam/question/list', + /** + * @description: 获取所有考试问题的接口 + */ ExamQuestionAll: '/exam/question/all', + /** + * @description: 更新考试问题的接口 + */ ExamQuestionUpdate: '/exam/question/update', + /** + * @description: 选择考试问题的接口 + */ ExamQuestionSelection: '/exam/question/selection', + /** + * @description: 创建考试问题的接口 + */ ExamQuestionCreate: '/exam/question/create', + /** + * @description: 获取考试列表的接口 + */ ExamList: '/exam/list', + /** + * @description: 获取所有考试的接口 + */ ExamAll: '/exam/all', - // 获取问题列表,按照单选、多选和判断进行分类 + /** + * @description: 按照单选、多选和判断分类获取问题列表的接口 + */ ExamQuestionTypeList: '/exam/question/type/list', + /** + * @description: 创建考试的接口 + */ ExamCreate: '/exam/create', + /** + * @description: 更新考试的接口 + */ ExamUpdate: '/exam/update', + /** + * @description: 获取考试卡片列表的接口 + */ ExamCardList: '/exam/card/list', - // 获取考试详情 + /** + * @description: 获取考试详情的接口 + */ ExamDetail: '/exam/detail/', - // 获取考试详情 + /** + * @description: 获取问题详情的接口 + */ QuestionDetail: '/exam/question/detail/', - // 交卷 + /** + * @description: 交卷的接口 + */ FinishExam: '/exam/finish/', + /** + * @description: 获取考试记录列表的接口 + */ ExamRecordList: '/exam/record/list', + /** + * @description: 获取考试记录详情的接口 + */ recordDetail: '/exam/record/detail/' } +/** + * @description: 默认导出api对象 + */ export default api diff --git a/frontend/src/api/login.js b/frontend/src/api/login.js index 62f15df..6ab7817 100644 --- a/frontend/src/api/login.js +++ b/frontend/src/api/login.js @@ -2,12 +2,12 @@ import api from './index' import { axios } from '../utils/request' /** - * login func - * parameter: { - * username: '', - * password: '', - * remember_me: true, - * captcha: '12345' + * 用户登录功能 + * 参数: { + * username: 用户名 + * password: 密码 + * remember_me: 是否记住 + * captcha: 验证码 * } * @param parameter * @returns {*} @@ -22,9 +22,9 @@ export function login (parameter) { } /** - *获取短信验证码 + * 获取短信验证码 * @param parameter - * @returns {AxiosPromise} + * @returns {*} */ export function getSmsCaptcha (parameter) { return axios({ @@ -36,7 +36,7 @@ export function getSmsCaptcha (parameter) { /** * 获取用户信息 - * @returns {AxiosPromise} + * @returns {*} */ export function getInfo () { return axios({ @@ -50,7 +50,7 @@ export function getInfo () { /** * 用户登出 - * @returns {AxiosPromise} + * @returns {*} */ export function logout () { return axios({ @@ -63,8 +63,9 @@ export function logout () { } /** - * 获取用户两步验证设置状态 - * @param parameter {*} + * 获取用户两步验证码开启状态 + * @param parameter + * @returns {*} */ export function get2step (parameter) { return axios({ diff --git a/frontend/src/api/user.js b/frontend/src/api/user.js index efc8428..162ca03 100644 --- a/frontend/src/api/user.js +++ b/frontend/src/api/user.js @@ -2,7 +2,12 @@ import api from './index' import { axios } from '../utils/request' -// 用户登录 + +/** + * 用户登录 + * @param {Object} parameter - 登录参数 + * @returns {Promise} - 返回登录请求的Promise + */ export function login (parameter) { return axios({ url: api.UserLogin, @@ -10,7 +15,12 @@ export function login (parameter) { data: parameter }) } -// 用户注册 + +/** + * 用户注册 + * @param {Object} parameter - 注册参数 + * @returns {Promise} - 返回注册请求的Promise + */ export function register (parameter) { return axios({ url: api.UserRegister,