# 自定义问卷功能增强开发记录

## 📋 任务概述

**开发日期**: 2025-01-XX  
**模块名称**: 自定义问卷功能增强  
**任务类型**: 功能增强与完善

---

## 🎯 需求说明

### 1. 菜单统一
- ✅ 删除"问卷管理"菜单，统一使用"自定义问卷"

### 2. 问卷测评功能
- 自定义问卷要像量表一样可以分配给用户进行测量
- 管理员可以设置对应的得分
- 在解释配置中可以设定对应的分数进行说明测量之后的结果

### 3. 题目类型支持
- 支持多种题目类型：单选、多选、判断、填空、排序、计算、简答、问答、作文

### 4. 主观题评分
- 管理员能汇总主观题进行评分

### 5. 成绩排名
- 管理员能查看所有问卷人员以及对应的分数和排名
- 排名从上往下是第一名往下排队

---

## ✅ 已完成工作

### 1. 菜单统一 ✅
- ✅ 修改SQL脚本，将"问卷管理"菜单改为"自定义问卷"
- ✅ 修改前端路由，将"问卷管理"改为"自定义问卷"
- ✅ 更新菜单图标为`edit`

**修改文件**:
- `sql/psychological_system_complete.sql` - 菜单配置SQL
- `ruoyi-ui/src/router/index.js` - 前端路由配置

### 2. 数据库表结构增强 ✅
- ✅ 创建问卷答案详情表 `psy_questionnaire_answer_detail`
  - 存储每道题的答案
  - 支持客观题和主观题
  - 支持管理员评分功能
- ✅ 修改解释配置表 `psy_result_interpretation`
  - 添加 `questionnaire_id` 字段，支持问卷解释配置
  - 添加索引和外键约束

**新增表结构**:
```sql
-- 问卷答案详情表
psy_questionnaire_answer_detail
  - detail_id: 详情ID
  - answer_id: 答案ID（关联问卷答题记录）
  - item_id: 题目ID
  - option_id: 选项ID（单选/判断）
  - option_ids: 选项ID列表（多选）
  - answer_text: 文本答案（填空、简答、问答、作文）
  - answer_score: 答案得分
  - is_subjective: 是否主观题
  - is_scored: 是否已评分
  - scored_by: 评分人
  - scored_time: 评分时间
```

**修改表结构**:
```sql
-- 解释配置表
psy_result_interpretation
  - questionnaire_id: 问卷ID（新增）
```

---

## 🚧 待完成工作

### 1. 问卷测评功能（类似量表测评）
- [ ] 创建问卷测评实体类 `PsyQuestionnaireAnswerDetail`
- [ ] 创建问卷测评Mapper和Service
- [ ] 创建问卷测评Controller
  - [ ] 开始问卷测评接口
  - [ ] 获取问卷题目接口
  - [ ] 保存答案接口
  - [ ] 提交问卷接口
  - [ ] 自动计分服务（客观题）
- [ ] 创建问卷测评前端页面
  - [ ] 问卷列表页面
  - [ ] 开始问卷页面
  - [ ] 答题页面（支持多种题型）
  - [ ] 提交问卷页面

### 2. 多种题目类型支持
- [ ] 题目类型枚举定义
  - [ ] radio: 单选
  - [ ] checkbox: 多选
  - [ ] boolean: 判断
  - [ ] input: 填空
  - [ ] sort: 排序
  - [ ] calculate: 计算
  - [ ] text: 简答
  - [ ] textarea: 问答
  - [ ] essay: 作文
- [ ] 题目管理页面增强
  - [ ] 题目类型选择器
  - [ ] 不同题型的编辑界面
  - [ ] 选项配置（单选、多选、判断）
  - [ ] 文本答案配置（填空、简答、问答、作文）

### 3. 主观题评分功能
- [ ] 主观题评分管理页面
  - [ ] 待评分题目列表
  - [ ] 评分界面
  - [ ] 批量评分功能
- [ ] 主观题评分接口
  - [ ] 获取待评分题目接口
  - [ ] 提交评分接口
  - [ ] 批量评分接口

### 4. 成绩排名功能
- [ ] 成绩排名查询接口
  - [ ] 按问卷ID查询排名
  - [ ] 按用户ID查询排名
  - [ ] 排名计算逻辑（从高到低）
- [ ] 成绩排名展示页面
  - [ ] 排名列表（表格）
  - [ ] 排名统计图表
  - [ ] 导出排名数据

### 5. 解释配置增强
- [ ] 解释配置页面增强
  - [ ] 支持选择问卷
  - [ ] 问卷解释配置界面
- [ ] 解释配置查询接口
  - [ ] 按问卷ID查询解释
  - [ ] 按分数范围匹配解释

---

## 📁 涉及文件

### 后端文件
- `ry-news-system/src/main/java/com/ddnai/system/domain/psychology/PsyQuestionnaireAnswerDetail.java` (待创建)
- `ry-news-system/src/main/java/com/ddnai/system/mapper/psychology/PsyQuestionnaireAnswerDetailMapper.java` (待创建)
- `ry-news-system/src/main/java/com/ddnai/system/service/psychology/IPsyQuestionnaireAnswerDetailService.java` (待创建)
- `ry-news-system/src/main/java/com/ddnai/system/service/impl/psychology/PsyQuestionnaireAnswerDetailServiceImpl.java` (待创建)
- `ry-news-admin/src/main/java/com/ddnai/web/controller/psychology/PsyQuestionnaireAnswerController.java` (待创建)
- `ry-news-system/src/main/java/com/ddnai/system/domain/psychology/PsyResultInterpretation.java` (待修改)
- `ry-news-system/src/main/resources/mapper/system/psychology/PsyQuestionnaireAnswerDetailMapper.xml` (待创建)

### 前端文件
- `ruoyi-ui/src/views/psychology/questionnaire/answer/index.vue` (待创建)
- `ruoyi-ui/src/views/psychology/questionnaire/answer/taking.vue` (待创建)
- `ruoyi-ui/src/views/psychology/questionnaire/score/index.vue` (待创建)
- `ruoyi-ui/src/views/psychology/questionnaire/rank/index.vue` (待创建)
- `ruoyi-ui/src/api/psychology/questionnaire.js` (待修改)

### 数据库文件
- `sql/psychological_system_complete.sql` (已修改)

---

## 📝 技术要点

### 1. 题目类型判断
- 客观题：radio、checkbox、boolean、input（有标准答案）、sort、calculate
- 主观题：text、textarea、essay、input（无标准答案）

### 2. 自动计分逻辑
- 客观题：提交时自动计算得分
- 主观题：需要管理员手动评分

### 3. 排名计算
- 按总分从高到低排序
- 相同分数按提交时间排序（先提交的排名靠前）

### 4. 解释配置匹配
- 根据问卷ID和分数范围匹配解释
- 支持多个分数区间配置

---

## ⚠️ 注意事项

1. 问卷测评功能要参考量表测评的实现方式
2. 题目类型要支持所有9种类型
3. 主观题评分要有明确的权限控制
4. 排名计算要考虑相同分数的情况
5. 解释配置要同时支持量表和问卷

---

## 📌 下一步计划

1. 创建问卷答案详情实体类和Mapper
2. 实现问卷测评基础功能（开始、答题、提交）
3. 实现多种题目类型的答题界面
4. 实现主观题评分功能
5. 实现成绩排名功能
6. 完善解释配置功能

---

**创建时间**: 2025-01-XX  
**最后更新**: 2025-01-XX