SEEC-II-FrontEnd/src/api/review.js

import request from "@/util/request";
import { REVIEW_MODULE } from "./_prefix";

// ====================== TEACHER ======================

/**
 * 新建互评作业
 * @param {number} documentHwId 作业id
 * @param {number} startAt 开始时间
 * @param {number} reviewDdl 互评结束时间
 * @param {number} argueDdl argue结束时间
 * @param {number} endDdl 最后结束时间
 * @param {number} taskNumber 互评任务数
 * @returns {Promise<ReviewSimpleSerializerType>}
 * @throws {StatusException} 输入不合法
 */
export const createReview = ({
  documentHwId,
  startAt,
  reviewDdl,
  argueDdl,
  endDdl,
  taskNumber
}) => {
  return request(`${REVIEW_MODULE}/review`, {
    method: "POST",
    body: { documentHwId, startAt, reviewDdl, argueDdl, endDdl, taskNumber }
  });
};

/**
 * 老师查看互评作业列表
 * @param {string|number} courseId
 * @return {Promise<{data:ReviewSimpleSerializerType[]}>}
 */
export const getTeacherCourseReviewList = courseId => {
  return request(`${REVIEW_MODULE}/teacher/course/${courseId}/review`);
};

/**
 * 老师查看互评作业详情
 * @param {string|number} reviewId
 * @return {Promise<{data:ReviewDetailSerializerType}>}
 */
export const getTeacherReviewDetail = reviewId => {
  return request(`${REVIEW_MODULE}/teacher/review/${reviewId}`);
};

/**
 * 老师查看互评作业汇总结果
 * @param {string|number} reviewId
 * @return {Promise<{data:ReviewResultSerializerType}>}
 */
export const getTeacherReviewResult = reviewId => {
  return request(`${REVIEW_MODULE}/sum/${reviewId}`);
};

/**
 * 老师查看某次互评作业所有小组
 * @param reviewId
 * @return {Promise<{data:GroupSerializerType}>}
 */
export const getTeacherReviewAllGroups = reviewId => {
  return request(`${REVIEW_MODULE}/sum/${reviewId}/group`);
};

/**
 * 老师查看某次互评作业一个小组的详细结果
 * @param reviewId
 * @param groupId
 * @return {Promise<{data:ReviewDocResultSerializerType}>}
 */
export const getTeacherReviewGroupDetail = (reviewId, groupId) => {
  return request(`${REVIEW_MODULE}/sum/${reviewId}/group/${groupId}`);
};

/**
 * 老师开始对某次互评作业一个小组进行评价
 * @param {string|number} reviewId
 * @param {string|number} groupId
 * @return {Promise<{data:ReviewDocDetailSerializerType}>}
 */
export const getTeacherStartArgue = (reviewId, groupId) => {
  return request(`${REVIEW_MODULE}/sum/${reviewId}/argue/${groupId}`);
};

/**
 * 老师提交对某次互评作业一个小组的评价结果
 * @param {string|number} reviewId
 * @param {string|number} groupId
 * @param {CheckListItemSerializerType[]} checkList
 * @return {Promise<{checkList:CheckListItemSerializerType[]}>}
 */
export const postTeacherArgueResult = (reviewId, groupId, checkList) => {
  return request(`${REVIEW_MODULE}/sum/${reviewId}/argue/${groupId}`, {
    method: "POST",
    body: { checkList }
  });
};

/**
 * 老师更新作业评分标准
 * @param {string|number} reviewId
 * @param {*} level
 * @return {Promise<{}>}
 * @throws {StatusException} 输入不合法
 */
export const postReviewSumLevel = (reviewId, level) => {
  return request(`${REVIEW_MODULE}/sum/${reviewId}/level`, {
    method: "POST",
    body: level
  });
};

// ====================== STUDENT ======================

/**
 * 学生查看老师发布的互评作业列表
 * @param {string|number} courseId
 * @return {Promise<{data:ReviewSimpleSerializerType[]}>}
 */
export const getStudentCourseReviewList = courseId => {
  return request(`${REVIEW_MODULE}/student/course/${courseId}/review`);
};

/**
 * 学生查看互评作业详情
 * @param {string|number} reviewId
 * @return {Promise<{data:ReviewDetailSerializerType}>}
 */
export const getStudentReviewDetail = reviewId => {
  return request(`${REVIEW_MODULE}/student/review/${reviewId}`);
};

/**
 * 学生获取某次互评作业中某个文档
 * @param {string|number} reviewId
 * @param {string|number} docReviewId
 * @return {Promise<{data:ReviewDocDetailSerializerType}>}
 */
export const getStudentReviewDocDetail = (reviewId, docReviewId) => {
  return request(
    `${REVIEW_MODULE}/student/review/${reviewId}/doc-review/${docReviewId}`
  );
};

/**
 * 学生提交某次互评作业中的某个文档
 * @param {string|number} reviewId
 * @param {string|number} docReviewId
 * @param {{data:CheckListItemSerializerType[]}} checkListBody
 * @return {Promise<{data:CheckListItemSerializerType[]}>}
 * @throws {StatusException} 输入不合法
 */
export const postStudentReviewWork = (reviewId, docReviewId, checkListBody) => {
  return request(
    `${REVIEW_MODULE}/student/review/${reviewId}/doc-review/${docReviewId}`,
    {
      method: "POST",
      body: checkListBody
    }
  );
};

/**
 * 学生选择查看某次互评作业中自己的文档
 * @param {string|number} reviewId
 * @return {Promise<{data:ReviewDocResultSerializerType}>}
 */
export const getStudentReviewSelfDetail = reviewId => {
  return request(`${REVIEW_MODULE}/student/review/${reviewId}/result`);
};

/**
 * 学生对某个组的某条checklist提出argue
 * @param {string|number} reviewId 作业id
 * @param {string|number} id 某个checkList的id
 * @param {string|number} groupId 某个小组的id
 * @param {string} remark 评论
 * @returns {Promise<{}>}
 * @throws {StatusException} 输入不合法 | 已评审，不可重复评审
 */
export const postStudentArgueReview = ({
  reviewId,
  id,
  groupId,
  remark = ""
}) => {
  return request(`${REVIEW_MODULE}/student/argue`, {
    method: "POST",
    body: { reviewId, id, groupId, remark }
  });
};

/**
 * 学生(评审方)判断是否愿意处理argue
 * @param {string|number} reviewId
 * @param {string|number} checkListId
 * @param {boolean} accept
 * @return {Promise<{data:CheckListItemSerializerType[]}>}
 */
export const postStudentArgueAcceptation = (reviewId, checkListId, accept) => {
  return request(
    `${REVIEW_MODULE}/student/review/${reviewId}/checklist/${checkListId}/argue/acceptation`,
    {
      method: "POST",
      body: { accept }
    }
  );
};

/**
 * 学生(评审方)提交argue [标记为已处理完成]
 * @param {string|number} reviewId
 * @param {string|number} checkListId
 * @param {CheckListItemSerializerType} checkListItem
 * @return {Promise<{data:CheckListItemSerializerType[]}>}
 */
export const postStudentArgueEnd = (reviewId, checkListId, checkListItem) => {
  return request(
    `${REVIEW_MODULE}/student/review/${reviewId}/checklist/${checkListId}/argue/end`,
    {
      method: "POST",
      body: { data: checkListItem }
    }
  );
};