feat(cross_end): add cross-platform E2E test support for freight full flow
Add tests/cross_end/ directory with dual-driver architecture:
- conftest.py: Playwright admin_page + Appium app_driver fixtures
- Admin Page Objects: FreightSourcePage, WaybillManagementPage, SettlementPage
- App Page Objects: DriverOrderListPage, DriverTransportPage, DriverHomePage (re-export)
- test_freight_full_flow.py: 8-step end-to-end test (publish → accept → load → unload → accounting → review → shipper pay → platform pay)
- Shared context dict for cross-step data passing
- Graceful skip when either Playwright or Appium is unavailable
- All selectors marked with ⚠️ placeholders for discovery against real environments
Add cross_end marker to pytest.ini for selective execution.
This commit is contained in:
@@ -0,0 +1 @@
|
||||
# cross_end admin pages package
|
||||
@@ -0,0 +1,115 @@
|
||||
"""管理端 — 货源管理 — 发布货源 Page Object。
|
||||
|
||||
Usage:
|
||||
freight_page = FreightSourcePage(page)
|
||||
freight_page.fill_freight_form(...)
|
||||
freight_page.submit()
|
||||
order_no = freight_page.get_published_order_no()
|
||||
"""
|
||||
|
||||
from playwright.sync_api import Page
|
||||
|
||||
from tests.web.admin.pages.base_page import BasePage
|
||||
|
||||
|
||||
class FreightSourcePage(BasePage):
|
||||
"""管理端 - 货源管理 - 发布货源。"""
|
||||
|
||||
def __init__(self, page: Page):
|
||||
super().__init__(page)
|
||||
# ⚠️ 以下定位器需要根据实际 DOM 调整
|
||||
# 通过 Playwright Inspector 或浏览器 DevTools 获取真实选择器
|
||||
|
||||
# ── 货源表单字段 ──
|
||||
self.goods_name_input = page.get_by_placeholder("请输入货物名称") # ⚠️
|
||||
self.weight_input = page.get_by_placeholder("请输入重量") # ⚠️
|
||||
self.load_address_input = page.get_by_placeholder("请选择装货地") # ⚠️
|
||||
self.unload_address_input = page.get_by_placeholder("请选择卸货地") # ⚠️
|
||||
self.price_input = page.get_by_placeholder("请输入运费") # ⚠️
|
||||
|
||||
# ── 操作按钮 ──
|
||||
self.submit_btn = page.get_by_role("button", name="发布") # ⚠️
|
||||
self.confirm_btn = page.get_by_role("button", name="确认") # ⚠️
|
||||
|
||||
# ── 结果元素 ──
|
||||
self.success_toast = page.locator(".el-message--success") # ⚠️
|
||||
self.order_no_text = page.locator(".order-no, .freight-no") # ⚠️ 发布成功后显示订单号的位置
|
||||
|
||||
def fill_freight_form(
|
||||
self,
|
||||
goods_name: str,
|
||||
weight: float,
|
||||
load_addr: str,
|
||||
unload_addr: str,
|
||||
) -> None:
|
||||
"""填写货源发布表单。
|
||||
|
||||
Args:
|
||||
goods_name: 货物名称
|
||||
weight: 货物重量 (吨)
|
||||
load_addr: 装货地址
|
||||
unload_addr: 卸货地址
|
||||
"""
|
||||
# ⚠️ 具体字段依赖实际表单结构,以下为通用模式
|
||||
self.fill_field(self.goods_name_input, goods_name)
|
||||
self.fill_field(self.weight_input, str(weight))
|
||||
self.fill_field(self.load_address_input, load_addr)
|
||||
self.fill_field(self.unload_address_input, unload_addr)
|
||||
# 如有运费字段:
|
||||
# self.fill_field(self.price_input, "1000")
|
||||
|
||||
def submit(self) -> None:
|
||||
"""点击发布按钮。"""
|
||||
self.click_when_ready(self.submit_btn)
|
||||
self.page.wait_for_timeout(1000)
|
||||
|
||||
def confirm_publish(self) -> None:
|
||||
"""确认发布弹窗(如果有二次确认)。"""
|
||||
# ⚠️ 如果发布时有确认弹窗
|
||||
try:
|
||||
self.click_when_ready(self.confirm_btn)
|
||||
self.page.wait_for_timeout(500)
|
||||
except Exception:
|
||||
pass # 无确认弹窗则跳过
|
||||
|
||||
def get_published_order_no(self) -> str:
|
||||
"""发布成功后获取生成的订单号。
|
||||
|
||||
策略 (按优先级尝试):
|
||||
1. 从成功提示文本中提取
|
||||
2. 从跳转后的详情页 URL 中提取
|
||||
3. 从列表页第一条提取
|
||||
|
||||
Returns:
|
||||
订单号字符串
|
||||
|
||||
Raises:
|
||||
RuntimeError: 无法获取订单号
|
||||
"""
|
||||
# ⚠️ 策略取决于系统实际行为
|
||||
# 策略1: 等待成功 toast
|
||||
self.wait_visible(self.success_toast, timeout_ms=10_000)
|
||||
toast_text = self.success_toast.inner_text()
|
||||
self.page.wait_for_timeout(500)
|
||||
|
||||
# 策略2: 从当前页面提取订单号文本
|
||||
if self.order_no_text.is_visible():
|
||||
return self.order_no_text.inner_text().strip()
|
||||
|
||||
# 策略3: 从 URL 提取
|
||||
import re
|
||||
match = re.search(r"orderNo=(\w+)", self.page.url)
|
||||
if match:
|
||||
return match.group(1)
|
||||
|
||||
# 策略4: 从成功 toast 文本中提取数字编号
|
||||
match = re.search(r"[A-Z]{2,6}\d{10,20}", toast_text)
|
||||
if match:
|
||||
return match.group(0)
|
||||
|
||||
raise RuntimeError(
|
||||
f"无法获取发布的订单号。\n"
|
||||
f"当前 URL: {self.page.url}\n"
|
||||
f"Toast 文本: {toast_text}\n"
|
||||
f"请更新 get_published_order_no() 中的选择器。"
|
||||
)
|
||||
@@ -0,0 +1,88 @@
|
||||
"""管理端 — 承运结算 — 打款 Page Object。
|
||||
|
||||
覆盖步骤:
|
||||
7. 货主打款 (do_shipper_payment)
|
||||
8. 平台打款给司机 (do_platform_payment)
|
||||
|
||||
Usage:
|
||||
settlement_page = SettlementPage(page)
|
||||
settlement_page.do_shipper_payment(order_no)
|
||||
settlement_page.do_platform_payment(order_no)
|
||||
"""
|
||||
|
||||
from playwright.sync_api import Page
|
||||
|
||||
from tests.web.admin.pages.base_page import BasePage
|
||||
|
||||
|
||||
class SettlementPage(BasePage):
|
||||
"""管理端 - 承运结算 - 打款管理。"""
|
||||
|
||||
def __init__(self, page: Page):
|
||||
super().__init__(page)
|
||||
# ⚠️ 以下定位器需要根据实际 DOM 调整
|
||||
|
||||
# ── 搜索区 ──
|
||||
self.search_order_input = page.get_by_placeholder("请输入订单号") # ⚠️
|
||||
self.search_btn = page.get_by_role("button", name="查询") # ⚠️
|
||||
|
||||
# ── 操作按钮 ──
|
||||
self.shipper_pay_btn = page.get_by_role("button", name="货主打款") # ⚠️
|
||||
self.platform_pay_btn = page.get_by_role("button", name="平台打款") # ⚠️ 或"财务打款"
|
||||
self.confirm_btn = page.get_by_role("button", name="确定") # ⚠️ 确认打款弹窗
|
||||
|
||||
# ── 结果元素 ──
|
||||
self.success_toast = page.locator(".el-message--success") # ⚠️
|
||||
self.status_text = page.locator(".settlement-status") # ⚠️ 结算状态文本
|
||||
|
||||
def search_order(self, order_no: str) -> None:
|
||||
"""搜索运单。"""
|
||||
self.fill_field(self.search_order_input, order_no)
|
||||
self.click_when_ready(self.search_btn)
|
||||
self.page.wait_for_timeout(1000)
|
||||
|
||||
def do_shipper_payment(self, order_no: str) -> None:
|
||||
"""货主打款流程: 搜索 → 货主打款 → 确认。
|
||||
|
||||
Args:
|
||||
order_no: 订单号
|
||||
"""
|
||||
self.search_order(order_no)
|
||||
self.page.wait_for_timeout(500)
|
||||
|
||||
self.click_when_ready(self.shipper_pay_btn)
|
||||
self.page.wait_for_timeout(500)
|
||||
|
||||
# 确认打款弹窗
|
||||
self._confirm_if_present()
|
||||
|
||||
# 等待成功提示
|
||||
self.wait_visible(self.success_toast, timeout_ms=10_000)
|
||||
|
||||
def do_platform_payment(self, order_no: str) -> None:
|
||||
"""平台打款给司机流程: 搜索 → 平台打款 → 确认。
|
||||
|
||||
Args:
|
||||
order_no: 订单号
|
||||
"""
|
||||
self.search_order(order_no)
|
||||
self.page.wait_for_timeout(500)
|
||||
|
||||
self.click_when_ready(self.platform_pay_btn)
|
||||
self.page.wait_for_timeout(500)
|
||||
|
||||
# 确认打款弹窗
|
||||
self._confirm_if_present()
|
||||
|
||||
# 等待成功提示
|
||||
self.wait_visible(self.success_toast, timeout_ms=10_000)
|
||||
|
||||
def _confirm_if_present(self) -> None:
|
||||
"""如果有确认弹窗则点击确定。"""
|
||||
# ⚠️ 确认按钮可能以不同形式存在
|
||||
try:
|
||||
if self.confirm_btn.is_visible():
|
||||
self.click_when_ready(self.confirm_btn)
|
||||
self.page.wait_for_timeout(500)
|
||||
except Exception:
|
||||
pass
|
||||
@@ -0,0 +1,98 @@
|
||||
"""管理端 — 运输管理 — 运单核算 Page Object。
|
||||
|
||||
覆盖步骤:
|
||||
5. 核算运单 (do_accounting)
|
||||
6. 核算审核 (do_review)
|
||||
|
||||
Usage:
|
||||
waybill_page = WaybillManagementPage(page)
|
||||
waybill_page.do_accounting(order_no)
|
||||
waybill_page.do_review(order_no)
|
||||
"""
|
||||
|
||||
from playwright.sync_api import Page
|
||||
|
||||
from tests.web.admin.pages.base_page import BasePage
|
||||
|
||||
|
||||
class WaybillManagementPage(BasePage):
|
||||
"""管理端 - 运输管理 - 运单管理/核算。"""
|
||||
|
||||
def __init__(self, page: Page):
|
||||
super().__init__(page)
|
||||
# ⚠️ 以下定位器需要根据实际 DOM 调整
|
||||
|
||||
# ── 搜索区 ──
|
||||
self.search_order_input = page.get_by_placeholder("请输入订单号") # ⚠️
|
||||
self.search_btn = page.get_by_role("button", name="查询") # ⚠️
|
||||
|
||||
# ── 操作按钮 ──
|
||||
self.accounting_btn = page.get_by_role("button", name="核算") # ⚠️ 核算运单
|
||||
self.review_btn = page.get_by_role("button", name="审核") # ⚠️ 核算审核
|
||||
self.confirm_btn = page.get_by_role("button", name="确定") # ⚠️ 确认弹窗
|
||||
|
||||
# ── 结果元素 ──
|
||||
self.success_toast = page.locator(".el-message--success") # ⚠️
|
||||
self.table_first_row = page.locator(".el-table__body tr:first-child") # ⚠️ 列表第一行
|
||||
|
||||
def search_order(self, order_no: str) -> None:
|
||||
"""搜索运单。"""
|
||||
self.fill_field(self.search_order_input, order_no)
|
||||
self.click_when_ready(self.search_btn)
|
||||
self.page.wait_for_timeout(1000)
|
||||
|
||||
def click_accounting(self) -> None:
|
||||
"""点击核算按钮。"""
|
||||
self.click_when_ready(self.accounting_btn)
|
||||
self.page.wait_for_timeout(500)
|
||||
|
||||
def click_review(self) -> None:
|
||||
"""点击审核按钮(核算审核)。"""
|
||||
self.click_when_ready(self.review_btn)
|
||||
self.page.wait_for_timeout(500)
|
||||
|
||||
def confirm_action(self) -> None:
|
||||
"""确认操作弹窗。"""
|
||||
# ⚠️ 可能没有确认弹窗,try 一下
|
||||
try:
|
||||
if self.confirm_btn.is_visible():
|
||||
self.click_when_ready(self.confirm_btn)
|
||||
self.page.wait_for_timeout(500)
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
def do_accounting(self, order_no: str) -> None:
|
||||
"""完整的核算运单流程: 搜索 → 核算 → 确认。
|
||||
|
||||
Args:
|
||||
order_no: 订单号
|
||||
"""
|
||||
self.search_order(order_no)
|
||||
self.page.wait_for_timeout(500)
|
||||
self.click_accounting()
|
||||
self.confirm_action()
|
||||
|
||||
# 等待核算完成
|
||||
self.has_success_toast()
|
||||
|
||||
def do_review(self, order_no: str) -> None:
|
||||
"""完整的核算审核流程: 搜索 → 审核 → 确认。
|
||||
|
||||
Args:
|
||||
order_no: 订单号
|
||||
"""
|
||||
self.search_order(order_no)
|
||||
self.page.wait_for_timeout(500)
|
||||
self.click_review()
|
||||
self.confirm_action()
|
||||
|
||||
# 等待审核完成
|
||||
self.has_success_toast()
|
||||
|
||||
def has_success_toast(self) -> bool:
|
||||
"""检查操作是否成功(有成功 toast)。"""
|
||||
try:
|
||||
self.wait_visible(self.success_toast, timeout_ms=5_000)
|
||||
return True
|
||||
except Exception:
|
||||
return False
|
||||
Reference in New Issue
Block a user