xinli/z_Project change/进度汇总/15-新量表导入完整操作指南.md

# 新量表导入完整操作指南

## 📋 概述

本文档详细说明如何将一个新的心理量表完整导入到系统中，包括所有必要的配置步骤。

## 🎯 导入流程概览

```
1. 创建量表基本信息
   ↓
2. 添加题目（题目管理）
   ↓
3. 为每个题目添加选项（选项管理）
   ↓
4. 添加因子（因子管理）
   ↓
5. 配置因子计分规则（计分规则管理）
   ↓
6. 配置结果解释（解释配置）
   ↓
7. 配置预警规则（可选，预警规则配置）
   ↓
8. 启用量表并测试
```

---

## 📝 详细操作步骤

### 步骤1：创建量表基本信息

**路径**：`心理测评管理` → `量表管理`

**操作步骤**：
1. 点击 **"新增"** 按钮
2. 填写量表基本信息：
   - **量表编码**：唯一标识，如 `SCL_90`、`EPQ_001`（必填）
   - **量表名称**：如 `症状自评量表SCL-90`（必填）
   - **量表类型**：选择类型（情绪、人格、行为等）
   - **量表简介**：简短介绍
   - **量表描述**：详细描述
   - **题目数量**：预计题目数（如 `90`）
   - **预计完成时间**：分钟数（如 `30`）
   - **适用人群**：如 `一般人群`、`青少年`等
   - **作者**：量表作者
   - **来源**：量表来源
   - **状态**：选择 `正常`（启用）或 `停用`
3. 点击 **"确定"** 保存

**注意事项**：
- 量表编码必须唯一
- 状态选择 `正常` 后，量表才会在测评选择页面显示
- 题目数量可以后续修改

---

### 步骤2：添加题目（题目管理）

**路径**：`心理测评管理` → `量表管理` → 点击量表行的 **"题目管理"** 按钮

**操作步骤**：
1. 在量表列表中找到刚创建的量表
2. 点击该行的 **"题目管理"** 按钮
3. 进入题目管理页面后，点击 **"新增"** 按钮
4. 填写题目信息：
   - **题目序号**：如 `1`、`2`、`3`...（必填，用于排序）
   - **题目内容**：题目的完整文字内容（必填）
   - **题目类型**：选择 `单选题` 或 `多选题`
   - **是否必答**：选择 `是` 或 `否`
   - **排序**：数字越小越靠前（可选）
5. 点击 **"确定"** 保存
6. 重复步骤3-5，添加所有题目

**批量添加技巧**：
- 可以一次性添加多个题目，然后逐个配置选项
- 建议先添加所有题目，再统一配置选项

**注意事项**：
- 题目序号建议连续，从1开始
- 题目内容支持富文本（如果需要）
- 题目类型决定了后续选项的配置方式

---

### 步骤3：为每个题目添加选项（选项管理）

**路径**：在题目管理页面，点击题目行的 **"选项管理"** 按钮

**操作步骤**：
1. 在题目列表中，找到要配置选项的题目
2. 点击该行的 **"选项管理"** 按钮
3. 在弹出的对话框中，点击 **"新增"** 按钮
4. 填写选项信息：
   - **选项编码**：如 `A`、`B`、`C`、`D` 或 `1`、`2`、`3`、`4`（必填）
   - **选项内容**：选项的文字内容（必填）
   - **选项分数**：该选项对应的分数（必填，如 `0`、`1`、`2`、`3`）
   - **排序**：数字越小越靠前（可选）
5. 点击 **"确定"** 保存
6. 重复步骤3-5，为该题目添加所有选项
7. 点击对话框的 **"关闭"** 按钮
8. 重复步骤1-7，为所有题目配置选项

**选项配置示例**：

**单选题示例**（如焦虑自评量表）：
- 选项A：没有或很少时间（分数：1）
- 选项B：小部分时间（分数：2）
- 选项C：相当多时间（分数：3）
- 选项D：绝大部分或全部时间（分数：4）

**多选题示例**（如症状自评量表）：
- 选项A：没有（分数：0）
- 选项B：很轻（分数：1）
- 选项C：中等（分数：2）
- 选项D：偏重（分数：3）
- 选项E：严重（分数：4）

**注意事项**：
- 选项编码在同一题目内必须唯一
- 选项分数用于后续计分，必须准确
- 单选题通常每个选项对应一个分数
- 多选题可能需要累加分数或取最高分

---

### 步骤4：添加因子（因子管理）

**路径**：`心理测评管理` → `量表管理` → 点击量表行的 **"因子管理"** 按钮

**操作步骤**：
1. 在量表列表中找到量表
2. 点击该行的 **"因子管理"** 按钮
3. 进入因子管理页面后，点击 **"新增"** 按钮
4. 填写因子信息：
   - **因子编码**：如 `F1`、`F2`、`F3` 或 `躯体化`、`强迫`等（必填）
   - **因子名称**：如 `躯体化因子`、`强迫症状因子`（必填）
   - **因子描述**：因子的详细说明（可选）
   - **排序**：数字越小越靠前（可选）
5. 点击 **"确定"** 保存
6. 重复步骤3-5，添加所有因子

**因子配置示例**（如SCL-90量表）：
- 因子1：躯体化
- 因子2：强迫症状
- 因子3：人际关系敏感
- 因子4：抑郁
- 因子5：焦虑
- 因子6：敌对
- 因子7：恐怖
- 因子8：偏执
- 因子9：精神病性

**注意事项**：
- 因子编码在同一量表内必须唯一
- 因子用于后续的计分规则配置和结果解释
- 如果量表没有因子（只有总分），可以跳过此步骤

---

### 步骤5：配置因子计分规则（计分规则管理）

**路径**：在因子管理页面，点击因子行的 **"计分规则"** 按钮

**操作步骤**：
1. 在因子列表中，找到要配置计分规则的因子
2. 点击该行的 **"计分规则"** 按钮
3. 在弹出的对话框中，点击 **"新增规则"** 按钮
4. 在表格中配置规则：
   - **题目**：从下拉框中选择题目（显示题目序号和内容）
   - **选项**：从下拉框中选择选项（多选，可选，留空表示所有选项）
   - **权重**：该规则在计分中的权重（0-10，默认1.00）
   - **计算方式**：选择 `求和`、`平均`、`最大`、`最小`
5. 重复步骤3-4，为该因子添加所有计分规则
6. 点击 **"保存"** 按钮保存所有规则
7. 重复步骤1-6，为所有因子配置计分规则

**计分规则配置示例**：

**示例1：简单求和**（如SCL-90的躯体化因子）：
- 规则1：题目1 → 所有选项 → 权重1.00 → 计算方式：求和
- 规则2：题目4 → 所有选项 → 权重1.00 → 计算方式：求和
- 规则3：题目12 → 所有选项 → 权重1.00 → 计算方式：求和
- ...（包含所有属于该因子的题目）

**示例2：加权求和**（如某些量表的因子）：
- 规则1：题目1 → 选项A,B → 权重2.00 → 计算方式：求和
- 规则2：题目2 → 所有选项 → 权重1.00 → 计算方式：求和

**注意事项**：
- 计分规则决定了因子分数的计算方式
- 如果某个题目属于多个因子，需要为每个因子都配置规则
- 计算方式：
  - **求和**：所有选中选项的分数之和 × 权重
  - **平均**：所有选中选项的分数平均值 × 权重
  - **最大**：所有选中选项的分数最大值 × 权重
  - **最小**：所有选中选项的分数最小值 × 权重

---

### 步骤6：配置结果解释（解释配置）

**路径**：`心理测评管理` → `解释配置`

**操作步骤**：
1. 进入解释配置页面
2. 点击 **"新增"** 按钮
3. 填写解释信息：
   - **量表**：从下拉框中选择量表（可选，留空表示通用解释）
   - **因子**：从下拉框中选择因子（可选，留空表示总体解释；需先选择量表）
   - **分数下限**：该解释适用的最低分数（必填）
   - **分数上限**：该解释适用的最高分数（必填）
   - **等级**：如 `低`、`中`、`高`（可选）
   - **等级名称**：如 `轻度`、`中度`、`重度`（可选）
   - **解释标题**：解释的标题（必填）
   - **解释内容**：详细的解释说明（可选）
   - **建议指导**：针对该分数段的建议或指导（可选）
   - **排序**：数字越小越靠前（可选）
4. 点击 **"确定"** 保存
5. 重复步骤2-4，为所有分数段配置解释

**结果解释配置示例**（如SCL-90的躯体化因子）：
- 解释1：量表=SCL-90，因子=躯体化，分数范围=0-10，等级=低，解释标题="正常范围"
- 解释2：量表=SCL-90，因子=躯体化，分数范围=11-20，等级=中，解释标题="轻度症状"
- 解释3：量表=SCL-90，因子=躯体化，分数范围=21-30，等级=高，解释标题="中度症状"
- 解释4：量表=SCL-90，因子=躯体化，分数范围=31-40，等级=高，解释标题="重度症状"

**注意事项**：
- 分数范围不能重叠（系统会根据分数自动匹配解释）
- 可以为量表总体配置解释（因子留空）
- 可以为特定因子配置解释（选择因子）
- 可以为通用情况配置解释（量表和因子都留空）

---

### 步骤7：配置预警规则（可选）

**路径**：`心理测评管理` → `预警规则配置`

**操作步骤**：
1. 进入预警规则配置页面
2. 点击 **"新增"** 按钮
3. 填写预警规则信息：
   - **量表**：从下拉框中选择量表（必填）
   - **因子**：从下拉框中选择因子（可选，留空表示针对总分）
   - **规则名称**：如 `重度抑郁预警`（必填）
   - **预警等级**：选择 `低`、`中`、`高`、`紧急`（必填）
   - **分数下限**：触发预警的最低分数（可选）
   - **分数上限**：触发预警的最高分数（可选）
   - **百分位下限**：触发预警的最低百分位（可选）
   - **百分位上限**：触发预警的最高百分位（可选）
   - **自动解除**：是否自动解除预警（可选）
   - **解除条件**：自动解除的条件（可选）
   - **状态**：选择 `正常`（启用）或 `停用`
4. 点击 **"确定"** 保存
5. 重复步骤2-4，配置所有预警规则

**预警规则配置示例**：
- 规则1：量表=SCL-90，因子=抑郁，预警等级=高，分数范围=30-40，状态=正常
- 规则2：量表=SCL-90，因子=焦虑，预警等级=紧急，分数范围=35-40，状态=正常

**注意事项**：
- 预警规则用于在测评结果异常时自动向管理员发出警告
- 可以针对特定因子配置，也可以针对总分配置
- 预警等级决定了警告的严重程度
- 只有状态为 `正常` 的规则才会生效

---

### 步骤8：启用量表并测试

**操作步骤**：
1. 返回 `量表管理` 页面
2. 确认量表状态为 `正常`（如果为 `停用`，点击修改改为 `正常`）
3. 确认所有配置已完成：
   - ✅ 量表基本信息已填写
   - ✅ 题目已添加（至少1题）
   - ✅ 每个题目都有选项（至少1个选项）
   - ✅ 因子已添加（如果有因子）
   - ✅ 因子计分规则已配置（如果有因子）
   - ✅ 结果解释已配置（至少1条）
4. 测试量表：
   - 进入 `测评管理` → `开始测评`
   - 选择刚创建的量表
   - 填写被测评人信息
   - 开始答题，完成所有题目
   - 提交测评
   - 查看生成的报告，验证：
     - 分数计算是否正确
     - 因子分数是否正确（如果有因子）
     - 结果解释是否正确显示
     - 预警是否正常触发（如果配置了预警规则）

---

## 📊 配置检查清单

在完成量表导入后，使用以下清单检查配置是否完整：

### 基本信息
- [ ] 量表编码已填写且唯一
- [ ] 量表名称已填写
- [ ] 量表状态为 `正常`
- [ ] 题目数量与实际题目数一致

### 题目配置
- [ ] 至少添加了1个题目
- [ ] 所有题目都有题目序号
- [ ] 所有题目都有题目内容
- [ ] 题目类型已选择（单选/多选）

### 选项配置
- [ ] 每个题目至少添加了1个选项
- [ ] 所有选项都有选项编码
- [ ] 所有选项都有选项内容
- [ ] 所有选项都有选项分数

### 因子配置（如果有因子）
- [ ] 至少添加了1个因子
- [ ] 所有因子都有因子编码
- [ ] 所有因子都有因子名称

### 计分规则配置（如果有因子）
- [ ] 每个因子至少配置了1条计分规则
- [ ] 计分规则中的题目都已选择
- [ ] 计分规则中的权重已设置
- [ ] 计分规则中的计算方式已选择

### 结果解释配置
- [ ] 至少配置了1条结果解释
- [ ] 结果解释的分数范围已设置
- [ ] 结果解释的解释标题已填写
- [ ] 结果解释的解释内容已填写（建议）

### 预警规则配置（可选）
- [ ] 预警规则已配置（如果需要）
- [ ] 预警规则的量表已选择
- [ ] 预警规则的预警等级已选择
- [ ] 预警规则的状态为 `正常`

---

## 🔍 常见问题

### Q1：量表创建后，在测评选择页面看不到？
**A**：检查以下几点：
- 量表状态是否为 `正常`
- 量表是否有至少1个题目
- 刷新浏览器页面

### Q2：题目添加后，选项管理按钮点击没反应？
**A**：检查以下几点：
- 题目是否已保存
- 浏览器控制台是否有错误
- 尝试刷新页面

### Q3：因子计分规则配置后，分数计算不正确？
**A**：检查以下几点：
- 选项分数是否正确
- 计分规则中的题目是否选择正确
- 计分规则中的计算方式是否合适
- 权重设置是否正确

### Q4：结果解释不显示？
**A**：检查以下几点：
- 是否配置了结果解释
- 结果解释的分数范围是否覆盖了实际分数
- 结果解释的量表和因子是否匹配

### Q5：预警规则不触发？
**A**：检查以下几点：
- 预警规则的状态是否为 `正常`
- 预警规则的分数范围是否设置正确
- 测评结果是否满足预警条件

---

## 📚 相关文档

- [功能使用指南](./使用指南-功能测试说明.md)
- [用户注册和量表权限管理功能开发](./14-用户注册和量表权限管理功能开发.md)

---

## ✅ 完成标志

当以下所有条件满足时，量表导入完成：

1. ✅ 量表在测评选择页面可以正常选择
2. ✅ 可以正常开始测评并答题
3. ✅ 提交测评后可以正常生成报告
4. ✅ 报告中的分数计算正确
5. ✅ 报告中的结果解释正确显示
6. ✅ 预警规则正常触发（如果配置了）

---

**最后更新**：2025-11-06