# 用户旅程地图（含正常路径 & 异常路径步骤）

## 阶段1：登录与注册

### 正常路径

- **路径1 正常登录**

  1. 打开登录界面
  2. 输入账号
  3. 输入密码
  4. 点击登录
  5. 系统验证账号密码
  6. 登录成功 → 进入主界面

  **路径分析**

  - **POM**: LoginPage, MainPage
  - **Mock**: mockLoginSuccess()
  - **规格**:
    - ✓ 用户名输入框可见
    - ✓ 密码输入框可见
    - ✓ 登录按钮可见
    - ✓ 登录成功提示显示
    - ✓ 跳转到主界面
  - **需要新建**: 无
  - **需要添加**: 无
  - **已有的data-testid**:
    - `login-username-input` - 用户名输入框
    - `login-password-input` - 密码输入框
    - `login-submit-button` - 登录按钮
    - `patient_management`, `register`, `worklist` - MainPage导航按钮

- **路径2 急诊登录**

  1. 点击急诊入口
  2. 输入最小化患者信息（姓名/性别/急诊号）
  3. 系统分配临时 ID
  4. 自动进入检查工作台

- **路径3 自动登录**

  1. 启动系统
  2. 读取本地缓存凭证
  3. 验证凭证有效性
  4. 自动进入主界面

- **路径4 辅助注册**

  1. 选择辅助方式（身份证/医保卡/人脸识别）
  2. 系统采集识别信息
  3. 自动填充注册表单
  4. 确认并提交注册
  5. 注册完成

### 异常路径

- **异常1 登录失败**

  1. 输入错误的用户名/密码
  2. 系统提示错误
  3. 超过限制 → 账号锁定

  **路径分析**

  - **POM**: LoginPage
  - **Mock**: mockLoginFail()
  - **规格**:
    - ✓ 输入错误的用户名和密码
    - ✓ 系统显示错误提示 "登录失败"
    - ✓ 停留在登录页面
  - **需要新建**: 无
  - **需要添加**: 错误提示的data-testid（可选，可用文本查找）
  - **已有的data-testid**:
    - `login-username-input` - 用户名输入框
    - `login-password-input` - 密码输入框
    - `login-submit-button` - 登录按钮

- **异常2 急诊登录信息不完整**

  1. 输入信息缺失（如缺少性别/急诊号）
  2. 系统校验失败
  3. 返回修改提示

- **异常3 自动登录失败**

  1. 启动系统 → 读取缓存凭证
  2. 凭证过期/无效
  3. 系统验证失败 → 返回登录页面

- **异常4 辅助注册失败**

  1. 选择身份证识别
  2. 识别失败（模糊 / 设备异常 / 网络超时）
  3. 系统提示“识别失败，请重试”

---

## 阶段2：病人任务管理

### 正常路径

- **路径1 新建检查**

  1. 打开注册界面
  2. 输入患者信息（姓名/性别/年龄/科室等）
  3. 选择检查协议 & 体位
  4. 系统生成检查任务
  5. 保存到 Worklist

- **路径2 任务清单管理**

  1. 打开任务清单
  2. 输入查询条件
  3. 查询到任务结果
  4. 执行编辑/删除/导入导出/云分享

- **路径3 历史清单管理**

  1. 打开历史清单
  2. 查询历史任务
  3. 执行编辑/导出/刻录/发送操作

- **路径4 归档与回收站**

  1. 打开归档/回收站
  2. 查询归档任务
  3. 执行恢复或永久删除

- **路径5 传输队列**

  1. 打开传输队列
  2. 查询待传任务
  3. 执行重试或删除

### 异常路径

- **异常1 新建检查失败**

  1. 未填写必填信息 / 编号冲突
  2. 系统校验失败 → 返回提示

- **异常2 查询无结果**

  1. 输入查询条件
  2. 系统返回空结果

- **异常3 任务操作失败**

  1. 删除任务时 → 任务被锁定或占用
  2. 系统提示“无法删除”

- **异常4 归档节点不可用**

  1. 执行归档操作
  2. 节点连接失败 → 返回错误

- **异常5 传输失败**

  1. 执行任务传输
  2. 网络异常 → 重试失败

---

## 阶段3：进入检查

### 正常路径

- **路径1.1 Worklist 双击进入**

  1. 打开 Worklist
  2. 双击任务条目
  3. 系统加载任务信息
  4. 进入检查界面

  **路径分析**

  - **POM**: LoginPage, MainPage, WorklistPage, ExamPage
  - **Mock**:
    - mockLoginSuccess() - 登录成功
    - mockFetchTwoWorks() - 获取工作列表
    - mockGetStudyArrived() - 获取检查信息
  - **规格**:
    - ✓ 登录成功
    - ✓ 导航到工作列表
    - ✓ 工作列表显示至少2条记录
    - ✓ 双击第一条记录
    - ✓ 系统加载任务信息
    - ✓ 进入检查界面
  - **需要新建**: ExamPage POM
  - **需要添加**:
    - 检查界面元素的data-testid: `exam-patient-info`, `exam-toolbar`等
  - **已有的data-testid**:
    - WorklistTable: `row-0`, `row-1` - 表格行
    - MainPage: `patient_management`, `worklist`, `exam` - 导航按钮

- **路径1.2 Worklist 导航按钮进入**

  1. 打开 Worklist
  2. 选中任务条目
  3. 点击导航按钮"exam"
  4. 系统加载任务信息
  5. 进入检查界面

  **路径分析**

  - **POM**: LoginPage, MainPage, WorklistPage, ExamPage
  - **Mock**:
    - mockLoginSuccess()
    - mockFetchTwoWorks()
    - mockGetStudyArrived()
  - **规格**:
    - ✓ 登录成功
    - ✓ 导航到工作列表
    - ✓ 选中第一条记录（单击）
    - ✓ 点击导航按钮 "exam"
    - ✓ 系统加载任务信息
    - ✓ 进入检查界面
  - **需要新建**: ExamPage POM
  - **需要添加**: 检查界面元素的data-testid
  - **已有的data-testid**:
    - MainPage: `exam` - 导航到检查的按钮
    - WorklistTable: `row-{index}` - 表格行

- **路径2.1 History 双击进入**

  1. 打开 History
  2. 双击历史检查条目
  3. 系统加载检查信息
  4. 进入检查界面

- **路径2.2 History 导航按钮进入**

  1. 打开 History
  2. 选中历史检查条目
  3. 点击导航按钮"exam"
  4. 系统加载检查信息
  5. 进入检查界面

- **路径3.1 Register 页面按钮进入**

  1. 注册新检查
  2. 点击页面上的检查按钮
  3. 系统跳转 → 检查界面

- **路径3.2 Register 导航按钮进入**

  1. 注册新检查
  2. 点击导航区域的"exam"按钮
  3. 系统跳转 → 检查界面

- **路径4 急诊入口进入**

  1. 点击急诊入口
  2. 确认病人基本信息
  3. 进入检查界面

### 异常路径

- **异常1 Worklist 条目缺失**

  1. 打开 Worklist
  2. 未同步到检查任务
  3. 系统提示“无可用任务”

- **异常2 检查入口权限不足**

  1. 双击进入检查
  2. 系统验证权限失败
  3. 提示“无权限进入”

- **异常3 急诊病人未绑定**

  1. 点击急诊入口
  2. 病人信息不完整
  3. 系统提示“无法进入检查”

---

## 阶段4：图像采集

### 正常路径

- **路径1 设备调整**

  1. 检查设备状态
  2. 选择患者体型/剂量参数
  3. 选择焦点

- **路径2 体位管理**

  1. 追加体位
  2. 删除/复制体位
  3. 保存参数

- **路径3 图像采集**

  1. 执行曝光
  2. 采集图像
  3. 检查图像质量
  4. 拒绝不合格图像 / 保留合格图像

- **路径4 检查控制**

  1. 挂起检查
  2. 结束检查

- **路径5 探测器校正**

  1. 启动校正
  2. 等待完成
  3. 可执行取消/中止

### 异常路径

- **异常1 设备状态异常**

  1. 进入检查
  2. 探测器未连接 / 电池不足
  3. 系统报错提示

- **异常2 剂量设置超限**

  1. 设置参数
  2. 超出上限 / 低于下限
  3. 系统提示错误

- **异常3 图像采集失败**

  1. 执行曝光
  2. 图像丢失 / 采集错误
  3. 系统提示“采集失败”

- **异常4 校正失败**

  1. 启动探测器校正
  2. 过程中出错 / 被中止
  3. 校正失败提示

---

## 阶段5：图像处理

### 正常路径

- **路径1 基础操作**

  1. 打开图像
  2. 添加标记
  3. 执行旋转/翻转
  4. 执行缩放/裁剪

- **路径2 增强对比**

  1. 调节亮度
  2. 调节对比度
  3. 应用预置风格
  4. 启用交响乐模式

- **路径3 测量**

  1. 选择测量工具
  2. 线段测量 / 角度 / Cobb角 / 宠物测量
  3. 生成测量结果

- **路径4 高级处理**

  1. 选择裁剪区域
  2. 应用 Mask/Shutter
  3. 进行断层重建

- **路径5 辅助功能**

  1. 查看图像信息
  2. 快照 / 另存为
  3. 启用 AI 诊断

### 异常路径

- **异常1 图像处理失败**

  1. 执行处理功能
  2. 图像格式不支持 / 算法报错
  3. 系统提示“处理失败”

- **异常2 测量错误**

  1. 启动测量工具
  2. 未正确选择对象
  3. 系统提示“测量失败”

- **异常3 AI 诊断失败**

  1. 启用 AI 功能
  2. AI 服务不可用 / 网络异常
  3. 系统提示“诊断失败”

---

## 阶段6：输出与归档

### 正常路径

- **路径1 打印任务**

  1. 打开打印任务列表
  2. 查询任务
  3. 执行重试/删除

- **路径2 胶片操作**

  1. 新建胶片
  2. 添加图像
  3. 调整布局/缩放/旋转/翻转
  4. 保存或删除胶片

- **路径3 发送任务**

  1. 打开发送任务列表
  2. 查询任务
  3. 执行重试/删除

- **路径4 发送图像/报告**

  1. 选中图像/报告
  2. 点击发送
  3. 系统执行发送

- **路径5 导出/刻录**

  1. 打开导出/刻录功能
  2. 选择目标图像
  3. 执行导出或刻录

### 异常路径

- **异常1 打印失败**

  1. 执行打印
  2. 打印机不可用 / DICOM 打印错误
  3. 系统提示失败

- **异常2 发送失败**

  1. 执行发送任务
  2. 网络断开 / 节点不可达
  3. 系统提示失败

- **异常3 导出失败**

  1. 执行导出操作
  2. 目标路径不可写 / 磁盘空间不足
  3. 系统提示“导出失败”

- **异常4 胶片布局错误**

  1. 调整布局时分格冲突
  2. 系统提示“布局无效”

---

## 阶段7：系统设置与安全

### 正常路径

- **路径1 硬件节点配置**

  1. 打开系统设置
  2. 配置探测器/发生器/节点
  3. 保存配置

- **路径2 协议参数管理**

  1. 打开协议设置
  2. 修改协议参数
  3. 导入/导出协议

- **路径3 安全权限**

  1. 管理用户/角色
  2. 分配权限
  3. 查看审计日志

- **路径4 设备与统计**

  1. 查看设备状态
  2. 生成统计报表
  3. 导出报表

### 异常路径

- **异常1 配置保存失败**

  1. 修改节点配置
  2. 保存时权限不足 / 配置冲突
  3. 系统提示失败

- **异常2 节点验证失败**

  1. 添加新节点
  2. 网络断开 / 验证超时
  3. 系统提示“验证失败”

- **异常3 权限分配错误**

  1. 设置权限
  2. 用户越权或缺少必要角色
  3. 系统提示“权限错误”

- **异常4 统计导出失败**

  1. 生成报表
  2. 导出 Excel 失败（模板缺失 / 系统异常）
  3. 提示“导出失败”

- **正常路径** → 步骤清晰
- **异常路径** → 可能出错的步骤 & 系统反馈

# 表格形式

| 阶段                 | 路径                 | 类型     | 步骤                                                                                                     |
| :------------------- | :------------------- | :------- | :------------------------------------------------------------------------------------------------------- |
| 阶段1 登录与注册     | 正常登录             | 正常路径 | 打开登录界面 → 输入账号 → 输入密码 → 点击登录 → 系统验证账号密码 → 登录成功 → 进入主界面                 |
| 阶段1 登录与注册     | 急诊登录             | 正常路径 | 点击急诊入口 → 输入最小化患者信息（姓名/性别/急诊号） → 系统分配临时ID → 自动进入检查工作台              |
| 阶段1 登录与注册     | 自动登录             | 正常路径 | 启动系统 → 读取本地缓存凭证 → 验证凭证有效性 → 自动进入主界面                                            |
| 阶段1 登录与注册     | 辅助注册             | 正常路径 | 选择辅助方式（身份证/医保卡/人脸识别） → 系统采集识别信息 → 自动填充注册表单 → 确认并提交注册 → 注册完成 |
| 阶段1 登录与注册     | 登录失败             | 异常路径 | 输入错误的用户名/密码 → 系统提示错误 → 超过限制 → 账号锁定                                               |
| 阶段1 登录与注册     | 急诊登录信息不完整   | 异常路径 | 输入信息缺失（如缺少性别/急诊号） → 系统校验失败 → 返回修改提示                                          |
| 阶段1 登录与注册     | 自动登录失败         | 异常路径 | 启动系统 → 读取缓存凭证 → 凭证过期/无效 → 系统验证失败 → 返回登录页面                                    |
| 阶段1 登录与注册     | 辅助注册失败         | 异常路径 | 选择身份证识别 → 识别失败（模糊 / 设备异常 / 网络超时） → 系统提示“识别失败，请重试”                     |
| 阶段2 病人任务管理   | 新建检查             | 正常路径 | 打开注册界面 → 输入患者信息 → 选择检查协议 & 体位 → 系统生成检查任务 → 保存到 Worklist                   |
| 阶段2 病人任务管理   | 任务清单管理         | 正常路径 | 打开任务清单 → 输入查询条件 → 查询到任务结果 → 执行编辑/删除/导入导出/云分享                             |
| 阶段2 病人任务管理   | 历史清单管理         | 正常路径 | 打开历史清单 → 查询历史任务 → 执行编辑/导出/刻录/发送操作                                                |
| 阶段2 病人任务管理   | 归档与回收站         | 正常路径 | 打开归档/回收站 → 查询归档任务 → 执行恢复或永久删除                                                      |
| 阶段2 病人任务管理   | 传输队列             | 正常路径 | 打开传输队列 → 查询待传任务 → 执行重试或删除                                                             |
| 阶段2 病人任务管理   | 新建检查失败         | 异常路径 | 未填写必填信息 / 编号冲突 → 系统校验失败 → 返回提示                                                      |
| 阶段2 病人任务管理   | 查询无结果           | 异常路径 | 输入查询条件 → 系统返回空结果                                                                            |
| 阶段2 病人任务管理   | 任务操作失败         | 异常路径 | 删除任务时 → 任务被锁定或占用 → 系统提示“无法删除”                                                       |
| 阶段2 病人任务管理   | 归档节点不可用       | 异常路径 | 执行归档操作 → 节点连接失败 → 返回错误                                                                   |
| 阶段2 病人任务管理   | 传输失败             | 异常路径 | 执行任务传输 → 网络异常 → 重试失败                                                                       |
| 阶段3 进入检查       | Worklist双击进入     | 正常路径 | 打开 Worklist → 双击任务条目 → 系统加载任务信息 → 进入检查界面                                           |
| 阶段3 进入检查       | Worklist导航按钮进入 | 正常路径 | 打开 Worklist → 选中任务条目 → 点击导航按钮"exam" → 系统加载任务信息 → 进入检查界面                      |
| 阶段3 进入检查       | History双击进入      | 正常路径 | 打开 History → 双击历史检查条目 → 系统加载检查信息 → 进入检查界面                                        |
| 阶段3 进入检查       | History导航按钮进入  | 正常路径 | 打开 History → 选中历史检查条目 → 点击导航按钮"exam" → 系统加载检查信息 → 进入检查界面                   |
| 阶段3 进入检查       | Register页面按钮进入 | 正常路径 | 注册新检查 → 点击页面上的检查按钮 → 系统跳转 → 检查界面                                                  |
| 阶段3 进入检查       | Register导航按钮进入 | 正常路径 | 注册新检查 → 点击导航区域的"exam"按钮 → 系统跳转 → 检查界面                                              |
| 阶段3 进入检查       | 急诊入口进入         | 正常路径 | 点击急诊入口 → 确认病人基本信息 → 进入检查界面                                                           |
| 阶段3 进入检查       | Worklist条目缺失     | 异常路径 | 打开 Worklist → 未同步到检查任务 → 系统提示“无可用任务”                                                  |
| 阶段3 进入检查       | 检查入口权限不足     | 异常路径 | 双击进入检查 → 系统验证权限失败 → 提示“无权限进入”                                                       |
| 阶段3 进入检查       | 急诊病人未绑定       | 异常路径 | 点击急诊入口 → 病人信息不完整 → 系统提示“无法进入检查”                                                   |
| 阶段4 图像采集       | 设备调整             | 正常路径 | 检查设备状态 → 选择患者体型/剂量参数 → 选择焦点                                                          |
| 阶段4 图像采集       | 体位管理             | 正常路径 | 追加体位 → 删除/复制体位 → 保存参数                                                                      |
| 阶段4 图像采集       | 图像采集             | 正常路径 | 执行曝光 → 采集图像 → 检查图像质量 → 拒绝不合格图像 / 保留合格图像                                       |
| 阶段4 图像采集       | 检查控制             | 正常路径 | 挂起检查 → 结束检查                                                                                      |
| 阶段4 图像采集       | 探测器校正           | 正常路径 | 启动校正 → 等待完成 → 可执行取消/中止                                                                    |
| 阶段4 图像采集       | 设备状态异常         | 异常路径 | 进入检查 → 探测器未连接 / 电池不足 → 系统报错提示                                                        |
| 阶段4 图像采集       | 剂量设置超限         | 异常路径 | 设置参数 → 超出上限 / 低于下限 → 系统提示错误                                                            |
| 阶段4 图像采集       | 图像采集失败         | 异常路径 | 执行曝光 → 图像丢失 / 采集错误 → 系统提示“采集失败”                                                      |
| 阶段4 图像采集       | 校正失败             | 异常路径 | 启动探测器校正 → 过程中出错 / 被中止 → 校正失败提示                                                      |
| 阶段5 图像处理       | 基础操作             | 正常路径 | 打开图像 → 添加标记 → 执行旋转/翻转 → 执行缩放/裁剪                                                      |
| 阶段5 图像处理       | 增强对比             | 正常路径 | 调节亮度 → 调节对比度 → 应用预置风格 → 启用交响乐模式                                                    |
| 阶段5 图像处理       | 测量                 | 正常路径 | 选择测量工具 → 线段/角度/Cobb角/宠物测量 → 生成测量结果                                                  |
| 阶段5 图像处理       | 高级处理             | 正常路径 | 选择裁剪区域 → 应用 Mask/Shutter → 进行断层重建                                                          |
| 阶段5 图像处理       | 辅助功能             | 正常路径 | 查看图像信息 → 快照 / 另存为 → 启用 AI 诊断                                                              |
| 阶段5 图像处理       | 图像处理失败         | 异常路径 | 执行处理功能 → 图像格式不支持 / 算法报错 → 系统提示“处理失败”                                            |
| 阶段5 图像处理       | 测量错误             | 异常路径 | 启动测量工具 → 未正确选择对象 → 系统提示“测量失败”                                                       |
| 阶段5 图像处理       | AI诊断失败           | 异常路径 | 启用 AI 功能 → AI 服务不可用 / 网络异常 → 系统提示“诊断失败”                                             |
| 阶段6 输出与归档     | 打印任务             | 正常路径 | 打开打印任务列表 → 查询任务 → 执行重试/删除                                                              |
| 阶段6 输出与归档     | 胶片操作             | 正常路径 | 新建胶片 → 添加图像 → 调整布局/缩放/旋转/翻转 → 保存或删除胶片                                           |
| 阶段6 输出与归档     | 发送任务             | 正常路径 | 打开发送任务列表 → 查询任务 → 执行重试/删除                                                              |
| 阶段6 输出与归档     | 发送图像/报告        | 正常路径 | 选中图像/报告 → 点击发送 → 系统执行发送                                                                  |
| 阶段6 输出与归档     | 导出/刻录            | 正常路径 | 打开导出/刻录功能 → 选择目标图像 → 执行导出或刻录                                                        |
| 阶段6 输出与归档     | 打印失败             | 异常路径 | 执行打印 → 打印机不可用 / DICOM 打印错误 → 系统提示失败                                                  |
| 阶段6 输出与归档     | 发送失败             | 异常路径 | 执行发送任务 → 网络断开 / 节点不可达 → 系统提示失败                                                      |
| 阶段6 输出与归档     | 导出失败             | 异常路径 | 执行导出操作 → 目标路径不可写 / 磁盘空间不足 → 系统提示“导出失败”                                        |
| 阶段6 输出与归档     | 胶片布局错误         | 异常路径 | 调整布局时分格冲突 → 系统提示“布局无效”                                                                  |
| 阶段7 系统设置与安全 | 硬件节点配置         | 正常路径 | 打开系统设置 → 配置探测器/发生器/节点 → 保存配置                                                         |
| 阶段7 系统设置与安全 | 协议参数管理         | 正常路径 | 打开协议设置 → 修改协议参数 → 导入/导出协议                                                              |
| 阶段7 系统设置与安全 | 安全权限             | 正常路径 | 管理用户/角色 → 分配权限 → 查看审计日志                                                                  |
| 阶段7 系统设置与安全 | 设备与统计           | 正常路径 | 查看设备状态 → 生成统计报表 → 导出报表                                                                   |
| 阶段7 系统设置与安全 | 配置保存失败         | 异常路径 | 修改节点配置 → 保存时权限不足 / 配置冲突 → 系统提示失败                                                  |
| 阶段7 系统设置与安全 | 节点验证失败         | 异常路径 | 添加新节点 → 网络断开 / 验证超时 → 系统提示“验证失败”                                                    |
| 阶段7 系统设置与安全 | 权限分配错误         | 异常路径 | 设置权限 → 用户越权或缺少必要角色 → 系统提示“权限错误”                                                   |
| 阶段7 系统设置与安全 | 统计导出失败         | 异常路径 | 生成报表 → 导出 Excel 失败（模板缺失 / 系统异常） → 提示“导出失败”                                       |