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 优先定位 + 失败自动截图

tests/utils/data_helper.py

@@ -0,0 +1,41 @@
+"""测试数据生成与清理辅助工具。
+
+提供常用方法：生成唯一标识、构建测试数据字典、API 层面清理数据。
+
+Usage:
+    from tests.utils.data_helper import generate_order_no, generate_phone
+
+    order_no = generate_order_no()
+    phone = generate_phone()
+"""
+
+import random
+import string
+from datetime import datetime
+
+
+def generate_order_no(prefix: str = "TEST") -> str:
+    """生成唯一订单号。"""
+    ts = datetime.now().strftime("%Y%m%d%H%M%S")
+    rand = "".join(random.choices(string.digits, k=4))
+    return f"{prefix}{ts}{rand}"
+
+
+def generate_phone() -> str:
+    """生成合法格式的测试手机号（138 开头）。"""
+    suffix = "".join(random.choices(string.digits, k=8))
+    return f"138{suffix}"
+
+
+def generate_shipment_no(prefix: str = "YB") -> str:
+    """生成运单号（格式: YB + 日期 + 随机数）。"""
+    ts = datetime.now().strftime("%Y%m%d")
+    rand = "".join(random.choices(string.digits, k=6))
+    return f"{prefix}{ts}{rand}"
+
+
+def generate_unique_id(prefix: str = "id") -> str:
+    """生成通用唯一 ID。"""
+    ts = datetime.now().strftime("%Y%m%d%H%M%S%f")
+    rand = "".join(random.choices(string.ascii_lowercase + string.digits, k=4))
+    return f"{prefix}_{ts}_{rand}"

tests/utils/logger.py

@@ -0,0 +1,47 @@
+"""统一日志工具。
+
+Usage:
+    from tests.utils.logger import get_logger
+
+    logger = get_logger(__name__)
+    logger.info("开始执行用例")
+    logger.error(f"用例失败: {e}")
+"""
+
+import logging
+import sys
+from datetime import datetime
+from pathlib import Path
+
+# 日志目录
+LOGS_DIR = Path("output/logs")
+LOGS_DIR.mkdir(parents=True, exist_ok=True)
+
+# 日志格式
+_FORMAT = "%(asctime)s [%(levelname)s] %(name)s — %(message)s"
+_DATE_FMT = "%Y-%m-%d %H:%M:%S"
+
+# 根 logger 配置（模块级，只初始化一次）
+_ROOT_LOGGER = logging.getLogger("tests")
+_ROOT_LOGGER.setLevel(logging.DEBUG)
+
+# 控制台 Handler
+_console_handler = logging.StreamHandler(sys.stdout)
+_console_handler.setLevel(logging.INFO)
+_console_handler.setFormatter(logging.Formatter(_FORMAT, datefmt=_DATE_FMT))
+
+# 文件 Handler（每次运行一个日志文件）
+_log_file = LOGS_DIR / f"test_run_{datetime.now().strftime('%Y%m%d_%H%M%S')}.log"
+_file_handler = logging.FileHandler(_log_file, encoding="utf-8")
+_file_handler.setLevel(logging.DEBUG)
+_file_handler.setFormatter(logging.Formatter(_FORMAT, datefmt=_DATE_FMT))
+
+_ROOT_LOGGER.addHandler(_console_handler)
+_ROOT_LOGGER.addHandler(_file_handler)
+
+
+def get_logger(name: str) -> logging.Logger:
+    """获取以 `tests.` 为前缀的子 logger。"""
+    if not name.startswith("tests."):
+        name = f"tests.{name}"
+    return logging.getLogger(name)