- 16 个业务模块,856 个测试用例,40 个 E2E 测试 - 单一 React 19 前端 + PlatformSwitcher 二合一切换 - Flask 后端支持 scenario/dcloud_module/dcloud_e2e/dcloud_all 四种任务类型 - E2E 测试面板:API 全链路(8条) + UI 点击(3条) + 分步测试(3个) - SSE 实时日志流 + 飞书告警 + 定时调度 - 完整还原原 ToB 平台 TestPanel E2E 模块
工作台(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: 工作台模块测试
运行测试
运行所有工作台测试
pytest tests/workbench/ -v
运行特定类型的测试
# 只运行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"
运行特定测试类
pytest tests/workbench/tests/test_workbench_ui.py::TestWorkbenchNavigation -v
依赖的 Fixture
测试依赖以下 pytest fixture(在 conftest.py 中定义):
authenticated_page: 已认证的 Playwright 页面api_client: API 客户端实例workbench_page: 工作台页面对象(自定义fixture)
测试设计原则
- 独立性: 每个测试用例独立运行,不依赖其他测试的状态
- 原子性: 每个测试验证单一功能或场景
- 健壮性: 包含适当的错误处理和跳过机制
- 可维护性: 清晰的文档和结构化的代码
- 实用性: 测试实际可运行的功能,不使用 mock 数据
页面元素适配说明
由于实际页面结构可能有所不同,部分定位器可能需要根据实际DOM结构进行调整:
- CSS 类名: 实际页面可能使用不同的类名(如
.dashboard-card代替.workbench-card) - 文本内容: 实际页面可能使用不同的文本(如"我的工作台"可能为"工作空间")
- 区域划分: 页面区域划分可能不同
建议在首次运行前检查实际页面的DOM结构,必要时调整定位器。
扩展建议
- 添加数据驱动测试: 使用
@pytest.mark.parametrize扩展测试场景 - 集成性能监控: 添加页面性能指标收集
- 截图对比: 添加视觉回归测试
- 跨浏览器测试: 扩展支持不同浏览器
- 移动端适配: 添加移动端响应式测试