# AI心理健康测评系统 - 系统管理员使用指南

## 📋 目录

1. [系统概述](#系统概述)
2. [登录系统](#登录系统)
3. [量表管理](#量表管理)
4. [用户管理](#用户管理)
5. [权限管理](#权限管理)
6. [测评管理](#测评管理)
7. [报告管理](#报告管理)
8. [问卷管理](#问卷管理)
9. [预警管理](#预警管理)
10. [二维码管理](#二维码管理)
11. [用户档案管理](#用户档案管理)
12. [心理网站管理](#心理网站管理)
13. [系统设置](#系统设置)
14. [数据导出](#数据导出)
15. [常见问题](#常见问题)

---

## 系统概述

AI心理健康测评系统是一个基于Web的心理测评管理平台，支持量表测评、自定义问卷、用户档案管理、预警管理等功能。

### 主要功能模块

- **量表管理**：创建、导入、配置心理量表
- **用户管理**：管理用户账号、分配权限
- **测评管理**：查看和管理测评记录
- **报告管理**：查看、编辑、导出测评报告
- **问卷管理**：创建自定义问卷、主观题评分
- **预警管理**：配置预警规则、查看预警信息
- **二维码管理**：生成和管理测评二维码
- **用户档案**：管理用户档案信息
- **心理网站**：管理心理教育网站内容

---

## 登录系统

### 访问系统

1. 打开浏览器，访问系统地址（如：`http://localhost:80`）
2. 进入登录页面

### 默认管理员账号

- **用户名**：`admin`
- **密码**：`admin123`

> ⚠️ **安全提示**：首次登录后请立即修改密码！

### 登录步骤

1. 输入用户名和密码
2. 输入验证码（如显示）
3. 点击"登录"按钮
4. 登录成功后进入系统首页

---

## 量表管理

### 功能说明

量表管理是系统的核心功能，管理员可以创建、导入、配置和管理心理量表。

### 创建新量表

#### 方式一：手动创建

1. 进入 **心理测评管理** → **量表管理**
2. 点击 **"新增"** 按钮
3. 填写量表基本信息：
   - **量表编码**：唯一标识（如：`SCL_90`）
   - **量表名称**：量表完整名称
   - **量表类型**：选择类型（情绪、人格、行为等）
   - **量表简介**：简短介绍
   - **量表描述**：详细描述
   - **题目数量**：预计题目数
   - **预计完成时间**：分钟数
   - **适用人群**：如"一般人群"、"青少年"等
   - **作者**：量表作者
   - **来源**：量表来源
   - **状态**：选择"正常"（启用）
4. 点击 **"确定"** 保存

#### 方式二：JSON格式导入

1. 进入 **量表管理** 页面
2. 点击 **"导入"** 按钮
3. 选择JSON格式的量表文件
4. 系统自动解析并导入量表数据
5. 检查导入结果，确认无误

> 📖 **详细说明**：参考《新量表导入完整操作指南.md》

### 配置量表

创建量表后，需要完成以下配置：

#### 1. 添加题目

1. 在量表列表中，点击 **"题目管理"** 按钮
2. 点击 **"新增"** 添加题目
3. 填写题目信息：
   - **题目序号**：如 1、2、3...
   - **题目内容**：题目的完整文字
   - **题目类型**：单选题/多选题
   - **是否必答**：是/否
4. 保存题目

#### 2. 配置选项

1. 在题目列表中，点击 **"选项管理"** 按钮
2. 为每个题目添加选项：
   - **选项编码**：如 A、B、C、D
   - **选项内容**：选项文字
   - **选项分数**：该选项对应的分数
3. 保存选项

#### 3. 添加因子（如需要）

1. 在量表列表中，点击 **"因子管理"** 按钮
2. 点击 **"新增"** 添加因子
3. 填写因子信息：
   - **因子编码**：如 F1、F2
   - **因子名称**：如"躯体化因子"
   - **因子描述**：详细说明
4. 保存因子

#### 4. 配置计分规则（如需要）

1. 在因子列表中，点击 **"计分规则"** 按钮
2. 为每个因子配置计分规则：
   - 选择题目
   - 选择选项（可选）
   - 设置权重
   - 选择计算方式（求和/平均/最大/最小）
3. 保存规则

#### 5. 配置结果解释

1. 进入 **心理测评管理** → **解释配置**
2. 点击 **"新增"** 添加解释
3. 填写解释信息：
   - **量表**：选择量表
   - **因子**：选择因子（可选）
   - **分数下限/上限**：分数范围
   - **等级**：如"低"、"中"、"高"
   - **解释标题**：解释标题
   - **解释内容**：详细解释
   - **建议指导**：建议和指导
4. 保存解释

### 管理量表

- **编辑量表**：点击 **"修改"** 按钮
- **删除量表**：点击 **"删除"** 按钮（需谨慎）
- **查看详情**：点击量表名称
- **导出量表**：勾选量表后点击 **"导出"** 按钮

---

## 用户管理

### 功能说明

用户管理用于管理系统用户账号，包括创建用户、分配角色、设置权限等。

### 查看用户列表

1. 进入 **系统管理** → **用户管理**
2. 查看用户列表，可以按条件搜索：
   - 用户名
   - 手机号
   - 状态
   - 创建时间

### 创建新用户

1. 在用户管理页面，点击 **"新增"** 按钮
2. 填写用户信息：
   - **用户名**：登录用户名
   - **昵称**：显示名称
   - **邮箱**：邮箱地址
   - **手机号**：手机号码
   - **性别**：男/女
   - **密码**：初始密码
   - **部门**：所属部门
   - **角色**：选择角色
   - **状态**：正常/停用
3. 点击 **"确定"** 保存

### 管理用户

- **编辑用户**：点击 **"修改"** 按钮
- **删除用户**：点击 **"删除"** 按钮
- **重置密码**：点击 **"重置密码"** 按钮
- **分配角色**：点击 **"更多"** → **"分配角色"**
- **分配量表权限**：点击 **"更多"** → **"分配量表权限"**

### 批量操作

1. 勾选多个用户
2. 点击 **"批量删除"** 或 **"批量导出"**

---

## 权限管理

### 功能说明

权限管理用于控制用户对量表的访问权限，支持按用户、角色、部门分配权限。

### 量表权限管理

1. 进入 **心理测评管理** → **量表权限管理**
2. 查看权限列表，可以按条件筛选：
   - 量表名称
   - 用户名称
   - 部门
   - 状态

### 分配权限

#### 方式一：通过权限管理页面

1. 在权限管理页面，点击 **"新增"** 按钮
2. 填写权限信息：
   - **量表**：选择量表
   - **用户**：选择用户（可选）
   - **角色**：选择角色（可选）
   - **部门**：选择部门（可选）
   - **开始时间**：权限生效时间
   - **结束时间**：权限失效时间
   - **状态**：有效/无效
3. 点击 **"确定"** 保存

#### 方式二：通过用户管理页面

1. 进入 **系统管理** → **用户管理**
2. 找到要分配权限的用户
3. 点击 **"更多"** → **"分配量表权限"**
4. 在权限分配页面，选择量表并设置时间范围
5. 点击 **"确定"** 保存

### 权限规则

- **管理员**（userId = 1）自动拥有所有量表的访问权限
- **用户直接权限**：优先级最高
- **角色权限**：次优先级
- **部门权限**：再次优先级
- **全局权限**：最低优先级（所有用户）

---

## 测评管理

### 功能说明

测评管理用于查看和管理所有测评记录，包括进行中的测评和已完成的测评。

### 查看测评列表

1. 进入 **心理测评管理** → **测评管理**
2. 查看测评列表，可以按条件搜索：
   - 量表名称
   - 被测评人
   - 测评状态
   - 创建时间

### 测评状态

- **进行中**：测评尚未完成
- **已完成**：测评已完成并生成报告
- **已暂停**：测评被暂停（支持继续测评）

### 管理测评

- **查看详情**：点击测评记录
- **查看报告**：点击 **"查看报告"** 按钮
- **删除测评**：点击 **"删除"** 按钮
- **继续测评**：对于暂停的测评，可以继续完成

### 管理员快速填充（测试功能）

> ⚠️ **注意**：此功能仅用于测试，不建议用于真实测评数据。

1. 进入测评页面
2. 点击 **"快速填充"** 下拉按钮
3. 选择填充策略：
   - 填充第一个选项并提交
   - 填充中间选项并提交
   - 填充最后一个选项并提交
   - 随机填充并提交
4. 确认后系统自动填充并提交测评

---

## 报告管理

### 功能说明

报告管理用于查看、编辑、导出测评报告。

### 查看报告列表

1. 进入 **心理测评管理** → **测评报告**
2. 查看报告列表，可以按条件搜索：
   - 报告标题
   - 被测评人
   - 量表名称
   - 生成状态
   - 创建时间

### 查看报告详情

1. 在报告列表中，点击 **"查看"** 按钮
2. 查看报告详细内容：
   - 基本信息
   - 测评结果
   - 因子分析
   - 结果解释
   - 建议指导

### 编辑报告

1. 在报告列表中，点击 **"编辑"** 按钮
2. 修改报告内容：
   - 解释标题
   - 解释内容
   - 建议指导
3. 点击 **"确定"** 保存

### 导出报告

1. 勾选需要导出的报告（可多选）
2. 点击 **"导出"** 按钮
3. 系统生成Excel文件并下载

---

## 问卷管理

### 功能说明

问卷管理用于创建自定义问卷，支持多种题型，适合在线考试、练习等场景。

### 创建问卷

1. 进入 **心理测评管理** → **问卷管理**
2. 点击 **"新增"** 按钮
3. 填写问卷信息：
   - **问卷名称**：问卷标题
   - **问卷描述**：问卷说明
   - **问卷类型**：选择类型
   - **状态**：正常/停用
4. 点击 **"确定"** 保存

### 添加题目

1. 在问卷列表中，点击 **"题目管理"** 按钮
2. 点击 **"新增"** 添加题目
3. 选择题目类型：
   - **单选题**：只有一个正确答案
   - **多选题**：可以有多个正确答案
   - **判断题**：对/错
   - **填空题**：文本输入
   - **简答题**：短文本回答
   - **问答题**：长文本回答
   - **作文题**：长文本回答
4. 填写题目信息：
   - **题目内容**：题目文字
   - **题目分值**：该题分数
   - **是否必答**：是/否
   - **正确答案**：客观题的正确答案
5. 保存题目

### 主观题评分

1. 进入 **心理测评管理** → **主观题评分**
2. 查看待评分题目列表
3. 点击 **"评分"** 按钮
4. 输入得分和评语（可选）
5. 点击 **"确定"** 保存

### 批量评分

1. 勾选多个待评分题目
2. 点击 **"批量评分"** 按钮
3. 为每个题目输入得分和评语
4. 点击 **"确定"** 批量保存

---

## 预警管理

### 功能说明

预警管理用于配置预警规则，当测评结果异常时自动向管理员发出警告。

### 配置预警规则

1. 进入 **心理测评管理** → **预警规则配置**
2. 点击 **"新增"** 按钮
3. 填写预警规则信息：
   - **量表**：选择量表
   - **因子**：选择因子（可选）
   - **规则名称**：如"重度抑郁预警"
   - **预警等级**：低/中/高/紧急
   - **分数下限/上限**：触发预警的分数范围
   - **百分位下限/上限**：触发预警的百分位范围
   - **自动解除**：是否自动解除预警
   - **解除条件**：自动解除的条件
   - **状态**：正常/停用
4. 点击 **"确定"** 保存

### 查看预警信息

1. 进入 **心理测评管理** → **预警管理**
2. 查看预警列表，可以按条件筛选：
   - 预警等级
   - 量表名称
   - 被测评人
   - 预警状态
   - 创建时间

### 处理预警

- **查看详情**：点击预警记录查看详细信息
- **解除预警**：手动解除预警
- **导出预警**：导出预警数据

---

## 二维码管理

### 功能说明

二维码管理用于生成和管理测评二维码，方便用户通过扫码快速访问测评和查看报告。

### 生成量表测评二维码

1. 进入 **心理测评管理** → **量表管理**
2. 找到目标量表
3. 点击 **"二维码"** 按钮
4. 系统生成二维码并显示
5. 可以下载二维码图片或直接打印

### 生成报告查看二维码

1. 进入 **心理测评管理** → **测评报告**
2. 找到目标报告
3. 点击 **"二维码"** 按钮
4. 系统生成二维码

### 管理二维码

1. 进入 **心理测评管理** → **二维码管理**
2. 查看所有二维码：
   - 二维码类型
   - 目标信息
   - 扫码次数
   - 状态
   - 过期时间
3. 可以重新生成或删除二维码

---

## 用户档案管理

### 功能说明

用户档案管理用于管理用户的档案信息，支持自定义档案项目。

### 查看用户档案

1. 进入 **心理测评管理** → **用户档案**
2. 查看用户档案列表
3. 可以按条件搜索用户

### 编辑用户档案

1. 在档案列表中，点击 **"编辑"** 按钮
2. 修改档案信息：
   - 基本信息
   - 自定义字段
3. 点击 **"确定"** 保存

### 自定义档案项目

1. 进入 **系统管理** → **参数设置**（如支持）
2. 配置自定义档案字段
3. 保存配置

---

## 心理网站管理

### 功能说明

心理网站管理用于管理心理教育网站的内容，包括文章、分类、评论等。

### 管理文章

1. 进入 **心理测评管理** → **心理网站** → **内容管理**
2. 查看文章列表
3. 可以新增、编辑、删除文章

### 管理分类

1. 进入 **心理测评管理** → **心理网站** → **分类管理**
2. 管理文章分类

### 管理评论

1. 进入 **心理测评管理** → **心理网站** → **评论管理**
2. 查看和管理用户评论

---

## 系统设置

### 角色管理

1. 进入 **系统管理** → **角色管理**
2. 查看和管理系统角色
3. 为角色分配菜单权限和按钮权限

### 菜单管理

1. 进入 **系统管理** → **菜单管理**
2. 查看和管理系统菜单
3. 可以新增、编辑、删除菜单

### 参数设置

1. 进入 **系统管理** → **参数设置**
2. 配置系统参数

### 字典管理

1. 进入 **系统管理** → **字典管理**
2. 管理系统字典数据

---

## 数据导出

### 量表导出

1. 进入 **心理测评管理** → **量表管理**
2. 勾选需要导出的量表（可多选）
3. 点击 **"导出"** 按钮
4. 系统生成JSON格式文件并下载

### 报告导出

1. 进入 **心理测评管理** → **测评报告**
2. 勾选需要导出的报告（可多选）
3. 点击 **"导出"** 按钮
4. 系统生成Excel格式文件并下载

### 数据备份

1. 进入 **系统管理** → **数据备份**（如支持）
2. 执行数据备份操作

---

## 常见问题

### Q1: 如何导入新量表？

**A**: 有两种方式：
1. **手动创建**：在量表管理中逐个添加题目和选项
2. **JSON导入**：准备符合格式的JSON文件，使用导入功能

详细说明请参考《新量表导入完整操作指南.md》

### Q2: 用户看不到量表怎么办？

**A**: 检查以下几点：
1. 量表状态是否为"正常"
2. 用户是否有量表访问权限
3. 权限是否在有效期内
4. 刷新浏览器页面

### Q3: 如何配置预警规则？

**A**: 
1. 进入"预警规则配置"
2. 选择量表和因子
3. 设置分数范围或百分位范围
4. 选择预警等级
5. 保存规则

### Q4: 二维码无法访问怎么办？

**A**: 检查以下几点：
1. 二维码是否过期
2. 二维码状态是否为"有效"
3. 网络连接是否正常
4. 系统URL配置是否正确

### Q5: 如何批量分配用户权限？

**A**: 
1. 进入"量表权限管理"
2. 点击"新增"
3. 选择量表
4. 选择角色或部门（不选择用户表示批量分配）
5. 设置时间范围
6. 保存

### Q6: 报告生成失败怎么办？

**A**: 检查以下几点：
1. 量表是否配置了结果解释
2. 因子计分规则是否正确
3. 测评是否已完成
4. 查看系统日志错误信息

### Q7: 如何修改报告内容？

**A**: 
1. 进入"测评报告"
2. 找到目标报告
3. 点击"编辑"按钮
4. 修改解释内容或建议指导
5. 保存

---

## 技术支持

如遇到问题，请：

1. 查看系统日志
2. 检查浏览器控制台错误
3. 参考相关文档
4. 联系技术支持

---

**最后更新**：2025-01-XX