python-qlv-helper 0.2.0__py3-none-any.whl → 0.5.7__py3-none-any.whl

{python_qlv_helper-0.2.0.dist-info → python_qlv_helper-0.5.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python_qlv_helper
-Version: 0.2.0
+Version: 0.5.7
 Summary: qlv helper python package
 Author-email: ckf10000 <ckf10000@sina.com>
 License:                                  Apache License
@@ -216,7 +216,8 @@ Requires-Dist: ddddocr==1.5.6; python_version >= "3.12" and platform_system == "
 Requires-Dist: aiohttp==3.13.2; python_version >= "3.12"
 Requires-Dist: beautifulsoup4==4.14.2; python_version >= "3.12"
 Requires-Dist: airtest==1.3.6; python_version >= "3.12" and platform_system == "Windows"
-Requires-Dist: python_http_helper==0.1.4; python_version >= "3.12"
+Requires-Dist: python_http_helper>=0.2.0; python_version >= "3.12"
+Requires-Dist: python_playwright_helper>=0.2.9; python_version >= "3.12"
 Dynamic: license-file
 
 # qlv-helper

{python_qlv_helper-0.2.0.dist-info → python_qlv_helper-0.5.7.dist-info}/RECORD

@@ -1,21 +1,24 @@
-python_qlv_helper-0.2.0.dist-info/licenses/LICENSE,sha256=WtjCEwlcVzkh1ziO35P2qfVEkLjr87Flro7xlHz3CEY,11556
+python_qlv_helper-0.5.7.dist-info/licenses/LICENSE,sha256=WtjCEwlcVzkh1ziO35P2qfVEkLjr87Flro7xlHz3CEY,11556
 qlv_helper/__init__.py,sha256=5DCc5JhfdsgtIuFWgkxPOW5VVKZ8RPikQLGIuyZX6_Y,465
+qlv_helper/config/__init__.py,sha256=0pKLgui-sC6yMNBBuuTTLkUGhPybiJQSTKTbi66alvg,465
+qlv_helper/config/custom_exception.py,sha256=uYme0iseQt_dP-Y6-hZ_H2OA2OQR0Kp5PmmZvhEZlEc,805
+qlv_helper/config/url_const.py,sha256=PbKKKH4heqP6SO186MTt-CEpf-Ix5ODlLQ2Aq2ZBZhU,537
 qlv_helper/controller/__init__.py,sha256=cOJA0xMIytv17oICzPYqWLaSy-Ro2Ceeti0hHhsUj6Y,468
 qlv_helper/controller/domestic_activity_order.py,sha256=MlmsDVsMBWq2h4Yjh1rhO372Z3p8tu2-4IZGP-nkfr8,1136
 qlv_helper/controller/main_page.py,sha256=JtkB6BdKYHoNYZ4fkeALpSmAj-NAuiv1x6BvCcBtpic,1252
-qlv_helper/controller/order_detail.py,sha256=F6KxZrupitF4EzykHLXxncT1ikmmP89O17E5oCn1XsY,1527
-qlv_helper/controller/order_table.py,sha256=rMqdyXrJbbqZmjvOYK1Ot09tR937m-0INU2rgzizjhU,5417
+qlv_helper/controller/order_detail.py,sha256=tOV80nrL8YDVNjvKi8YQP0hWqAcd8M1J0ToRK5YLWZ0,21701
+qlv_helper/controller/order_table.py,sha256=4AgA9EO0_GVuwnW3ltXPoN74U_6YpOqkRJVdeLb6L1o,6082
 qlv_helper/controller/user_login.py,sha256=iyyDbOREsXtV5bqAFeXGwurvcCmDHmquh6ReWCfnOBE,5281
 qlv_helper/http/__init__.py,sha256=yDh1xi_o7ohXqDAzLu62qCWIGk4_aD1dhnUaCon3klM,484
 qlv_helper/http/main_page.py,sha256=LTpwrG8H_NqwCa3185irgcGd6JQkChAk7HQsDM-TNTI,1519
-qlv_helper/http/order_page.py,sha256=VcoDoEPz3R0zHmKNRuRv2vDHkC3XS_bXhBE_uW9wEYw,11852
-qlv_helper/http/order_table_page.py,sha256=qDmQXkLcuTkLGPSURGzBKnhirjE8M1Ma9ibehg-mAkk,13135
+qlv_helper/http/order_page.py,sha256=zIUZk1UiinoLQ4Y-Qwcv0ZmNAXtYoOGOYDdwdoA0RBI,13157
+qlv_helper/http/order_table_page.py,sha256=IaXn5wjqPi1aRXHz0kucdHEdZswUWAZfECC13y57y8k,14440
 qlv_helper/po/__init__.py,sha256=eDr06o0eYapBsYpOhA11bbxzs2F0dsuDjOKmxk_2HVE,480
-qlv_helper/po/base_po.py,sha256=_Cym-vsrB1kjZeCkKzOj1BYC8pTR-nKlGDj7QaUiLBs,1362
-qlv_helper/po/domestic_activity_order_page.py,sha256=ySOrC1Rdc2ApL0FCRwf8xDKQrzTY63OxDC3EHPauvcA,5088
-qlv_helper/po/login_page.py,sha256=XcBSvOC_wQ4pInv6w_tDe6iB2UuNG-UUTpUS-mgwUEo,5951
-qlv_helper/po/main_page.py,sha256=x4ZJqWdxL6nQdQXDIZB87uDVXfLKs9FIAe0AQqaQO3M,3323
-qlv_helper/po/wechat_auth_page.py,sha256=SfZQn_mmfquf7srDs-rPRWKjaDWN7Xtsauk9AnLMMJs,3162
+qlv_helper/po/domestic_activity_order_page.py,sha256=f-XSc2HD6GYisUJZwK2-u0Tr4W3B_vb5JpXvHnjfHOQ,5030
+qlv_helper/po/login_page.py,sha256=HKGjS4WrkWnDdnh0JQAYxA3DyEWbInviQTna_KrP2FA,5960
+qlv_helper/po/main_page.py,sha256=Hf8Wj7D9GitIj4HIi_zDHHIc5kasFQwraqEMZObYI7w,3320
+qlv_helper/po/order_detail_page.py,sha256=zCB-pWyXdZz8vlDhvl1K79-bQ7C7Y12DiDSXlS_woYw,13681
+qlv_helper/po/wechat_auth_page.py,sha256=a4YZlM5JOS0l3CNJm_oJFBhZY7AbNOpdIwilSjAO5bY,3171
 qlv_helper/utils/__init__.py,sha256=rGzBkUf1tslG4WRPQjVWTVuwWG76pkckuKO_6K4sEus,465
 qlv_helper/utils/browser_utils.py,sha256=mKoqSEz1vFrVemp9cgI4R5UhA4k7i0Cd9cWsIXJZ6E4,986
 qlv_helper/utils/datetime_utils.py,sha256=BaDJKuH-yqc2NF9KYN66zUYUEJ9ZRHj09AV4-gILf3o,606
@@ -26,7 +29,7 @@ qlv_helper/utils/po_utils.py,sha256=SwQKL58HERGG2Weou_AwY_TQoYSvgi0gvaVCJBput_k,
 qlv_helper/utils/stealth_browser.py,sha256=srNOYJOboYo30TvW5OP5TaVpg4jgHm9GxqmYnuwcUQU,3140
 qlv_helper/utils/type_utils.py,sha256=S5FXUje2mbDuq27LU05WymxNu1VGOLBUV3tuqcx51dE,3792
 qlv_helper/utils/windows_utils.py,sha256=Cvedsk1c2ujgPNVxszz8XWANkvEr8G9kne6povtZRU4,2866
-python_qlv_helper-0.2.0.dist-info/METADATA,sha256=irKOAys7QdoUtxIoR1vxZnPT-yiD3zi4k_yF2-CDtf4,14779
-python_qlv_helper-0.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-python_qlv_helper-0.2.0.dist-info/top_level.txt,sha256=0pYdhD8SfBcC57LzLYGHY7cwwPqdqAkB1twysCJh5OA,11
-python_qlv_helper-0.2.0.dist-info/RECORD,,
+python_qlv_helper-0.5.7.dist-info/METADATA,sha256=QcI93-dpNseb9ie1ciSpmZu2GMC45SVG--lmaK8ZkJ8,14853
+python_qlv_helper-0.5.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+python_qlv_helper-0.5.7.dist-info/top_level.txt,sha256=0pYdhD8SfBcC57LzLYGHY7cwwPqdqAkB1twysCJh5OA,11
+python_qlv_helper-0.5.7.dist-info/RECORD,,

qlv_helper/config/__init__.py

@@ -0,0 +1,11 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  qlv-helper
+# FileName:     __init__.py
+# Description:  配置包
+# Author:       ASUS
+# CreateDate:   2025/12/16
+# Copyright ©2011-2025. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""

qlv_helper/config/custom_exception.py

@@ -0,0 +1,35 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  qlv-helper
+# FileName:     custom_exception.py
+# Description:  自定义异常模块
+# Author:       ASUS
+# CreateDate:   2025/12/17
+# Copyright ©2011-2025. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+
+
+class FirstPhaseException(Exception):
+    pass
+
+
+class SecondPhaseException(Exception):
+    pass
+
+
+class ThirdPhaseException(Exception):
+    pass
+
+
+class FourthPhaseException(Exception):
+    pass
+
+
+class FifthPhaseException(Exception):
+    pass
+
+
+class sixthPhaseException(Exception):
+    pass

qlv_helper/config/url_const.py

@@ -0,0 +1,13 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  qlv-helper
+# FileName:     url_const.py
+# Description:  url配置常量
+# Author:       ASUS
+# CreateDate:   2025/12/16
+# Copyright ©2011-2025. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+
+order_detail_url = "/OrderProcessing/NewTicket_show/{}?&r={}"

qlv_helper/controller/order_detail.py

@@ -10,13 +10,19 @@
 # ---------------------------------------------------------------------------------------------------------
 """
 import aiohttp
-from typing import Dict, Any, Optional
+import asyncio
+from logging import Logger
+from datetime import datetime
+import qlv_helper.config.url_const as url_const
+from typing import Dict, Any, List, cast, Optional
+from qlv_helper.po.order_detail_page import OrderDetailPage
 from qlv_helper.http.order_page import parser_order_info, get_order_page_html, parser_order_flight_table
+from playwright.async_api import Page, Locator, Error as PlaywrightError, TimeoutError as PlaywrightTimeoutError
 
 
 async def get_order_info_with_http(
-        order_id: int, domain: str, protocol: str = "http", retry: int = 1, timeout: int = 5, enable_log: bool = True,
-        cookie_jar: Optional[aiohttp.CookieJar] = None, playwright_state: Dict[str, Any] = None
+        *, order_id: int, domain: str, protocol: str = "http", retry: int = 1, timeout: int = 5,
+        enable_log: bool = True, cookie_jar: Optional[aiohttp.CookieJar] = None, playwright_state: Dict[str, Any] = None
 ) -> Dict[str, Any]:
     response = await get_order_page_html(
         order_id=order_id, domain=domain, protocol=protocol, retry=retry, timeout=timeout, enable_log=enable_log,
@@ -33,3 +39,389 @@ async def get_order_info_with_http(
         order_info["peoples"] = flight_info
     response["data"] = order_info
     return response
+
+
+async def open_order_detail_page(
+        *, page: Page, logger: Logger, protocol: str, domain: str, order_id: int, timeout: float = 20.0
+) -> OrderDetailPage:
+    url_prefix = f"{protocol}://{domain}"
+    current_dtstr: str = datetime.now().strftime("%Y%m%d%H%M%S")
+    order_detail_url_suffix = url_const.order_detail_url.format(order_id, current_dtstr)
+    order_detail_url = url_prefix + order_detail_url_suffix
+    await page.goto(order_detail_url)
+
+    order_detail_po = OrderDetailPage(page=page, url=order_detail_url)
+    await order_detail_po.url_wait_for(url=order_detail_url, timeout=timeout)
+    logger.info(f"即将劲旅订单详情页面，页面URL<{order_detail_url}>")
+
+    try:
+        confirm_btn = await order_detail_po.get_message_notice_dialog_confirm_btn(timeout=1)
+        await confirm_btn.click(button="left")
+        logger.info("订单详情页面，消息提醒弹框，【确认】按钮点击完成")
+    except (PlaywrightTimeoutError, PlaywrightError, RuntimeError, Exception):
+        pass
+    return order_detail_po
+
+
+async def add_custom_remark(*, logger: Logger, page: OrderDetailPage, remark: str, timeout: float = 5.0) -> None:
+    # 1. 添加自定义备注
+    custom_remark_input = await page.get_custom_remark_input(timeout=timeout)
+    await custom_remark_input.fill(value=remark)
+    logger.info(f"订单详情页面，日志记录栏，自定义备注：{remark}，输入完成")
+
+    # 2. 点击【保存备注】按钮
+    custom_remark_save_btn = await page.get_custom_remark_save_btn(timeout=timeout)
+    await custom_remark_save_btn.click(button="left")
+    logger.info(f"订单详情页面，日志记录栏，【保存备注】按钮点击完成")
+
+
+async def update_order_policy(
+        *, page: OrderDetailPage, logger: Logger, policy: str, order_id: int, timeout: float = 5.0
+) -> None:
+    # 1. 修改政策代码
+    policy_input = await page.get_policy_input(timeout=timeout)
+    await policy_input.fill(value=policy)
+
+    # 2. 执行回车按键
+    await policy_input.press("Enter")
+    logger.info(f"订单<{order_id}>，政策代码已更新成<{policy}>完成")
+
+
+async def order_unlock(
+        *, logger: Logger, page: OrderDetailPage, remark: str, order_id: int, is_force: bool = False,
+        qlv_user_id: Optional[str] = None, timeout: float = 5.0
+) -> None:
+    # 1. 获取订单操作锁的状态
+    lock_state, lock_btn = await page.get_order_lock_state_btn(timeout=timeout)
+    if "强制解锁" in lock_state:
+        if is_force is False:
+            raise EnvironmentError(f"订单<{order_id}>，被他人锁定，无需解锁处理")
+        await lock_btn.click(button="left")
+        logger.info(f"订单详情页面，用户操作【{lock_state}】按钮点击完成")
+        try:
+            confirm_btn = await page.get_message_notice_dialog_confirm_btn(timeout=1)
+            await confirm_btn.click(button="left")
+            logger.info("订单详情页面，强制解锁弹框确认，【确认】按钮点击完成")
+            await asyncio.sleep(2)
+        except (PlaywrightTimeoutError, PlaywrightError, RuntimeError, Exception):
+            pass
+        logger.warning(f"订单<{order_id}>，已被用户<{qlv_user_id or '无记录'}>强制解锁")
+        # 再次获取订单操作锁的状态
+        lock_state, lock_btn = await page.get_order_lock_state_btn(timeout=timeout)
+    elif "锁定" in lock_state:
+        logger.info(f"订单<{order_id}>，处于无锁状态，无需解锁处理")
+        return
+    elif "操作" in lock_state:
+        await lock_btn.click(button="left")
+        await asyncio.sleep(2)
+        lock_state_temp = lock_state
+        lock_state, lock_btn = await page.get_order_lock_state_btn(timeout=timeout)
+        logger.info(f"订单详情页面，日志记录栏，【{lock_state_temp}】按钮点击完成")
+    if remark:
+        # 2. 添加解锁备注
+        await add_custom_remark(logger=logger, page=page, remark=remark, timeout=timeout)
+
+    # 3. 点击【解锁返回】按钮
+    await lock_btn.click(button="left")
+    await asyncio.sleep(2)
+    logger.info(f"订单详情页面，日志记录栏，【{lock_state}】按钮点击完成")
+
+
+async def order_locked(
+        *, logger: Logger, page: OrderDetailPage, order_id: int, is_force: bool = False, timeout: float = 5.0,
+        qlv_user_id: Optional[str] = None
+) -> None:
+    # 1. 获取订单操作锁的状态
+    lock_state, lock_btn = await page.get_order_lock_state_btn(timeout=timeout)
+    if "强制解锁" in lock_state:
+        if is_force is False:
+            raise EnvironmentError(f"订单<{order_id}>，被他人锁定，不做加锁处理")
+        await lock_btn.click(button="left")
+        logger.info(f"订单详情页面，用户操作【{lock_state}】按钮点击完成")
+        try:
+            confirm_btn = await page.get_message_notice_dialog_confirm_btn(timeout=1)
+            await confirm_btn.click(button="left")
+            logger.info("订单详情页面，强制解锁弹框确认，【确认】按钮点击完成")
+            await asyncio.sleep(2)
+        except (PlaywrightTimeoutError, PlaywrightError, RuntimeError, Exception):
+            pass
+        logger.warning(f"订单<{order_id}>，已被用户<{qlv_user_id or '无记录'}>强制解锁")
+        return
+    elif "解锁返回" in lock_state:
+        logger.warning(f"订单<{order_id}>，处于锁定状态，不做加锁处理")
+        return
+    # 2. 点击【锁定|操作】按钮
+    await lock_btn.click(button="left")
+    logger.info(f"订单详情页面，日志记录栏，【{lock_state}】按钮点击完成")
+
+
+async def first_open_page_order_locked(
+        *, logger: Logger, page: Page, protocol: str, domain: str, order_id: int, is_force: bool = False,
+        qlv_user_id: Optional[str] = None, timeout: float = 5.0, **kwargs
+) -> OrderDetailPage:
+    # 1. 打开页面
+    order_detail_po = await open_order_detail_page(
+        page=page, logger=logger, protocol=protocol, domain=domain, order_id=order_id, timeout=timeout
+    )
+
+    # 2. 锁定订单
+    await order_locked(
+        logger=logger, page=order_detail_po, order_id=order_id, timeout=timeout, is_force=is_force,
+        qlv_user_id=qlv_user_id
+    )
+    return order_detail_po
+
+
+async def first_open_page_order_unlock(
+        *, logger: Logger, page: Page, protocol: str, domain: str, order_id: int, is_force: bool = False,
+        qlv_user_id: Optional[str] = None, timeout: float = 5.0, remark: Optional[str] = None, **kwargs
+) -> OrderDetailPage:
+    # 1. 打开页面
+    order_detail_po = await open_order_detail_page(
+        page=page, logger=logger, protocol=protocol, domain=domain, order_id=order_id, timeout=timeout
+    )
+
+    # 2. 解锁订单
+    await order_unlock(
+        logger=logger, page=order_detail_po, order_id=order_id, timeout=timeout, is_force=is_force,
+        qlv_user_id=qlv_user_id, remark=remark
+    )
+    return order_detail_po
+
+
+async def fill_procurement_info(
+        *, logger: Logger, page: OrderDetailPage, order_id: int, out_ticket_platform_type: str, purchase_amount: float,
+        out_ticket_platform: str, out_ticket_account: str, purchase_account_type: str, purchase_account: str,
+        ceair_user_id: str, ceair_password: str, payment_id: str, platform_order_id: str, timeout: float = 5.0
+) -> None:
+    # 1. 出票地类型选择【out_ticket_platform_type】
+    out_ticket_platform_type_dropdown = await page.get_out_ticket_platform_type_dropdown(timeout=timeout)
+    await out_ticket_platform_type_dropdown.select_option(label=out_ticket_platform_type)
+    # await out_ticket_platform_type_dropdown.click(button="left")
+    # out_ticket_platform_type_select_option = await page.get_out_ticket_platform_type_select_option(
+    #     select_option=out_ticket_platform_type, timeout=timeout
+    # )
+    # await out_ticket_platform_type_select_option.click(button="left")
+    logger.info(f"订单详情页面，采购信息栏，出票地类型选择<{out_ticket_platform_type}>已完成")
+    await asyncio.sleep(1)
+
+    # 2. 出票平台选择【out_ticket_platform】
+    out_ticket_platform_dropdown = await page.get_out_ticket_platform_dropdown(timeout=timeout)
+    await out_ticket_platform_dropdown.select_option(label=out_ticket_platform)
+    # await out_ticket_platform_dropdown.click(button="left")
+    # out_ticket_platform_select_option = await page.get_out_ticket_platform_select_option(
+    #     select_option=out_ticket_platform, timeout=timeout
+    # )
+    # await out_ticket_platform_select_option.click(button="left")
+    logger.info(f"订单详情页面，采购信息栏，出票平台选择<{out_ticket_platform}>已完成")
+    await asyncio.sleep(1)
+
+    # 3. 出票账号选择【out_ticket_account】
+    out_ticket_account_dropdown = await page.get_out_ticket_account_dropdown(timeout=timeout)
+    await out_ticket_account_dropdown.select_option(label=out_ticket_account)
+    # await out_ticket_account_dropdown.click(button="left")
+    # out_ticket_account_select_option = await page.get_out_ticket_account_select_option(
+    #     select_option=out_ticket_account, timeout=timeout
+    # )
+    # await out_ticket_account_select_option.click(button="left")
+    logger.info(f"订单详情页面，采购信息栏，出票账号选择<{out_ticket_account}>已完成")
+    await asyncio.sleep(1)
+
+    # 4. 采购账号类型选择【purchase_account_type】
+    purchase_account_type_dropdown = await page.get_purchase_account_type_dropdown(timeout=timeout)
+    await purchase_account_type_dropdown.select_option(label=purchase_account_type)
+    # await purchase_account_type_dropdown.click(button="left")
+    # purchase_account_type_select_option = await page.get_purchase_account_type_select_option(
+    #     select_option=purchase_account_type, timeout=timeout
+    # )
+    # await purchase_account_type_select_option.click(button="left")
+    logger.info(f"订单详情页面，采购信息栏，采购账号类型选择<{purchase_account_type}>已完成")
+    await asyncio.sleep(1)
+
+    # 5. 采购账号选择【purchase_account】
+    purchase_account_dropdown = await page.get_purchase_account_dropdown(timeout=timeout)
+    await purchase_account_dropdown.select_option(label=purchase_account)
+    # await purchase_account_dropdown.click(button="left")
+    # purchase_account_select_option = await page.get_purchase_account_select_option(
+    #     select_option=purchase_account, timeout=timeout
+    # )
+    # await purchase_account_select_option.click(button="left")
+    logger.info(f"订单详情页面，采购信息栏，采购账号选择<{purchase_account}>已完成")
+    await asyncio.sleep(1)
+
+    # 6. 填写采购金额
+    purchase_amount_input = await page.get_purchase_amount_input(timeout=timeout)
+    await purchase_amount_input.fill(value=str(purchase_amount))
+    logger.info(f"订单详情页面，采购信息栏，采购金额<{purchase_amount}>输入完成")
+
+    # 7. 填写备注
+    remark_input = await page.get_remark_input(timeout=timeout)
+    value = f"{ceair_user_id}/{ceair_password}"
+    await remark_input.fill(value=value)
+    logger.info(f"订单详情页面，采购信息栏，备注<{value}>输入完成")
+
+    # 8. 填写对账标识
+    main_check_input = await page.get_main_check_input(timeout=timeout)
+    await main_check_input.fill(value=payment_id)
+    logger.info(f"订单详情页面，采购信息栏，对账标识<{payment_id}>输入完成")
+
+    # 9. 填写官网订单号
+    air_comp_order_id_input = await page.get_air_comp_order_id_input(timeout=timeout)
+    await air_comp_order_id_input.fill(value=platform_order_id)
+    logger.info(f"订单详情页面，采购信息栏，官网订单号<{platform_order_id}>输入完成")
+
+    # 10. 点击【保存采购】按钮
+    procurement_info_save_btn = await page.get_procurement_info_save_btn(timeout=timeout)
+    await procurement_info_save_btn.click(button="left")
+    logger.info(f"订单详情页面，采购信息栏，【保存采购】按钮点击完成")
+
+
+async def first_open_page_fill_procurement_info(
+        *, logger: Logger, page: Page, order_id: int, protocol: str, domain: str, out_ticket_platform_type: str,
+        purchase_amount: float, out_ticket_platform: str, out_ticket_account: str, purchase_account_type: str,
+        purchase_account: str, ceair_user_id: str, ceair_password: str, payment_id: str, platform_order_id: str,
+        is_force: bool = False, qlv_user_id: Optional[str] = None, timeout: float = 5.0, **kwargs: Any
+) -> OrderDetailPage:
+    # 1. 打开页面
+    order_detail_po = await open_order_detail_page(
+        page=page, logger=logger, protocol=protocol, domain=domain, order_id=order_id, timeout=timeout
+    )
+
+    # 2. 锁定订单
+    await order_locked(
+        logger=logger, page=order_detail_po, order_id=order_id, is_force=is_force, timeout=timeout,
+        qlv_user_id=qlv_user_id
+    )
+
+    # 3. 回填采购信息
+    await fill_procurement_info(
+        out_ticket_platform_type=out_ticket_platform_type, out_ticket_account=out_ticket_account, payment_id=payment_id,
+        purchase_amount=purchase_amount, out_ticket_platform=out_ticket_platform, purchase_account=purchase_account,
+        purchase_account_type=purchase_account_type, ceair_user_id=ceair_user_id, ceair_password=ceair_password,
+        platform_order_id=platform_order_id, timeout=timeout, logger=logger, page=order_detail_po, order_id=order_id
+    )
+    return order_detail_po
+
+
+async def fill_itinerary(
+        *, logger: Logger, page: OrderDetailPage, order_id: int, passengers_itinerary: Dict[str, Any],
+        timeout: float = 5.0
+) -> None:
+    # 1. 获取订单操作锁的状态
+    passenger_itinerary_locators: List[Dict[str, Any]] = await page.get_passenger_itinerary_locators(timeout=timeout)
+    if not passenger_itinerary_locators:
+        logger.warning(f"订单<{order_id}>，没有需要填写票号的乘客，直接跳过")
+        return
+    current_passengers = set([x.get("username") for x in passenger_itinerary_locators])
+    kwargs_passengers = set(passengers_itinerary.keys())
+    diff = kwargs_passengers.difference(current_passengers)
+    if diff:
+        raise RuntimeError(
+            f"订单<{order_id}>，传递回填票号的乘客证件信息<{kwargs_passengers}>与订单实际乘客信息<{current_passengers}>不一致"
+        )
+    passenger_itinerary_locator = cast(Locator, None)
+    for passenger_locator in passenger_itinerary_locators:
+        current_passenger = passenger_locator.get("username")
+        passenger_itinerary = passengers_itinerary.get(current_passenger)
+        if passenger_itinerary:
+            passenger_itinerary_locator: Locator = passenger_locator.get("locator")
+            await passenger_itinerary_locator.fill(value=passenger_itinerary)
+            logger.info(f"订单<{order_id}>，乘客<{current_passenger}>的票号<{passenger_itinerary}>填写完成")
+        else:
+            logger.warning(f"订单<{order_id}>，乘客<{current_passenger}>的票号没有获取到，本次回填跳过，等待下一次")
+    if passenger_itinerary_locator:
+        await passenger_itinerary_locator.press("Enter")
+        logger.info(f"订单<{order_id}>，本次的票号回填完成")
+    else:
+        raise RuntimeError(f"订单<{order_id}>，回填票号过程异常，回填失败")
+
+
+async def first_open_page_fill_itinerary(
+        *, page: Page, logger: Logger, protocol: str, domain: str, order_id: int,
+        passengers_itinerary: Dict[str, Any], timeout: float = 20.0, **kwargs: Any
+) -> OrderDetailPage:
+    # 1. 开发页面
+    order_detail_po = await open_order_detail_page(
+        page=page, logger=logger, protocol=protocol, domain=domain, order_id=order_id, timeout=timeout
+    )
+
+    # 2. 回填票号
+    await fill_itinerary(
+        logger=logger, page=order_detail_po, order_id=order_id, timeout=timeout,
+        passengers_itinerary=passengers_itinerary
+    )
+    logger.info(f"订单<{order_id}>，票号回填流程结束")
+    await order_unlock(logger=logger, page=order_detail_po, order_id=order_id, timeout=timeout, remark="")
+    logger.info(f"订单<{order_id}>，订单解锁成功")
+    return order_detail_po
+
+
+async def first_open_page_update_policy(
+        *, page: Page, logger: Logger, protocol: str, domain: str, order_id: int, policy: str, timeout: float = 20.0,
+        **kwargs: Any
+) -> OrderDetailPage:
+    # 1. 打开页面
+    order_detail_po = await open_order_detail_page(
+        page=page, logger=logger, protocol=protocol, domain=domain, order_id=order_id, timeout=timeout
+    )
+
+    # 2. 更新订单政策代码
+    await update_order_policy(
+        logger=logger, page=order_detail_po, order_id=order_id, timeout=timeout, policy=policy
+    )
+
+    return order_detail_po
+
+
+async def first_open_page_my_order_unlock(
+        *, page: Page, logger: Logger, protocol: str, domain: str, order_id: int, qlv_user_id: str,
+        policy: Optional[str] = None, remark: Optional[str] = None, timeout: float = 20.0, is_force: bool = False,
+        **kwargs: Any
+) -> OrderDetailPage:
+    # 1. 打开页面
+    order_detail_po = await open_order_detail_page(
+        page=page, logger=logger, protocol=protocol, domain=domain, order_id=order_id, timeout=timeout
+    )
+
+    if policy:
+        # 2. 更新订单政策代码
+        await update_order_policy(
+            logger=logger, page=order_detail_po, order_id=order_id, timeout=timeout, policy=policy
+        )
+
+    if remark:
+        # 3. 添加解锁备注
+        await add_custom_remark(logger=logger, page=order_detail_po, remark=remark, timeout=timeout)
+
+    # 4. 获取订单操作锁的状态
+    lock_state, lock_btn = await order_detail_po.get_order_lock_state_btn(timeout=timeout)
+    if "强制解锁" in lock_state:
+        if is_force is False:
+            logger.warning(f"订单<{order_id}>，非本账号<{qlv_user_id}>的锁单，暂不处理，即将跳过")
+            return order_detail_po
+        await lock_btn.click(button="left")
+        logger.info(f"订单详情页面，用户操作【{lock_state}】按钮点击完成")
+        try:
+            confirm_btn = await order_detail_po.get_message_notice_dialog_confirm_btn(timeout=1)
+            await confirm_btn.click(button="left")
+            logger.info("订单详情页面，强制解锁弹框确认，【确认】按钮点击完成")
+            await asyncio.sleep(2)
+        except (PlaywrightTimeoutError, PlaywrightError, RuntimeError, Exception):
+            pass
+        logger.warning(f"订单<{order_id}>，已被用户<{qlv_user_id or '无记录'}>强制解锁")
+        # 再次获取订单操作锁的状态
+        lock_state, lock_btn = await order_detail_po.get_order_lock_state_btn(timeout=timeout)
+    elif "锁定" in lock_state:
+        logger.info(f"订单<{order_id}>，处于无锁状态，无需解锁处理")
+    elif "操作" in lock_state:
+        await lock_btn.click(button="left")
+        await asyncio.sleep(2)
+        lock_state_temp = lock_state
+        lock_state, lock_btn = await order_detail_po.get_order_lock_state_btn(timeout=timeout)
+        logger.info(f"订单详情页面，日志记录栏，【{lock_state_temp}】按钮点击完成")
+
+    # 5. 点击【解锁返回】按钮
+    await lock_btn.click(button="left")
+    await asyncio.sleep(2)
+    logger.info(f"订单详情页面，日志记录栏，【{lock_state}】按钮点击完成")
+    return order_detail_po

qlv_helper/controller/order_table.py

@@ -15,7 +15,7 @@ from typing import Optional, Dict, Any, Callable, List
 from http_helper.client.async_proxy import HttpClientFactory
 from qlv_helper.utils.html_utils import parse_pagination_info
 from qlv_helper.http.order_table_page import get_domestic_activity_order_page_html, get_domestic_ticket_outed_page_html, \
-    parse_order_table
+    parse_order_table, get_domestic_unticketed_order_page_html
 
 
 async def _get_paginated_order_table(
@@ -143,3 +143,19 @@ async def get_domestic_ticket_outed_table(
         table_state="completed",
         fetch_page_fn=get_domestic_ticket_outed_page_html
     )
+
+async def get_domestic_unticketed_order_table(
+        domain: str, protocol: str = "http", retry: int = 1, timeout: int = 5, enable_log: bool = True,
+        cookie_jar: Optional[CookieJar] = None, playwright_state: Dict[str, Any] = None
+) -> Dict[str, Any]:
+    return await _get_paginated_order_table(
+        domain=domain,
+        protocol=protocol,
+        retry=retry,
+        timeout=timeout,
+        enable_log=enable_log,
+        cookie_jar=cookie_jar,
+        playwright_state=playwright_state,
+        table_state="proccessing",
+        fetch_page_fn=get_domestic_unticketed_order_page_html
+    )

qlv_helper/http/order_page.py

@@ -55,40 +55,73 @@ def order_info_static_headers() -> OrderedDict[str, str]:
 
 def parser_order_info(html: str) -> Dict[str, Any]:
     soup = BeautifulSoup(html, "html.parser")
-    # 找到目标 table
-    table = soup.find("table", class_="table no_border")
-    if not table:
+    # 找到目标 table_border
+    table_border = soup.find("table", class_="table no_border")
+    if not table_border:
+        return {}
+
+    table_flight = soup.find("table", class_="info_flight")
+    if not table_border:
         return {}
 
     # 所有 td
-    tds = table.find_all("td")
+    tds_border = table_border.find_all("td")
     result = {}
 
-    for td in tds:
-        text = td.get_text(strip=True)
-        # 如果 td 内没有冒号、也不是按钮，跳过
-        if "：" not in text:
-            continue
-        # 按 "：" 进行分割
+    for td in tds_border:
         try:
-            key, value = text.split("：", 1)
-        except (Exception, ValueError):
-            continue
-        # 去掉换行符、空格
-        key = key.strip()
-        value = value.strip()
-
-        # 如果 value 为空，尝试取 <b> 或其他控件内文本
-        if not value:
-            b = td.find("b")
-            if b:
-                value = b.get_text(strip=True)
-
-        # 去掉尾部不需要的空格
-        value = value.replace("\u00a0", "").strip()
-        value = value[1:] if isinstance(value, str) and value.startswith("[") else value
-        value = value[:-1] if isinstance(value, str) and value.endswith("]") else value
-        result[key] = safe_convert_advanced(value)
+            text = td.get_text(strip=True)
+            # 如果 td 内没有冒号、也不是按钮，跳过
+            if "：" not in text:
+                continue
+            # 按 "：" 进行分割
+            try:
+                key, value = text.split("：", 1)
+            except (Exception, ValueError):
+                continue
+            # 去掉换行符、空格
+            key = key.strip()
+            value = value.strip()
+
+            # 如果 value 为空，尝试取 <b> 或其他控件内文本
+            if not value:
+                b = td.find("b")
+                if b:
+                    value = b.get_text(strip=True)
+
+            # 去掉尾部不需要的空格
+            value = value.replace("\u00a0", "").strip()
+            value = value[1:] if isinstance(value, str) and value.startswith("[") else value
+            value = value[:-1] if isinstance(value, str) and value.endswith("]") else value
+            result[key] = safe_convert_advanced(value)
+        except (Exception,):
+            pass
+
+    # 所有 td
+    tds_flight = table_flight.find_all("td")
+
+    for td in tds_flight:
+        try:
+            dat_dep = td.find("span", class_="DatDep")
+            if dat_dep:
+                text = dat_dep.get_text(strip=True)
+                result["dat_dep"] = text + ":00"
+            city_dep = td.find("span", class_="CityDep")
+            if city_dep:
+                text = city_dep.get_text(strip=True)
+                city_dep = text.split("【")[0].strip()
+                result["city_dep"] = city_dep
+            dat_arr = td.find("p", class_="DatArr")
+            if dat_arr:
+                text = dat_arr.get_text(strip=True)
+                result["dat_arr"] = text + ":00"
+            city_arr = td.find("span", class_="CityArr")
+            if city_arr:
+                text = city_arr.get_text(strip=True)
+                city_arr = text.split("【")[0].strip()
+                result["city_arr"] = city_arr
+        except (Exception,):
+            pass
     return convert_cn_to_en(data=result, header_map=order_info_static_headers())
 
 

qlv_helper/http/order_table_page.py

@@ -81,10 +81,34 @@ async def get_domestic_ticket_outed_page_html(
         json_data["PageCountFormPage"] = pages
         return await order_http_client.request(method="post", url=url, is_end=is_end, json_data=json_data)
 
+async def get_domestic_unticketed_order_page_html(
+        domain: str, protocol: str = "http", retry: int = 1, timeout: int = 5, enable_log: bool = True,
+        cookie_jar: Optional[aiohttp.CookieJar] = None, playwright_state: Dict[str, Any] = None, current_page: int = 1,
+        pages: int = 1, order_http_client: HttpClientFactory = None, is_end: bool = True
+) -> Dict[str, Any]:
+    if not order_http_client:
+        order_http_client = HttpClientFactory(
+            protocol=protocol if protocol == "http" else "https",
+            domain=domain,
+            timeout=timeout,
+            retry=retry,
+            enable_log=enable_log,
+            cookie_jar=cookie_jar,
+            playwright_state=playwright_state
+        )
+    url = "/OrderList/GuoNei_TicketOutUndo"
+    if current_page == 1:
+        return await order_http_client.request(method="get", url=url, is_end=is_end)
+    else:
+        json_data = deepcopy(kwargs)
+        json_data["JumpPageFromPage"] = current_page
+        json_data["PageCountFormPage"] = pages
+        return await order_http_client.request(method="post", url=url, is_end=is_end, json_data=json_data)
+
 
 def processing_static_headers() -> OrderedDict[str, str]:
     return OrderedDict([
-        ("source_ota", "来源"),  # 0
+        ("source_name", "来源"),  # 0
         ("id", "订单号"),  # 1
         ("raw_order_no", "平台订单号"),  # 2
         ("adult_pnr", "成人PNR"),  # 3
@@ -104,7 +128,7 @@ def processing_static_headers() -> OrderedDict[str, str]:
 
 def completed_static_headers() -> OrderedDict[str, str]:
     return OrderedDict([
-        ("source_ota", "来源"),  # 0
+        ("source_name", "来源"),  # 0
         ("id", "订单号"),  # 1
         ("raw_order_no", "平台订单号"),  # 2
         ("adult_pnr", "成人PNR"),  # 3
@@ -274,8 +298,10 @@ def parse_order_row(cells: ResultSet[Tag], headers: OrderedDict, extend_headers:
                 total_child_key = get_key_by_index(ordered_dict=extend_headers, index=7)
                 order_data[total_adult_key] = safe_convert_advanced(cell_text_slice[1])
                 order_data[total_child_key] = safe_convert_advanced(cell_text_slice[2])
-            else:
+            elif header_key == "receipted":
                 order_data[header_key] = safe_convert_advanced(cell_text)
+            else:
+                order_data[header_key] = cell_text
 
             # 提取特殊属性
             extract_special_attributes(cells=cells, order_data=order_data, header=headers)
@@ -317,7 +343,7 @@ def parse_order_table(html: str, table_state: str = "proccessing") -> List[Optio
         cells = row.find_all(['td', 'th'])
 
         order_data = parse_order_row(cells, headers=headers, extend_headers=extend, row_index=i)
-        if order_data:
+        if order_data and order_data.get("id") is not None:
             orders.append(order_data)
 
     return orders

qlv_helper/po/domestic_activity_order_page.py

@@ -10,8 +10,8 @@
 # ---------------------------------------------------------------------------------------------------------
 """
 from bs4 import BeautifulSoup
-from qlv_helper.po.base_po import BasePo
 from typing import Tuple, Union, List, Any, Dict
+from playwright_helper.libs.base_po import BasePo
 from playwright.async_api import Page, TimeoutError as PlaywrightTimeoutError, Locator
 
 
@@ -105,13 +105,11 @@ class DomesticActivityOrderPage(BasePo):
                 # 解析当前页的数据
                 rows = self.parse_tbody_rows(tbody_html=tbody_html, headers=headers)
                 all_rows.extend(rows)
-                print(all_rows)
 
                 # --- 2. 获取当前页数与总页数 ---
                 current_page: int = int(await self.__page.locator('//label[@id="Lab_PageIndex"][1]').inner_text())
                 pages: int = int(await self.__page.locator('//label[@id="Lab_PageCount"][1]').inner_text())
 
-                print(current_page, pages)
                 # --- 3. 如果到最后一页，退出 ---
                 if current_page >= pages:
                     break
@@ -122,7 +120,7 @@ class DomesticActivityOrderPage(BasePo):
                 # 等待页面刷新（简单但稳）
                 await self.__page.wait_for_timeout(timeout=refresh_wait_time)
             except PlaywrightTimeoutError:
-                all_rows.append(dict(error_message=f"元素 '{self.__table_selector}' 未在 {timeout} 秒内找到"))
+                all_rows.append(dict(error_message=f"元素 '{self.__table_selector}' 未在 {refresh_wait_time} 秒内找到"))
             except Exception as e:
                 all_rows.append(dict(error_message=f"检查元素时发生错误: {str(e)}"))
 

qlv_helper/po/login_page.py

@@ -10,7 +10,7 @@
 # ---------------------------------------------------------------------------------------------------------
 """
 from typing import Tuple, Union
-from qlv_helper.po.base_po import BasePo
+from playwright_helper.libs.base_po import BasePo
 from qlv_helper.utils.ocr_helper import get_image_text
 from playwright.async_api import Page, TimeoutError as PlaywrightTimeoutError, Locator
 

qlv_helper/po/main_page.py

@@ -10,8 +10,7 @@
 # ---------------------------------------------------------------------------------------------------------
 """
 from typing import Tuple, Union
-from qlv_helper.po.base_po import BasePo
-from qlv_helper.utils.ocr_helper import get_image_text
+from playwright_helper.libs.base_po import BasePo
 from playwright.async_api import Page, TimeoutError as PlaywrightTimeoutError, Locator
 
 
@@ -42,7 +41,7 @@ class MainPage(BasePo):
         except Exception as e:
             return False, f"检查元素时发生错误: {str(e)}"
 
-    async def get_level1_menu_order_checkout(self) -> Tuple[bool, Union[Locator, str]]:
+    async def get_level1_menu_order_checkout(self, timeout: float = 5.0) -> Tuple[bool, Union[Locator, str]]:
         selector: str = "//span[contains(normalize-space(), '订单出票')]"
         try:
             locator = self.__page.locator(selector)
@@ -56,7 +55,7 @@ class MainPage(BasePo):
         except Exception as e:
             return False, f"检查元素时发生错误: {str(e)}"
 
-    async def get_level2_menu_order_checkout(self) -> Tuple[bool, Union[Locator, str]]:
+    async def get_level2_menu_order_checkout(self, timeout: float = 5.0) -> Tuple[bool, Union[Locator, str]]:
         selector: str = "//a[@menuname='国内活动订单']"
         try:
             locator = self.__page.locator(selector)

qlv_helper/po/order_detail_page.py

@@ -0,0 +1,275 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  qlv-helper
+# FileName:     order_detail_page.py
+# Description:  订单详情页面对象
+# Author:       ASUS
+# CreateDate:   2025/12/16
+# Copyright ©2011-2025. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from typing import Dict, Any, List, Tuple
+from playwright.async_api import Page, Locator
+from playwright_helper.libs.base_po import BasePo
+from qlv_helper.config.url_const import order_detail_url
+
+
+class OrderDetailPage(BasePo):
+    url: str = order_detail_url
+    __page: Page
+
+    def __init__(self, page: Page, url: str = order_detail_url) -> None:
+        super().__init__(page, url)
+        self.url = url
+        self.__page = page
+
+    async def get_order_lock_state_btn(self, timeout: float = 5.0) -> Tuple[str, Locator]:
+        """
+        订单详情页面，获取订单锁单状态按钮
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//div[@class="order_information "]//a[(@class="view_detail_red" and contains(text(), "强制解锁")) or (@class="view_detail_green" and (contains(text(), "锁定") or contains(text(), "解锁返回") or contains(text(), "操作")))]'
+        locator: Locator = await self.get_locator(selector=selector, timeout=timeout)
+        text: str = (await locator.inner_text()).strip()
+        return text, locator
+
+    async def get_out_ticket_platform_type_dropdown(self, timeout: float = 5.0) -> Locator:
+        """
+        订单详情页面，采购信息栏，获取出票地类型下拉菜单按钮
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//table[@id="PurchaseInfos"]//select[@id="OutTktPFTypeID"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_out_ticket_platform_type_select_option(self, select_option: str, timeout: float = 5.0) -> Locator:
+        """
+        订单详情页面，采购信息栏，获取出票地类型下拉菜单选项
+        :param select_option: 要获取的选项
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = f'//table[@id="PurchaseInfos"]//select[@id="OutTktPFTypeID"]/option[contains(text(), "{select_option}")]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_out_ticket_platform_dropdown(self, timeout: float = 5.0) -> Locator:
+        """
+        订单详情页面，采购信息栏，获取出票平台下拉菜单按钮
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//table[@id="PurchaseInfos"]//select[@id="OutTktPF"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_out_ticket_platform_select_option(self, select_option: str, timeout: float = 5.0) -> Locator:
+        """
+        订单详情页面，采购信息栏，获取出票平台下拉菜单选项
+        :param select_option: 要获取的选项
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = f'//table[@id="PurchaseInfos"]//select[@id="OutTktPF"]/option[contains(text(), "{select_option}")]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_out_ticket_account_dropdown(self, timeout: float = 5.0) -> Locator:
+        """
+        订单详情页面，采购信息栏，获取出票账号下拉菜单按钮
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//table[@id="PurchaseInfos"]//select[@id="AccountNumber"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_out_ticket_account_select_option(self, select_option: str, timeout: float = 5.0) -> Locator:
+        """
+        订单详情页面，采购信息栏，获取出票账号下拉菜单选项
+        :param select_option: 要获取的选项
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = f'//table[@id="PurchaseInfos"]//select[@id="AccountNumber"]/option[contains(text(), "{select_option}")]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_purchase_account_type_dropdown(self, timeout: float = 5.0) -> Locator:
+        """
+        订单详情页面，采购信息栏，获取采购账号类型下拉菜单按钮
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//table[@id="PurchaseInfos"]//select[@id="TypeName"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_purchase_account_type_select_option(self, select_option: str, timeout: float = 5.0) -> Locator:
+        """
+        订单详情页面，采购信息栏，获取采购账号类型下拉菜单选项
+        :param select_option: 要获取的选项
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = f'//table[@id="PurchaseInfos"]//select[@id="TypeName"]/option[contains(text(), "{select_option}")]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_purchase_account_dropdown(self, timeout: float = 5.0) -> Locator:
+        """
+        订单详情页面，采购信息栏，获取采购账号下拉菜单按钮
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//table[@id="PurchaseInfos"]//select[@id="PurchaseAccount"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_purchase_account_select_option(self, select_option: str, timeout: float = 5.0) -> Locator:
+        """
+        订单详情页面，采购信息栏，获取采购账号下拉菜单选项
+        :param select_option: 要获取的选项
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = f'//table[@id="PurchaseInfos"]//select[@id="PurchaseAccount"]/option[contains(text(), "{select_option}")]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_purchase_amount_input(self, timeout: float = 5.0) -> Locator:
+        """
+        订单详情页面，采购信息栏，获取采购金额输入框
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//table[@id="PurchaseInfos"]//input[@id="TransactionAmount"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_remark_input(self, timeout: float = 5.0) -> Locator:
+        """
+        订单详情页面，采购信息栏，获取备注输入框，一般输入登录官网的"账号/密码"
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//table[@id="PurchaseInfos"]//input[@id="Remark"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_main_check_input(self, timeout: float = 5.0) -> Locator:
+        """
+        订单详情页面，采购信息栏，获取对账标识输入框，一般输入虚拟卡的card_id
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//table[@id="PurchaseInfos"]//input[@id="MainCheckNumber"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_air_comp_order_id_input(self, timeout: float = 5.0) -> Locator:
+        """
+        订单详情页面，采购信息栏，获取官网订单号输入框
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//table[@id="PurchaseInfos"]//input[@id="AirCoOrderID"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_procurement_info_save_btn(self, timeout: float = 5.0) -> Locator:
+        """
+        订单详情页面，采购信息栏，获取【保存采购】按钮
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//table[@id="PurchaseInfos"]//input[@id="submit"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_passenger_itinerary_locators(self, timeout: float = 5.0) -> List[Dict[str, Any]]:
+        """
+        订单详情页面，乘客信息栏，获取票号输入框
+        :param timeout：超时时间（秒）
+        :return: List[{
+                    "username": str,
+                    "id_number": str,
+                    "locator": Locator  # 指向 <input name="ticketNo">
+                    }]
+        """
+        results = list()
+        tbody_selector: str = '(//div[@class="order_information"]//table[@class="table table_border table_center"]/tbody)[3]'
+        tbody_locator: Locator = await self.get_locator(selector=tbody_selector, timeout=timeout)
+        # 只选真正的数据行（有 pid / ticketNo 的 tr）
+        rows = tbody_locator.locator("tr[pid]")
+        row_count = await rows.count()
+        for i in range(row_count):
+            row = rows.nth(i)
+
+            out_ticket_state: Locator = await self.get_sub_locator(
+                locator=row, selector='xpath=(.//td)[1]', timeout=timeout
+            )
+            out_ticket_state_text = (await out_ticket_state.inner_text()).strip()
+            if "已出票" in out_ticket_state_text:
+                continue
+
+            # 1️⃣ 用户名
+            name_locator = await self.get_sub_locator(
+                locator=row, selector='xpath=.//span[@name="pname"]', timeout=timeout
+            )
+            username = (await name_locator.first.inner_text()).strip()
+
+            # 2️⃣ 身份证号
+            # a 标签里：javascript:showIDNo('身份证号', ...)
+            id_link = await self.get_sub_locator(locator=row, selector='xpath=.//a[starts-with(@id, "IDNo_")]',
+                                                 timeout=timeout)
+
+            href = await id_link.first.get_attribute("href")
+            # href 示例：
+            # javascript:showIDNo('320324198511254466','175687',...)
+
+            id_number = None
+            if href:
+                # 非正则版本，更安全
+                start = href.find("'") + 1
+                end = href.find("'", start)
+                id_number = href[start:end]
+
+            # 3️⃣ ticketNo 输入框 locator
+            ticket_input = await self.get_sub_locator(locator=row, selector='xpath=.//input[@name="ticketNo"]',
+                                                      timeout=timeout)
+
+            # 防御性校验（可选）
+            if await ticket_input.count() == 0:
+                continue
+
+            results.append({
+                "username": username,
+                "id_number": id_number,
+                "locator": ticket_input  # Playwright Locator 对象
+            })
+        return results
+
+    async def get_custom_remark_input(self, timeout: float = 5.0) -> Locator:
+        """
+        订单详情页面，日志记录栏，获取自定义备注输入框
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//input[@id="rmk"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_custom_remark_save_btn(self, timeout: float = 5.0) -> Locator:
+        """
+        订单详情页面，日志记录栏，获取【保存备注】按钮
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//a[@href="javascript:fnSaveRemark()"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_message_notice_dialog_confirm_btn(self, timeout: float = 5.0) -> Locator:
+        """
+        订单详情页面，消息提醒弹框，获取【确认】按钮
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//a[@id="alertMsg_btnConfirm"]/cite'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_policy_input(self, timeout: float = 5.0) -> Locator:
+        """
+        订单详情页面，获取政策代码输入框
+        :param timeout:
+        :return:
+        """
+        selector: str = '//legend//input[@name="PolicyName"]'
+        return await self.get_locator(selector=selector, timeout=timeout)

qlv_helper/po/wechat_auth_page.py

@@ -12,7 +12,7 @@
 import os
 import asyncio
 from typing import Tuple, Union
-from qlv_helper.po.base_po import BasePo
+from playwright_helper.libs.base_po import BasePo
 from qlv_helper.utils.file_handle import get_caller_dir
 from qlv_helper.utils.windows_utils import gen_allow_btn_image, windows_on_click
 from playwright.async_api import Page, TimeoutError as PlaywrightTimeoutError, Locator

qlv_helper/po/base_po.py

@@ -1,40 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-# ---------------------------------------------------------------------------------------------------------
-# ProjectName:  qlv-helper
-# FileName:     base_po.py
-# Description:  po对象基础类
-# Author:       ASUS
-# CreateDate:   2025/11/25
-# Copyright ©2011-2025. Hunan xxxxxxx Company limited. All rights reserved.
-# ---------------------------------------------------------------------------------------------------------
-"""
-from typing import List
-from playwright.async_api import Page
-
-
-class BasePo(object):
-    __page: Page
-
-    def __init__(self, page: Page, url: str):
-        self.url = url
-        self.__page = page
-        if self.is_current_page() is False:
-            raise ValueError("page参数值无效")
-
-    def get_page(self) -> Page:
-        return self.__page
-
-    def is_current_page(self) -> bool:
-        url = self.__page.url.split("?")[0]
-        if isinstance(self.__page, Page) and url.endswith(self.url):
-            return True
-        else:
-            return False
-
-    def get_url_domain(self) -> str:
-        if isinstance(self.__page, Page):
-            page_slice: List[str] = self.__page.url.split("/")
-            return f"{page_slice[0]}://{page_slice[2]}"
-        else:
-            raise AttributeError("PO对象中的page属性未被初始化")