python-qdairlines-helper 0.0.6__py3-none-any.whl

qdairlines_helper/controller/add_passenger.py

@@ -0,0 +1,92 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     add_passenger.py
+# Description:  添加乘客控制器
+# Author:       ASUS
+# CreateDate:   2026/01/04
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from typing import List, Dict, Any
+from playwright.async_api import Page
+from qdairlines_helper.utils.log_utils import logger
+import qdairlines_helper.config.url_const as url_const
+from qdairlines_helper.po.add_passenger_page import AddPassengerPage
+from qdairlines_helper.utils.po_utils import get_ip_access_blocked_msg
+
+
+async def load_add_passenger_po(
+        *, page: Page, protocol: str, domain: str, timeout: float = 60.0
+) -> AddPassengerPage:
+    url_prefix = f"{protocol}://{domain}"
+    add_passenger_url = url_prefix + url_const.add_passenger_url
+    add_passenger_po = AddPassengerPage(page=page, url=add_passenger_url)
+    await add_passenger_po.url_wait_for(url=add_passenger_url, timeout=timeout)
+    logger.info(f"即将进入青岛航空官网添加乘客页面，页面URL<{add_passenger_url}>")
+    ip_access_blocked_msg = await get_ip_access_blocked_msg(page=page, timeout=3)
+    if ip_access_blocked_msg:
+        raise EnvironmentError(ip_access_blocked_msg)
+    return add_passenger_po
+
+
+async def add_passenger(
+        *, page: AddPassengerPage, passengers: List[Dict[str, Any]], service_mobile: str, timeout: float = 60.0
+) -> None:
+    # 遍历方式添加乘客
+    for index, passenger in enumerate(passengers):
+        p_type = passenger.get("p_type")
+        if index != 0:
+            # 1. 点击【添加成人|添加儿童|添加婴儿】按钮
+            add_adult_btn = await page.get_add_passenger_btn(passenger_type=p_type, timeout=timeout)
+            await add_adult_btn.click(button="left")
+            logger.info(f"添加乘客页面，【添加{p_type}】按钮点击完成")
+        # 2. 获取 乘机人信息plane
+        passenger_info_plane = await page.get_add_passenger_plane(timeout=timeout, position_index=index)
+        logger.info(f"添加乘客页面，第<{index + 1}>乘机人信息---plane获取完成")
+
+        # 3. 选择旅客类型
+        adult_checkbox = await page.get_passenger_type_checkbox(
+            passenger_type=p_type, timeout=timeout, position_index=index
+        )
+        await adult_checkbox.click(button="left")
+        logger.info(f"添加乘客页面，第<{index + 1}>乘机人信息---旅客类型【{p_type}】单选框点击完成")
+
+        # 4. 输入姓名
+        p_name = passenger.get("p_name")
+        username_input = await page.get_passenger_username_input(locator=passenger_info_plane, timeout=timeout)
+        await username_input.fill(value=p_name)
+        logger.info(f"添加乘客页面，第<{index + 1}>乘机人信息---姓名<{p_name}>输入完成")
+
+        # 5. 选择性别
+        gender = passenger.get("gender")
+        gender_checkbox = await page.get_gender_checkbox(locator=passenger_info_plane, gender=gender, timeout=timeout)
+        await gender_checkbox.click(button="left")
+        logger.info(f"添加乘客页面，第<{index + 1}>乘机人信息---性别【{gender}】单选框点击完成")
+
+        # 6. 选择证件类型 TODO 暂时只支持身份证类型，待后续完善
+        id_type = passenger.get("id_type")
+        if id_type != "身份证":
+            raise EnvironmentError(f"乘客证件类型<{id_type}>暂不支持")
+
+        # 7. 输入证件号码
+        id_no = passenger.get("id_no")
+        id_no_input = await page.get_id_no_input(locator=passenger_info_plane, timeout=timeout)
+        await id_no_input.fill(value=id_no)
+        logger.info(f"添加乘客页面，第<{index + 1}>乘机人信息---证件号码<{id_no}>输入完成")
+
+    # 8. 输入联系人电话
+    service_mobile_input = await page.get_service_mobile_input(timeout=timeout)
+    await service_mobile_input.fill(value=service_mobile)
+    logger.info(f"添加乘客页面，联系人信息---手机号码<{service_mobile}>输入完成")
+
+    # 9. 勾选同意单选框
+    agree_checkbox = await page.get_agree_checkbox(timeout=timeout)
+    await agree_checkbox.click(button="left")
+    logger.info(f"添加乘客页面，购票须知---【已阅读并同意】单选框点击完成")
+
+    # 10. 点击【下一步】
+    next_btn = await page.get_next_btn(timeout=timeout)
+    await next_btn.click(button="left")
+    logger.info(f"添加乘客页面，【下一步】按钮点击完成，<{len(passengers)}>名乘客信息添加成功")

qdairlines_helper/controller/book_payment.py

@@ -0,0 +1,83 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     book_payment.py
+# Description:  预订支付控制器
+# Author:       ASUS
+# CreateDate:   2026/01/04
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from playwright.async_api import Page
+from qdairlines_helper.utils.log_utils import logger
+from typing import Dict, Any, List, Optional, Callable
+from qdairlines_helper.controller.book_search import open_book_search_page, book_search
+from qdairlines_helper.controller.order_verify import load_order_verify_po, order_verify
+from qdairlines_helper.controller.add_passenger import add_passenger, load_add_passenger_po
+from qdairlines_helper.controller.cash_pax_info import load_cash_pax_info_po, select_payment_type
+from qdairlines_helper.controller.nhlms_cashdesk import load_nhlms_cash_desk_po, pay_account_payment
+
+
+async def book_payment_callback(
+        *, page: Page, protocol: str, domain: str, dep_city: str, arr_city: str, dep_date: str, flight_no: str,
+        cabin: str, login_user: str, login_password: str, passengers: List[Dict[str, Any]], service_mobile: str,
+        price_std: float, order_id: int, is_pay_completed_callback: Callable, product_type: str = "经济舱",
+        payment_type: str = "汇付天下", sub_payment_type: str = "付款账户支付", operator_account: Optional[str] = None,
+        timeout: float = 60.0, pay_password: Optional[str] = None, refresh_attempt: int = 3,
+        price_increase_threshold: float = 20.0, price_reduction_threshold: float = 10.0, **kwargs: Any
+) -> Dict[str, Any]:
+    # 1. 打开预订搜索页面
+    book_search_page = await open_book_search_page(page=page, protocol=protocol, domain=domain, timeout=timeout)
+
+    # 2. 预订搜索
+    await book_search(
+        book_search_page=book_search_page, dep_city=dep_city, arr_city=arr_city, dep_date=dep_date, flight_no=flight_no,
+        cabin=cabin, passengers=len(passengers), product_type=product_type, price_std=price_std, timeout=timeout,
+        price_increase_threshold=price_increase_threshold, price_reduction_threshold=price_reduction_threshold,
+    )
+    logger.info(f"订单<{order_id}>，预订搜索结束")
+
+    # 3. 加载添加乘客页面对象
+    add_passenger_po = await load_add_passenger_po(page=page, protocol=protocol, domain=domain, timeout=timeout)
+
+    # 4. 添加乘客
+    await add_passenger(page=add_passenger_po, passengers=passengers, service_mobile=service_mobile, timeout=timeout)
+    logger.info(f"订单<{order_id}>，添加乘客结束")
+
+    # 5. 加载订单校验页面对象
+    order_verify_po = await load_order_verify_po(page=page, protocol=protocol, domain=domain, timeout=timeout)
+
+    # 6. 校验订单
+    await order_verify(page=order_verify_po, refresh_attempt=refresh_attempt, timeout=timeout)
+    logger.info(f"订单<{order_id}>，校验订单结束")
+
+    # 7. 加载支付类型页面对象
+    cash_pax_info_po = await load_cash_pax_info_po(page=page, protocol=protocol, domain=domain, timeout=timeout)
+
+    # 8. 选择支付方式
+    pre_order_no: str = await select_payment_type(page=cash_pax_info_po, payment_type=payment_type, timeout=timeout)
+    logger.info(f"订单<{order_id}>，选择支付方式结束")
+
+    # 9. 根据支付方式，加载不同的收银台页面对象
+    if payment_type == "汇付天下":
+        nhlms_cash_desk_po = await load_nhlms_cash_desk_po(context=kwargs.get("context"), timeout=timeout)
+
+        # 10. 汇付天下操作支付
+        if sub_payment_type == "付款账户支付":
+            # 10. 汇付天下操作支付
+            pay_transaction, actual_payment_amount = await pay_account_payment(
+                page=nhlms_cash_desk_po, operator_account=operator_account, pay_password=pay_password, timeout=timeout,
+                payment_type=sub_payment_type, is_pay_completed_callback=is_pay_completed_callback, order_id=order_id
+            )
+            logger.info(f"订单<{order_id}>，汇付天下操作支付结束")
+
+            return dict(
+                actual_payment_amount=actual_payment_amount, pre_order_no=pre_order_no, passengers=passengers,
+                channel_user_id=login_user, channel_user_password=login_password, order_id=order_id,
+                pay_transaction=pay_transaction
+            )
+        else:
+            raise EnvironmentError(f"汇付天下暂不支持<{sub_payment_type}>操作支付方式")
+    else:
+        raise EnvironmentError(f"暂不支持<{payment_type}>支付方式")

qdairlines_helper/controller/book_search.py

@@ -0,0 +1,114 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     book_search.py
+# Description:  航班搜索控制器
+# Author:       ASUS
+# CreateDate:   2026/01/04
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+import asyncio
+from typing import Dict, Any
+from playwright.async_api import Page, Locator
+from qdairlines_helper.utils.log_utils import logger
+import qdairlines_helper.config.url_const as url_const
+from qdairlines_helper.po.book_search_page import BookSearchPage
+from qdairlines_helper.utils.po_utils import get_ip_access_blocked_msg
+
+
+async def open_book_search_page(*, page: Page, protocol: str, domain: str, timeout: float = 60.0) -> BookSearchPage:
+    url_prefix = f"{protocol}://{domain}"
+    book_search_url = url_prefix + url_const.login_url
+    await page.goto(book_search_url)
+
+    book_search_po = BookSearchPage(page=page, url=book_search_url)
+    await book_search_po.url_wait_for(url=book_search_url, timeout=timeout)
+    logger.info(f"即将进入青岛航空官网航班预订查询页面，页面URL<{book_search_url}>")
+    ip_access_blocked_msg = await get_ip_access_blocked_msg(page=page, timeout=3)
+    if ip_access_blocked_msg:
+        raise EnvironmentError(ip_access_blocked_msg)
+    return book_search_po
+
+
+async def book_search(
+        *, book_search_page: BookSearchPage, dep_city: str, arr_city: str, dep_date: str, flight_no: str,
+        cabin: str, passengers: int, product_type: str = "经济舱", price_std: float, timeout: float = 60.0,
+        price_increase_threshold: float = 20.0, price_reduction_threshold: float = 10.0
+) -> None:
+    try:
+        # 1. 判断是否存在温馨提醒弹框
+        continue_book_btn = await book_search_page.get_reminder_dialog_continue_book_btn(timeout=timeout)
+        await continue_book_btn.click(button="left")
+        logger.info("航班预订查询页面，出现温馨提醒弹框，【继续购票】按钮点击完成")
+    except (Exception,):
+        pass
+
+    # 2.搜索栏输入起飞城市
+    depart_city_input = await book_search_page.get_depart_city_input(timeout=timeout)
+    await depart_city_input.fill(value=dep_city)
+    await asyncio.sleep(delay=1)
+    await depart_city_input.press("Enter")
+    logger.info(f"航班预订查询页面，搜索栏-起飞城市<{dep_city}>输入完成")
+
+    # 3.搜索栏输入抵达城市
+    arrive_city_input = await book_search_page.get_arrive_city_input(timeout=timeout)
+    await arrive_city_input.fill(value=arr_city)
+    await asyncio.sleep(delay=1)
+    await arrive_city_input.press("Enter")
+    logger.info(f"航班预订查询页面，搜索栏-抵达城市<{arr_city}>输入完成")
+
+    # 4.搜索栏输入起飞时间
+    depart_date_input = await book_search_page.get_depart_date_input(timeout=timeout)
+    await depart_date_input.fill(value=dep_date)
+    await asyncio.sleep(delay=1)
+    await depart_date_input.press("Enter")
+    logger.info(f"航班预订查询页面，搜索栏-起飞日期<{dep_date}>输入完成")
+
+    # 5.点击【查询机票】按钮
+    flight_query_btn = await book_search_page.get_flight_query_btn(timeout=timeout)
+    await flight_query_btn.click(button="left")
+    logger.info(f"航班预订查询页面，【查询机票】按钮点击完成")
+
+    # 6. 获取航班基本信息plane locator
+    flight_info_plane: Locator = await book_search_page.get_flight_info_plane(timeout=timeout)
+    page_flight_no: str = await book_search_page.get_flight_no(locator=flight_info_plane, timeout=timeout)
+    if flight_no not in page_flight_no:
+        raise RuntimeError(f"航班预订查询页面，没有搜索到航班<{flight_no}>数据")
+
+    # 7. 获取产品类型
+    flight_product_nav: Locator = await book_search_page.get_flight_product_nav(
+        locator=flight_info_plane, product_type=product_type, timeout=timeout
+    )
+    await flight_product_nav.click(button="left")
+    logger.info(f"航班预订查询页面，产品类型【{product_type}】选择完成")
+
+    # 8. 获取所有的产品
+    products: Dict[str, Any] = await book_search_page.get_flight_products(timeout=timeout)
+    cabin_product: Dict[str, Any] = products.get(cabin)
+    # 8.1 判断是否存在该舱位
+    if not cabin_product:
+        raise RuntimeError(f"航班预订查询页面，没有搜索到航班<{flight_no}>的{cabin}舱数据")
+    # 8.2 判断余座
+    seats_status = cabin_product.get("seats_status")
+    logger.info(f"航班预订查询页面，航班<{flight_no}>舱位<{cabin}>的座位情况：{seats_status}")
+    if seats_status < passengers:
+        raise EnvironmentError(f"航班<{flight_no}>的余票: {seats_status}，数量不足")
+    # 8.3. 判断货币符号，是否为 ¥(人民币结算)
+    # 目前都为国内航班，暂不考虑货币种类
+
+    # 8.4 判断销售价格是否满足预订需要
+    amounts: Dict[str, Any] = cabin_product.get("amounts")
+    amount: float = amounts.get("amount")
+    if amount > price_std + price_increase_threshold:
+        raise EnvironmentError(
+            f"航班预订查询页面，航班<{flight_no}>官网价：{amount} 高于：订单销售价[{price_std}] + 上浮阈值[{price_increase_threshold}]，损失过高")
+    if amount < price_std - price_reduction_threshold:
+        raise EnvironmentError(
+            f"航班预订查询页面，航班<{flight_no}>官网价：{amount} 低于：订单销售价[{price_std}] - 下降阈值[{price_reduction_threshold}]，收益过高")
+
+    # 9. 点击【购票】按钮
+    booking_btn: Locator = cabin_product.get("booking_btn")
+    await booking_btn.click(button="left")
+    logger.info(f"航班预订查询页面，【购票】按钮点击完成")

qdairlines_helper/controller/cash_pax_info.py

@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     cash_pax_info.py
+# Description:  支付类型控制器
+# Author:       ASUS
+# CreateDate:   2026/01/05
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from playwright.async_api import Page
+from qdairlines_helper.utils.log_utils import logger
+import qdairlines_helper.config.url_const as url_const
+from qdairlines_helper.po.cash_pax_info_page import CashPaxInfoPage
+from qdairlines_helper.utils.po_utils import get_ip_access_blocked_msg
+
+
+async def load_cash_pax_info_po(
+        *, page: Page, protocol: str, domain: str, timeout: float = 60.0
+) -> CashPaxInfoPage:
+    url_prefix = f"{protocol}://{domain}"
+    cash_pax_info_url = url_prefix + url_const.cash_pax_info_url
+    cash_pax_info_po = CashPaxInfoPage(page=page, url=cash_pax_info_url)
+    await cash_pax_info_po.url_wait_for(url=cash_pax_info_url, timeout=timeout)
+    logger.info(f"即将进入青岛航空官网支付方式页面，页面URL<{cash_pax_info_url}>")
+    ip_access_blocked_msg = await get_ip_access_blocked_msg(page=page, timeout=3)
+    if ip_access_blocked_msg:
+        raise EnvironmentError(ip_access_blocked_msg)
+    return cash_pax_info_po
+
+
+async def select_payment_type(*, page: CashPaxInfoPage, payment_type: str = "汇付天下", timeout: float = 60.0) -> str:
+    # 1. 获取青岛航空官网订单号
+    pre_order_no = await page.get_pre_order_no(timeout=timeout)
+    logger.info(f"选择支付方式页面，青岛航空官网订单号<{pre_order_no}>获取完成")
+
+    # 2. 选择支付类型【payment_type】
+    payment_type_checkbox = await page.get_payment_type_checkbox(payment_type=payment_type, timeout=timeout)
+    await payment_type_checkbox.click(button="left")
+    logger.info(f"选择支付方式页面，第三方支付【{payment_type}】单选框点击完成")
+
+    # 3. 点击【确认支付】
+    confirm_payment_btn = await page.get_confirm_payment_btn(timeout=timeout)
+    await confirm_payment_btn.click(button="left")
+    logger.info("选择支付方式页面，【确认支付】按钮点击完成")
+    return pre_order_no

qdairlines_helper/controller/home.py

@@ -0,0 +1,28 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     home.py
+# Description:  主页控制器模块
+# Author:       ASUS
+# CreateDate:   2026/01/04
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from playwright.async_api import Page
+from qdairlines_helper.po.home_page import HomePage
+from qdairlines_helper.utils.log_utils import logger
+import qdairlines_helper.config.url_const as url_const
+from qdairlines_helper.utils.po_utils import get_ip_access_blocked_msg
+
+
+async def load_home_po(*, page: Page, protocol: str, domain: str, timeout: float = 60.0) -> HomePage:
+    url_prefix = f"{protocol}://{domain}"
+    home_url = url_prefix + url_const.home_url
+    home_po = HomePage(page=page, url=home_url)
+    await home_po.url_wait_for(url=home_url, timeout=timeout)
+    logger.info(f"即将进入青岛航空官网首页，页面URL<{home_url}>")
+    ip_access_blocked_msg = await get_ip_access_blocked_msg(page=page, timeout=3)
+    if ip_access_blocked_msg:
+        raise EnvironmentError(ip_access_blocked_msg)
+    return home_po

qdairlines_helper/controller/nhlms_cashdesk.py

@@ -0,0 +1,74 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     nhlms_cashdesk.py
+# Description:  汇付天下收银台控制器
+# Author:       ASUS
+# CreateDate:   2026/01/05
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+import inspect
+from typing import Tuple, Callable
+from playwright.async_api import BrowserContext
+from qdairlines_helper.utils.log_utils import logger
+import qdairlines_helper.config.url_const as url_const
+from qdairlines_helper.po.nhlms_cash_desk_page import NhlmsCashDeskPage
+from playwright_helper.utils.browser_utils import switch_for_table_window
+from qdairlines_helper.utils.exception_utils import DuplicatePaymentError
+
+
+async def load_nhlms_cash_desk_po(*, context: BrowserContext, timeout: float = 60.0) -> NhlmsCashDeskPage:
+    nhlms_cashdesk_url = url_const.nhlms_cashdesk_domain + url_const.nhlms_cashdesk_url
+
+    current_page = await switch_for_table_window(
+        browser=context, url_keyword=url_const.nhlms_cashdesk_url, wait_time=int(timeout)
+    )
+
+    nhlms_cashdesk_po = NhlmsCashDeskPage(page=current_page, url=nhlms_cashdesk_url)
+    await nhlms_cashdesk_po.url_wait_for(url=nhlms_cashdesk_url, timeout=timeout)
+    logger.info(f"即将进入汇付天下收银台页面，页面URL<{nhlms_cashdesk_url}>")
+    return nhlms_cashdesk_po
+
+
+async def pay_account_payment(
+        *, page: NhlmsCashDeskPage, operator_account: str, pay_password: str, order_id: int,
+        is_pay_completed_callback: Callable, payment_type: str = "付款账户支付", timeout: float = 60.0
+) -> Tuple[str, float]:
+    # 1. 获取收银台支付流水
+    pay_transaction = await page.get_order_transaction(timeout=timeout)
+    logger.info(f"汇付天下收银台页面，支付流水<{pay_transaction}>获取完成")
+
+    # 2. 获取订单支付金额
+    actual_payment_amount = await page.get_order_amount(timeout=timeout)
+    logger.info(f"汇付天下收银台页面，支付金额<{actual_payment_amount}>获取完成")
+
+    # 3. 获取付款方式tab
+    payment_type_tab = await page.get_payment_type_tab(payment_type=payment_type, timeout=timeout)
+    await payment_type_tab.click(button="left")
+    logger.info(f"汇付天下收银台页面，【{payment_type}】Tab点击完成")
+
+    # 4. 输入操作员号
+    username_input = await page.get_username_input(timeout=timeout)
+    await username_input.fill(value=operator_account)
+    logger.info(f"汇付天下收银台页面，操作员号<{operator_account}>输入完成")
+
+    # 5. 输入交易密码
+    password_input = await page.get_password_input(timeout=timeout)
+    await password_input.fill(value=pay_password)
+    logger.info(f"汇付天下收银台页面，交易密码<{pay_password}>输入完成")
+
+    # 6. 校验订单是否已经被支付
+    if inspect.iscoroutinefunction(is_pay_completed_callback):
+        is_pay: bool = await is_pay_completed_callback(order_id=order_id)
+    else:
+        is_pay: bool = is_pay_completed_callback(order_id=order_id)
+    if is_pay is True:
+        raise DuplicatePaymentError(order_id=order_id)
+
+    # 6. 点击【确认支付】
+    confirm_payment_btn = await page.get_confirm_payment_btn(timeout=timeout)
+    await confirm_payment_btn.click(button="left")
+    logger.info("汇付天下收银台页面，【确认支付】按钮点击完成")
+    return pay_transaction, actual_payment_amount

qdairlines_helper/controller/order_detail.py

@@ -0,0 +1,53 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     order_detail.py
+# Description:  订单详情控制器
+# Author:       ASUS
+# CreateDate:   2026/01/06
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from aiohttp import CookieJar
+from typing import Dict, Any, Optional, List
+from qdairlines_helper.utils.log_utils import logger
+from qdairlines_helper.http.flight_order import FlightOrder
+
+
+async def get_order_itinerary(
+        *, playwright_state: Dict[str, Any], token: Optional[str], pre_order_no: str, user_id: str,
+        proxy: Dict[str, Any], domain: Optional[str] = None, protocol: Optional[str] = None,
+        timeout: Optional[int] = None, retry: Optional[int] = None, enable_log: Optional[bool] = None,
+        cookie_jar: Optional[CookieJar] = None, headers: Dict[str, str] = None
+) -> Dict[str, Any]:
+    flight_order = FlightOrder(
+        playwright_state=playwright_state, token=token, domain=domain, protocol=protocol, timeout=timeout, retry=retry,
+        enable_log=enable_log, cookie_jar=cookie_jar
+    )
+    _order_info: Dict[str, Any] = dict(pre_order_no=pre_order_no)
+    try:
+        order_info = await flight_order.get_order_details(
+            pre_order_no=pre_order_no, user_id=user_id, is_end=True, proxy=proxy, headers=headers
+        )
+        if isinstance(order_info, dict) and order_info.get("result"):
+            result = order_info.get("result") or dict()
+            _order_info["cash_unit"] = result.get("cashUnit")
+            _order_info["order_status"] = result.get("orderStatus")
+            _order_info["actual_payment_amount"] = result.get("totalPrice")
+            passenger_infos: List[Dict[str, Any]] = result.get("passengerInfoVoList")
+            order_itineraries = list()
+            for passenger_info in passenger_infos:
+                id_no = passenger_info.get("idNo")
+                order_itinerary = passenger_info.get("tktNo")
+                passenger = passenger_info.get("passName")
+                order_itineraries.append(dict(
+                    passenger=passenger, id_no=id_no, order_itinerary=order_itinerary, pre_order_no=pre_order_no
+                ))
+            if order_itineraries:
+                _order_info["order_itineraries"] = order_itineraries
+        else:
+            raise RuntimeError(f"订单<{pre_order_no}>，获取订单详情数据异常，返回值：{order_info}")
+    except Exception as e:
+        logger.error(e)
+    return _order_info

qdairlines_helper/controller/order_query.py

@@ -0,0 +1,41 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     order_query.py
+# Description:  订单查询控制器
+# Author:       ASUS
+# CreateDate:   2026/01/04
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from typing import Any
+from playwright.async_api import Page
+from qdairlines_helper.utils.log_utils import logger
+import qdairlines_helper.config.url_const as url_const
+from qdairlines_helper.po.air_order_page import AirOrderPage
+from qdairlines_helper.utils.po_utils import get_ip_access_blocked_msg
+
+
+async def open_air_page(*, page: Page, protocol: str, domain: str, timeout: float = 60.0) -> AirOrderPage:
+    url_prefix = f"{protocol}://{domain}"
+    air_order_url = url_prefix + url_const.air_order_url
+    await page.goto(air_order_url)
+
+    air_order_po = AirOrderPage(page=page, url=air_order_url)
+    await air_order_po.url_wait_for(url=air_order_url, timeout=timeout)
+    logger.info(f"即将进入青岛航空官网航班查询页面，页面URL<{air_order_url}>")
+    ip_access_blocked_msg = await get_ip_access_blocked_msg(page=page, timeout=3)
+    if ip_access_blocked_msg:
+        raise EnvironmentError(ip_access_blocked_msg)
+    return air_order_po
+
+
+async def is_open_air_page_callback(
+        *, page: Page, protocol: str, domain: str, timeout: float = 60.0, **kwargs: Any
+) -> bool:
+    try:
+        await open_air_page(page=page, protocol=protocol, domain=domain, timeout=timeout)
+        return True
+    except (Exception,):
+        return False

qdairlines_helper/controller/order_verify.py

@@ -0,0 +1,43 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     order_verify.py
+# Description:  订单校验控制器
+# Author:       ASUS
+# CreateDate:   2026/01/05
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from playwright.async_api import Page
+from qdairlines_helper.utils.log_utils import logger
+import qdairlines_helper.config.url_const as url_const
+from qdairlines_helper.po.order_verify_page import OrderVerifyPage
+from qdairlines_helper.utils.po_utils import get_ip_access_blocked_msg
+
+
+async def load_order_verify_po(*, page: Page, protocol: str, domain: str, timeout: float = 60.0) -> OrderVerifyPage:
+    url_prefix = f"{protocol}://{domain}"
+    order_verify_url = url_prefix + url_const.order_verify_url
+    order_verify_po = OrderVerifyPage(page=page, url=order_verify_url)
+    await order_verify_po.url_wait_for(url=order_verify_url, timeout=timeout)
+    logger.info(f"即将进入青岛航空官网订单校验页面，页面URL<{order_verify_url}>")
+    ip_access_blocked_msg = await get_ip_access_blocked_msg(page=page, timeout=3)
+    if ip_access_blocked_msg:
+        raise EnvironmentError(ip_access_blocked_msg)
+    return order_verify_po
+
+
+async def order_verify(*, page: OrderVerifyPage, refresh_attempt: int = 3, timeout: float = 60.0) -> None:
+    # 1. 先确认订单数据是否加载出来
+    await page.get_order_info_plane(timeout=timeout, refresh_attempt=refresh_attempt)
+
+    # 2. 勾选【同意条款】单选框
+    agree_checkbox = await page.get_agree_checkbox(timeout=timeout)
+    await agree_checkbox.click(button="left")
+    logger.info(f"订单校验页面，规定及条款---【我已核对】单选框点击完成")
+
+    # 3. 点击【下一步】
+    next_btn = await page.get_next_btn(timeout=timeout)
+    await next_btn.click(button="left")
+    logger.info("订单校验页面，【下一步】按钮点击完成")