feat: 重构测试框架 — 覆盖 6 端 (管理端 + 小程序 + 4 个移动端)

目录结构:
  tests/web/admin/       管理端 (Playwright)
  tests/web/mini_program/ 司机端小程序 (Playwright/微信 WebView)
  tests/app/driver_android/  司机安卓 (Appium)
  tests/app/shipper_android/ 货主安卓 (Appium)
  tests/app/driver_ios/      司机苹果 (Appium)
  tests/app/shipper_ios/     货主苹果 (Appium)

公共模块:
  tests/app/_shared.py       driver+ensure_logged_in 工厂
  tests/app/_base_page.py    App Page Object 基类

配置:
  test_config.yaml 拆分为 6 个独立 section + 货主账号

tests/web/admin/pages/base_page.py

@@ -0,0 +1,76 @@
+"""Page Object 基类 — 封装所有页面共享的通用操作。
+
+每个具体页面应继承 BasePage，在 __init__ 中声明所有定位器。
+
+Usage:
+    class LoginPage(BasePage):
+        def __init__(self, page):
+            super().__init__(page)
+            self.phone_input = page.get_by_placeholder("请输入用户名")
+            self.login_btn = page.get_by_role("button", name="登录")
+"""
+
+from datetime import datetime
+from pathlib import Path
+from typing import Optional
+
+from playwright.sync_api import Page, Locator, expect
+
+SCREENSHOTS_DIR = Path("output/screenshots")
+
+
+class BasePage:
+    """Page Object 基类。"""
+
+    def __init__(self, page: Page, timeout_ms: int = 30_000):
+        self.page = page
+        self.timeout = timeout_ms
+
+    # ── 通用等待 ──
+
+    def wait_visible(self, locator: Locator, timeout_ms: Optional[int] = None) -> None:
+        """等待元素可见。"""
+        expect(locator).to_be_visible(timeout=timeout_ms or self.timeout)
+
+    def wait_hidden(self, locator: Locator, timeout_ms: Optional[int] = None) -> None:
+        """等待元素消失（如 Loading 遮罩）。"""
+        expect(locator).to_be_hidden(timeout=timeout_ms or self.timeout)
+
+    def wait_for_text(self, text: str, timeout_ms: Optional[int] = None) -> None:
+        """等待页面上出现指定文本。"""
+        expect(self.page.get_by_text(text)).to_be_visible(timeout=timeout_ms or self.timeout)
+
+    # ── 通用操作 ──
+
+    def fill_field(self, locator: Locator, value: str) -> None:
+        """安全填写输入框（先等待可见，再清空后填写）。"""
+        self.wait_visible(locator)
+        locator.clear()
+        locator.fill(value)
+
+    def click_when_ready(self, locator: Locator) -> None:
+        """安全点击（等待可见 + 可操作）。"""
+        self.wait_visible(locator)
+        locator.click()
+
+    def get_text(self, locator: Locator) -> str:
+        """获取元素的 inner text。"""
+        self.wait_visible(locator)
+        return locator.inner_text()
+
+    # ── 截图 ──
+
+    def screenshot(self, name: str, full_page: bool = False) -> str:
+        """关键节点截图，返回文件路径。"""
+        scenario_dir = SCREENSHOTS_DIR / self.__class__.__name__
+        scenario_dir.mkdir(parents=True, exist_ok=True)
+        ts = datetime.now().strftime("%Y%m%d_%H%M%S")
+        path = str(scenario_dir / f"{name}_{ts}.png")
+        self.page.screenshot(path=path, full_page=full_page)
+        return path
+
+    # ── 导航 ──
+
+    def navigate(self, url: str) -> None:
+        """导航到指定 URL 并等待页面加载完成。"""
+        self.page.goto(url, wait_until="domcontentloaded")

tests/web/admin/pages/components/navbar.py

@@ -0,0 +1,53 @@
+"""导航栏公共组件。
+
+跨页面复用的顶部/侧边导航操作。
+
+Usage:
+    from tests.web.admin.pages.components.navbar import NavBar
+
+    navbar = NavBar(page)
+    navbar.go_to("运输管理")
+"""
+
+from playwright.sync_api import Page, expect
+
+from tests.web.admin.pages.base_page import BasePage
+
+
+class NavBar(BasePage):
+    """侧边导航栏组件。"""
+
+    def __init__(self, page: Page):
+        super().__init__(page)
+        # ⚠️ 以下定位器需要根据实际 DOM 调整
+        self.sidebar = page.locator(".ant-layout-sider")
+        self.logout_btn = page.get_by_text("退出登录")
+
+    def go_to(self, menu_name: str) -> None:
+        """点击侧边栏菜单项展开/跳转。
+
+        Args:
+            menu_name: 菜单名称文本（如 "运输管理"、"基础信息"）
+        """
+        menu_item = self.page.get_by_text(menu_name).first
+        self.click_when_ready(menu_item)
+
+    def go_to_submenu(self, parent_menu: str, sub_menu: str) -> None:
+        """点击父级菜单后，点击子菜单项。
+
+        Args:
+            parent_menu: 父级菜单文本（如 "整车运输"）
+            sub_menu: 子菜单文本（如 "运单管理"）
+        """
+        self.go_to(parent_menu)
+        sub_item = self.page.get_by_text(sub_menu).first
+        self.click_when_ready(sub_item)
+
+    def logout(self) -> None:
+        """退出登录。"""
+        self.click_when_ready(self.logout_btn)
+        expect(self.page).to_have_url("#/login", timeout=10_000)
+
+    def is_expanded(self) -> bool:
+        """检查侧边栏是否展开。"""
+        return self.sidebar.is_visible()

tests/web/admin/pages/login_page.py

@@ -0,0 +1,54 @@
+"""登录页面 — Page Object。
+
+Usage:
+    from tests.web.admin.pages.login_page import LoginPage
+
+    login_page = LoginPage(page)
+    login_page.login(phone="super_admin", password="951260684NiAn..")
+"""
+
+from playwright.sync_api import Page, expect
+
+from tests.web.admin.pages.base_page import BasePage
+
+
+class LoginPage(BasePage):
+    """运八管理端登录页。"""
+
+    def __init__(self, page: Page):
+        super().__init__(page)
+        # ── 定位器声明 ──
+        self.username_input = page.get_by_placeholder("请输入用户名")
+        self.password_input = page.get_by_placeholder("请输入密码")
+        self.login_btn = page.get_by_role("button", name="登录")
+        self.error_tip = page.locator(".ant-form-item-explain-error")
+
+    def login(self, phone: str, password: str, expect_success: bool = True) -> None:
+        """执行登录流程。
+
+        Args:
+            phone: 用户名/手机号
+            password: 密码
+            expect_success: True=预期成功跳转，False=预期留在登录页并有错误提示
+        """
+        self.fill_field(self.username_input, phone)
+        self.fill_field(self.password_input, password)
+        self.click_when_ready(self.login_btn)
+
+        if expect_success:
+            # 等待登录成功后页面跳转（hash 路由模式）
+            self.page.wait_for_timeout(3000)
+            assert "/#/login" not in self.page.url and "/login" not in self.page.url, \
+                "登录失败，仍在登录页"
+        else:
+            # 预期登录失败，停留在当前页
+            expect(self.page).to_have_url("**/login**", timeout=5_000)
+
+    def get_error_message(self) -> str:
+        """获取登录失败时的错误提示文本。"""
+        self.wait_visible(self.error_tip)
+        return self.error_tip.inner_text()
+
+    def is_on_login_page(self) -> bool:
+        """检查是否仍在登录页（兼容 hash 路由）。"""
+        return "/login" in self.page.url or "/#/login" in self.page.url