flight-helper 0.0.3__tar.gz → 0.3.6__tar.gz

{flight_helper-0.0.3 → flight_helper-0.3.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flight_helper
-Version: 0.0.3
+Version: 0.3.6
 Summary: flight helper python package
 Author-email: ckf10000 <ckf10000@sina.com>
 License:                                  Apache License

{flight_helper-0.0.3 → flight_helper-0.3.6}/flight_helper/models/dto/booking.py

@@ -11,17 +11,42 @@
 """
 from typing import Optional
 from flight_helper.validator.type_validator import parse_to_date_str
-from pydantic import BaseModel, model_validator, PositiveInt, PositiveFloat, NonNegativeFloat, Field, field_validator
+from pydantic import BaseModel, model_validator, PositiveInt, NonNegativeFloat, Field, field_validator
 
 
-class OneWayBookingDTO(BaseModel):
+class BookingInputDTO(BaseModel):
     # 平台信息
-    book_domain: Optional[str] = Field(default=None, description="预订平台域名，例如：www.ceair.com")
-    book_protocol: Optional[str] = Field(default=None, description="预订平台协议，例如：https")
+    book_domain: str = Field(..., description="预订平台域名，例如：www.ceair.com")
+    book_protocol: str = Field(..., description="预订平台协议，例如：https")
+
+    book_login_user: str = Field(..., description="预订平台登录用户")
+    book_password: str = Field(..., description="预订平台登录密码")
+
+    # 产品
+    product_type: str = Field(..., description="产品类型，如：经济舱、超级经济舱等")
+    product_name: Optional[str] = Field(default=None, description="产品名称，如：C919特惠，老年特惠")
+
+    sale_increase_threshold: NonNegativeFloat = Field(
+        default=0.0, description="涨价上限（相对于 sale_price 的绝对值或百分比？按业务定）"
+    )
+    sale_reduction_threshold: NonNegativeFloat = Field(
+        default=0.0, description="降价上限（相对于 sale_price 的绝对值或百分比？按业务定）"
+    )
+    standard_increase_threshold: NonNegativeFloat = Field(
+        default=0.0, description="涨价上限（相对于 standard_price 的绝对值或百分比？按业务定）"
+    )
+    standard_reduction_threshold: NonNegativeFloat = Field(
+        default=0.0, description="降价上限（相对于 standard_price 的绝对值或百分比？按业务定）"
+    )
 
-    book_login_user: Optional[str] = Field(default=None, description="预订平台登录用户")
-    book_password: Optional[str] = Field(default=None, description="预订平台登录密码")
+    # 服务联系人
+    specialist_name: Optional[str] = Field(default=None, description="退改联系人姓名")
+    specialist_mobile: Optional[str] = Field(default=None, description="电话")
+    specialist_email: Optional[str] = Field(default=None, description="邮箱")
 
+
+class OneWayBookingDTO(BaseModel):
+    order_no: PositiveInt = Field(..., description="报表平台的订单号")
     # 航班信息
     dep_city: str = Field(..., description="起飞城市（中文）")
     arr_city: str = Field(..., description="抵达城市（中文）")
@@ -37,28 +62,9 @@ class OneWayBookingDTO(BaseModel):
     children: Optional[PositiveInt] = Field(default=None, description="儿童数量（如提供，必须 ≥1；未提供则视为无儿童）")
     infant: Optional[PositiveInt] = Field(default=None, description="婴儿数量（如提供，必须 ≥1；未提供则视为无婴儿）")
 
-    # 产品与价格
-    product_type: str = Field(..., description="产品类型，如：经济舱、超级经济舱等")
-    product_name: Optional[str] = Field(default=None, description="产品名称，如：C919特惠，老年特惠")
-    sale_price: Optional[PositiveFloat] = Field(default=None, description="预期销售价")
-    standard_price: PositiveFloat = Field(..., description="预期票面价（应 ≥ sale_price）")
-    sale_increase_threshold: Optional[NonNegativeFloat] = Field(
-        default=0.00, description="涨价上限（相对于 sale_price 的绝对值或百分比？按业务定）"
-    )
-    sale_reduction_threshold: Optional[NonNegativeFloat] = Field(
-        default=0.00, description="降价上限（相对于 sale_price 的绝对值或百分比？按业务定）"
-    )
-    standard_increase_threshold: Optional[NonNegativeFloat] = Field(
-        default=0.00, description="涨价上限（相对于 standard_price 的绝对值或百分比？按业务定）"
-    )
-    standard_reduction_threshold: Optional[NonNegativeFloat] = Field(
-        default=0.00, description="降价上限（相对于 standard_price 的绝对值或百分比？按业务定）"
-    )
-
-    # 服务联系人
-    specialist_name: Optional[str] = Field(default=None, description="退改联系人姓名")
-    specialist_mobile: Optional[str] = Field(default=None, description="电话")
-    specialist_email: Optional[str] = Field(default=None, description="邮箱")
+    # 价格
+    sale_price: NonNegativeFloat = Field(default=0.0, description="预期销售价")
+    standard_price: NonNegativeFloat = Field(default=0.0, description="预期票面价（应 ≥ sale_price）")
 
     @field_validator("dep_date")
     @classmethod

flight_helper-0.3.6/flight_helper/models/dto/http_schema.py

@@ -0,0 +1,31 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-flight-helper
+# FileName:     http_schema.py
+# Description:  http请求参数基础模型
+# Author:       ASUS
+# CreateDate:   2026/01/13
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from typing import Optional, Dict, Any
+from pydantic import BaseModel, Field, PositiveInt, NonNegativeInt
+
+
+class HTTPRequestDTO(BaseModel):
+    # 平台信息
+    http_domain: Optional[str] = Field(default=None, description="平台域名，例如：www.ceair.com")
+    http_protocol: Optional[str] = Field(default=None, description="平台协议，例如：https")
+    storage_state: Optional[Dict[str, Any]] = Field(
+        default=None, description="playwright 爬取的用户登录状态没礼貌包含了cookie和origin"
+    )
+    timeout: Optional[PositiveInt] = Field(default=60, description="请求超时时间")
+    retry: Optional[NonNegativeInt] = Field(default=0, description="重试次数")
+    enable_log: Optional[bool] = Field(default=True, description="是否打印日志")
+    token: Optional[str] = Field(default=None, description="token值")
+    json_data: Optional[Dict[str, Any]] = Field(default=None, description="json参数")
+    params_data: Optional[Dict[str, Any]] = Field(default=None, description="params参数")
+    data: Optional[Dict[str, Any]] = Field(default=None, description="data参数")
+    proxy: Optional[Dict[str, Any]] = Field(default=None, description="http的代理配置")
+    headers: Optional[Dict[str, Any]] = Field(default=None, description="自定义的http headers")

{flight_helper-0.0.3 → flight_helper-0.3.6}/flight_helper/models/dto/itinerary.py

@@ -9,9 +9,8 @@
 # Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
 # ---------------------------------------------------------------------------------------------------------
 """
-from aiohttp import CookieJar
 from typing import Optional, List, Dict, Any
-from pydantic import BaseModel, NonNegativeFloat, Field, field_validator
+from pydantic import BaseModel, NonNegativeFloat, Field, field_validator, PositiveInt
 
 
 class ItineraryInfoDTO(BaseModel):
@@ -23,16 +22,16 @@ class ItineraryInfoDTO(BaseModel):
 
 
 class QueryItineraryResponseDTO(BaseModel):
-    order_no: Optional[str] = Field(default=None, description="业务平台订单号")
+    order_no: Optional[PositiveInt] = Field(default=None, description="业务平台订单号")
     pre_order_no: str = Field(..., description="采购平台订单号")
     order_status: Optional[str] = Field(default=None, description="采购平台订单状态")
-    order_amount: Optional[NonNegativeFloat] = Field(default=None, description="采购平台订单金额")
+    order_amount: NonNegativeFloat = Field(default=0.0, description="采购平台订单金额")
     cash_unit: Optional[str] = Field(default=None, description="采购金额的币种")
     itinerary_info: List[ItineraryInfoDTO] = Field(..., description="乘客行程单信息")
 
     @field_validator("itinerary_info")
     @classmethod
-    def validate_non_empty(cls, info, v: List[ItineraryInfoDTO]):
+    def validate_non_empty(cls, v: List[ItineraryInfoDTO], info):
         if len(v) == 0:
             raise ValueError("至少需要一个乘客行程")
         # 获取外层的 pre_order_no
@@ -55,4 +54,3 @@ class QueryItineraryRequestDTO(BaseModel):
     user_id: Optional[str] = Field(default=None, description="采购平台登录用户的ID")
     proxy: Optional[Dict[str, Any]] = Field(default=None, description="http的代理配置")
     headers: Optional[Dict[str, Any]] = Field(default=None, description="自定义的http headers")
-    cookie_jar: Optional[CookieJar] = Field(default=None, description="自定义的CookieJar对象")

{flight_helper-0.0.3 → flight_helper-0.3.6}/flight_helper/models/dto/passenger.py

@@ -10,10 +10,11 @@
 # ---------------------------------------------------------------------------------------------------------
 """
 from typing import Optional, Literal
-from pydantic import BaseModel, Field
+from pydantic import BaseModel, Field, PositiveInt
 
 
 class PassengerDTO(BaseModel):
+    segment_index: PositiveInt = Field(..., description="航段索引")
     # 乘客基本信息
     passenger_type: Literal["成人", "儿童", "婴儿"] = Field(
         ..., description="乘客类型，必须是：成人、儿童 或 婴儿"
@@ -21,14 +22,17 @@ class PassengerDTO(BaseModel):
     passenger_name: str = Field(
         ..., description="乘客法定姓名（按证件填写），如：Zhang San 或 张三"
     )
-    passenger_alias: Optional[str] = Field(
-        default=None,
-        description="乘客中文常用名（仅外国人使用），如：汤姆（对应 Tom）"
-    )
-
     # 性别与证件
     gender: Literal["男", "女"] = Field(..., description='性别，只能是"男"或"女"')
     id_type: Literal["身份证", "港澳通行证", "护照", "军官证", "回乡证"] = Field(
         ..., description='证件类型'
     )
     id_number: str = Field(..., description="证件号码（按证件如实填写）")
+
+    passenger_id: Optional[str] = Field(default=None, description="乘客ID")
+    flight_id: Optional[str] = Field(default=None, description="乘客航段ID")
+    table_id: Optional[str] = Field(default=None, description="乘客制表ID")
+    passenger_alias: Optional[str] = Field(
+        default=None,
+        description="乘客中文常用名（仅外国人使用），如：汤姆（对应 Tom）"
+    )

{flight_helper-0.0.3 → flight_helper-0.3.6}/flight_helper/models/dto/payment.py

@@ -10,28 +10,31 @@
 # ---------------------------------------------------------------------------------------------------------
 """
 from typing import Literal, Optional, Union, Annotated
-from pydantic import BaseModel, Field, TypeAdapter, NonNegativeFloat
+from pydantic import BaseModel, Field, TypeAdapter, NonNegativeFloat, PositiveInt
 
-SupportedChannels = Literal["微信", "支付宝", "汇付天下", "易宝支付"]
+SupportedChannels = Literal["微信", "支付宝", "汇付天下", "易宝支付", "空中云汇", "快钱"]
 
 
 class __BasePaymentDTO(BaseModel):
-    pay_domain: Optional[str] = Field(default=None, description="支付在线收银台域名，例如：www.ceair.com")
-    pay_protocol: Optional[str] = Field(default=None, description="支付在线收银台协议，例如：https")
-
-    channel_name: SupportedChannels = Field(
-        ..., description=f'支付渠道，只能是其中之一：{SupportedChannels}'
-    )
+    channel_name: SupportedChannels = Field(..., description=f'支付渠道，只能是其中之一：{SupportedChannels}')
     payment_type: str = Field(..., description="支付方式")
-    order_no: str = Field(..., description="报表平台订单号")
-    pre_order_no: Optional[str] = Field(default=None, description="采购平台订单号")
     account: Optional[str] = Field(default=None, description="支付账号")
     password: Optional[str] = Field(default=None, description="账号密码")
+
+
+class PaymentResultDTO(__BasePaymentDTO):
+    order_no: PositiveInt = Field(..., description="报表平台订单号")
+    pre_order_no: Optional[str] = Field(default=None, description="采购平台订单号")
     pay_transaction: Optional[str] = Field(default=None, description="支付流水")
-    pay_amount: Optional[NonNegativeFloat] = Field(default=None, description="支付金额")
+    pay_amount: NonNegativeFloat = Field(default=0.0, description="支付金额")
 
 
-class YBAccountPaymentDTO(__BasePaymentDTO):
+class __BasePaymentInputDTO(__BasePaymentDTO):
+    pay_domain: Optional[str] = Field(default=None, description="支付在线收银台域名，例如：www.ceair.com")
+    pay_protocol: Optional[str] = Field(default=None, description="支付在线收银台协议，例如：https")
+
+
+class YBAccountPaymentInputDTO(__BasePaymentInputDTO):
     """易宝支付-账号支付"""
     channel_name: Literal["易宝支付"] = Field(..., description="支付渠道")
     payment_type: Literal["账户支付"] = Field(..., description="支付方式")
@@ -39,17 +42,17 @@ class YBAccountPaymentDTO(__BasePaymentDTO):
     password: str = Field(..., description="账号密码")
 
 
-class WeChatPaymentDTO(__BasePaymentDTO):
+class WeChatPaymentInputDTO(__BasePaymentInputDTO):
     channel_name: Literal["微信"] = Field(..., description="支付渠道")
     payment_type: Literal["二维码识别"] = Field(..., description="支付方式")
 
 
-class AlipayPaymentDTO(__BasePaymentDTO):
+class AlipayPaymentInputDTO(__BasePaymentInputDTO):
     channel_name: Literal["支付宝"] = Field(..., description="支付渠道")
     payment_type: Literal["二维码识别"] = Field(..., description="支付方式")
 
 
-class HFPaidAccountPaymentDTO(__BasePaymentDTO):
+class HFPaidAccountPaymentInputDTO(__BasePaymentInputDTO):
     """汇付天下-付款账户支付"""
     channel_name: Literal["汇付天下"] = Field(..., description="支付渠道")
     payment_type: Literal["付款账户支付"] = Field(..., description="支付方式")
@@ -57,13 +60,48 @@ class HFPaidAccountPaymentDTO(__BasePaymentDTO):
     password: str = Field(..., description="操作员交易密码")
 
 
+class AirwallexVCCPaymentInputDTO(__BasePaymentInputDTO):
+    """空中云汇-VCC支付"""
+    channel_name: Literal["空中云汇"] = Field(..., description="支付渠道")
+    payment_type: Literal["VCC"] = Field(..., description="支付方式")
+
+
+class Bill99AccountPaymentInputDTO(__BasePaymentInputDTO):
+    """快钱-快钱账户支付"""
+    channel_name: Literal["快钱"] = Field(..., description="支付渠道")
+    payment_type: Literal["快钱账户"] = Field(..., description="支付方式")
+    account: str = Field(..., description="快钱账户")
+
+
+class AirwallexVCCPaymentInfoDTO(AirwallexVCCPaymentInputDTO):
+    first_name: str = Field(..., description="名字")
+    last_name: str = Field(..., description="姓氏")
+    id_number: str = Field(..., description="证件号码")
+    email: str = Field(..., description="电子邮箱")
+    mobile: str = Field(..., description="手机号码")
+    id_type: str = Field(..., description="证件类型")
+    country: str = Field(..., description="国家/地区")
+    state: str = Field(..., description="省/州")
+    city: str = Field(..., description="城市")
+    street: str = Field(..., description="街道名称")
+    house_number: str = Field(..., description="门牌号码")
+    postal_code: str = Field(..., description="邮编")
+    card_number: Optional[str] = Field(default=None, description="卡号")
+    expiry_year: Optional[PositiveInt] = Field(default=None, description="有效年份")
+    expiry_month: Optional[PositiveInt] = Field(default=None, description="有效月份")
+    card_id: Optional[str] = Field(..., description="虚拟卡ID")
+    cvv: Optional[str] = Field(..., description="cvv")
+
+
 # 3. 创建联合类型，并指定 discriminator
-PaymentRuestDTO = Annotated[
+PaymentInputDTO = Annotated[
     Union[
-        YBAccountPaymentDTO,
-        WeChatPaymentDTO,
-        AlipayPaymentDTO,
-        HFPaidAccountPaymentDTO,
+        YBAccountPaymentInputDTO,
+        WeChatPaymentInputDTO,
+        AlipayPaymentInputDTO,
+        HFPaidAccountPaymentInputDTO,
+        AirwallexVCCPaymentInputDTO,
+        Bill99AccountPaymentInputDTO
         # TODO ... 其他支付方式
     ],
     Field(discriminator='channel_name')  # 或者用 'payment_type'，看业务
@@ -71,27 +109,26 @@ PaymentRuestDTO = Annotated[
 
 if __name__ == '__main__':
     # 创建适配器
-    adapter = TypeAdapter(PaymentRuestDTO)
+    adapter = TypeAdapter(PaymentInputDTO)
 
     # 测试 1: 易宝支付
     yb_data = {
-        "order_no": "1312312",
+        "order_no": 1312312,
         "channel_name": "易宝支付",
         "payment_type": "账户支付",
         "account": "yb123",
-        "password": "pass123"
+        "password": "pass123",
+        "pay_amount": 0.00
     }
-    yb = YBAccountPaymentDTO(**yb_data)
-    yb.pay_transaction = "112312"
+    yb = PaymentResultDTO(**yb_data)
     print(yb)
     yb_payment = adapter.validate_python(yb_data)
-    yb_payment.pay_transaction = "123123123"
     print(yb_payment)
     print(type(yb_payment))  # <class '__main__.YBAccountPayment'>
 
     # 测试 2: 微信支付
     wx_data = {
-        "order_no": "1312312",
+        "order_no": 1312312,
         "channel_name": "微信",
         "payment_type": "二维码识别",
         # account/password 可省略（Optional）

flight_helper-0.3.6/flight_helper/models/dto/procurement.py

@@ -0,0 +1,56 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-flight-helper
+# FileName:     procurement.py
+# Description:  采购信息数据转换对象
+# Author:       ASUS
+# CreateDate:   2026/01/08
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from typing import Optional, List, Literal
+from pydantic import BaseModel, PositiveInt, NonNegativeFloat, Field
+
+
+class ProcurementInputDTO(BaseModel):
+    # 平台信息
+    pl_domain: str = Field(..., description="平台域名，例如：www.ceair.com")
+    pl_protocol: str = Field(..., description="平台协议，例如：https")
+    out_ticket_platform_type: str = Field(..., description="出票平台类型")
+    out_ticket_platform: str = Field(..., description="出票平台")
+    account_number: str = Field(..., description="出票账号")
+    type_name: str = Field(..., description="采购账号类型")
+    purchase_account: str = Field(..., description="采购账号")
+    pl_login_user: str = Field(..., description="采购平台登录账号")
+    pl_login_password: str = Field(..., description="采购平台登录密码")
+    remark: str = Field(..., description="备注，一般是由采购平台登录账号 + 采购平台登录密码拼接而成")
+
+    out_ticket_account: Optional[str] = Field(default=None, description="账号")
+    out_ticket_account_id: Optional[int] = Field(default=None, description="账号ID")
+    out_ticket_account_password: Optional[str] = Field(default=None, description="密码")
+    purchase_account_id: Optional[int] = Field(default=None, description="采购账号ID")
+    out_ticket_platform_type_id: Optional[int] = Field(default=None, description="出票平台类型ID")
+    out_ticket_mobile: Optional[str] = Field(default=None, description="出票手机，退改业务需要根据此手机号码来进行操作")
+
+
+class ProcurementReusltDTO(BaseModel):
+    # 平台信息
+    order_no: PositiveInt = Field(..., description="报表平台的订单号")
+    air_co_order_id: str = Field(..., description="官网订单号")
+    transaction_amount: NonNegativeFloat = Field(..., description="采购金额")
+    passenger_type: Literal["成人", "儿童", "婴儿"] = Field(
+        ..., description="乘客类型，必须是：成人、儿童 或 婴儿"
+    )
+
+    passenger_names: Optional[List[str]] = Field(default=None, description="采购乘客")
+    segment_index: Optional[PositiveInt] = Field(default=None, description="航段索引")
+    flight_ids: Optional[str] = Field(default=None, description="乘客航段ID")
+    passenger_ids: Optional[List[str]] = Field(default=None, description="乘客ID列表")
+    pay_transaction: Optional[str] = Field(default=None, description="对账标识")
+
+
+class FillProcurementInputDTO(ProcurementInputDTO, ProcurementReusltDTO):
+    order_no: Optional[PositiveInt] = Field(default=None, description="报表平台的订单号")
+    transaction_amount: Optional[NonNegativeFloat] = Field(default=None, description="采购金额")
+    air_co_order_id: Optional[str] = Field(default=None, description="官网订单号")

flight_helper-0.3.6/flight_helper/utils/__init__.py

@@ -0,0 +1,11 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-flight-helper
+# FileName:     __init__.py
+# Description:  工具包
+# Author:       ASUS
+# CreateDate:   2026/01/11
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""

flight_helper-0.3.6/flight_helper/utils/exception_utils.py

@@ -0,0 +1,138 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-flight-helper
+# FileName:     exception_utils.py
+# Description:  异常类工具模块
+# Author:       ASUS
+# CreateDate:   2026/01/11
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from typing import Literal
+
+
+class DuplicatePaymentError(Exception):
+    def __init__(self, order_no: int):
+        self.order_no = order_no
+        super().__init__(f"订单<{order_no}>重复支付")
+
+
+class DuplicateBookingError(Exception):
+    def __init__(self, message):
+        super().__init__(message)
+
+
+class NotEnoughTicketsError(Exception):
+    def __init__(self, flight_no: str, seats_status: int, passengers: int):
+        self.flight_no = flight_no
+        self.seats_status = seats_status
+        self.passengers = passengers
+        super().__init__(f"采购平台显示航班<{flight_no}>的余票<{seats_status}>少于乘客人数<{passengers}>")
+
+
+class ExcessiveProfitdError(Exception):
+    def __init__(
+            self, flight_no: str, query_price: float, order_price: float, reduction_threshold: float,
+            asset: Literal["票面价", "销售价"] = "票面价"
+    ):
+        self.flight_no = flight_no
+        self.query_price = query_price
+        self.order_price = order_price
+        self.reduction_threshold = reduction_threshold
+        self.asset = asset
+        super().__init__(
+            f"航班<{flight_no}>采购平台价：{query_price} 低于：订单{asset}[{order_price}] - 下降阈值[{reduction_threshold}]，收益过高"
+        )
+
+
+class ExcessiveLossesError(Exception):
+    def __init__(
+            self, flight_no: str, query_price: float, order_price: float, increase_threshold: float,
+            asset: Literal["票面价", "销售价"] = "票面价"
+    ):
+        self.flight_no = flight_no
+        self.query_price = query_price
+        self.order_price = order_price
+        self.increase_threshold = increase_threshold
+        self.asset = asset
+        super().__init__(
+            f"航班<{flight_no}>官网价：{query_price} 高于：订单{asset}[{order_price}] + 上浮阈值[{increase_threshold}]，亏损太多"
+        )
+
+
+class PaymentChannelError(Exception):
+    def __init__(self, channel_name: str):
+        self.channel_name = channel_name
+        super().__init__(f"支付渠道<{channel_name}>暂不支持")
+
+
+class PaymentChannelMissError(Exception):
+    def __init__(self):
+        super().__init__(f"支付渠道参数丢失")
+
+
+class PaymentTypeError(Exception):
+    def __init__(self, payment_type: str):
+        self.payment_type = payment_type
+        super().__init__(f"付款方式<{payment_type}>暂不支持")
+
+
+class PassengerTypeError(Exception):
+    def __init__(self, passenger_type: str):
+        self.passenger_type = passenger_type
+        super().__init__(f"乘客类型<{passenger_type}>暂不支持")
+
+
+class ProductTypeError(Exception):
+    def __init__(self, product_type: str):
+        self.product_type = product_type
+        super().__init__(f"产品类型<{product_type}>暂不支持")
+
+
+class HFPaymentTypeError(Exception):
+    def __init__(self, payment_type: str):
+        self.payment_type = payment_type
+        super().__init__(f"汇付天下的付款方式<{payment_type}>暂不支持")
+
+
+class PaymentFailedError(Exception):
+    def __init__(self, pre_order_no: str, order_status: str):
+        self.pre_order_no = pre_order_no
+        self.order_status = order_status
+        super().__init__(f"采购平台订单<{pre_order_no}>支付失败，支付结束后的状态<{order_status}>")
+
+
+class PaymentFailError(Exception):
+    def __init__(self, message: str):
+        self.message = message
+        super().__init__(message)
+
+
+class IPBlockError(Exception):
+
+    def __init__(self, message: str):
+        self.message = message
+        super().__init__(message)
+
+
+class RelationOrderConflictError(Exception):
+
+    def __init__(self, message: str):
+        super().__init__(message)
+
+class LockedOrderFailedError(Exception):
+
+    def __init__(self, message: str):
+        super().__init__(message)
+
+
+class OrderLimitError(Exception):
+    def __init__(self, user_id: str, message: str):
+        self.user_id = user_id
+        super().__init__(f"用户<{user_id}>已受限，{message}")
+
+class UserNotLoginError(Exception):
+
+    def __init__(self, message: str):
+        super().__init__(message)

{flight_helper-0.0.3 → flight_helper-0.3.6}/flight_helper.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flight_helper
-Version: 0.0.3
+Version: 0.3.6
 Summary: flight helper python package
 Author-email: ckf10000 <ckf10000@sina.com>
 License:                                  Apache License

{flight_helper-0.0.3 → flight_helper-0.3.6}/flight_helper.egg-info/SOURCES.txt

@@ -10,9 +10,12 @@ flight_helper.egg-info/top_level.txt
 flight_helper/models/__init__.py
 flight_helper/models/dto/__init__.py
 flight_helper/models/dto/booking.py
+flight_helper/models/dto/http_schema.py
 flight_helper/models/dto/itinerary.py
 flight_helper/models/dto/passenger.py
 flight_helper/models/dto/payment.py
 flight_helper/models/dto/procurement.py
+flight_helper/utils/__init__.py
+flight_helper/utils/exception_utils.py
 flight_helper/validator/__init__.py
 flight_helper/validator/type_validator.py

{flight_helper-0.0.3 → flight_helper-0.3.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "flight_helper"                             # pip包名（不要大写）
-version = "0.0.3"                                  # 版本号
+version = "0.3.6"                                  # 版本号
 description = "flight helper python package"
 readme = "README.md"
 requires-python = ">=3.12"                         # Python 版本要求

flight_helper-0.0.3/flight_helper/models/dto/procurement.py

@@ -1,30 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-# ---------------------------------------------------------------------------------------------------------
-# ProjectName:  python-flight-helper
-# FileName:     procurement.py
-# Description:  采购信息数据转换对象
-# Author:       ASUS
-# CreateDate:   2026/01/08
-# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
-# ---------------------------------------------------------------------------------------------------------
-"""
-from typing import Optional
-from pydantic import BaseModel, PositiveInt, NegativeFloat, Field
-
-
-class ProcurementDTO(BaseModel):
-    # 平台信息
-    pl_domain: Optional[str] = Field(default=None, description="平台域名，例如：www.ceair.com")
-    pl_protocol: Optional[str] = Field(default=None, description="平台协议，例如：https")
-    order_no: PositiveInt = Field(..., description="订单号")
-    out_ticket_platform_type: str = Field(..., description="出票平台类型")
-    out_ticket_platform: str = Field(..., description="出票平台")
-    out_ticket_account: str = Field(..., description="出票账号")
-    purchase_account_type: str = Field(..., description="采购账号类型")
-    purchase_account: str = Field(..., description="采购账号")
-    purchase_amount: NegativeFloat = Field(..., description="采购金额")
-    remark: str = Field(..., description="备注，一般是由采购平台账号 + 账号密码拼接而成")
-    out_ticket_mobile: str = Field(..., description="出票手机，退改业务需要根据此手机号码来进行操作")
-    pay_transaction: str = Field(..., description="支付流水")
-    pre_order_no: str = Field(..., description="采购平台订单号")