12 KiB
AutoFlow 二合一重构评估
基于 docs/TBC_分析报告_0626.html 和逐文件代码审读,对 ToB(D-Cloud)和 ToC(Robogo)两个测试框架真正统一的可行性、风险和方案评估。
1. 现状:6 条断裂线
两个平台本质上是被测系统不同、技术选型不同的独立工程,合并只是放在了一个仓库里,没有做任何抽象统一。
| 断裂线 | D-Cloud (ToB) | Robogo (ToC) | 文件 |
|---|---|---|---|
| 配置系统 | config/settings.py,3 环境(dev/test/prod),工厂模式,validate_config() |
framework/config/settings.py,单类,手动 ROBOGO_ENV 判断 |
config/settings.py vs framework/config/settings.py |
| BasePage | 10 个 Mixin 组合,职责分离,强类型,86 行 | 单一类 312 行,smart_* 靠 page.evaluate 暴力扫 DOM 兜底 |
tests/base/base_page.py vs framework/core/base_page.py |
| API 客户端 | httpx,300 行,文件上传/代理/脱敏/认证快失败 |
requests.Session,63 行,极简 |
tests/utils/api_client.py vs framework/core/base_api.py |
| 认证流程 | pytest fixture + SSO + .auth/state.json 缓存 + token 有效性校验 |
环境变量 AUTH_TOKEN/COOKIE |
tests/conftest_auth.py vs framework/config/settings.py |
| 日志系统 | 129 行,彩色控制台,按日期分文件,上下文感知 | 21 行,基本控制台 + 文件 | tests/logger.py vs framework/core/logger.py |
| 场景文件 | — | scenarios/ 是 framework/scripts/ 的逐字副本 |
scenarios/ vs framework/scripts/ |
2. 无法统一的部分
| 项目 | 原因 |
|---|---|
| 被测前端 UI 组件库 | D-Cloud 用 Ant Design(.ant-table),Robogo 用 PrimeVue(.p-dialog),选择器语法不同 |
| 认证方式 | D-Cloud 走 SSO(sso-fat.d-robotics.cc),Robogo 走本地登录(robogo.d-robotics.cc),URL 和流程不同 |
| 测试运行器 | D-Cloud 走 pytest + marker(-m api/-m e2e),Robogo 走脚本编排器(DataManagement.run_all_scenarios),执行模式不同 |
| 被测 URL | D-Cloud 用 cloud-fat.d-robotics.cc,Robogo 用 robogo.d-robotics.cc,不是同一套后端 |
3. 推荐方案:分 4 阶段
阶段 1:统一配置(1 天)🟢 低风险 ✅ 已完成
目标:framework/config/settings.py → config/settings.py,所有代码从同一个配置入口读。
具体操作:
- 将
framework/config/settings.py的CloudDesktop/DevMachine嵌套类迁移到config/settings.py - 新增
RobogoConfig(BaseConfig)类,覆盖BASE_URL(Robogo URL)、LOGIN_URL(/cloud-desktop/login)、DEFAULT_TIMEOUT(30000) - 新增
Config = RobogoConfig别名,保持framework/代码Config.XXX类属性访问方式不变 - 23 个文件 import 路径更新:
from framework.config.settings import Config→from config.settings import Config - 删除
framework/config/settings.py
验证结果:
- 24 个 Python 文件编译 ✅ 0 错误
- D-Cloud 配置(
config实例)BASE_URL/DEFAULT_TIMEOUT不变 - Robogo 配置(
Config类)所有属性可访问 - 856 个测试全量收集通过
- E2E 不受影响
提交:561bcae — 阶段1: 配置统一
阶段 2:统一 API 客户端 + 日志(1 天)🟡 中风险 ✅ 已完成
目标:BaseAPI(requests)→ APIClient(httpx),日志统一到 tests/logger.py。
2.1 API 客户端差异分析
| 方法 | BaseAPI(Robogo, 63 行) |
APIClient(D-Cloud, 300 行) |
兼容性 |
|---|---|---|---|
get_common_headers(referer_path) |
构建完整 header(referer/UUID/sourceapp/user-agent) | 不存在 | 需新增 |
request(method, endpoint, headers, **kwargs) |
返回解析后的 dict(JSON) |
_request() 返回 httpx.Response |
不兼容 |
_check_response(resp, step_name) |
检查 HTTP 状态码 + 业务 status 字段,抛 TokenExpiredError/APIError |
_assert_not_auth_error() 仅检查认证错误 |
需适配 |
| 会话管理 | requests.Session(持久化) |
每次新建 httpx.Client |
无影响 |
关键不兼容点:BaseAPI 子类代码直接对返回值做 data.get("data", {}) 操作,换 Response 对象会崩。需给 APIClient 加 request() 兼容方法,内部解析 JSON 并做业务状态检查。
2.2 影响范围
| 文件 | 数量 | 操作 |
|---|---|---|
BaseAPI 子类 |
5 个 | 改为继承 APIClient |
framework/core/logger.py 引用 |
41 个 | import 路径改为 tests.logger |
| 需删除 | 2 个 | framework/core/base_api.py + framework/core/logger.py |
需新增到 APIClient |
2 个方法 | get_common_headers() + request() 兼容层 |
2.3 额外发现的缺失 Config 属性
| 属性 | 引用处 | 值 |
|---|---|---|
Config.CLOUD_AUTH_TOKEN |
billing.py |
os.getenv("CLOUD_AUTH_TOKEN", "") |
Config.AMAP_KEY |
meal_reminder.py × 2 |
os.getenv("AMAP_KEY", "") |
Config.AMAP_COORDINATES |
meal_reminder.py × 2 |
os.getenv("AMAP_COORDINATES", "") |
2.4 日志系统差异
| 维度 | framework/core/logger.py(21 行) |
tests/logger.py(129 行) |
|---|---|---|
| 函数签名 | get_logger(name) |
get_logger(name) — 相同 |
| 日志级别 | INFO | DEBUG |
| 控制台格式 | 标准格式 | 彩色 + 压缩多行 |
| 文件输出 | automation.log |
logs/api_YYYY-MM-DD.log(按日期分文件) |
| 上下文感知 | 无 | ContextVar 追踪当前测试名称 |
迁移策略:41 个文件 from framework.core.logger import get_logger → from tests.logger import get_logger,函数签名完全相同,无需改调用代码。
2.5 风险点
httpx和requests在重定向处理、超时语义上有细微差异get_common_headers()构建的 header 格式(sourceapp/x-request-id/referer)需保持一致- 5 个
BaseAPI子类需逐个验证request()返回值兼容
验证方式:Python 编译 + 5 个子类 import 不报错 + 856 个测试收集不受影响。
2.6 实施结果
分支:refactor/phase2-unified-api-client · 提交 6fc10ea
| 验证项 | 结果 |
|---|---|
| 全量 Python 编译 | ✅ 0 错误 |
| 856 测试收集 | ✅ 全量通过 |
| E2E 测试 | ✅ 不受影响 |
get_common_headers() 兼容性 |
✅ 输出与旧 BaseAPI 完全一致 |
request() 兼容层 |
✅ 返回 dict,行为一致 |
| 新增 Config 属性 | ✅ CLOUD_AUTH_TOKEN/AMAP_KEY/AMAP_COORDINATES |
变更统计:48 个文件变更(+101/-134),删除 2 个旧文件,净减少 33 行。
阶段 3:BasePage 合并(2 天)🔴 高风险 ✅ 已完成
分支:refactor/phase3-unified-basepage · 提交 0abf0a2
实施内容:
framework/core/base_page.py的smart_find/visible_dialog/goto_route提取为SmartLocatorMixinsmart_click/smart_click_any/smart_fill/smart_select/smart_delete/click_row_action提取为SmartInteractionMixin- 统一
BasePage继承 12 个 Mixin(原有 10 个 + 新增 2 个) - 9 个
framework/business/*_page.py改为继承tests.base.base_page.BasePage - 删除
framework/core/base_page.py
验证结果:
| 验证项 | 结果 |
|---|---|
| 全量项目源文件编译 | ✅ 0 错误 |
| 856 测试收集 | ✅ 全量通过 |
| 12 个 Mixin 方法名零冲突 | ✅ |
| 原有 10 个 Mixin 方法未受影响 | ✅ |
| E2E 测试 | ✅ 不受影响 |
D-Cloud 侧:856 测试编译通过即安全,Mixin 只新增方法,不修改任何已有方法。
Robogo 侧需关注的 4 个点:
| 风险点 | 原因 | 验证方式 |
|---|---|---|
smart_find 策略优先级 |
合并后 self.find() 可能调用 D-Cloud LocatorMixin.find() 而非 smart_find |
逐个场景跑,确认所有按钮/元素能找到 |
smart_click JS 暴力兜底 |
扫描 button, a, span, .p-button-label 等 PrimeVue 选择器 |
确认点击行为正常 |
smart_fill 邻近探测 |
查找 .p-inputgroup, .field, .flex 等 PrimeVue class |
确认表单填写能正确定位输入框 |
goto_route/visible_dialog |
9 个页面对象依赖 self.page 引用 |
确认导航跳转和弹窗操作正常 |
状态:代码已完成,待 Robogo 真机环境跑 14 个场景验证。
阶段 4:场景去重 + Robogo 接入 pytest(1 天)🟢 低风险 ✅ 已完成
分支:refactor/phase4-platform-unification · 提交 9ba4b25
目标:删除重复的场景文件,统一入口,Robogo 场景接入 pytest 收集。
实施内容:
- 删除
scenarios/(14 个文件,与framework/scripts/逐字重复) - 新建
framework/scripts/run_all.py(修复DataManagementRunner悬挂引用) - 新建
framework/scripts/run_data_loop.py(数据闭环入口) - 更新
backend/app.pyPRODUCTS 入口指向framework/scripts/ - 新建
tests/robogo/test_scenarios.py(11 个场景参数化 pytest 收集) - 新增
pytest.inimarkerrobogo
验证结果:
| 验证项 | 结果 |
|---|---|
| 全量项目源文件编译 | ✅ 0 错误 |
| 测试收集 | ✅ 867 个(856 D-Cloud + 11 Robogo) |
| Robogo 场景中文名称 | ✅ 全部显示 |
| 后端入口文件 | ✅ 存在且可编译 |
| E2E 测试 | ✅ 不受影响 |
平台层面统一效果:pytest tests/ --collect-only 首次统计全部 867 个测试,前端仪表盘可显示完整测试规模。
4. 风险分析
为什么不能保证 0 异常
| 硬伤 | 影响 |
|---|---|
| 856 个用例测的是 D-Cloud 平台本身,不是测框架代码 | BasePage/Mixin/smart_* 改了之后,没有单元测试告诉你是改对了还是改坏了 |
smart_* 是运行时 DOM 暴力匹配,非编译时逻辑 |
合并后一个选择器顺序调换,可能在 PrimeVue 页面上引入隐性 bug |
| 没有 CI | 跑一次全量验证需要手动操作,14 个场景逐个执行 |
各阶段风险评级
| 阶段 | 风险 | 原因 |
|---|---|---|
| 阶段 1:配置统一 | 🟢 低 | 改 import 路径,Python 编译通过即可验证 |
| 阶段 2:API 客户端 + 日志 | 🟡 中 | httpx 和 requests 行为有细微差异,需验证 header 构建 |
| 阶段 3:BasePage 合并 | 🔴 高 | 必须逐场景回跑,没有框架级测试兜底 |
| 阶段 4:场景去重 | 🟢 低 | 纯删除重复文件,入口路径校验即可 |
5. 实际能做到的保障
| 保障手段 | 覆盖范围 |
|---|---|
| 构造一个 D-Cloud 模块的 pytest 全量运行 | 覆盖 ToB 侧 856 条 |
逐个跑 scenarios/ 下 14 个脚本 |
覆盖 ToC 侧全场景 |
| 阶段 1 验证:Python 编译 + import 不报错 | 配置和 API 客户端 |
| 阶段 3 验证:14 个场景逐个回跑 | 页面交互逻辑 |
6. 最终状态
已完成:5/6 条断裂线
| 断裂线 | 分支 | 状态 |
|---|---|---|
| 配置系统 | dev |
✅ |
| API 客户端 | dev |
✅ |
| 日志系统 | dev |
✅ |
| BasePage | dev |
✅ 已验证(11/14 场景通过) |
| 场景去重 + pytest 收集 | dev |
✅ 867 测试 |
未完成:1 条 + 3 个硬约束
| 项目 | 原因 |
|---|---|
| 认证流程 ⬜ | D-Cloud SSO ≠ Robogo 本地登录 |
| 被测前端 | Ant Design ≠ PrimeVue |
| 测试运行器 | pytest + marker ≠ 脚本编排器 |
| 被测 URL | cloud-fat.d-robotics.cc ≠ robogo.d-robotics.cc |
结论
代码层面已实现二合一。 两个项目共享了基础设施代码(配置、API、日志、BasePage),pytest --collect-only 首次统计全部 867 个测试。但真机测试时跑的是不同的被测平台,永远不会测同一个东西。
7. 收益对比
| 维度 | 重构前 | 重构后 |
|---|---|---|
| 配置入口 | 2 个文件,字段名不一致 | 1 个文件,统一命名 |
| API 客户端 | 2 个(httpx + requests) | 1 个(httpx) |
| 日志系统 | 2 套 | 1 套 |
| BasePage | 2 个类(86 行 + 312 行) | 1 个组合类 + 12 Mixin |
| 死代码 | B 套后端(3 个文件) | 已删除 |
| 重复文件 | 3 组 | 已删除 |
| 新成员上手 | 需要理解两套体系 | 大幅简化 |
评估日期:2026-06-26 · 更新日期:2026-06-27 · 基于 docs/TBC_分析报告_0626.html 和仓库逐文件代码审读