-
架构图
本框架采用分层架构，各层职责明确，共同构成坚实可靠的测试体系：
- 基础支撑层：以 Playwrightt、SSH、Redis 等第三方依赖为基础，提供核心执行引擎与外部系统交互能力。
- 核心框架层：提供统一的配置、数据、日志、报告管理模块，支持UI/API自动化测试以及测试中需要用到的中间件和数据库交互等功能
- 通用业务层：封装UI操作、API调用、数据库访问等技术维度的可复用模块，实现测试用例快速调用业务模块以完成自动化测试。
- 场景应用层：基于通用模块，组合构建端到端业务流程测试，并集成至 DevOps/Jenkins 流水线，服务于集成测试、回归测试等具体质量目标。
-
核心框架功能清单
-
自动化测试模块
| # | 模块 | 子模块 | 功能说明 | 指南 |
| 1 | UI自动化模块 | playwright | 模拟用户操作，实现Web界面的功能与交互测试。 当前实现：基于 Playwright，封装元素定位、点击、输入、拖拽等操作为页面对象模型。 业务层封装：在原子操作上，封装如 login_agent_ui (坐席登录)、change_state(修改坐席状态) 等业务流方法。 |
Playwright |
| 2 | API自动化模块 | api | 对系统提供的HTTP/HTTPS等接口进行功能集成 当前实现：基于 Requests，封装发送HTTP请求、处理响应、管理Session/Token。 通用方法：核心方法 send_request 业务封装：按系统模块封装，如 admin_api.create_tenant (创建租户)、XXX_api.submit_application (提交申请)。 在探索：计划集成 Swagger UI/OpenAPI 规范，实现接口文档同步、用例自动生成。 |
API |
| 3 | 数据库交互 | dameng | 针对达梦数据库进行业务数据验证、测试数据准备与清理 驱动：使用 dmPython 官方驱动。 连接管理：封装连接串配置，支持自动重连。关键操作：执行SQL查询、数据插入/更新/删除、存储过程调用、事务管理（提交/回滚）。 适配要点：注意达梦特有语法（如序列、模式）与常用函数的兼容性处理。 |
待补充 |
| mysql | 对MySQL数据库进行数据完整性校验和测试数据管理。 驱动：使用 PyMySQL 关键操作：通用的CRUD操作、事务控制、批量数据操作。 数据断言：将查询结果转换为字典或对象，方便与API/UI返回数据进行比对。 |
待补充 | ||
| PostgreSQL | 驱动：使用 psycopg2 关键操作：标准SQL执行、连接管理、支持扩展的游标操作。 |
待补充 | ||
| 4 | 中间件交互 | Redis | 验证缓存数据的正确性，测试缓存读写。 |
待补充 |
| kafka | kafka | |||
| 5 | 终端交互模块 | ssh | 核心功能：通过SSH执行命令、上传/下载文件、管理进程。 封装内容：将常用shell指令（如服务重启、日志拉取）封装为可复用的测试方法。 |
待补充 |
| cmd | 核心功能：通过CMD执行命令执行本地命令、管理进程。 | 待补充 | ||
| 6 | 日志查询 | kibana | 核心功能: 是一个用于与 Kibana 服务进行交互的 Python 模块，提供了强大的日志查询和数据分析功能，支持 KQL 查询、时间范围过滤和结果解析。 | Kibana |
-
基础功能
| # | 模块 | 功能说明 | 指南 |
| 1 | 配置管理 | 环境配置信息在yml中统一管理， 支持多个环境入参,$获取配置文件的参数 | 配置文件使用指南 |
| 2 | 上下文值传递 | 提供跨步骤变量传递机制；支持多种数据类型（String, Map, List, JSON, XML, YAML, Table），@获取传递的值 | 上下文值传递 |
| 3 | 动态值生成 | 支持表达式生成动态值，如 %{uuid()}%、%{timestamp()}%、%{random_int(10,100)}% | 动态值生成 |
| 4 | 校验模块 | 提供通用断言：值匹配、JSONPath 校验、SQL 校验、表格比对等 | 数据校验模块 |
| 5 | 报告 | 输出统一格式报告，兼容 Allure 与 HTML 格式 | 待补充 |
| 6 | 日志管理 | 设计统一日志格式，文件/控制台 | 待补充 |
| 7 | 加密解密 | 敏感信息尤其是密码的加密解密逻辑 | 待补充 |
| 8 | Excel测试 | 支持多文件与多Sheet用例读取，兼容 TestCase 与 TestData 结构，管理测试数据组（DataGroup）、参数映射与数据覆盖逻辑。 目前推荐用于单接口测试编写 | Excel测试用例编写 执行器入口 |
-
业务模块功能清单
| # | 模块 | 子模块 | 功能说明 | 指南 |
| 1 | UI业务封装模块 | demo UI | 待补充 | |
| agentdesktop UI | 待补充 | |||
| 2 | API 业务封装 | |||