# 心理测评系统 - 功能使用指南

## 📋 目录
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