# 功能中心深层交互用例补充 需求文档

> **文档版本**: v1.0
> **创建日期**: 2026-07-23
> **文档状态**: 初稿待评审
> **负责人**: czj

---

## 一、背景

### 1.1 问题描述

当前 `platform-auto-test` 平台中，UI自动化测试用例共202个，其中59个是"页面访问验证"用例（仅验证页面可打开）。深层交互用例仅覆盖了会议管理、数据分析、管理看板、运维管理四个模块，大量功能中心页面缺少深层交互步骤（筛选器、表格、Tab切换等交互验证）。

### 1.2 覆盖现状

| 模块 | 页面访问用例 | 深层交互用例 | 覆盖率 |
|------|-------------|-------------|--------|
| 会议管理 | 6 | 38 | 100% |
| 数据分析 | 12 | 19 | 63% |
| 管理看板 | 1 | 14 | 100% |
| 运维管理 | 3 | 12 | 100% |
| 会议运维 | 6 | 0 | 0% |
| 集控控制 | 13 | 2 | 15% |
| 资产管理 | 3 | 0 | 0% |
| 维护工单 | 4 | 0 | 0% |
| 会务管理 | 2 | 0 | 0% |
| 信息管理 | 3 | 0 | 0% |
| 信息发布 | 1 | 0 | 0% |
| 其他分类 | 4 | 0 | 0% |

**问题**：37个页面的用例仅验证页面可访问，无法验证实际功能是否正常。

### 1.3 目标

为37个页面补充深层交互用例，使：
- 总用例数从202增加到约275
- 深层交互用例覆盖率从50%提升到70%以上
- 新增用例执行通过率 >= 75%

---

## 二、需求内容

### 2.1 功能需求

#### 2.1.1 用例新增

为以下9个模块的37个页面补充深层交互用例：

| 模块 | 页面数 | 新增用例数 |
|------|--------|-----------|
| 会议运维 | 6 | 12 |
| 集控控制 | 11 | 22 |
| 资产管理 | 3 | 6 |
| 维护工单 | 4 | 8 |
| 会务管理 | 2 | 4 |
| 信息管理 | 3 | 6 |
| 信息发布 | 1 | 1 |
| 其他分类 | 4 | 8 |
| 数据分析 | 3 | 6 |
| **合计** | **37** | **73** |

#### 2.1.2 交互模式分类

根据页面特征，将37个页面分为6种交互模式：

| 模式 | 页面特征 | 交互步骤 | 适用页面数 |
|------|---------|---------|-----------|
| 模式A: 表格+筛选器 | el-table + el-select | 导航→等待表格→筛选器操作→验证表格 | 14 |
| 模式B: Tab切换 | el-tabs | 导航→验证Tab存在→切换Tab→验证内容 | 6 |
| 模式C: 图表+筛选器 | canvas + el-select | 导航→等待图表→筛选器操作→验证图表 | 3 |
| 模式D: 纯表格验证 | 仅el-table | 导航→等待表格→验证分页/行数 | 5 |
| 模式E: 树形结构 | el-tree + el-table | 导航→点击树节点→验证表格变化 | 3 |
| 模式F: 按钮操作 | 操作按钮 | 导航→点击按钮→验证弹窗/响应 | 4 |

#### 2.1.3 用例设计原则

1. **每个页面至少2个深层交互用例**：表格验证 + 交互验证
2. **断言策略宽松优先**：使用 `element_exists` 而非 `visible`，使用 `element_count_min` 而非 `count`
3. **选择器策略**：使用 `selectors` 回退链而非单一 `selector`
4. **等待策略**：三段式等待（特征元素 + 渲染 + 额外等待）
5. **状态重置**：每个用例末尾添加"回到首页"步骤
6. **无登录步骤**：`auto_login=True`，由执行器自动处理登录

### 2.2 非功能需求

#### 2.2.1 执行效率

- 单个用例执行时间不超过180秒
- 批量执行73个用例总时间不超过60分钟

#### 2.2.2 可维护性

- 步骤模板函数可复用
- 新增页面时可直接使用模板快速创建用例
- 支持按名称查找并更新已有用例

---

## 三、用例设计

### 3.1 会议运维模块（12个用例）

| 页面 | 用例1 | 用例2 |
|------|-------|-------|
| 告警列表 | 表格数据验证 | 筛选器交互验证 |
| 视讯设备 | 表格数据验证 | 树形筛选验证 |
| 运维区域 | 表格数据验证 | 筛选器交互验证 |
| 会议巡检 | 表格数据验证 | 分页验证 |
| 运维巡检 | 页面元素验证 | 表格验证 |
| 运维设备 | 表格数据验证 | 筛选器验证 |

### 3.2 集控控制模块（22个用例）

| 页面 | 用例1 | 用例2 |
|------|-------|-------|
| 壁纸推送 | 页面元素验证 | 表格验证 |
| 屏幕管理 | 页面元素验证 | Tab切换验证 |
| 应用管理 | 表格数据验证 | 搜索验证 |
| 播放器发布 | 页面元素验证 | 表格验证 |
| 文件推送 | 表格数据验证 | 筛选器验证 |
| 消息推送 | 表格数据验证 | 筛选器验证 |
| 脚本命令 | 表格数据验证 | 操作按钮验证 |
| 设备网络 | 页面元素验证 | 表格验证 |
| 转录列表 | 表格数据验证 | Tab切换验证 |
| 软件卸载 | 页面元素验证 | 表格验证 |
| 门口屏发布 | 页面元素验证 | 表格验证 |

### 3.3 资产管理模块（6个用例）

| 页面 | 用例1 | 用例2 |
|------|-------|-------|
| 资产信息 | 表格数据验证 | 筛选器交互验证 |
| 资产故障 | 表格数据验证 | 筛选器交互验证 |
| 资产设备 | 表格数据验证 | 操作按钮验证 |

### 3.4 维护工单模块（8个用例）

| 页面 | 用例1 | 用例2 |
|------|-------|-------|
| 信息窗管理 | 表格数据验证 | 筛选器验证 |
| 告警工单 | 表格数据验证 | Tab切换验证 |
| 工单列表 | 表格数据验证 | Tab切换验证 |
| 我的工单 | 表格数据验证 | Tab切换验证 |

### 3.5 会务管理模块（4个用例）

| 页面 | 用例1 | 用例2 |
|------|-------|-------|
| 会务统筹 | 表格数据验证 | 筛选器验证 |
| 会务工单 | 表格数据验证 | 筛选器验证 |

### 3.6 信息管理模块（6个用例）

| 页面 | 用例1 | 用例2 |
|------|-------|-------|
| 下载列表 | 表格数据验证 | 筛选器验证 |
| 文件列表 | 表格数据验证 | 筛选器验证 |
| 通讯录 | 表格数据验证 | 树形筛选验证 |

### 3.7 信息发布模块（1个用例）

| 页面 | 用例 |
|------|------|
| 消息通知 | 表格数据验证 |

### 3.8 其他分类模块（8个用例）

| 页面 | 用例1 | 用例2 |
|------|-------|-------|
| 会议审批 | 表格数据验证 | Tab切换验证 |
| 历史记录 | 表格数据验证 | Tab切换验证 |
| 参会人模板 | 表格数据验证 | 操作按钮验证 |
| 已预定会议 | 表格数据验证 | 筛选器验证 |

### 3.9 数据分析模块（6个用例）

| 页面 | 用例1 | 用例2 |
|------|-------|-------|
| RSE会议统计 | 页面元素验证 | 图表验证 |
| SMC3.0会议统计 | 页面元素验证 | 图表验证 |
| Welink会议统计 | 页面元素验证 | 图表验证 |

---

## 四、验收标准

### 4.1 功能验收

| 验收项 | 验收标准 |
|--------|---------|
| 用例创建 | 数据库新增73个深层交互用例 |
| 用例执行 | 新增用例批量执行通过率 >= 75% |
| 步骤设计 | 每个用例包含至少1个交互操作步骤 |
| 断言设计 | 每个用例包含至少2个断言步骤 |

### 4.2 质量验收

| 验收项 | 验收标准 |
|--------|---------|
| 步骤模板化 | 7个可复用的步骤模板函数 |
| 选择器健壮性 | 使用 selectors 回退链 |
| 状态隔离 | 每个用例末尾有"回到首页"步骤 |

---

## 五、风险评估

| 风险 | 概率 | 影响 | 缓解措施 |
|------|------|------|---------|
| 功能中心抽屉状态残留 | 中 | 中 | 每个用例末尾添加"回到首页"步骤 |
| 表格数据为空 | 高 | 低 | 使用 `element_exists` 断言 |
| 筛选器下拉不弹出 | 中 | 中 | 增加多选器回退链 |
| Tab切换不生效 | 低 | 中 | 增加等待时间 |
| 页面加载超时 | 中 | 中 | 增加超时时间至30s |

---

## 六、附录

### 6.1 相关文档

- HANDOFF_UI自动化.md — 项目交接文档
- _PRD_需求文档_深层交互用例步骤优化.md — 步骤优化PRD
- create_deep_interaction_cases_v2.py — 已有步骤模板脚本

### 6.2 执行器支持的动作和断言

**动作类型**：navigate, click, fill, select, hover, wait, scroll, press, check, uncheck, screenshot

**断言类型**：visible, hidden, element_exists, element_count_min, count, contains, text, value, url_contains, title