学之思开源考试系统Mysql版自定义试卷功能：创建到发布流程

一、功能概述

学之思开源考试系统（Mysql版）的自定义试卷功能是系统核心模块之一，支持教师用户通过Web管理端完成从试卷信息配置、题目添加到最终发布的全流程管理。该功能基于前后端分离架构实现，前端通过Vue组件化开发，后端提供RESTful API接口，支持多种题型组合、分数权重配置和发布状态管理。

1.1 核心价值

痛点场景	解决方案	业务价值
传统纸质试卷印刷成本高、分发困难	全数字化试卷管理，支持在线作答	降低教学成本，提升考试效率
手动组卷耗时且易出现重复题目	题库随机抽题与手动选题结合	减少教师工作量，保证试卷质量
考试进度难监控、成绩统计繁琐	实时考试监控与自动评分	简化考务工作，数据可视化呈现

1.2 功能架构

flowchart LR
    A[试卷管理] --> B[基础信息配置]
    A --> C[题目添加]
    A --> D[分数设置]
    A --> E[发布管理]
    B -->|包含| B1[试卷名称/时间/类型]
    C -->|支持| C1[单选题/多选题/判断题/主观题]
    E -->|状态| E1[草稿/已发布/已归档]

二、前置准备

2.1 环境要求

• 学之思系统版本：3.9.0+
• 权限要求：管理员或教师角色（userLevel ≥ 2）
• 前置数据：已创建学科分类和题目库

2.2 核心API接口

接口名称	请求方式	接口地址	功能描述
试卷分页查询	POST	/api/admin/exam/paper/page	获取试卷列表，支持条件筛选
试卷创建	POST	/api/admin/exam/paper/edit	创建或编辑试卷信息
试卷删除	POST	/api/admin/exam/paper/delete/{id}	删除指定试卷
任务试卷分页	POST	/api/admin/exam/paper/taskExamPage	查询任务关联的试卷

接口定义参考：source/vue/xzs-admin/src/api/examPaper.js

三、详细操作步骤

3.1 进入试卷管理模块

1. 使用管理员账号登录系统后台
2. 在左侧导航栏选择「考试管理」→「试卷管理」
3. 点击右上角「新增试卷」按钮，进入创建页面

3.2 基础信息配置

3.2.1 关键参数配置

<template>
  <el-form ref="paperForm" :model="paperForm" label-width="120px">
    <el-form-item label="试卷名称" prop="name">
      <el-input v-model="paperForm.name" placeholder="请输入试卷名称" maxlength="50"/>
    </el-form-item>
    <el-form-item label="考试时长(分钟)" prop="timeLimit">
      <el-input-number v-model="paperForm.timeLimit" :min="5" :max="300" step="5"/>
    </el-form-item>
    <el-form-item label="试卷类型">
      <el-radio-group v-model="paperForm.paperType">
        <el-radio :label="1">固定试卷</el-radio>
        <el-radio :label="2">随机试卷</el-radio>
      </el-radio-group>
    </el-form-item>
    <!-- 更多配置项 -->
  </el-form>
</template>

3.2.2 参数说明

参数名称	数据类型	约束条件	业务说明
name	String	非空，50字符以内	建议包含学科、年级和考试类型信息
timeLimit	Number	5 ≤ value ≤ 300	考试时长，单位：分钟
paperType	Number	1:固定试卷, 2:随机试卷	固定试卷题目固定，随机试卷从题库动态抽取
subjectId	Number	非空	关联的学科ID，影响题目库筛选范围

3.3 题目添加与分数配置

3.3.1 题目选择方式

系统支持两种题目添加模式：

1. 手动选题：从题库中勾选指定题目

   sequenceDiagram
     教师->>系统: 选择"手动选题"
     系统->>题库: 查询当前学科题目
     题库-->>系统: 返回题目列表(含题型/难度)
     教师->>系统: 勾选题目并设置分数
     系统->>试卷: 保存题目关联关系
   

2. 随机抽题：设置题型、数量和难度条件，系统自动抽取

   • 支持按难度系数（1-5级）筛选
   • 可限制知识点标签
   • 自动去重机制确保题目不重复

3.3.2 分数权重配置

• 单题分数设置：在题目列表中直接输入每题分值
• 总分自动计算：系统实时累加所有题目分数
• 分数调整：支持批量设置相同题型分数（如所有单选题10分）

3.4 试卷预览与发布

3.4.1 状态流转管理

stateDiagram-v2
    [*] --> 草稿
    草稿 --> 已发布 : 点击"发布"按钮
    已发布 --> 进行中 : 关联考试任务
    进行中 --> 已归档 : 考试结束
    已发布 --> 草稿 : 点击"撤回"按钮
    已归档 --> [*]

3.4.2 发布操作步骤

1. 完成题目配置后点击「预览试卷」检查完整性
2. 确认无误后点击「保存并发布」
3. 在弹出框中选择发布范围：
   • 全年级可见
   • 指定班级/学生组可见
   • 仅任务关联可见

四、高级功能

4.1 试卷复制与模板

对于周期性考试（如月考、期中/期末考试），可使用「试卷复制」功能快速创建相似试卷：

1. 在试卷列表页找到目标试卷
2. 点击操作列「更多」→「复制」
3. 修改必要信息后保存为新试卷

4.2 数据统计与分析

试卷发布后，可在「考试分析」模块查看：

• 参与人数与完成率
• 各题型正确率分布
• 分数段统计直方图
• 错题率TOP5题目

五、常见问题解决

5.1 试卷创建失败

可能原因：

• 学科ID未选择或不存在
• 题目总分未达到最低要求（默认≥10分）
• 试卷名称重复

解决方案：

// 前端表单验证示例
this.$refs.paperForm.validate((valid) => {
  if (valid) {
    if (this.totalScore < 10) {
      this.$message.error('试卷总分不能低于10分')
      return false
    }
    // 提交表单
    examPaperApi.edit(this.paperForm).then(res => {
      if (res.code === 1) {
        this.$message.success('保存成功')
      }
    })
  }
})

5.2 学生端看不到试卷

排查步骤：

1. 检查试卷发布状态是否为「已发布」
2. 确认学生账号所属班级是否在发布范围内
3. 检查试卷是否关联了有效的考试任务

六、最佳实践建议

6.1 试卷命名规范

推荐格式：[学科][年级][考试类型][日期]
示例：高中数学_高一年级_期中考试_20231101

6.2 题型组合策略

考试类型	题型组合建议	难度分布
随堂测验	单选+判断（8:2）	易:中=7:3
期中考试	单选+多选+主观（4:3:3）	易:中:难=5:3:2
期末考试	全题型覆盖	易:中:难=4:4:2

6.3 数据备份

定期导出试卷数据：

1. 在试卷列表页点击「导出」按钮
2. 选择导出格式（Excel/PDF）
3. 建议每月备份一次重要试卷数据

七、总结与展望

自定义试卷功能作为学之思系统的核心模块，通过直观的操作界面和灵活的配置选项，有效解决了传统考试管理中的效率问题。后续版本将增强以下功能：

• AI辅助组卷：基于知识点图谱智能推荐题目
• 多终端同步：支持手机端组卷与发布
• 试卷版本管理：保留历史修改记录，支持版本回溯

完整功能实现可参考管理端源代码：source/vue/xzs-admin/src/views/exam目录下相关组件

通过本文档的操作指南，教师用户可快速掌握自定义试卷的创建流程，结合系统提供的题库管理和考试监控功能，构建完整的在线考试闭环。