153 lines
4.4 KiB
Markdown
153 lines
4.4 KiB
Markdown
# 管理员快速填充功能说明
|
||
|
||
## 📋 功能概述
|
||
|
||
管理员在进行量表测评时，可以使用"快速填充"功能，自动选择所有题目的特定选项并提交测评。此功能主要用于测试和快速验证量表功能。
|
||
|
||
## 🎯 功能特性
|
||
|
||
### 1. 管理员专用
|
||
- 只有管理员（userId === 1 或 roles 包含 'admin'）才能看到和使用此功能
|
||
- 普通用户无法看到快速填充按钮
|
||
|
||
### 2. 快速填充策略
|
||
系统提供4种填充策略：
|
||
|
||
#### ① 填充第一个选项并提交
|
||
- 为所有题目选择第一个选项（选项A或第一个选项）
|
||
- 适用于测试最低分或基础功能
|
||
|
||
#### ② 填充中间选项并提交
|
||
- 为所有题目选择中间选项
|
||
- 例如：5个选项中选择第3个，4个选项中选择第2个
|
||
|
||
#### ③ 填充最后一个选项并提交
|
||
- 为所有题目选择最后一个选项
|
||
- 适用于测试最高分或极端情况
|
||
|
||
#### ④ 随机填充并提交
|
||
- 为每个题目随机选择一个选项
|
||
- 适用于模拟真实答题情况
|
||
|
||
### 3. 自动处理
|
||
- 自动处理单选题、多选题、矩阵题
|
||
- 自动计算得分
|
||
- 自动保存所有答案
|
||
- 自动提交测评并生成报告
|
||
|
||
## 📝 使用方法
|
||
|
||
### 步骤1：进入测评页面
|
||
1. 登录系统（管理员账户）
|
||
2. 进入 `心理测评管理` → `测评记录`
|
||
3. 点击 **"开始测评"** 或 **"继续测评"**
|
||
|
||
### 步骤2：使用快速填充
|
||
1. 在测评页面顶部，找到 **"快速填充"** 按钮
|
||
2. 点击下拉箭头，选择填充策略：
|
||
- 填充第一个选项并提交
|
||
- 填充中间选项并提交
|
||
- 填充最后一个选项并提交
|
||
- 随机填充并提交
|
||
|
||
### 步骤3：确认并执行
|
||
1. 系统会弹出确认对话框
|
||
2. 点击 **"确定"** 后，系统会：
|
||
- 自动填充所有题目
|
||
- 保存所有答案
|
||
- 提交测评
|
||
- 生成测评报告
|
||
3. 完成后自动跳转到测评记录页面
|
||
|
||
## ⚙️ 技术实现
|
||
|
||
### 前端实现
|
||
- **文件位置**：`ruoyi-ui/src/views/psychology/assessment/taking.vue`
|
||
- **关键方法**：
|
||
- `handleQuickFill(command)`: 处理快速填充命令
|
||
- `performQuickFill(command)`: 执行快速填充逻辑
|
||
- `saveAnswerToServerPromise(answer)`: 保存答案到服务器
|
||
|
||
### 权限控制
|
||
- 使用 `isAdmin` 计算属性判断管理员身份
|
||
- 通过 `v-if="isAdmin"` 控制按钮显示
|
||
- 在方法中再次验证权限
|
||
|
||
### 填充逻辑
|
||
```javascript
|
||
// 选项选择策略
|
||
switch (command) {
|
||
case 'first': // 第一个选项
|
||
case 'middle': // 中间选项
|
||
case 'last': // 最后一个选项
|
||
case 'random': // 随机选项
|
||
}
|
||
|
||
// 自动保存和提交
|
||
Promise.all(fillPromises).then(() => {
|
||
submitAssessment(this.assessmentId)
|
||
})
|
||
```
|
||
|
||
## 🔒 安全特性
|
||
|
||
1. **权限验证**：双重验证管理员身份
|
||
2. **确认对话框**：防止误操作
|
||
3. **错误处理**：完善的错误处理和提示
|
||
4. **日志记录**：记录填充操作的日志
|
||
|
||
## ⚠️ 注意事项
|
||
|
||
1. **不可撤销**：快速填充并提交后，测评结果无法修改
|
||
2. **覆盖已有答案**：如果题目已有答案，快速填充会覆盖原有答案
|
||
3. **多选题处理**：多选题目前只选择第一个选项（可根据需要调整）
|
||
4. **测试用途**：此功能主要用于测试，不建议用于真实测评数据
|
||
|
||
## 📊 使用场景
|
||
|
||
### 适用场景
|
||
- ✅ 测试量表功能是否正常
|
||
- ✅ 快速生成测试报告
|
||
- ✅ 验证报告生成功能
|
||
- ✅ 系统功能演示
|
||
|
||
### 不适用场景
|
||
- ❌ 真实用户测评
|
||
- ❌ 正式的数据收集
|
||
- ❌ 需要准确答案的测评
|
||
|
||
## 🔧 自定义配置
|
||
|
||
如果需要修改填充策略，可以编辑 `performQuickFill` 方法中的 `optionStrategy` 函数。
|
||
|
||
例如，修改多选题策略为选择所有选项：
|
||
```javascript
|
||
else if (item.itemType === 'multiple') {
|
||
// 多选题，选择所有选项
|
||
selectedOptions = options.map(opt => opt.optionId);
|
||
const totalScore = options.reduce((sum, opt) => sum + (opt.optionScore || 0), 0);
|
||
// ...
|
||
}
|
||
```
|
||
|
||
## ✅ 验证清单
|
||
|
||
使用前请确认：
|
||
- [ ] 当前用户是管理员
|
||
- [ ] 测评状态为"进行中"
|
||
- [ ] 量表包含题目
|
||
- [ ] 所有题目都有选项
|
||
|
||
## 📚 相关文件
|
||
|
||
- `ruoyi-ui/src/views/psychology/assessment/taking.vue` - 测评页面
|
||
- `ruoyi-ui/src/api/psychology/assessment.js` - 测评API
|
||
|
||
## 🎉 更新日志
|
||
|
||
- **2025-01-XX**：添加管理员快速填充功能
|
||
- 支持4种填充策略
|
||
- 自动保存和提交
|
||
- 完善的权限控制和错误处理
|
||
|