guoyu/Test/备份/_已清理文件备份_周六 22512/md/题库功能设计方案.md

# 题库上传和随机抽题功能设计方案

## 一、功能概述

在现有考试系统基础上，新增题库管理功能，支持：
1. **题库管理**：创建和管理独立的题目库
2. **题目上传**：支持Excel批量导入题目
3. **随机抽题**：创建考试时从题库中按题型和数量随机抽取题目

## 二、数据库设计

### 2.1 新增表结构

#### 1. 题库表（question_bank）
```sql
CREATE TABLE `question_bank` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '题库ID',
  `bank_name` varchar(200) NOT NULL COMMENT '题库名称',
  `subject_id` bigint NOT NULL COMMENT '科目ID',
  `subject_name` varchar(100) DEFAULT NULL COMMENT '科目名称',
  `description` varchar(500) DEFAULT NULL COMMENT '题库描述',
  `question_count` int DEFAULT 0 COMMENT '题目数量',
  `create_user_id` bigint DEFAULT NULL COMMENT '创建人ID（教师ID）',
  `create_by` varchar(64) DEFAULT '' COMMENT '创建者',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_by` varchar(64) DEFAULT '' COMMENT '更新者',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  `remark` varchar(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`id`),
  KEY `idx_subject_id` (`subject_id`),
  KEY `idx_create_user_id` (`create_user_id`)
) COMMENT='题库表';
```

#### 2. 题库题目表（question_bank_item）
```sql
CREATE TABLE `question_bank_item` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '题目ID',
  `bank_id` bigint NOT NULL COMMENT '题库ID',
  `question_type` varchar(20) NOT NULL COMMENT '题型（single-单选, multiple-多选, judge-判断, fill-填空, essay-简答）',
  `question_content` text NOT NULL COMMENT '题干',
  `options` text DEFAULT NULL COMMENT '选项（JSON格式）',
  `correct_answer` text NOT NULL COMMENT '正确答案',
  `score` decimal(10,2) DEFAULT 0.00 COMMENT '默认分值',
  `difficulty` varchar(10) DEFAULT 'medium' COMMENT '难度（easy-简单, medium-中等, hard-困难）',
  `knowledge_point` varchar(200) DEFAULT NULL COMMENT '知识点',
  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
  PRIMARY KEY (`id`),
  KEY `idx_bank_id` (`bank_id`),
  KEY `idx_question_type` (`question_type`),
  KEY `idx_difficulty` (`difficulty`)
) COMMENT='题库题目表';
```

#### 3. 修改现有题目表（question）
```sql
-- 添加字段，标识题目来源
ALTER TABLE `question` 
ADD COLUMN `source_type` varchar(20) DEFAULT 'manual' COMMENT '题目来源（manual-手动创建, bank-题库抽取, ai-AI生成）',
ADD COLUMN `bank_id` bigint DEFAULT NULL COMMENT '来源题库ID（如果来自题库）',
ADD COLUMN `bank_item_id` bigint DEFAULT NULL COMMENT '来源题库题目ID（如果来自题库）';
```

### 2.2 表关系说明

```
question_bank (题库)
    ↓ (1:N)
question_bank_item (题库题目)
    ↓ (N:1) [随机抽取]
question (考试题目) ← exam (考试)
```

## 三、功能模块设计

### 3.1 题库管理模块

#### 3.1.1 题库列表页面
- **路径**：`/study/questionBank/index`
- **功能**：
  - 显示题库列表（名称、科目、题目数量、创建时间等）
  - 支持按科目、名称搜索
  - 支持新增、编辑、删除题库
  - 支持查看题库详情和题目列表

#### 3.1.2 题库详情页面
- **路径**：`/study/questionBank/detail`
- **功能**：
  - 显示题库基本信息
  - 显示题库中的题目列表
  - 支持按题型筛选
  - 支持添加、编辑、删除题目
  - 支持批量导入题目（Excel）

### 3.2 题目上传模块

#### 3.2.1 Excel导入功能
- **支持格式**：
  - Excel文件（.xlsx, .xls）
  - 模板下载功能
- **Excel模板结构**：
  ```
  题型 | 题干 | 选项A | 选项B | 选项C | 选项D | 正确答案 | 分值 | 难度 | 知识点
  ```
- **导入流程**：
  1. 选择题库
  2. 下载模板（可选）
  3. 上传Excel文件
  4. 预览导入数据
  5. 确认导入
  6. 显示导入结果（成功/失败统计）

#### 3.2.2 手动添加题目
- 支持在线表单添加单个题目
- 支持所有题型（单选、多选、判断、填空、简答）

### 3.3 随机抽题模块

#### 3.3.1 修改考试创建页面
- **现有流程**：AI生成题目 → 预览 → 保存
- **新增流程**：选择出题方式 → [AI生成 / 从题库抽取] → 预览 → 保存

#### 3.3.2 从题库抽题界面
- **选择题库**：下拉选择（按科目筛选）
- **题型配置**：
  - 题型选择（单选、多选、判断、填空、简答）
  - 每种题型的抽取数量
  - 可选：难度筛选、知识点筛选
- **抽题规则**：
  - 随机抽取
  - 按难度比例抽取（如：简单30%，中等50%，困难20%）
  - 按知识点分布抽取

#### 3.3.3 抽题逻辑
```java
// 伪代码
1. 根据题型、难度、知识点等条件筛选题库题目
2. 如果符合条件的题目数量 >= 需要的数量
   - 随机抽取指定数量的题目
3. 如果符合条件的题目数量 < 需要的数量
   - 提示：题库中该类型题目不足
   - 可选择：减少数量 或 放宽条件
4. 将抽取的题目复制到question表，关联到exam_id
5. 记录题目来源（bank_id, bank_item_id）
```

## 四、API接口设计

### 4.1 题库管理接口

```javascript
// 题库列表
GET /study/questionBank/list
// 题库详情
GET /study/questionBank/{id}
// 新增题库
POST /study/questionBank
// 修改题库
PUT /study/questionBank
// 删除题库
DELETE /study/questionBank/{ids}
// 题库题目列表
GET /study/questionBank/{bankId}/items
```

### 4.2 题目管理接口

```javascript
// 添加题目到题库
POST /study/questionBank/{bankId}/items
// 修改题库题目
PUT /study/questionBank/items/{id}
// 删除题库题目
DELETE /study/questionBank/items/{ids}
// 批量导入题目
POST /study/questionBank/{bankId}/import
// 下载导入模板
GET /study/questionBank/template
```

### 4.3 随机抽题接口

```javascript
// 从题库随机抽题
POST /study/exam/{examId}/random-questions
// 请求参数：
{
  "bankId": 1,
  "questionConfig": [
    {
      "type": "single",
      "count": 10,
      "difficulty": "medium",  // 可选
      "knowledgePoint": "xxx"   // 可选
    },
    {
      "type": "multiple",
      "count": 5
    }
  ]
}
```

## 五、前端页面设计

### 5.1 菜单结构
```
学习系统
  ├── 学科分类
  ├── 班级管理
  ├── 课件管理
  ├── 课程管理
  ├── 课程分配
  ├── 学习记录
  ├── 学习监控
  ├── 用户审核
  ├── 班级用户管理
  ├── 考试管理
  ├── 成绩管理
  ├── 语音评测
  └── 题库管理（新增） ← 新增菜单
      ├── 题库列表
      └── 题目管理
```

### 5.2 页面文件结构
```
ruoyi-ui/src/views/study/questionBank/
  ├── index.vue          # 题库列表
  ├── detail.vue         # 题库详情和题目管理
  └── components/
      ├── QuestionForm.vue      # 题目表单组件
      ├── ImportDialog.vue      # 导入对话框
      └── QuestionPreview.vue   # 题目预览组件
```

### 5.3 修改现有页面
- `exam/create.vue`：增加"从题库抽取"选项
- `exam/index.vue`：显示题目来源标识

## 六、实现步骤

### 第一阶段：数据库和基础功能
1. ✅ 创建数据库表（question_bank, question_bank_item）
2. ✅ 修改question表，添加来源字段
3. ✅ 创建后端实体类、Mapper、Service、Controller
4. ✅ 创建前端API文件

### 第二阶段：题库管理功能
1. ✅ 题库列表页面
2. ✅ 题库新增/编辑功能
3. ✅ 题库题目列表和CRUD
4. ✅ 手动添加题目功能

### 第三阶段：题目导入功能
1. ✅ Excel模板生成和下载
2. ✅ Excel文件解析
3. ✅ 数据验证和导入
4. ✅ 导入结果反馈

### 第四阶段：随机抽题功能
1. ✅ 修改考试创建页面，增加抽题选项
2. ✅ 题库选择界面
3. ✅ 题型配置界面
4. ✅ 后端抽题算法实现
5. ✅ 题目预览和确认

### 第五阶段：优化和测试
1. ✅ 抽题算法优化（避免重复、难度分布等）
2. ✅ 性能优化（大量题目时的查询优化）
3. ✅ 异常处理（题目不足时的提示）
4. ✅ 单元测试和集成测试

## 七、技术要点

### 7.1 Excel导入
- **前端**：使用 `xlsx` 库解析Excel
- **后端**：使用 `EasyExcel` 或 `Apache POI` 解析
- **验证**：题目格式验证、必填项检查、选项格式验证

### 7.2 随机抽题算法
```java
// 核心算法
1. 根据条件查询符合条件的题目列表
2. 使用Collections.shuffle()打乱顺序
3. 取前N个题目
4. 检查是否有重复（如果题库题目可能重复）
```

### 7.3 性能优化
- 题库题目表添加索引（bank_id, question_type, difficulty）
- 大量题目时使用分页查询
- 抽题时使用数据库随机函数（ORDER BY RAND()）或应用层随机

## 八、注意事项

1. **数据一致性**：
   - 删除题库时，检查是否有考试正在使用该题库的题目
   - 删除题库题目时，检查是否已被考试使用

2. **权限控制**：
   - 教师只能管理自己创建的题库
   - 管理员可以管理所有题库

3. **题目去重**：
   - 导入时检查重复题目（可根据题干内容判断）
   - 抽题时避免同一题目被多次抽取

4. **用户体验**：
   - 导入失败时，详细提示错误原因和行号
   - 抽题时，实时显示可抽取的题目数量
   - 题目不足时，提供友好的提示和建议

## 九、扩展功能（可选）

1. **题目标签系统**：支持给题目打标签，按标签筛选
2. **题目难度自动评估**：基于答题数据自动调整难度
3. **题目使用统计**：统计题目被使用的次数和正确率
4. **题库共享**：支持题库在教师间共享
5. **题目审核**：支持题目审核流程

---

## 确认事项

请确认以下内容：
1. ✅ 数据库表结构设计是否合理？
2. ✅ 功能模块划分是否清晰？
3. ✅ 随机抽题的规则是否符合需求？
4. ✅ Excel导入格式是否满足要求？
5. ✅ 是否需要其他扩展功能？

确认后即可开始实现。