# 题库上传和随机抽题功能设计方案 ## 一、功能概述 在现有考试系统基础上，新增题库管理功能，支持： 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. ✅ 是否需要其他扩展功能？ 确认后即可开始实现。