figureout conflict

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({

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

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({

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,