- CLI + Web 双平台,基于 LLM 的 TDD+DDD 自动化测试生成 - 集成 unified-test-platform 903 个 D-Cloud 用例 + 13 个 Robogo 场景 - Agent 5 步流水线: 扫描 -> DDD -> LLM 生成测试 - 精确回归 + UI 变更检查 - 可视化 HTML 测试报告 - 暗色/亮色主题切换 - 19 个 API 端点 + 6 个 SPA 页面 - 15/15 项 TDD+DDD 合规
140 lines
5.3 KiB
Markdown
140 lines
5.3 KiB
Markdown
# 工作台(Workbench)测试套件
|
||
|
||
工作台是网站的主入口页面(URL: `/d-cloud/workbench/list`),包含工作台卡片列表、导航菜单、快捷操作入口和统计信息展示。
|
||
|
||
## 测试文件结构
|
||
|
||
```
|
||
tests/workbench/
|
||
├── __init__.py # 模块初始化
|
||
├── workbench_page.py # 页面对象模型
|
||
├── tests/
|
||
│ ├── __init__.py # 测试目录初始化
|
||
│ ├── test_workbench_ui.py # UI 界面测试
|
||
│ ├── test_workbench_api.py # API 接口测试
|
||
│ └── test_workbench_flow.py # 业务流程测试
|
||
└── README.md # 本文档
|
||
```
|
||
|
||
## 页面对象(WorkbenchPage)
|
||
|
||
### 主要功能
|
||
- **导航功能**: 导航到工作台页面,等待页面加载
|
||
- **元素定位**: 定义了页面所有关键元素的定位器
|
||
- **卡片操作**: 获取卡片信息、点击卡片操作按钮
|
||
- **导航菜单**: 获取菜单项、点击菜单项、检查激活状态
|
||
- **快捷操作**: 获取快捷操作按钮、点击快捷操作
|
||
- **统计信息**: 获取统计卡片数据
|
||
- **最近活动**: 获取活动记录
|
||
- **搜索功能**: 搜索、清除搜索
|
||
- **用户菜单**: 打开用户菜单、获取菜单项
|
||
- **通知功能**: 打开通知面板、获取通知数量
|
||
- **页面状态**: 检查页面加载状态、元素可见性
|
||
|
||
### 关键定位器
|
||
- `page_title`: 页面标题(包含"工作台")
|
||
- `nav_menu`: 导航菜单
|
||
- `workbench_cards`: 工作台卡片列表
|
||
- `quick_action_buttons`: 快捷操作按钮
|
||
- `stat_cards`: 统计信息卡片
|
||
- `activity_items`: 最近活动记录
|
||
- `search_input`: 搜索输入框
|
||
- `user_avatar`: 用户头像/菜单
|
||
- `notification_bell`: 通知铃铛
|
||
|
||
## 测试分类
|
||
|
||
### 1. UI 测试 (`test_workbench_ui.py`)
|
||
- **导航测试**: 验证页面导航功能
|
||
- **元素显示测试**: 验证所有关键元素正常显示
|
||
- **卡片功能测试**: 验证卡片信息完整性和操作按钮
|
||
- **搜索功能测试**: 验证搜索框功能
|
||
- **用户界面测试**: 验证用户相关UI元素
|
||
- **统计信息测试**: 验证统计卡片显示
|
||
- **最近活动测试**: 验证活动记录显示
|
||
- **响应式测试**: 验证页面在不同屏幕尺寸下的布局
|
||
- **页面操作测试**: 验证页面刷新和导航状态保持
|
||
|
||
### 2. API 测试 (`test_workbench_api.py`)
|
||
- **工作台API测试**: 验证工作台数据接口
|
||
- **统计信息API测试**: 验证统计接口
|
||
- **最近活动API测试**: 验证活动记录接口
|
||
- **卡片配置API测试**: 验证卡片配置接口
|
||
- **API端点可用性测试**: 验证所有相关API端点
|
||
- **API响应时间测试**: 验证接口响应性能
|
||
- **API错误处理测试**: 验证错误处理机制
|
||
|
||
### 3. 流程测试 (`test_workbench_flow.py`)
|
||
- **导航流程测试**: 测试完整的导航流程
|
||
- **卡片交互流程**: 测试与卡片的完整交互
|
||
- **快捷操作流程**: 测试快捷操作的使用流程
|
||
- **搜索流程测试**: 测试完整的搜索流程
|
||
- **用户菜单流程**: 测试用户菜单操作流程
|
||
- **通知流程测试**: 测试通知功能流程
|
||
- **完整用户流程**: 模拟用户完整的使用流程
|
||
- **错误恢复流程**: 测试页面错误后的恢复能力
|
||
- **性能流程测试**: 测试页面加载和刷新性能
|
||
|
||
## 测试标记(pytest markers)
|
||
|
||
- `@pytest.mark.ui`: UI 测试
|
||
- `@pytest.mark.api`: API 测试
|
||
- `@pytest.mark.flow`: 流程测试
|
||
- `@pytest.mark.workbench`: 工作台模块测试
|
||
|
||
## 运行测试
|
||
|
||
### 运行所有工作台测试
|
||
```bash
|
||
pytest tests/workbench/ -v
|
||
```
|
||
|
||
### 运行特定类型的测试
|
||
```bash
|
||
# 只运行UI测试
|
||
pytest tests/workbench/tests/test_workbench_ui.py -v -m "ui"
|
||
|
||
# 只运行API测试
|
||
pytest tests/workbench/tests/test_workbench_api.py -v -m "api"
|
||
|
||
# 只运行流程测试
|
||
pytest tests/workbench/tests/test_workbench_flow.py -v -m "flow"
|
||
```
|
||
|
||
### 运行特定测试类
|
||
```bash
|
||
pytest tests/workbench/tests/test_workbench_ui.py::TestWorkbenchNavigation -v
|
||
```
|
||
|
||
## 依赖的 Fixture
|
||
|
||
测试依赖以下 pytest fixture(在 `conftest.py` 中定义):
|
||
- `authenticated_page`: 已认证的 Playwright 页面
|
||
- `api_client`: API 客户端实例
|
||
- `workbench_page`: 工作台页面对象(自定义fixture)
|
||
|
||
## 测试设计原则
|
||
|
||
1. **独立性**: 每个测试用例独立运行,不依赖其他测试的状态
|
||
2. **原子性**: 每个测试验证单一功能或场景
|
||
3. **健壮性**: 包含适当的错误处理和跳过机制
|
||
4. **可维护性**: 清晰的文档和结构化的代码
|
||
5. **实用性**: 测试实际可运行的功能,不使用 mock 数据
|
||
|
||
## 页面元素适配说明
|
||
|
||
由于实际页面结构可能有所不同,部分定位器可能需要根据实际DOM结构进行调整:
|
||
|
||
1. **CSS 类名**: 实际页面可能使用不同的类名(如 `.dashboard-card` 代替 `.workbench-card`)
|
||
2. **文本内容**: 实际页面可能使用不同的文本(如"我的工作台"可能为"工作空间")
|
||
3. **区域划分**: 页面区域划分可能不同
|
||
|
||
建议在首次运行前检查实际页面的DOM结构,必要时调整定位器。
|
||
|
||
## 扩展建议
|
||
|
||
1. **添加数据驱动测试**: 使用 `@pytest.mark.parametrize` 扩展测试场景
|
||
2. **集成性能监控**: 添加页面性能指标收集
|
||
3. **截图对比**: 添加视觉回归测试
|
||
4. **跨浏览器测试**: 扩展支持不同浏览器
|
||
5. **移动端适配**: 添加移动端响应式测试 |