TBC/REFACTOR_EVALUATION.md

12 KiB
Raw Blame History

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 提取为 SmartLocatorMixin
  • smart_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.py PRODUCTS 入口指向 framework/scripts/
  • 新建 tests/robogo/test_scenarios.py(11 个场景参数化 pytest 收集)
  • 新增 pytest.ini marker robogo

验证结果:

验证项 结果
全量项目源文件编译 ✅ 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 和仓库逐文件代码审读