394 lines
22 KiB
Markdown
394 lines
22 KiB
Markdown
# 出题做题生成流程示意图
|
||
|
||
> **版本**: v2.0 (2026-05-10 更新)
|
||
> **状态**: 与代码实现已对齐
|
||
|
||
---
|
||
|
||
## 一、模块总览
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────────────┐
|
||
│ 考察与训练 (ExamModule) │
|
||
├──────────┬──────────┬──────────────┬──────────────┬────────────────┤
|
||
│ 🤖 AI出题 │ 📚 题库管理 │ 📋 智能组卷 │ 📝 试卷考核 │ 🎯 互动训练 │
|
||
│ (管理员) │ (管理员) │ (管理员) │ (全员) │ (全员) │
|
||
│ exam:ai │ exam:bank│ exam:paper │ exam:exam │ exam:train │
|
||
└──────────┴──────────┴──────────────┴──────────────┴────────────────┘
|
||
```
|
||
|
||
### 各模块功能说明
|
||
|
||
| 模块 | 权限码 | 功能描述 | 目标用户 |
|
||
|-----|--------|---------|---------|
|
||
| AI出题 | `exam:ai` | 选择文档→AI生成题目 | 管理员/有权限用户 |
|
||
| 题库管理 | `exam:bank` | 题目审核/编辑/删除 | 管理员 |
|
||
| 智能组卷 | `exam:paper` | 配置参数→生成试卷→**编辑+发布** | 管理员 |
|
||
| 试卷考核 | `exam:exam` | 待考试/答题/成绩/错题本/**自测组卷** | 全员 |
|
||
| 互动训练 | `exam:train` | 闯关模式/每日一练/错题本(本地) | 全员 |
|
||
|
||
---
|
||
|
||
## 二、题目生成流程（AI出题）
|
||
|
||
```
|
||
┌──────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────┐
|
||
│ 上传文档 │ ──→│ 文件向量化处理 │ ──→│ AI题目生成 │ ──→│ 题目预览 │
|
||
│ │ │ │ │ │ │ │
|
||
└──────────┘ └──────────────┘ └──────────────┘ └────┬─────┘
|
||
│
|
||
┌─────────────────────────────────────────┘
|
||
↓
|
||
┌──────────────┐
|
||
│ 管理员审核操作 │
|
||
└──────┬───────┘
|
||
│
|
||
┌──────────┼──────────┐
|
||
↓ ↓ ↓
|
||
┌────────┐ ┌────────┐ ┌────────┐
|
||
│ 采纳通过 │ │ 编辑修改 │ │ 删除丢弃 │
|
||
└───┬────┘ └───┬────┘ └────────┘
|
||
↓ ↓
|
||
┌────────┐ ┌────────┐
|
||
│ 进入题库 │→ │ 进入题库 │
|
||
└────────┘ └────────┘
|
||
```
|
||
|
||
### 相关API接口
|
||
|
||
| 序号 | 接口路径 | 方法 | 说明 |
|
||
|-----|---------|------|------|
|
||
| 1 | `/api/file/upload` | POST | 上传制度文件 |
|
||
| 2 | `/api/collections/{name}/vectorize` | POST | 文件向量化处理 |
|
||
| 3 | `/api/exam/generate` | POST | AI智能出题接口 |
|
||
| 4 | `/api/question/review/{questionId}` | PUT | 审核题目(采纳/拒绝) |
|
||
|
||
---
|
||
|
||
## 三、试卷生成流程（双路径）
|
||
|
||
### 路径A：管理员 — 智能组卷（可编辑 + 可发布）
|
||
|
||
```
|
||
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
|
||
│ 选择关联文档 │ ──→│ 配置试卷参数 │ ──→│ 调用组卷API │ ──→│ 预览编辑试卷 │
|
||
│ (可选) │ │ │ │ │ │ │
|
||
└──────────────┘ └──────────────┘ └──────────────┘ └──────┬───────┘
|
||
│
|
||
┌────────────────────────────────┘
|
||
↓
|
||
┌──────────────────────┐
|
||
│ 管理员操作面板 │
|
||
│ ├─ 编辑题目(题干/选项) │
|
||
│ ├─ 调整分值/顺序 │
|
||
│ └─ 发布试卷给指定用户 │
|
||
└──────────┬───────────┘
|
||
│
|
||
┌───────────────┼───────────────┐
|
||
↓ ↓ ↓
|
||
┌──────────┐ ┌──────────┐ ┌──────────┐
|
||
│ 保存草稿 │ │ 发布试卷 │ │ 删除试卷 │
|
||
└──────────┘ └────┬─────┘ └──────────┘
|
||
│
|
||
↓ 用户收到通知
|
||
┌──────────────────────┐
|
||
│ 试卷考核-待考试列表 │
|
||
└──────────────────────┘
|
||
```
|
||
|
||
### 路径B：用户 — 自测组卷（仅生成，直接答题）
|
||
|
||
```
|
||
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
|
||
│ 配置参数 │ ──→│ 调用组卷API │ ──→│ 生成成功 │ ──→│ 直接进入答题 │
|
||
│ (题型/难度) │ │ │ │ │ │ (不可编辑) │
|
||
└──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘
|
||
```
|
||
|
||
### 两条路径对比
|
||
|
||
| 维度 | 路径A：管理员智能组卷 | 路径B：用户自测组卷 |
|
||
|-----|-------------------|------------------|
|
||
| 入口 | 「智能组卷」标签页 | 「试卷考核→自测组卷」子标签 |
|
||
| API | `POST /api/exam/paper/generate` | 同一接口 |
|
||
| 可选文件 | ✅ 关联制度文件筛选 | ✅ 可选关联 |
|
||
| 生成后行为 | 进入编辑预览 | **直接进入答题页面** |
|
||
| 编辑题目 | ✅ 题干/选项/答案/分值 | ❌ 不支持 |
|
||
| 发布功能 | ✅ 发布给指定部门/用户 | ❌ 仅自己使用 |
|
||
| 数据持久化 | ✅ 存入后端试卷表 | ❌ 前端暂存，关闭即失 |
|
||
| 权限要求 | `exam:paper` | `exam:exam` |
|
||
|
||
### 相关API接口
|
||
|
||
| 序号 | 接口路径 | 方法 | 说明 |
|
||
|-----|---------|------|------|
|
||
| 1 | `/api/exam/paper/generate` | POST | 从题库动态生成试卷 |
|
||
| 2 | `/admin/exam/paper/{paperId}/publish` | POST | 管理员发布试卷(含deadline/target) |
|
||
| 3 | `/api/exam/my/papers` | GET | 获取我的试卷列表 |
|
||
| 4 | `/api/exam/paper/{paperId}` | GET | 获取试卷详情 |
|
||
|
||
---
|
||
|
||
## 四、答题考试流程（试卷考核）
|
||
|
||
### 核心流程图
|
||
|
||
```
|
||
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
|
||
│ 获取待考试 │ ────→ │ 选择试卷 │ ────→ │ 启动考试记录 │
|
||
│ 列表 │ │ │ │ /record/start│
|
||
└──────┬───────┘ └──────┬───────┘ └──────┬───────┘
|
||
│ │ │
|
||
↓ ↓ ↓
|
||
┌──────────────┐ ┌──────────────────────────────────────────┐
|
||
│ GET │ │ 答题界面 │
|
||
│ /my/papers │ │ ┌─────────────────────────────────────┐ │
|
||
└──────────────┘ │ │ 第 N 题 [题型] ★ 分值 │ │
|
||
│ │ 题目内容 │ │
|
||
│ │ ○ A. 选项内容 │ │
|
||
│ │ ○ B. 选项内容 │ │
|
||
│ │ ○ C. 选项内容 │ │
|
||
│ │ ○ D. 选项内容 │ │
|
||
│ └─────────────────────────────────────┘ │
|
||
│ │
|
||
│ [上一题] ●●●○●● [下一题] [提交试卷] │
|
||
└──────────────┬───────────────────────────┘
|
||
│
|
||
┌───────────────────┼───────────────────┐
|
||
↓ ↓ ↓
|
||
┌──────────┐ ┌──────────┐ ┌──────────┐
|
||
│ 自动保存 │ │ 提交试卷 │ │ 退出确认 │
|
||
│ /save │ │ /submit │ │ │
|
||
└──────────┘ └────┬─────┘ └──────────┘
|
||
│
|
||
↓
|
||
┌──────────────────────┐
|
||
│ 后端AI批改处理 │
|
||
│ (自动触发) │
|
||
└──────────┬───────────┘
|
||
│
|
||
↓
|
||
┌──────────────────────┐
|
||
│ 显示成绩单 │
|
||
│ 总分/得分率/每题详情 │
|
||
└──────────┬───────────┘
|
||
│
|
||
↓
|
||
┌──────────────────────┐
|
||
│ 错题自动收集入库 │
|
||
│ → 错题本可查看/重做 │
|
||
└──────────────────────┘
|
||
```
|
||
|
||
### 答题流程详细步骤与API对应关系
|
||
|
||
| 步骤 | 操作 | API接口 | 方法 | 说明 |
|
||
|-----|------|---------|------|------|
|
||
| 1 | 获取待考试列表 | `/api/exam/my/papers` | GET | 返回当前用户的已发布试卷 |
|
||
| 2 | 选择并进入试卷 | - | 前端切换视图 | 加载试卷数据到答题组件 |
|
||
| 3 | **启动考试记录** | `/api/exam/record/{recordId}/start` | POST | 创建考试记录，开始计时 |
|
||
| 4 | 答题中(自动保存) | `/api/exam/record/{recordId}/save` | PUT | 定期保存当前答案进度 |
|
||
| 5 | 提交试卷 | `/api/exam/record/{recordId}/submit` | POST | 提交最终答案，触发后端AI批改 |
|
||
| 6 | 查看成绩结果 | `/api/exam/record/{recordId}/result` | GET | 获取AI批改后的成绩和错题信息 |
|
||
| 7 | 错题自动收集 | 后端自动处理 | - | 批改后自动将错题录入错题库 |
|
||
|
||
> **注意**：当后端尚未实现 record 系列 API 时，前端会优雅降级：
|
||
> - start/save 失败时继续前端答题模式
|
||
> - submit 失败时降级为直接调用 `/exam/grade` 进行批改
|
||
|
||
### 支持的题型及答题方式
|
||
|
||
| 题型 | question_type | 答题控件 | 答案格式 |
|
||
|-----|--------------|---------|---------|
|
||
| 单选题 | `single_choice` | Radio单选框 | 字符串 `"A"` |
|
||
| 多选题 | `multiple_choice` | Checkbox多选框 | 数组 `["A","C"]` |
|
||
| 判断题 | `true_false` | 是/否双选 | 字符串 `"true"`/`"false"` |
|
||
| 填空题 | `fill_blank` | 文本输入框 | 字符串 |
|
||
| 简答题 | `subjective` | 多行文本域 | 字符串 |
|
||
|
||
---
|
||
|
||
## 五、错题系统（两套独立机制）
|
||
|
||
### 架构对比
|
||
|
||
```
|
||
┌─────────────────────┐ ┌─────────────────────┐
|
||
│ 互动训练-错题本 │ │ 试卷考核-错题本 │
|
||
│ (trainTab='wrong') │ │ (examTab='wrong') │
|
||
├─────────────────────┤ ├─────────────────────┤
|
||
│ 数据来源: 前端缓存 │ │ 数据来源: 后端API │
|
||
│ 存储位置: trainingData│ │ 存储位置: 数据库表 │
|
||
│ .wrongQuestions │ │ wrong_questions │
|
||
│ │ │ │
|
||
│ 触发场景: │ │ 触发场景: │
|
||
│ • 闯关模式答错 │ │ • 试卷考核提交后 │
|
||
│ • 每日一练答错 │ │ • 后端自动收集 │
|
||
│ │ │ │
|
||
│ 操作能力: │ │ 操作能力: │
|
||
│ • 查看解析(前端mock) │ │ • 查看解析(API数据) │
|
||
│ • 重做(重置关卡) │ │ • 重做(/redo API) │
|
||
│ • 无持久化 │ │ • 收藏(/toggle API) │
|
||
└─────────────────────┘ └─────────────────────┘
|
||
```
|
||
|
||
### 试卷考核错题本API
|
||
|
||
| 操作 | API | 方法 | 说明 |
|
||
|-----|-----|------|------|
|
||
| 获取错题列表 | `/api/wrong-questions/list` | POST | 分页查询，支持collection过滤 |
|
||
| 收藏/取消收藏 | `/api/wrong-questions/collection/toggle` | POST | 传入question_id |
|
||
| 重做错题 | `/api/wrong-questions/redo` | POST | 传入question_ids数组 |
|
||
|
||
---
|
||
|
||
## 六、互动训练流程
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 互动训练 (exam:train) │
|
||
├──────────┬──────────┬──────────────────────────────────────┤
|
||
│ 🏆 闯关 │ 📅 每日一练│ ❌ 错题本(本地缓存) │
|
||
│ checkpoint│ daily │ wrong │
|
||
└──────────┴──────────┴──────────────────────────────────────┘
|
||
|
||
闯关模式流程:
|
||
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
|
||
│ 选择关卡 │ → │ 组卷API │ → │ 答题提交 │ → │ 批改评分 │
|
||
│ (5个预设) │ │ generate │ │ grade │ │ 更新关卡 │
|
||
└──────────┘ └──────────┘ └──────────┘ └──────────┘
|
||
│
|
||
┌──────────┴──────────┐
|
||
↓ ↓
|
||
┌──────────┐ ┌──────────┐
|
||
│ 通过升级 │ │ 错题缓存 │
|
||
│ 下一关 │ │ 本地存储 │
|
||
└──────────┘ └──────────┘
|
||
```
|
||
|
||
### 互动训练关卡配置（预设固定关卡）
|
||
|
||
| 关卡ID | 名称 | 难度 | 单选 | 多选 | 判断 | 简答 | 状态 |
|
||
|-------|------|------|------|------|------|------|------|
|
||
| 1 | 入门挑战 | ⭐ | 3 | 0 | 2 | 0 | in-progress |
|
||
| 2 | 基础巩固 | ⭐⭐ | 4 | 2 | 2 | 0 | pending |
|
||
| 3 | 进阶提升 | ⭐⭐⭐ | 4 | 3 | 3 | 0 | pending |
|
||
| 4 | 高级挑战 | ⭐⭐⭐⭐ | 3 | 3 | 2 | 2 | pending |
|
||
| 5 | 大师试炼 | ⭐⭐⭐⭐⭐ | 4 | 4 | 2 | 2 | pending |
|
||
|
||
---
|
||
|
||
## 七、完整API接口清单
|
||
|
||
### 7.1 题目管理
|
||
|
||
| 接口 | 路径 | 方法 | 权限 | 说明 |
|
||
|-----|------|------|------|------|
|
||
| AI出题 | `/api/exam/generate` | POST | exam:ai | 根据文档生成题目 |
|
||
| 审核题目 | `/api/question/review/{id}` | PUT | exam:bank | 采纳/拒绝题目 |
|
||
|
||
### 7.2 试卷管理
|
||
|
||
| 接口 | 路径 | 方法 | 权限 | 说明 |
|
||
|-----|------|------|------|------|
|
||
| 生成试卷 | `/api/exam/paper/generate` | POST | exam:paper 或 exam:exam | 从题库动态组卷 |
|
||
| 我的试卷 | `/api/exam/my/papers` | GET | exam:exam | 获取用户试卷列表 |
|
||
| 试卷详情 | `/api/exam/paper/{paperId}` | GET | exam:paper 或 exam:exam | 获取试卷完整内容 |
|
||
| 发布试卷 | `/admin/exam/paper/{paperId}/publish` | POST | exam:paper | 管理员发布试卷 |
|
||
|
||
### 7.3 答题考试(record-based)
|
||
|
||
| 接口 | 路径 | 方法 | 权限 | 说明 |
|
||
|-----|------|------|------|------|
|
||
| 启动考试 | `/api/exam/record/{recordId}/start` | POST | exam:exam | 开始考试计时 |
|
||
| 保存答案 | `/api/exam/record/{recordId}/save` | PUT | exam:exam | 答题中途自动保存 |
|
||
| 提交试卷 | `/api/exam/record/{recordId}/submit` | POST | exam:exam | 提交最终答案 |
|
||
| 成绩查询 | `/api/exam/record/{recordId}/result` | GET | exam:exam | 获取批改成绩和错题 |
|
||
|
||
### 7.4 批改与查询
|
||
|
||
| 接口 | 路径 | 方法 | 权限 | 说明 |
|
||
|-----|------|------|------|------|
|
||
| 批改答案 | `/api/exam/grade` | POST | exam:exam | AI批改(降级备用) |
|
||
| 查询答题记录 | `/api/exam/answers/query` | POST | exam:exam | 按paperId/sessionId查询 |
|
||
|
||
### 7.5 错题管理
|
||
|
||
| 接口 | 路径 | 方法 | 权限 | 说明 |
|
||
|-----|------|------|------|------|
|
||
| 错题列表 | `/api/wrong-questions/list` | POST | exam:exam | 分页获取错题 |
|
||
| 收藏切换 | `/api/wrong-questions/collection/toggle` | POST | exam:exam | 收藏/取消收藏错题 |
|
||
| 重做错题 | `/api/wrong-questions/redo` | POST | exam:exam | 重新练习错题 |
|
||
|
||
---
|
||
|
||
## 八、数据库核心表结构
|
||
|
||
### exam_paper（试卷表）
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|-------|------|------|
|
||
| id | BIGINT | 主键 |
|
||
| uuid | VARCHAR(36) | UUID唯一标识 |
|
||
| title | VARCHAR(200) | 试卷标题 |
|
||
| total_score | INT | 总分 |
|
||
| question_count | INT | 题目数量 |
|
||
| difficulty | INT | 整体难度(1-5) |
|
||
| status | TINYINT | 状态(0=草稿,1=已发布,2=已归档) |
|
||
| creator_id | BIGINT | 创建者(管理员) |
|
||
| created_at | DATETIME | 创建时间 |
|
||
| updated_at | DATETIME | 更新时间 |
|
||
|
||
### exam_record（考试记录表）
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|-------|------|------|
|
||
| id | BIGINT | 主键 |
|
||
| uuid | VARCHAR(36) | UUID唯一标识 |
|
||
| paper_id | BIGINT | 关联试卷ID |
|
||
| user_id | BIGINT | 考试用户ID |
|
||
| status | TINYINT | 状态(0=未开始,1=进行中,2=已交卷,3=已批改) |
|
||
| score | DECIMAL(5,2) | 得分 |
|
||
| max_score | INT | 满分 |
|
||
| started_at | DATETIME | 开始时间 |
|
||
| submitted_at | DATETIME | 提交时间 |
|
||
| graded_at | DATETIME | 批改完成时间 |
|
||
|
||
### wrong_questions（错题表）
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|-------|------|------|
|
||
| id | BIGINT | 主键 |
|
||
| question_id | BIGINT | 关联题目ID |
|
||
| user_id | BIGINT | 用户ID |
|
||
| student_answer | TEXT | 学生答案 |
|
||
| correct_answer | TEXT | 正确答案 |
|
||
| is_correct | TINYINT | 是否正确(0=错误) |
|
||
| error_count | INT | 错误次数 |
|
||
| last_wrong_at | DATETIME | 最近错误时间 |
|
||
|
||
---
|
||
|
||
## 九、管理员 vs 用户 功能矩阵
|
||
|
||
| 功能 | 管理员 | 普通用户 |
|
||
|-----|:-----:|:-------:|
|
||
| AI出题 | ✅ | ✅(有权限) |
|
||
| 题库审核 | ✅ | ❌ |
|
||
| 智能组卷(生成) | ✅ | ❌ |
|
||
| 智能组卷(编辑) | ✅ | ❌ |
|
||
| 智能组卷(发布) | ✅ | ❌ |
|
||
| 试卷考核-待考试 | ❌ | ✅ |
|
||
| 试卷考核-答题 | ✅(测试) | ✅ |
|
||
| 试卷考核-成绩单 | ✅ | ✅ |
|
||
| 试卷考核-错题本(API) | ✅ | ✅ |
|
||
| 试卷考核-自测组卷 | ✅ | ✅ |
|
||
| 互动训练-闯关 | ✅ | ✅ |
|
||
| 互动训练-每日一练 | ✅ | ✅ |
|
||
| 互动训练-错题本(本地) | ✅ | ✅ |
|
||
|
||
---
|
||
|
||
*文档更新日期: 2026-05-10*
|
||
*与 ExamModule.vue v2.0 + exam.js v2.0 对齐*
|