xiaozhang/xinli
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

更新项目文件：添加使用指南文档和修改报告详情页面

Browse Source
This commit is contained in:
xiao12feng 2025-11-20 11:38:07 +08:00
parent ee5a28836c
commit 1625f8d3f6
5 changed files with 1725 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

207
xinli-ui/src/views/psychology/report/detail.vue
View File

@ -72,6 +72,34 @@
<div v-if="reportForm.pdfPath">
<el-button type="primary" icon="el-icon-download" @click="handleDownloadPDF">下载PDF报告</el-button>
</div>
<!-- AI分析 -->
<el-divider content-position="left">AI智能分析</el-divider>
<div class="ai-analysis-section">
<el-button
type="primary"
icon="el-icon-magic-stick"
@click="handleAIAnalysis"
:loading="aiLoading"
:disabled="!reportForm.reportContent"
>
{{ aiLoading ? '分析中...' : 'AI分析' }}
</el-button>
<div v-if="aiError" class="ai-error">
<el-alert
:title="aiError"
type="error"
:closable="false"
show-icon>
</el-alert>
</div>
<div v-if="aiResult" class="ai-result">
<h3 class="ai-result-title">
<i class="el-icon-magic-stick"></i> AI分析结果
</h3>
<div class="ai-result-content" v-html="aiResult"></div>
</div>
</div>
</el-card>
<!-- 报告编辑对话框 -->
@ -119,6 +147,7 @@
import { getReport, getReportByAssessmentId, updateReportWithType } from "@/api/psychology/report";
import { getQuestionnaireRankList } from "@/api/psychology/questionnaireAnswer";
import request from '@/utils/request';
import axios from 'axios';
export default {
name: "ReportDetail",
@ -129,6 +158,10 @@ export default {
sourceType: null,
rankList: [],
rankLoading: false,
// AI分析
aiLoading: false,
aiResult: '',
aiError: '',
// 编辑对话框
editOpen: false,
editForm: {},
@ -291,6 +324,116 @@ export default {
if (this.$refs["editForm"]) {
this.$refs["editForm"].resetFields();
}
},
/** AI分析 */
async handleAIAnalysis() {
if (!this.reportForm.reportContent) {
this.$modal.msgWarning("报告内容为空，无法进行分析");
return;
}
this.aiLoading = true;
this.aiError = '';
this.aiResult = '';
// Ollama API配置
const OLLAMA_URL = 'http://192.168.0.106:11434/api/generate';
const MODEL = 'deepseek-r1:32b';
// 构建系统提示词
const SYSTEM_PROMPT = [
'你是专业心理测评报告分析师，请根据用户提供的报告内容进行深度分析。要求：',
'1. 提取报告的核心信息和关键指标；',
'2. 分析测评结果的含义和可能的影响；',
'3. 提供专业、客观、易懂的分析解读（500-800字）；',
'4. 使用结构化的格式输出，包含：核心结论、详细分析、建议等部分；',
'5. 仅输出分析结果，不添加额外建议、问候语或思考过程；',
'6. 使用HTML格式输出，使用<h3>标签作为小标题，<p>标签作为段落。'
].join('\n');
// 构建完整的提示词
const reportContent = this.reportForm.reportContent || '';
const reportTitle = this.reportForm.reportTitle || '心理测评报告';
const reportType = this.reportForm.reportType || '标准报告';
// 提取纯文本内容（去除HTML标签）
const textContent = reportContent.replace(/<[^>]*>/g, '').substring(0, 3000);
const prompt = `${SYSTEM_PROMPT}\n\n重要：请直接输出结果，不要包含任何思考过程、<think>标签或<think>标签。\n\n报告标题：${reportTitle}\n报告类型：${reportType}\n报告内容：${textContent}`;
try {
const { data } = await axios.post(OLLAMA_URL, {
model: MODEL,
prompt: prompt,
temperature: 0.2,
num_predict: 1000,
stream: false
}, {
timeout: 60000 // 60秒超时
});
let rawResponse = data?.response ?? '无法解析模型输出';
// 过滤掉思考过程标签
rawResponse = rawResponse
.replace(/<think>[\s\S]*?<\/think>/gi, '')
.replace(/<think>[\s\S]*?<\/redacted_reasoning>/gi, '')
.replace(/<think[\s\S]*?>/gi, '')
.replace(/<redacted_reasoning[\s\S]*?>/gi, '')
.trim();
if (!rawResponse || rawResponse === '无法解析模型输出') {
this.aiError = '模型返回结果为空，请稍后重试';
return;
}
// 格式化结果，确保HTML格式正确
this.aiResult = this.formatAIResult(rawResponse);
} catch (err) {
console.error('AI分析失败:', err);
if (err.code === 'ECONNABORTED' || err.message.includes('timeout')) {
this.aiError = '请求超时，请检查Ollama服务是否正常运行';
} else if (err.response) {
this.aiError = err.response.data?.error || err.message || 'AI分析失败，请稍后重试';
} else if (err.request) {
this.aiError = '无法连接到Ollama服务，请检查服务地址是否正确（当前：' + OLLAMA_URL + '）';
} else {
this.aiError = err.message || 'AI分析失败，请稍后重试';
}
} finally {
this.aiLoading = false;
}
},
/** 格式化AI分析结果 */
formatAIResult(text) {
// 如果已经是HTML格式，直接返回
if (text.includes('<h3>') || text.includes('<p>')) {
return text;
}
// 将文本转换为HTML格式
let html = text;
// 处理标题（以数字开头或包含"结论"、"分析"、"建议"等关键词的行）
html = html.replace(/^(\d+[\.、]?\s*[^\n]+)$/gm, '<h3>$1</h3>');
html = html.replace(/^([^\n]*(?:结论|分析|建议|总结|概述)[^\n]*)$/gm, '<h3>$1</h3>');
// 将段落分隔符转换为<p>标签
html = html.split('\n\n').map(para => {
para = para.trim();
if (!para) return '';
if (para.startsWith('<h3>')) return para;
return '<p>' + para.replace(/\n/g, '<br>') + '</p>';
}).join('');
// 确保每个段落都有正确的格式
html = html.replace(/(<p>.*?<\/p>)/g, (match) => {
if (match.includes('<h3>')) return match.replace(/<p>|<\/p>/g, '');
return match;
});
return html;
}
}
};
@ -345,5 +488,69 @@ export default {
font-weight: bold;
margin: 10px 0;
}
/* AI分析区域样式 */
.ai-analysis-section {
margin-top: 20px;
padding: 20px;
background-color: #f8f9fa;
border-radius: 8px;
}
.ai-error {
margin-top: 15px;
}
.ai-result {
margin-top: 20px;
padding: 20px;
background-color: #fff;
border-radius: 8px;
box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
}
.ai-result-title {
font-size: 18px;
font-weight: bold;
color: #409eff;
margin: 0 0 15px 0;
padding-bottom: 10px;
border-bottom: 2px solid #e4e7ed;
display: flex;
align-items: center;
gap: 8px;
}
.ai-result-title i {
font-size: 20px;
}
.ai-result-content {
line-height: 1.8;
color: #333;
}
.ai-result-content >>> h3 {
font-size: 16px;
font-weight: bold;
color: #409eff;
margin: 20px 0 10px 0;
padding-left: 10px;
border-left: 3px solid #409eff;
}
.ai-result-content >>> p {
margin: 12px 0;
text-align: justify;
color: #606266;
}
.ai-result-content >>> p:first-of-type {
margin-top: 0;
}
.ai-result-content >>> br {
line-height: 1.8;
}
</style>

229
使用指南-总览.md Normal file
View File

@ -0,0 +1,229 @@
# 心理健康测评系统 - 使用指南总览
## 📚 文档导航
本系统为不同身份的用户提供了详细的使用指南，请根据您的身份选择对应的指南文档。
---
## 👥 用户身份说明
### 1. 系统管理员
**适用对象**：
- 系统管理员
- 拥有完整系统管理权限的用户
**主要职责**：
- 管理量表、用户、权限
- 配置预警规则
- 查看和管理测评报告
- 管理二维码
- 系统设置和维护
**对应指南**：👉 [系统管理员使用指南](./使用指南-系统管理员.md)
---
### 2. 普通用户/测评者
**适用对象**：
- 已获得量表权限的注册用户
- 需要进行心理测评的用户
- 查看测评报告的用户
**主要功能**：
- 进行心理量表测评
- 查看测评报告
- 查看历史记录
- 使用二维码扫描
- 管理个人档案
**对应指南**：👉 [普通用户使用指南](./使用指南-普通用户.md)
---
### 3. 注册用户
**适用对象**：
- 新注册的用户
- 等待权限分配的用户
**主要流程**：
- 注册账号
- 首次登录
- 等待权限分配
- 开始使用系统
**对应指南**：👉 [注册用户使用指南](./使用指南-注册用户.md)
---
## 📖 快速开始
### 我是系统管理员
1. 使用默认账号登录（用户名：`admin`，密码：`admin123`）
2. 阅读 [系统管理员使用指南](./使用指南-系统管理员.md)
3. 开始配置系统和管理用户
### 我是新用户
1. 在登录页面点击"注册"
2. 填写注册信息完成注册
3. 阅读 [注册用户使用指南](./使用指南-注册用户.md)
4. 等待管理员分配权限
5. 获得权限后，阅读 [普通用户使用指南](./使用指南-普通用户.md)
6. 开始进行测评
### 我是已有权限的用户
1. 使用账号登录系统
2. 阅读 [普通用户使用指南](./使用指南-普通用户.md)
3. 开始进行测评
---
## 🎯 功能模块说明
### 量表管理
- **管理员**：创建、导入、配置量表
- **普通用户**：选择量表进行测评
### 测评管理
- **管理员**：查看和管理所有测评记录
- **普通用户**：查看自己的测评记录
### 报告管理
- **管理员**：查看、编辑、导出所有报告
- **普通用户**：查看自己的测评报告
### 权限管理
- **管理员**：为用户分配量表权限
- **普通用户**：查看自己的权限范围
### 问卷管理
- **管理员**：创建自定义问卷、主观题评分
- **普通用户**：参与问卷答题
### 预警管理
- **管理员**：配置预警规则、查看预警信息
- **普通用户**：不涉及
### 二维码管理
- **管理员**：生成和管理二维码
- **普通用户**：扫描二维码进行测评或查看报告
---
## 📋 文档结构
```
使用指南总览.md ← 您当前所在的位置
├── 使用指南-系统管理员.md ← 管理员完整使用指南
├── 使用指南-普通用户.md ← 普通用户完整使用指南
└── 使用指南-注册用户.md ← 注册用户指南
```
---
## 🔍 常见问题快速查找
### 关于注册
- 如何注册账号？ → [注册用户使用指南](./使用指南-注册用户.md#注册流程)
- 注册后无法登录？ → [注册用户使用指南](./使用指南-注册用户.md#常见问题)
### 关于测评
- 如何开始测评？ → [普通用户使用指南](./使用指南-普通用户.md#开始测评)
- 如何答题？ → [普通用户使用指南](./使用指南-普通用户.md#答题操作)
- 可以暂停测评吗？ → [普通用户使用指南](./使用指南-普通用户.md#暂停和继续)
### 关于报告
- 如何查看报告？ → [普通用户使用指南](./使用指南-普通用户.md#查看报告)
- 报告什么时候生成？ → [普通用户使用指南](./使用指南-普通用户.md#常见问题)
### 关于权限
- 看不到量表怎么办？ → [普通用户使用指南](./使用指南-普通用户.md#常见问题)
- 如何分配权限？ → [系统管理员使用指南](./使用指南-系统管理员.md#权限管理)
### 关于量表
- 如何导入新量表？ → [系统管理员使用指南](./使用指南-系统管理员.md#量表管理)
- 如何配置量表？ → [系统管理员使用指南](./使用指南-系统管理员.md#配置量表)
---
## 📞 获取帮助
### 技术支持
如遇到问题，可以：
1. **查看文档**：阅读对应的使用指南
2. **查看常见问题**：每个指南都包含常见问题部分
3. **联系管理员**：联系系统管理员获取帮助
4. **查看系统日志**：管理员可以查看系统日志排查问题
### 文档更新
- 文档会随着系统更新而更新
- 建议定期查看最新版本
- 如有疑问，请联系技术支持
---
## ✅ 使用检查清单
### 新用户检查清单
- [ ] 已完成账号注册
- [ ] 已成功登录系统
- [ ] 已阅读注册用户使用指南
- [ ] 已联系管理员申请权限
- [ ] 已获得量表权限
- [ ] 已阅读普通用户使用指南
- [ ] 已准备好进行首次测评
### 管理员检查清单
- [ ] 已修改默认密码
- [ ] 已阅读系统管理员使用指南
- [ ] 已配置系统基础设置
- [ ] 已导入或创建量表
- [ ] 已为用户分配权限
- [ ] 已配置预警规则（如需要）
- [ ] 已测试系统功能
---
## 🎓 学习路径建议
### 对于新用户
1. **第一步**：注册账号 → [注册用户使用指南](./使用指南-注册用户.md)
2. **第二步**：等待权限分配
3. **第三步**：学习使用系统 → [普通用户使用指南](./使用指南-普通用户.md)
4. **第四步**：进行首次测评
5. **第五步**：查看测评报告
### 对于管理员
1. **第一步**：登录系统并修改密码
2. **第二步**：阅读管理员指南 → [系统管理员使用指南](./使用指南-系统管理员.md)
3. **第三步**：配置系统基础设置
4. **第四步**：导入或创建量表
5. **第五步**：为用户分配权限
6. **第六步**：测试系统功能
7. **第七步**：开始日常管理
---
## 📝 文档说明
- **最后更新**：2025-01-XX
- **文档版本**：v1.0
- **适用系统版本**：心理健康测评系统 v1.0
---
**祝您使用愉快！** 🎉

375
使用指南-普通用户.md Normal file
View File

@ -0,0 +1,375 @@
# 心理健康测评系统 - 普通用户使用指南
## 📋 目录
1. [系统概述](#系统概述)
2. [注册账号](#注册账号)
3. [登录系统](#登录系统)
4. [开始测评](#开始测评)
5. [答题操作](#答题操作)
6. [查看报告](#查看报告)
7. [查看历史记录](#查看历史记录)
8. [使用二维码](#使用二维码)
9. [用户档案](#用户档案)
10. [常见问题](#常见问题)
---
## 系统概述
心理健康测评系统是一个专业的心理测评平台，您可以通过该系统进行各种心理量表测评，查看测评报告，了解自己的心理健康状况。
### 主要功能
- **心理测评**：进行各种心理量表测评
- **查看报告**：查看详细的测评报告和结果解释
- **历史记录**：查看历史测评记录
- **二维码扫描**：通过扫码快速开始测评
- **用户档案**：管理个人档案信息
---
## 注册账号
### 注册步骤
1. 打开浏览器，访问系统地址（如：`http://localhost:80`）
2. 在登录页面，点击 **"注册"** 链接
3. 填写注册信息：
- **用户名**：用于登录的用户名（必填，唯一）
- **密码**：登录密码（必填，建议8位以上）
- **确认密码**：再次输入密码（必填）
- **手机号**：手机号码（可选）
- **邮箱**：邮箱地址（可选）
4. 输入验证码（如显示）
5. 点击 **"注册"** 按钮
6. 注册成功后，系统会提示注册成功
### 注册注意事项
- 用户名不能重复，如果提示用户名已存在，请更换用户名
- 密码建议包含字母和数字，提高安全性
- 注册后需要等待管理员分配量表权限才能进行测评
- 如果忘记密码，请联系管理员重置
---
## 登录系统
### 登录步骤
1. 打开浏览器，访问系统地址
2. 在登录页面输入：
- **用户名**：您的用户名
- **密码**：您的密码
- **验证码**：输入显示的验证码（如显示）
3. 点击 **"登录"** 按钮
4. 登录成功后进入系统首页
### 登录问题
- **忘记密码**：请联系管理员重置密码
- **账号被锁定**：联系管理员解锁账号
- **验证码看不清**：点击验证码图片刷新
---
## 开始测评
### 方式一：通过菜单开始
1. 登录系统后，点击左侧菜单 **"心理测评管理"** → **"测评管理"**
2. 点击 **"开始测评"** 按钮
3. 在量表选择页面，选择要进行的量表
4. 填写被测评人信息：
- **姓名**：被测评人姓名
- **性别**：男/女
- **年龄**：年龄
- **其他信息**：根据需要填写
5. 点击 **"开始测评"** 按钮
6. 进入答题页面
### 方式二：通过二维码扫描
1. 使用手机扫描管理员提供的测评二维码
2. 如果未登录，系统会提示先登录
3. 登录后自动跳转到测评开始页面
4. 填写被测评人信息
5. 开始答题
### 量表选择说明
- **权限限制**：您只能看到管理员为您分配权限的量表
- **量表信息**：每个量表显示名称、类型、题目数量、预计时间
- **无权限提示**：如果没有可用的量表，系统会提示联系管理员
---
## 答题操作
### 答题界面
答题页面包含以下元素：
- **量表信息**：显示量表名称和进度
- **题目区域**：显示当前题目和选项
- **进度条**：显示答题进度
- **导航按钮**：上一题、下一题、提交
### 答题步骤
1. **阅读题目**：仔细阅读题目内容
2. **选择答案**：
- **单选题**：选择一个选项
- **多选题**：可以选择多个选项
3. **保存答案**：选择答案后，系统自动保存
4. **继续答题**：
- 点击 **"下一题"** 继续
- 或点击 **"上一题"** 返回修改
5. **完成答题**：
- 答完所有题目后，点击 **"提交"** 按钮
- 确认提交后，系统生成测评报告
### 答题技巧
- **认真阅读**：仔细阅读每个题目，理解题意
- **如实回答**：根据自己的真实情况回答，不要猜测
- **不要跳过**：尽量回答所有题目，确保结果准确
- **可以修改**：在提交前可以随时返回修改答案
- **注意时间**：某些量表有时间限制，注意答题时间
### 暂停和继续
如果无法一次性完成测评：
1. **暂停测评**：
- 点击 **"暂停"** 按钮
- 系统保存当前进度
2. **继续测评**：
- 下次登录后，进入 **"测评管理"**
- 找到状态为"进行中"的测评
- 点击 **"继续测评"** 按钮
- 系统自动跳转到上次的答题位置
---
## 查看报告
### 查看方式
#### 方式一：通过菜单查看
1. 登录系统后，点击 **"心理测评管理"** → **"测评报告"**
2. 在报告列表中，找到要查看的报告
3. 点击 **"查看"** 按钮
4. 查看报告详细内容
#### 方式二：通过测评记录查看
1. 进入 **"测评管理"**
2. 找到已完成的测评记录
3. 点击 **"查看报告"** 按钮
4. 查看报告
#### 方式三：通过二维码扫描
1. 扫描管理员提供的报告查看二维码
2. 如果未登录，系统会提示先登录
3. 登录后自动跳转到报告详情页面
### 报告内容
测评报告通常包含以下内容：
- **基本信息**：
- 被测评人信息
- 测评时间
- 量表名称
- **测评结果**：
- 总分
- 各因子得分（如有）
- 分数解释
- **结果分析**：
- 结果等级（如：正常、轻度、中度、重度）
- 详细解释
- 因子分析（如有）
- **建议指导**：
- 针对性的建议
- 改善方法
- 注意事项
### 报告说明
- **报告生成**：提交测评后，系统自动生成报告
- **报告准确性**：报告结果基于您的答题情况，请如实回答
- **仅供参考**：报告结果仅供参考，不能替代专业诊断
- **隐私保护**：您的测评数据受到隐私保护
---
## 查看历史记录
### 查看测评记录
1. 进入 **"心理测评管理"** → **"测评管理"**
2. 查看所有测评记录：
- **进行中**：尚未完成的测评
- **已完成**：已完成的测评
- **已暂停**：暂停的测评
3. 可以按条件搜索：
- 量表名称
- 被测评人
- 测评状态
- 创建时间
### 查看报告记录
1. 进入 **"心理测评管理"** → **"测评报告"**
2. 查看所有报告记录
3. 可以按条件搜索：
- 报告标题
- 量表名称
- 创建时间
### 对比分析
- 可以查看同一被测评人的多次测评记录
- 对比不同时间的测评结果
- 了解心理变化趋势
---
## 使用二维码
### 扫描测评二维码
1. 使用手机扫描管理员提供的测评二维码
2. 如果未登录，系统会提示先登录
3. 登录后自动跳转到测评开始页面
4. 填写被测评人信息
5. 开始答题
### 扫描报告二维码
1. 使用手机扫描管理员提供的报告查看二维码
2. 如果未登录，系统会提示先登录
3. 登录后自动跳转到报告详情页面
4. 查看报告内容
### 二维码使用说明
- **扫码工具**：可以使用微信、支付宝等应用的扫一扫功能
- **网络要求**：需要网络连接才能访问
- **权限要求**：需要登录并有相应权限
- **有效期**：二维码可能有过期时间，过期后无法使用
---
## 用户档案
### 查看个人档案
1. 进入 **"心理测评管理"** → **"用户档案"**
2. 查看个人档案信息
3. 可以查看：
- 基本信息
- 测评记录
- 档案历史
### 编辑个人档案
1. 在档案页面，点击 **"编辑"** 按钮
2. 修改档案信息（如允许）
3. 点击 **"确定"** 保存
### 档案说明
- **档案内容**：由管理员配置，可能包含自定义字段
- **隐私保护**：档案信息受到隐私保护
- **权限限制**：某些字段可能无法自行修改
---
## 常见问题
### Q1: 注册后无法看到量表？
**A**: 注册后需要等待管理员为您分配量表权限。请联系管理员分配权限。
### Q2: 忘记密码怎么办？
**A**: 请联系管理员重置密码。管理员可以在用户管理中重置您的密码。
### Q3: 答题过程中可以暂停吗？
**A**: 可以。点击"暂停"按钮，系统会保存当前进度。下次登录后可以继续完成测评。
### Q4: 可以修改已提交的答案吗？
**A**: 不可以。提交后无法修改答案。请在提交前仔细检查。
### Q5: 报告什么时候生成？
**A**: 提交测评后，系统会自动生成报告。通常几秒钟内完成。
### Q6: 可以查看历史测评记录吗？
**A**: 可以。在"测评管理"中可以查看所有历史测评记录。
### Q7: 报告结果准确吗？
**A**: 报告结果基于您的答题情况。请如实回答题目，确保结果准确。但报告结果仅供参考，不能替代专业诊断。
### Q8: 可以导出报告吗？
**A**: 普通用户无法导出报告。如需导出，请联系管理员。
### Q9: 二维码扫描后无法访问？
**A**: 检查以下几点：
- 是否已登录
- 是否有相应权限
- 二维码是否过期
- 网络连接是否正常
### Q10: 如何联系管理员？
**A**: 请联系系统管理员或技术支持人员。
---
## 使用提示
### 测评前
- ✅ 确保网络连接正常
- ✅ 选择一个安静的环境
- ✅ 预留足够的答题时间
- ✅ 准备好被测评人的基本信息
### 测评中
- ✅ 认真阅读每个题目
- ✅ 根据自己的真实情况回答
- ✅ 不要猜测或随意选择
- ✅ 注意答题时间
### 测评后
- ✅ 查看生成的报告
- ✅ 理解报告内容
- ✅ 如有疑问，咨询专业人员
- ✅ 保存报告信息（如需要）
---
## 隐私说明
- 您的测评数据受到严格保护
- 只有管理员和您本人可以查看您的测评记录
- 系统不会向第三方泄露您的个人信息
- 请妥善保管您的账号密码
---
**最后更新**：2025-01-XX

264
使用指南-注册用户.md Normal file
View File

@ -0,0 +1,264 @@
# 心理健康测评系统 - 注册用户使用指南
## 📋 目录
1. [注册流程](#注册流程)
2. [首次登录](#首次登录)
3. [等待权限分配](#等待权限分配)
4. [开始使用](#开始使用)
5. [常见问题](#常见问题)
---
## 注册流程
### 访问注册页面
1. 打开浏览器，访问系统地址（如：`http://localhost:80`）
2. 在登录页面，点击 **"注册"** 链接或按钮
3. 进入注册页面
### 填写注册信息
在注册页面填写以下信息：
#### 必填信息
- **用户名**：
- 用于登录的用户名
- 必须唯一，不能与其他用户重复
- 建议使用字母、数字组合
- 长度建议：3-20个字符
- **密码**：
- 登录密码
- 建议8位以上
- 建议包含字母和数字
- 不要使用过于简单的密码（如：123456）
- **确认密码**：
- 再次输入密码
- 必须与密码一致
#### 可选信息
- **手机号**：手机号码（用于找回密码等）
- **邮箱**：邮箱地址（用于接收通知等）
### 完成注册
1. 输入验证码（如显示）
2. 阅读并同意用户协议（如有）
3. 点击 **"注册"** 按钮
4. 系统验证信息：
- 如果用户名已存在，会提示"用户名已存在"
- 如果密码不一致，会提示"两次密码不一致"
- 如果验证码错误，会提示"验证码错误"
5. 注册成功后，系统会显示"注册成功"提示
---
## 首次登录
### 登录步骤
1. 注册成功后，返回登录页面
2. 使用注册的用户名和密码登录
3. 首次登录后，您可能会看到：
- 欢迎页面
- 系统提示（如：等待管理员分配权限）
- 空白的量表列表（如果还没有权限）
### 登录后状态
注册用户首次登录后，通常处于以下状态：
- ✅ **账号已激活**：可以正常登录系统
- ⏳ **等待权限**：需要等待管理员分配量表权限
- 📋 **功能受限**：可能无法看到量表或进行测评
---
## 等待权限分配
### 为什么需要等待？
注册用户需要管理员分配量表访问权限后才能进行测评。这是为了：
- **权限控制**：确保用户只能访问被授权的量表
- **数据安全**：保护测评数据的安全
- **管理规范**：便于管理员统一管理
### 如何知道权限已分配？
权限分配后，您可以通过以下方式确认：
1. **刷新页面**：登录后刷新浏览器页面
2. **查看量表列表**：进入"测评管理"，如果能看到量表列表，说明已有权限
3. **联系管理员**：如果长时间没有权限，可以联系管理员确认
### 权限说明
管理员可以为您分配：
- **量表权限**：指定您可以访问哪些量表
- **时间范围**：权限的有效期（开始时间和结束时间）
- **权限类型**：按用户、角色或部门分配
---
## 开始使用
### 获得权限后
当管理员为您分配权限后，您可以：
1. **查看可用量表**：
- 进入"心理测评管理" → "测评管理"
- 点击"开始测评"
- 查看可用的量表列表
2. **开始测评**：
- 选择要进行的量表
- 填写被测评人信息
- 开始答题
3. **查看报告**：
- 完成测评后查看报告
- 查看历史测评记录
### 使用流程
完整的测评流程：
```
注册账号
↓
登录系统
↓
等待权限分配
↓
选择量表
↓
填写被测评人信息
↓
开始答题
↓
提交测评
↓
查看报告
```
---
## 常见问题
### Q1: 注册时提示"用户名已存在"？
**A**: 该用户名已被其他用户使用。请更换一个不同的用户名。
**建议**：
- 使用字母+数字组合
- 添加下划线或连字符
- 使用邮箱前缀作为用户名
### Q2: 注册时提示"密码不一致"？
**A**: "密码"和"确认密码"输入不一致。请重新输入，确保两次输入的密码完全相同。
### Q3: 注册后无法登录？
**A**: 检查以下几点：
- 用户名和密码是否正确
- 是否输入了正确的验证码
- 账号是否被管理员停用
- 联系管理员确认账号状态
### Q4: 登录后看不到量表？
**A**: 这是正常情况。注册用户需要等待管理员分配量表权限。请：
- 等待管理员分配权限
- 或联系管理员申请权限
### Q5: 如何联系管理员？
**A**: 请联系系统管理员或技术支持人员，告知您的用户名和需求。
### Q6: 忘记密码怎么办？
**A**: 请联系管理员重置密码。管理员可以在用户管理中重置您的密码。
### Q7: 可以修改注册信息吗？
**A**: 部分信息可以修改：
- 登录后进入"个人中心"（如有）
- 或联系管理员修改
### Q8: 注册后多久可以获得权限？
**A**: 这取决于管理员的工作安排。通常：
- 管理员会定期审核新注册用户
- 或根据申请及时分配权限
- 建议主动联系管理员申请
### Q9: 可以注册多个账号吗？
**A**: 可以，但需要：
- 使用不同的用户名
- 每个账号独立管理
- 遵守系统使用规范
### Q10: 注册信息会被泄露吗？
**A**: 不会。系统严格保护用户隐私：
- 注册信息受到加密保护
- 不会向第三方泄露
- 只有管理员可以查看（用于权限管理）
---
## 注册注意事项
### 用户名选择
- ✅ 使用易记的用户名
- ✅ 避免使用特殊字符
- ✅ 不要使用真实姓名（保护隐私）
- ❌ 不要使用过于简单的用户名（如：abc、123）
### 密码设置
- ✅ 使用8位以上的密码
- ✅ 包含字母和数字
- ✅ 定期更换密码
- ❌ 不要使用过于简单的密码
- ❌ 不要使用个人信息作为密码
### 信息填写
- ✅ 如实填写信息（如手机号、邮箱）
- ✅ 信息用于账号管理和找回密码
- ⚠️ 注意保护个人隐私
---
## 下一步
注册成功后，建议您：
1. **保存账号信息**：记录用户名和密码，妥善保管
2. **联系管理员**：主动联系管理员申请量表权限
3. **了解系统**：阅读《普通用户使用指南》，了解系统功能
4. **准备测评**：获得权限后，准备好进行测评
---
## 相关文档
- [普通用户使用指南](./使用指南-普通用户.md) - 详细的使用说明
- [系统管理员使用指南](./使用指南-系统管理员.md) - 管理员功能说明
---
**最后更新**：2025-01-XX

650
使用指南-系统管理员.md Normal file
View File

@ -0,0 +1,650 @@
# 心理健康测评系统 - 系统管理员使用指南
## 📋 目录
1. [系统概述](#系统概述)
2. [登录系统](#登录系统)
3. [量表管理](#量表管理)
4. [用户管理](#用户管理)
5. [权限管理](#权限管理)
6. [测评管理](#测评管理)
7. [报告管理](#报告管理)
8. [问卷管理](#问卷管理)
9. [预警管理](#预警管理)
10. [二维码管理](#二维码管理)
11. [用户档案管理](#用户档案管理)
12. [心理网站管理](#心理网站管理)
13. [系统设置](#系统设置)
14. [数据导出](#数据导出)
15. [常见问题](#常见问题)
---
## 系统概述
心理健康测评系统是一个基于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