feat: 基于 UI 自动化最佳实践的测试框架骨架搭建

- tests/config: 环境配置 (.yaml) + 配置加载器 - tests/utils: 日志工具 + 测试数据生成器 - tests/web: Playwright conftest + Page Object 基类 + 登录页 + 导航栏组件 + 登录用例(6条) - tests/app: Appium conftest + Page Object 基类 + 司机端首页 + 登录用例(3条) - pytest.ini: markers(p0/p1/p2/smoke/web/app) + 运行配置 - 所有用例按最佳实践采用 Page Object 模式 + data-testid 优先定位 + 失败自动截图
2026-07-15 10:24:22 +08:00
parent 26ef99f7e7
commit aade9e39d0
17 changed files with 1034 additions and 0 deletions
@@ -0,0 +1,42 @@
+"""配置加载器。
+
+从 tests/config/test_config.yaml 读取配置，提供类型安全的访问接口。
+
+Usage:
+    from tests.config.test_config import load_config
+
+    config = load_config()
+    web_url = config["web"]["base_url"]
+    admin_phone = config["accounts"]["super_admin"]["phone"]
+"""
+
+from pathlib import Path
+from typing import Any, Dict
+
+import yaml
+
+_CONFIG_PATH = Path(__file__).parent / "test_config.yaml"
+_cache: Dict[str, Any] | None = None
+
+
+def load_config(force_reload: bool = False) -> Dict[str, Any]:
+    """加载测试配置（带缓存，force_reload=True 可强制重载）。"""
+    global _cache
+    if _cache is not None and not force_reload:
+        return _cache
+
+    if not _CONFIG_PATH.exists():
+        raise FileNotFoundError(f"配置文件不存在: {_CONFIG_PATH}")
+
+    with open(_CONFIG_PATH, encoding="utf-8") as f:
+        _cache = yaml.safe_load(f)
+
+    return _cache
+
+
+def get_config_section(section: str) -> Dict[str, Any]:
+    """获取配置中指定 section 的字典。"""
+    config = load_config()
+    if section not in config:
+        raise KeyError(f"配置中不存在 section '{section}'，可用: {list(config.keys())}")
+    return config[section]
@@ -0,0 +1,63 @@
+# 运八网络货运平台 — 测试环境配置
+# 数据来源: knowledge_base/00_project/project_profile.md
+# 使用方式: from config.test_config import load_config
+
+# ── Web 管理端 ──
+web:
+  base_url: "https://ybxcx.ynyun8.com:8000/admin"
+  api_base_url: "https://ybxcx.ynyun8.com:8000/"
+  timeout_seconds: 120
+  screenshot_on_failure: true
+  screenshot_on_step: false
+  browsers:
+    - chromium
+    - firefox
+  # WebKit 默认关闭（Windows 下问题较多），CI 环境可开启
+  viewport:
+    width: 1920
+    height: 1080
+
+# ── App 移动端 ──
+app:
+  appium_host: "http://localhost:4723"
+  timeout_seconds: 120
+  screenshot_on_failure: true
+  platforms:
+    - android
+    # - ios  # iOS 仅在 macOS CI 环境下开启
+
+  android:
+    device_name: "Android Emulator"
+    app_package: "com.yunba.driver"         # ⚠️ 请确认实际包名
+    app_activity: ".MainActivity"            # ⚠️ 请确认实际启动 Activity
+    no_reset: true
+    new_command_timeout: 120
+
+  ios:
+    device_name: "iPhone 15"
+    bundle_id: "com.yunba.driver"           # ⚠️ 请确认实际 Bundle ID
+    no_reset: true
+    new_command_timeout: 120
+
+# ── 测试账号 ──
+accounts:
+  super_admin:
+    phone: "super_admin"
+    password: "951260684NiAn.."             # ⚠️ 若密码变更请同步修改
+    role: "平台运营人员"
+
+  team_leader:
+    phone: "13113113113"
+    password: "88888888"
+    role: "车队长"
+
+  driver:
+    phone: "15188888888"
+    password: "88888888"
+    role: "司机"
+
+# ── 报告 ──
+report:
+  logs_dir: "output/logs"
+  screenshots_dir: "output/screenshots"
+  junit_xml: "output/reports/junit.xml"