420 lines
11 KiB
Markdown
420 lines
11 KiB
Markdown
|
# 心理测评系统 - 功能使用指南
|
|||
|
|
|
|||
|
|
## 📋 目录
|
|||
|
|
1. [新用户使用流程](#新用户使用流程)
|
|||
|
|
2. [管理员使用流程](#管理员使用流程)
|
|||
|
|
3. [功能测试清单](#功能测试清单)
|
|||
|
|
4. [常见问题](#常见问题)
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 👤 新用户使用流程
|
|||
|
|
|
|||
|
|
### 步骤1：登录系统
|
|||
|
|
1. 访问系统首页（通常是 `http://localhost:80` 或部署后的地址）
|
|||
|
|
2. 使用账号密码登录（如果没有账号，需要管理员创建）
|
|||
|
|
|
|||
|
|
### 步骤2：开始心理测评
|
|||
|
|
|
|||
|
|
#### 2.1 进入测评管理
|
|||
|
|
- 登录后，在左侧菜单找到 **"心理测评管理"** → **"测评管理"**
|
|||
|
|
- 或直接访问路由：`/psychology/assessment`
|
|||
|
|
|
|||
|
|
#### 2.2 开始新测评
|
|||
|
|
1. 点击页面上的 **"开始测评"** 按钮
|
|||
|
|
2. 进入测评选择页面（`/psychology/assessment/start`）
|
|||
|
|
|
|||
|
|
#### 2.3 填写测评信息
|
|||
|
|
在测评选择页面：
|
|||
|
|
- **选择量表**：从下拉框中选择想要测试的量表
|
|||
|
|
- **填写被测评人信息**：
|
|||
|
|
- 姓名（必填）
|
|||
|
|
- 性别（男/女）
|
|||
|
|
- 年龄（可选）
|
|||
|
|
- 手机号（可选）
|
|||
|
|
|
|||
|
|
#### 2.4 开始答题
|
|||
|
|
1. 点击 **"开始测评"** 按钮
|
|||
|
|
2. 系统会自动跳转到答题页面（`/psychology/assessment/taking`）
|
|||
|
|
|
|||
|
|
#### 2.5 答题界面功能
|
|||
|
|
- **题目显示**：显示当前题目和选项
|
|||
|
|
- **进度条**：显示答题进度
|
|||
|
|
- **导航按钮**：
|
|||
|
|
- **上一题**：返回上一题
|
|||
|
|
- **下一题**：进入下一题
|
|||
|
|
- **暂停测评**：保存当前进度，稍后继续
|
|||
|
|
- **提交测评**：完成所有题目后提交
|
|||
|
|
|
|||
|
|
#### 2.6 查看测评结果
|
|||
|
|
- 提交测评后，系统会自动生成测评报告
|
|||
|
|
- 返回测评列表页面，找到刚才完成的测评
|
|||
|
|
- 点击 **"查看报告"** 按钮查看详细结果
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 步骤3：查看心理网站内容
|
|||
|
|
|
|||
|
|
#### 3.1 访问心理网站内容（需要管理员配置）
|
|||
|
|
**目前状态**：心理网站内容管理功能已在后台实现，但**前台展示页面尚未开发**。
|
|||
|
|
|
|||
|
|
**临时方案**：
|
|||
|
|
1. 可以通过后台管理查看内容：**"心理网站管理"** → **"网站内容管理"**
|
|||
|
|
2. 或者等待前台展示页面开发完成
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🔧 管理员使用流程
|
|||
|
|
|
|||
|
|
### 一、量表管理
|
|||
|
|
|
|||
|
|
#### 1.1 创建新量表
|
|||
|
|
**路径**：`心理测评管理` → `量表管理`
|
|||
|
|
|
|||
|
|
**操作步骤**：
|
|||
|
|
1. 点击 **"新增"** 按钮
|
|||
|
|
2. 填写量表基本信息：
|
|||
|
|
- **量表编码**：唯一标识，如 `SAI_001`
|
|||
|
|
- **量表名称**：如 `焦虑自评量表`
|
|||
|
|
- **量表类型**：选择类型（情绪、人格、行为等）
|
|||
|
|
- **量表简介**：简短介绍
|
|||
|
|
- **量表描述**：详细描述
|
|||
|
|
- **题目数量**：预计题目数
|
|||
|
|
- **预计完成时间**：分钟数
|
|||
|
|
- **适用人群**：如 `一般人群`
|
|||
|
|
- **作者**：量表作者
|
|||
|
|
- **来源**：量表来源
|
|||
|
|
- **状态**：选择 `正常` 或 `停用`
|
|||
|
|
3. 点击 **"确定"** 保存
|
|||
|
|
|
|||
|
|
#### 1.2 编辑量表
|
|||
|
|
1. 在量表列表中找到要编辑的量表
|
|||
|
|
2. 点击 **"修改"** 按钮
|
|||
|
|
3. 修改信息后点击 **"确定"** 保存
|
|||
|
|
|
|||
|
|
#### 1.3 删除量表
|
|||
|
|
1. 勾选要删除的量表
|
|||
|
|
2. 点击 **"删除"** 按钮
|
|||
|
|
3. 确认删除
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 二、题目管理
|
|||
|
|
|
|||
|
|
#### 2.1 为量表添加题目
|
|||
|
|
**路径**：`心理测评管理` → `量表管理` → 点击某个量表的 **"题目管理"** 按钮
|
|||
|
|
|
|||
|
|
**操作步骤**：
|
|||
|
|
1. 在题目管理页面点击 **"新增"** 按钮
|
|||
|
|
2. 填写题目信息：
|
|||
|
|
- **题号**：题目序号
|
|||
|
|
- **题目内容**：题目文本
|
|||
|
|
- **题目类型**：
|
|||
|
|
- `single`：单选题
|
|||
|
|
- `multiple`：多选题
|
|||
|
|
- `matrix`：矩阵题
|
|||
|
|
- **是否必答**：是/否
|
|||
|
|
- **排序顺序**：数字越小越靠前
|
|||
|
|
3. 点击 **"确定"** 保存题目
|
|||
|
|
4. 为题目添加选项（见下方）
|
|||
|
|
|
|||
|
|
#### 2.2 为题目添加选项
|
|||
|
|
1. 在题目列表中，找到要添加选项的题目
|
|||
|
|
2. 点击该题目行的 **"选项管理"** 或相关按钮
|
|||
|
|
3. 在选项管理页面点击 **"新增"** 按钮
|
|||
|
|
4. 填写选项信息：
|
|||
|
|
- **选项编码**：如 `A`、`B`、`C`、`D`
|
|||
|
|
- **选项内容**：选项文本
|
|||
|
|
- **选项分值**：选择该选项的得分
|
|||
|
|
- **排序顺序**：选项显示顺序
|
|||
|
|
5. 点击 **"确定"** 保存
|
|||
|
|
|
|||
|
|
**选项示例**（5点量表）：
|
|||
|
|
- A. 完全不符合（1分）
|
|||
|
|
- B. 不太符合（2分）
|
|||
|
|
- C. 一般（3分）
|
|||
|
|
- D. 比较符合（4分）
|
|||
|
|
- E. 完全符合（5分）
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 三、因子与计分规则
|
|||
|
|
|
|||
|
|
#### 3.1 创建因子
|
|||
|
|
**路径**：`心理测评管理` → `量表管理` → 点击某个量表的 **"因子管理"** 按钮
|
|||
|
|
|
|||
|
|
**操作步骤**：
|
|||
|
|
1. 点击 **"新增"** 按钮
|
|||
|
|
2. 填写因子信息：
|
|||
|
|
- **因子编码**：如 `ANXIETY`（焦虑）、`DEPRESSION`（抑郁）
|
|||
|
|
- **因子名称**：如 `焦虑因子`、`抑郁因子`
|
|||
|
|
- **因子描述**：因子说明
|
|||
|
|
- **计算方式**：
|
|||
|
|
- `sum`：求和
|
|||
|
|
- `average`：平均
|
|||
|
|
- `weighted_sum`：加权求和
|
|||
|
|
3. 点击 **"确定"** 保存
|
|||
|
|
|
|||
|
|
#### 3.2 配置因子计分规则
|
|||
|
|
1. 在因子列表中，找到要配置的因子
|
|||
|
|
2. 点击 **"计分规则"** 或相关按钮
|
|||
|
|
3. 选择该因子包含的题目：
|
|||
|
|
- 勾选属于该因子的题目
|
|||
|
|
- 设置权重（默认1.0）
|
|||
|
|
- 设置计算类型（sum/average）
|
|||
|
|
4. 保存规则
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 四、设定解读方式（结果解释）
|
|||
|
|
|
|||
|
|
#### 4.1 创建结果解释规则
|
|||
|
|
**路径**：`心理测评管理` → `结果解释管理`（如果菜单存在）
|
|||
|
|
|
|||
|
|
**操作步骤**：
|
|||
|
|
1. 选择要配置的量表和因子
|
|||
|
|
2. 点击 **"新增"** 按钮
|
|||
|
|
3. 填写解释规则：
|
|||
|
|
- **分值范围**：
|
|||
|
|
- 最低分：如 `0`
|
|||
|
|
- 最高分：如 `20`
|
|||
|
|
- **等级**：`low`（低）、`medium`（中）、`high`（高）
|
|||
|
|
- **等级名称**：如 `轻度焦虑`、`中度焦虑`、`重度焦虑`
|
|||
|
|
- **解释标题**：如 `您的焦虑水平为轻度`
|
|||
|
|
- **解释内容**：详细解释文本
|
|||
|
|
- **建议**：针对性的建议
|
|||
|
|
4. 点击 **"确定"** 保存
|
|||
|
|
|
|||
|
|
**示例配置**：
|
|||
|
|
```
|
|||
|
|
因子：焦虑因子
|
|||
|
|
分值范围：0-20
|
|||
|
|
等级：low
|
|||
|
|
等级名称：轻度焦虑
|
|||
|
|
解释内容：您的焦虑水平处于正常范围，略高于平均水平...
|
|||
|
|
建议：保持当前状态，适当放松...
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 五、心理网站内容管理
|
|||
|
|
|
|||
|
|
#### 5.1 创建栏目
|
|||
|
|
**路径**：`心理网站管理` → `网站栏目管理`
|
|||
|
|
|
|||
|
|
**操作步骤**：
|
|||
|
|
1. 点击 **"新增"** 按钮
|
|||
|
|
2. 填写栏目信息：
|
|||
|
|
- **栏目名称**：如 `心理健康知识`、`心理测试`、`专家问答`
|
|||
|
|
- **栏目编码**：如 `health_knowledge`
|
|||
|
|
- **上级栏目**：选择父栏目（可为空，表示一级栏目）
|
|||
|
|
- **栏目类型**：选择类型
|
|||
|
|
- **图标**：栏目图标
|
|||
|
|
- **描述**：栏目描述
|
|||
|
|
- **排序顺序**：数字越小越靠前
|
|||
|
|
- **状态**：正常/停用
|
|||
|
|
3. 点击 **"确定"** 保存
|
|||
|
|
|
|||
|
|
#### 5.2 添加文章内容
|
|||
|
|
**路径**：`心理网站管理` → `网站内容管理`
|
|||
|
|
|
|||
|
|
**操作步骤**：
|
|||
|
|
1. 点击 **"新增"** 按钮
|
|||
|
|
2. 填写内容信息：
|
|||
|
|
- **内容类型**：文章/公告/轮播/链接
|
|||
|
|
- **归属栏目**：选择栏目（必填）
|
|||
|
|
- **标题**：文章标题（必填）
|
|||
|
|
- **副标题**：可选
|
|||
|
|
- **摘要**：文章摘要
|
|||
|
|
- **内容**：正文内容（富文本编辑器）
|
|||
|
|
- **封面图片**：上传封面
|
|||
|
|
- **作者**：文章作者
|
|||
|
|
- **来源**：文章来源
|
|||
|
|
- **状态**：正常/停用
|
|||
|
|
- **是否置顶**：是/否
|
|||
|
|
- **是否推荐**：是/否
|
|||
|
|
3. 点击 **"确定"** 保存
|
|||
|
|
|
|||
|
|
#### 5.3 管理评论
|
|||
|
|
**路径**：`心理网站管理` → `网站评论管理`
|
|||
|
|
|
|||
|
|
**功能**：
|
|||
|
|
- 查看所有评论
|
|||
|
|
- 审核评论（正常/停用）
|
|||
|
|
- 删除不当评论
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## ✅ 功能测试清单
|
|||
|
|
|
|||
|
|
### 新用户功能测试
|
|||
|
|
|
|||
|
|
- [ ] **登录系统**
|
|||
|
|
- [ ] 使用有效账号登录
|
|||
|
|
- [ ] 验证登录成功
|
|||
|
|
|
|||
|
|
- [ ] **开始测评**
|
|||
|
|
- [ ] 进入测评管理页面
|
|||
|
|
- [ ] 点击"开始测评"按钮
|
|||
|
|
- [ ] 选择量表
|
|||
|
|
- [ ] 填写被测评人信息
|
|||
|
|
- [ ] 成功开始测评
|
|||
|
|
|
|||
|
|
- [ ] **答题过程**
|
|||
|
|
- [ ] 查看题目和选项
|
|||
|
|
- [ ] 选择答案
|
|||
|
|
- [ ] 使用"上一题"按钮
|
|||
|
|
- [ ] 使用"下一题"按钮
|
|||
|
|
- [ ] 查看进度条
|
|||
|
|
- [ ] 暂停测评
|
|||
|
|
- [ ] 恢复暂停的测评
|
|||
|
|
- [ ] 提交测评
|
|||
|
|
|
|||
|
|
- [ ] **查看结果**
|
|||
|
|
- [ ] 查看测评报告
|
|||
|
|
- [ ] 验证报告内容正确性
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 管理员功能测试
|
|||
|
|
|
|||
|
|
#### 量表管理
|
|||
|
|
- [ ] **创建量表**
|
|||
|
|
- [ ] 新增量表成功
|
|||
|
|
- [ ] 验证量表编码唯一性
|
|||
|
|
- [ ] 查看量表列表
|
|||
|
|
|
|||
|
|
- [ ] **编辑量表**
|
|||
|
|
- [ ] 修改量表信息
|
|||
|
|
- [ ] 保存成功
|
|||
|
|
|
|||
|
|
- [ ] **删除量表**
|
|||
|
|
- [ ] 删除单个量表
|
|||
|
|
- [ ] 批量删除量表
|
|||
|
|
|
|||
|
|
#### 题目管理
|
|||
|
|
- [ ] **添加题目**
|
|||
|
|
- [ ] 新增单选题
|
|||
|
|
- [ ] 新增多选题
|
|||
|
|
- [ ] 新增矩阵题
|
|||
|
|
|
|||
|
|
- [ ] **管理选项**
|
|||
|
|
- [ ] 为题目添加选项
|
|||
|
|
- [ ] 设置选项分值
|
|||
|
|
- [ ] 编辑选项
|
|||
|
|
- [ ] 删除选项
|
|||
|
|
|
|||
|
|
#### 因子管理
|
|||
|
|
- [ ] **创建因子**
|
|||
|
|
- [ ] 新增因子
|
|||
|
|
- [ ] 配置因子计分规则
|
|||
|
|
- [ ] 关联题目到因子
|
|||
|
|
|
|||
|
|
#### 结果解释
|
|||
|
|
- [ ] **配置解释规则**
|
|||
|
|
- [ ] 创建解释规则
|
|||
|
|
- [ ] 设置分值范围
|
|||
|
|
- [ ] 填写解释内容
|
|||
|
|
- [ ] 验证报告生成时使用解释规则
|
|||
|
|
|
|||
|
|
#### 心理网站管理
|
|||
|
|
- [ ] **栏目管理**
|
|||
|
|
- [ ] 创建一级栏目
|
|||
|
|
- [ ] 创建二级栏目
|
|||
|
|
- [ ] 编辑栏目
|
|||
|
|
- [ ] 删除栏目
|
|||
|
|
|
|||
|
|
- [ ] **内容管理**
|
|||
|
|
- [ ] 创建文章
|
|||
|
|
- [ ] 选择栏目
|
|||
|
|
- [ ] 编辑内容
|
|||
|
|
- [ ] 设置封面图片
|
|||
|
|
- [ ] 发布文章
|
|||
|
|
|
|||
|
|
- [ ] **评论管理**
|
|||
|
|
- [ ] 查看评论
|
|||
|
|
- [ ] 审核评论
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## ❓ 常见问题
|
|||
|
|
|
|||
|
|
### Q1: 如何测试测评功能？
|
|||
|
|
**A**:
|
|||
|
|
1. 先以管理员身份登录
|
|||
|
|
2. 创建一个测试量表
|
|||
|
|
3. 为量表添加至少3-5道题目
|
|||
|
|
4. 为每道题目添加选项
|
|||
|
|
5. 创建因子并配置计分规则
|
|||
|
|
6. 配置结果解释规则
|
|||
|
|
7. 退出，用普通用户账号登录
|
|||
|
|
8. 开始测评并答题
|
|||
|
|
|
|||
|
|
### Q2: 测评报告如何生成？
|
|||
|
|
**A**:
|
|||
|
|
1. 提交测评后，系统会自动计算得分
|
|||
|
|
2. 根据因子计分规则计算各因子分
|
|||
|
|
3. 匹配结果解释规则
|
|||
|
|
4. 生成HTML格式的报告
|
|||
|
|
5. 可以在"测评报告"页面查看
|
|||
|
|
|
|||
|
|
### Q3: 如何查看心理网站内容？
|
|||
|
|
**A**:
|
|||
|
|
**目前状态**：前台展示页面尚未开发，只能通过后台管理查看。
|
|||
|
|
|
|||
|
|
**解决方案**：
|
|||
|
|
1. 临时方案：在后台"网站内容管理"中查看
|
|||
|
|
2. 完整方案：需要开发前台展示页面（预计1-2天开发时间）
|
|||
|
|
|
|||
|
|
### Q4: 量表状态"停用"是什么意思？
|
|||
|
|
**A**:
|
|||
|
|
- 停用的量表不会在"开始测评"页面的量表列表中显示
|
|||
|
|
- 但已有的测评记录不受影响
|
|||
|
|
- 管理员可以在量表管理中修改状态
|
|||
|
|
|
|||
|
|
### Q5: 如何批量导入题目？
|
|||
|
|
**A**:
|
|||
|
|
**目前状态**：批量导入功能尚未实现，需要手动添加。
|
|||
|
|
|
|||
|
|
**建议**：
|
|||
|
|
- 先创建少量题目测试功能
|
|||
|
|
- 后续可以开发Excel导入功能
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📝 测试建议
|
|||
|
|
|
|||
|
|
### 第一步：准备测试数据
|
|||
|
|
1. 创建1-2个测试量表
|
|||
|
|
2. 每个量表添加5-10道题目
|
|||
|
|
3. 每道题目添加4-5个选项
|
|||
|
|
4. 创建1-2个因子
|
|||
|
|
5. 配置结果解释规则
|
|||
|
|
|
|||
|
|
### 第二步：测试完整流程
|
|||
|
|
1. 以新用户身份登录
|
|||
|
|
2. 开始测评
|
|||
|
|
3. 完成答题
|
|||
|
|
4. 查看报告
|
|||
|
|
5. 验证报告内容
|
|||
|
|
|
|||
|
|
### 第三步：测试管理功能
|
|||
|
|
1. 修改量表信息
|
|||
|
|
2. 添加新题目
|
|||
|
|
3. 修改因子配置
|
|||
|
|
4. 添加网站内容
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🚧 待开发功能
|
|||
|
|
|
|||
|
|
1. **前台展示页面**（新用户查看心理网站内容）
|
|||
|
|
2. **批量导入题目**（Excel导入）
|
|||
|
|
3. **报告PDF导出**
|
|||
|
|
4. **测评数据统计图表**
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
**文档版本**：v1.0
|
|||
|
|
**最后更新**：2025-11-04
|