xinli/z_Project change/使用指南-功能测试说明.md
2025-11-06 14:59:32 +08:00

11 KiB
Raw Blame History

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

📋 目录

  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. 填写选项信息:
    • 选项编码:如 ABCD
    • 选项内容:选项文本
    • 选项分值:选择该选项的得分
    • 排序顺序:选项显示顺序
  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