222 lines
7.3 KiB
Markdown
222 lines
7.3 KiB
Markdown
# 问卷功能完整实现方案
|
||
|
||
## 📋 需求概述
|
||
|
||
系统需要支持完整的问卷功能，包括：
|
||
1. **问卷在量表管理中显示**：创建的问卷能够出现在量表管理中
|
||
2. **问卷答题功能**：用户填写完问卷后，客观题自动打分，主观题传给管理员进行打分
|
||
3. **多种题目类型支持**：单选、多选、判断、填空、排序、计算、简答、问答、作文等
|
||
4. **多种组卷形式**：自助组卷、随机组卷、手动随机相结合
|
||
5. **成绩排名统计**：客观题系统自动实现打分，成绩自动排名统计
|
||
|
||
---
|
||
|
||
## 🎯 实现方案
|
||
|
||
### 阶段一：让问卷显示在量表管理中
|
||
|
||
#### 方案1：统一查询接口（推荐）
|
||
- 修改量表列表查询，同时返回问卷数据
|
||
- 添加类型标识字段（`sourceType`: 'scale' 或 'questionnaire'）
|
||
- 前端统一显示，根据类型标识区分操作
|
||
|
||
#### 方案2：创建统一视图
|
||
- 在数据库创建视图，统一量表和问卷
|
||
- 查询时使用视图
|
||
|
||
**选择方案1**，因为更灵活，不需要修改数据库结构。
|
||
|
||
---
|
||
|
||
### 阶段二：问卷答题功能
|
||
|
||
参考量表测评的实现方式：
|
||
|
||
1. **开始问卷**：创建问卷答题记录
|
||
2. **获取题目**：根据组卷方式获取题目列表
|
||
3. **保存答案**：实时保存用户答案
|
||
4. **提交问卷**：
|
||
- 客观题自动计分
|
||
- 主观题标记为待评分
|
||
- 计算客观题总分
|
||
- 更新排名
|
||
|
||
---
|
||
|
||
### 阶段三：自动打分功能
|
||
|
||
#### 客观题类型
|
||
- **radio（单选）**：根据选项的`is_correct`和`option_score`计分
|
||
- **checkbox（多选）**：全对得满分，部分对按比例得分
|
||
- **boolean（判断）**：根据选项的`is_correct`计分
|
||
- **input（填空）**：如果有标准答案，进行文本匹配（支持模糊匹配）
|
||
- **sort（排序）**：顺序完全正确得满分，部分正确按比例得分
|
||
- **calculate（计算）**：数值匹配，允许误差范围
|
||
|
||
#### 主观题类型
|
||
- **text（简答）**：需要管理员评分
|
||
- **textarea（问答）**：需要管理员评分
|
||
- **essay（作文）**：需要管理员评分
|
||
- **input（无标准答案）**：需要管理员评分
|
||
|
||
---
|
||
|
||
### 阶段四：主观题评分管理
|
||
|
||
1. **待评分列表**：显示所有待评分的主观题
|
||
2. **评分界面**：管理员可以查看题目、答案，进行评分
|
||
3. **批量评分**：支持批量评分功能
|
||
4. **评分后更新**：评分后更新总分和排名
|
||
|
||
---
|
||
|
||
### 阶段五：成绩排名统计
|
||
|
||
1. **排名计算**：
|
||
- 按总分从高到低排序
|
||
- 相同分数按提交时间排序（先提交的排名靠前）
|
||
2. **排名更新**：提交问卷或评分后自动更新排名
|
||
3. **排名查询**：支持按问卷查询排名列表
|
||
|
||
---
|
||
|
||
## 📁 需要创建/修改的文件
|
||
|
||
### 数据库
|
||
- [x] `psy_questionnaire` - 问卷表（已存在）
|
||
- [x] `psy_questionnaire_item` - 问卷题目表（已存在）
|
||
- [x] `psy_questionnaire_option` - 问卷选项表（已存在）
|
||
- [x] `psy_questionnaire_answer` - 问卷答题记录表（已存在）
|
||
- [ ] `psy_questionnaire_answer_detail` - 问卷答案详情表（需要创建）
|
||
|
||
### 后端Java文件
|
||
- [ ] `PsyQuestionnaireAnswerDetail.java` - 问卷答案详情实体类
|
||
- [ ] `PsyQuestionnaireAnswerDetailMapper.java` - Mapper接口
|
||
- [ ] `PsyQuestionnaireAnswerDetailMapper.xml` - MyBatis映射
|
||
- [ ] `IPsyQuestionnaireAnswerService.java` - 问卷答题服务接口
|
||
- [ ] `PsyQuestionnaireAnswerServiceImpl.java` - 问卷答题服务实现
|
||
- [ ] `PsyQuestionnaireController.java` - 问卷控制器（需要增强）
|
||
- [ ] `PsyScaleController.java` - 量表控制器（需要修改列表查询）
|
||
|
||
### 前端Vue文件
|
||
- [ ] `questionnaire/taking.vue` - 问卷答题页面
|
||
- [ ] `questionnaire/start.vue` - 开始问卷页面
|
||
- [ ] `questionnaire/scoring.vue` - 主观题评分页面
|
||
- [ ] `questionnaire/ranking.vue` - 成绩排名页面
|
||
- [ ] `scale/index.vue` - 量表管理页面（需要修改，显示问卷）
|
||
|
||
---
|
||
|
||
## 🔧 技术实现细节
|
||
|
||
### 1. 量表列表统一显示问卷
|
||
|
||
**后端修改**：
|
||
```java
|
||
// PsyScaleController.java
|
||
@GetMapping("/list")
|
||
public TableDataInfo list(PsyScale scale, @RequestParam(required = false) Boolean includeQuestionnaire)
|
||
{
|
||
startPage();
|
||
List<PsyScale> scaleList = scaleService.selectScaleList(scale);
|
||
|
||
// 如果需要包含问卷
|
||
if (includeQuestionnaire != null && includeQuestionnaire) {
|
||
List<PsyQuestionnaire> questionnaireList = questionnaireService.selectQuestionnaireList(...);
|
||
// 转换为统一的Scale格式，添加sourceType标识
|
||
// 合并到scaleList
|
||
}
|
||
|
||
return getDataTable(scaleList);
|
||
}
|
||
```
|
||
|
||
**前端修改**：
|
||
```javascript
|
||
// scale/index.vue
|
||
// 在表格中添加类型列
|
||
<el-table-column label="类型" prop="sourceType" width="100">
|
||
<template slot-scope="scope">
|
||
<el-tag v-if="scope.row.sourceType === 'questionnaire'" type="warning">问卷</el-tag>
|
||
<el-tag v-else type="primary">量表</el-tag>
|
||
</template>
|
||
</el-table-column>
|
||
```
|
||
|
||
### 2. 问卷答题流程
|
||
|
||
参考量表测评的实现：
|
||
1. 开始问卷 → 创建`PsyQuestionnaireAnswer`记录
|
||
2. 获取题目 → 根据`paper_type`获取题目列表
|
||
3. 保存答案 → 保存到`PsyQuestionnaireAnswerDetail`
|
||
4. 提交问卷 → 自动计分 + 更新排名
|
||
|
||
### 3. 自动计分逻辑
|
||
|
||
```java
|
||
// 客观题计分
|
||
private BigDecimal calculateObjectiveScore(PsyQuestionnaireItem item, AnswerDetailVO answer) {
|
||
switch(item.getItemType()) {
|
||
case "radio":
|
||
// 单选：检查选项是否正确
|
||
return checkOptionCorrect(item, answer.getOptionId()) ? item.getScore() : BigDecimal.ZERO;
|
||
case "checkbox":
|
||
// 多选：检查所有选项是否正确
|
||
return calculateMultiChoiceScore(item, answer.getOptionIds());
|
||
case "boolean":
|
||
// 判断：检查选项是否正确
|
||
return checkOptionCorrect(item, answer.getOptionId()) ? item.getScore() : BigDecimal.ZERO;
|
||
case "input":
|
||
// 填空：文本匹配
|
||
return checkTextMatch(item, answer.getAnswerText()) ? item.getScore() : BigDecimal.ZERO;
|
||
// ... 其他类型
|
||
}
|
||
}
|
||
```
|
||
|
||
### 4. 排名计算
|
||
|
||
```sql
|
||
-- 更新排名
|
||
UPDATE psy_questionnaire_answer qa
|
||
SET qa.rank = (
|
||
SELECT COUNT(*) + 1
|
||
FROM psy_questionnaire_answer qa2
|
||
WHERE qa2.questionnaire_id = qa.questionnaire_id
|
||
AND (
|
||
qa2.total_score > qa.total_score
|
||
OR (qa2.total_score = qa.total_score AND qa2.submit_time < qa.submit_time)
|
||
)
|
||
)
|
||
WHERE qa.questionnaire_id = #{questionnaireId}
|
||
AND qa.status = '1'
|
||
```
|
||
|
||
---
|
||
|
||
## 📌 实施步骤
|
||
|
||
1. ✅ **创建问卷答案详情表**（SQL）
|
||
2. ⏳ **修改量表列表查询，包含问卷**（后端）
|
||
3. ⏳ **修改量表管理页面，显示问卷**（前端）
|
||
4. ⏳ **创建问卷答题功能**（后端+前端）
|
||
5. ⏳ **实现自动计分功能**（后端）
|
||
6. ⏳ **实现主观题评分功能**（后端+前端）
|
||
7. ⏳ **实现成绩排名功能**（后端+前端）
|
||
|
||
---
|
||
|
||
## ⚠️ 注意事项
|
||
|
||
1. 问卷和量表的数据结构不同，需要统一转换
|
||
2. 组卷方式（随机、手动、混合）需要在获取题目时实现
|
||
3. 主观题评分需要权限控制
|
||
4. 排名计算要考虑性能，可能需要定时任务
|
||
5. 填空题的文本匹配需要考虑容错性
|
||
|
||
---
|
||
|
||
**创建时间**: 2025-01-XX
|
||
**最后更新**: 2025-01-XX
|
||
|