py_wisharetec_toolkit 3.0.2__py3-none-any.whl

py_wisharetec_toolkit/shanshu/models.py

@@ -0,0 +1,1276 @@
+#!/usr/bin/env python3
+# -*- coding: UTF-8 -*-
+
+"""Shanshu API 返回模型与响应解析。
+
+所有接口返回的结构化校验均在此使用 pydantic 实现。
+仅对 ``code`` 字段做判断，其余字段允许任意属性。
+"""
+
+from __future__ import annotations
+
+from typing import Any, Generic, TypeVar
+
+from pydantic import BaseModel, Field, ConfigDict
+
+T = TypeVar("T")
+
+
+class ShanshuLoginError(RuntimeError):
+    """Shanshu 登录业务异常（返回体包含 ``code`` 字段视为登录失败）。"""
+
+
+class ShanshuBaseResponse(BaseModel):
+    """通用 API 响应模型。
+
+    - ``code`` 存在即视为业务失败；
+    - 允许额外任意属性。
+    """
+
+    model_config = ConfigDict(extra="allow")
+
+    code: int | None = Field(default=None, description="业务状态码，存在即视为失败")
+
+    @property
+    def ok(self) -> bool:
+        """返回体不包含 ``code`` 字段即视为成功。"""
+        return self.code is None
+
+
+class ShanshuLoginResponse(ShanshuBaseResponse):
+    """登录接口响应模型（返回体不含 ``code`` 字段即为成功）。"""
+
+
+class ShanshuCommunityRecord(BaseModel):
+    """园区档案记录（前台分页接口 records 数组中的单条记录）。
+
+    列出已知字段，其余字段通过 ``extra="allow"`` 接收，兼容任意属性。
+    """
+
+    model_config = ConfigDict(extra="allow")
+
+    id: str | None = None
+    name: str | None = None
+    code: str | None = None
+    cover: str | None = None
+    province: str | None = None
+    city: str | None = None
+    area: str | None = None
+    shequ: str | None = None
+    street: str | None = None
+    longitude: str | None = None
+    latitude: str | None = None
+    type: Any = None
+    typeName: str | None = None
+    stage: str | None = None
+    ownership: int | None = None
+    buildArea: Any = None
+    contacts: Any = None
+    serialNumber: str | None = None
+    contactsPhone: str | None = None
+    developer: str | None = None
+    developerNames: Any = None
+    state: int | None = None
+    tenantId: str | None = None
+    disabled: int | None = None
+    creator: str | None = None
+    operator: str | None = None
+    creatorName: str | None = None
+    operatorName: str | None = None
+    gmtCreate: str | None = None
+    gmtModify: str | None = None
+    orgId: Any = None
+    orgIds: list[Any] | None = None
+    orgNames: list[Any] | None = None
+    typeNameFlag: str | None = None
+    takeOverDate: Any = None
+    orgFinanceId: Any = None
+    orgFinanceName: Any = None
+    totalHouses: int | None = None
+    streetCommunity: str | None = None
+    totalHouseArea: str | None = None
+    expectedRentYearAmount: str | None = None
+    expectedYearManagementFee: str | None = None
+    currentOccupancyRate: str | None = None
+
+
+class ShanshuPageResponse(ShanshuBaseResponse, Generic[T]):
+    """分页响应模型。
+
+    继承 ``ShanshuBaseResponse``，``code`` 存在即视为失败；
+    ``records`` 为泛型列表，兼容任意记录类型。
+    """
+
+    pageNum: int = Field(default=1, description="页码")
+    pageSize: int = Field(default=20, description="每页大小")
+    total: int = Field(default=0, description="总记录数")
+    last: bool = Field(default=False, description="是否最后一页")
+    records: list[T] | None = Field(default=None, description="记录列表")
+
+
+class ShanshuCommunityPageResponse(ShanshuPageResponse[ShanshuCommunityRecord]):
+    """园区档案分页响应模型。"""
+
+
+class ShanshuPropertyRecord(BaseModel):
+    """房产档案记录（房产分页接口 records 数组中的单条记录）。
+
+    列出已知字段，其余字段通过 ``extra="allow"`` 接收，兼容任意属性。
+    """
+
+    model_config = ConfigDict(extra="allow")
+
+    id: int | None = None
+    type: int | None = None
+    typeName: str | None = None
+    communityId: str | None = None
+    pid: str | None = None
+    name: str | None = None
+    standardSpaceName: str | None = None
+    ownership: int | None = None
+    houseOwnership: Any = None
+    houseOwnershipName: Any = None
+    ownershipName: Any = None
+    isAsset: int | None = None
+    typeNameFlag: str | None = None
+    deleted: int | None = None
+    creatorName: str | None = None
+    operatorName: str | None = None
+    creator: str | None = None
+    operator: str | None = None
+    gmtCreate: str | None = None
+    gmtModify: str | None = None
+    sourceSys: int | None = None
+    path: list[Any] | None = None
+    disabled: int | None = None
+    province: str | None = None
+    city: str | None = None
+    district: str | None = None
+    address: str | None = None
+    longitude: Any = None
+    latitude: Any = None
+    remark: Any = None
+    sort: int | None = None
+    effectiveFlag: bool | None = None
+    spaceIndex: int | None = None
+    buildArea: float | None = None
+    floor: str | None = None
+    billableArea: float | None = None
+    houseType: Any = None
+    houseSalesState: Any = None
+    houseDeliveryState: Any = None
+    houseDecoratState: Any = None
+    houseUsageState: str | None = None
+    houseSalesName: Any = None
+    houseDeliveryName: Any = None
+    houseDecoratName: Any = None
+    blockName: Any = None
+    buildingNumberName: Any = None
+    unitName: Any = None
+    roomName: Any = None
+    isBySplitMerge: int | None = None
+    operationState: int | None = None
+    decorateTypeCode: Any = None
+    decorateTypeName: str | None = None
+    decorationStageCfgId: Any = None
+    decorationStageCfgName: str | None = None
+    parkingNames: Any = None
+    visitNumber: Any = None
+    taskTypeName: Any = None
+    taskName: Any = None
+    middleTaskId: Any = None
+    taskTypeId: Any = None
+    instSource: Any = None
+    status: Any = None
+    statusName: Any = None
+    assigneeName: Any = None
+    taskStartTime: Any = None
+    taskEndTime: Any = None
+    communityName: Any = None
+    houseName: Any = None
+    houseId: Any = None
+    visitTime: Any = None
+    callee: Any = None
+    visitLog: Any = None
+    picture: Any = None
+    ifTimeOut: Any = None
+    ifTimeOutName: Any = None
+    tenantId: Any = None
+    pictureFList: Any = None
+    tagList: Any = None
+    tagToExport: Any = None
+    lease: Any = None
+    isRentName: str | None = None
+    isRent: int | None = None
+    leaseName: Any = None
+    customerId: Any = None
+    customerName: Any = None
+    rentAmount: Any = None
+    rentAmountName: Any = None
+    estimateManageFee: Any = None
+    estimateManageFeeName: Any = None
+    manageFeeRate: Any = None
+    manageFeeRateName: Any = None
+    contractStartDate: Any = None
+    contractEndDate: Any = None
+    certificateOfTitle: Any = None
+    leasedArea: Any = None
+    leasedAreaName: Any = None
+    rentStandard: Any = None
+    rentUnit: Any = None
+    rentStandardName: Any = None
+    externalId: Any = None
+
+
+class ShanshuPropertyPageResponse(ShanshuPageResponse[ShanshuPropertyRecord]):
+    """房产档案分页响应模型。"""
+
+
+class ShanshuYardArchiveRecord(BaseModel):
+    """车场档案记录（车场档案分页接口 records 数组中的单条记录）。
+
+    列出已知字段，其余字段通过 ``extra="allow"`` 接收，兼容任意属性。
+    """
+
+    model_config = ConfigDict(extra="allow")
+
+    id: str | None = None
+    name: str | None = None
+    parkCode: Any = None
+    thirdId: Any = None
+    communityId: str | None = None
+    communityName: str | None = None
+    parkType: int | None = None
+    parkTypeName: str | None = None
+    disabled: int | None = None
+    disabledName: str | None = None
+    totalFloor: Any = None
+    carNum: Any = None
+    buildArea: Any = None
+    numberEntrance: Any = None
+    numberExport: Any = None
+    remark: Any = None
+    remarks: Any = None
+    pid: str | None = None
+    operatorName: str | None = None
+    gmtModify: str | None = None
+    fileUrl: Any = None
+    file: Any = None
+    contactPeople: Any = None
+    contactPhone: Any = None
+
+
+class ShanshuYardArchivePageResponse(ShanshuPageResponse[ShanshuYardArchiveRecord]):
+    """车场档案分页响应模型。"""
+
+
+class ShanshuBuildingRecord(BaseModel):
+    """楼幢档案记录（楼幢分页接口 records 数组中的单条记录）。
+
+    列出已知字段，其余字段通过 ``extra="allow"`` 接收，兼容任意属性。
+    """
+
+    model_config = ConfigDict(extra="allow")
+
+    buildingId: str | None = None
+    buildingName: str | None = None
+    floor: Any = None
+    disabled: int | None = None
+    disabledName: str | None = None
+    buildingNature: Any = None
+    buildingStructure: Any = None
+    buildingNatureName: Any = None
+    buildingStructureName: Any = None
+    floorHeight: Any = None
+    unitCount: int | None = None
+    deliveryDate: Any = None
+    operator: str | None = None
+    operatorName: str | None = None
+    gmtModify: str | None = None
+    standardSpaceName: str | None = None
+    communityId: str | None = None
+    communityName: str | None = None
+    blockName: Any = None
+    buildingNumberName: Any = None
+    type: Any = None
+    pid: str | None = None
+    buildingAssetType: Any = None
+    buildingAssetTypeName: Any = None
+    assetOwnershipUnit: Any = None
+    buildingOwner: Any = None
+
+
+class ShanshuBuildingPageResponse(ShanshuPageResponse[ShanshuBuildingRecord]):
+    """楼幢档案分页响应模型。"""
+
+
+class ShanshuResidentRecord(BaseModel):
+    """用户/居民档案记录（居民分页接口 records 数组中的单条记录）。
+
+    列出已知字段，其余字段通过 ``extra="allow"`` 接收，兼容任意属性。
+    """
+
+    model_config = ConfigDict(extra="allow")
+
+    id: str | None = None
+    userName: str | None = None
+    nickName: Any = None
+    headPicUrl: Any = None
+    certificates: Any = None
+    headPicUrlVo: Any = None
+    mobileNum: str | None = None
+    politicalStatus: Any = None
+    gender: Any = None
+    birthday: Any = None
+    job: Any = None
+    nation: Any = None
+    maritalStatus: Any = None
+    arOperator: Any = None
+    tenantId: Any = None
+    arGmtModify: Any = None
+    telephone: Any = None
+    email: Any = None
+    nameAndPhone: Any = None
+    logoff: bool | None = None
+    logoffName: str | None = None
+    tageList: Any = None
+    registeredSource: int | None = None
+    registeredSourceName: str | None = None
+    validated: int | None = None
+    validatedName: str | None = None
+    relevanceAssets: int | None = None
+    relevanceAssetsName: str | None = None
+    gmtCreate: str | None = None
+    gmtModify: str | None = None
+    logoffTime: Any = None
+    uiaGmtModify: Any = None
+    idType: Any = None
+    idTypeName: Any = None
+    idCardNum: Any = None
+    imageObverse: Any = None
+    imageReverse: Any = None
+    userIdentityAuth: Any = None
+    sassetVS: Any = None
+
+
+class ShanshuResidentPageResponse(ShanshuPageResponse[ShanshuResidentRecord]):
+    """用户/居民档案分页响应模型。"""
+
+
+class ShanshuArchiveRecord(BaseModel):
+    """业主档案记录（业主档案分页接口 records 数组中的单条记录）。
+
+    列出已知字段，其余字段通过 ``extra="allow"`` 接收，兼容任意属性。
+    """
+
+    model_config = ConfigDict(extra="allow")
+
+    id: str | None = None
+    userId: str | None = None
+    communityId: str | None = None
+    communityName: str | None = None
+    spaceId: Any = None
+    parkingNames: Any = None
+    carNums: Any = None
+    expireDateStr: Any = None
+    externalId: Any = None
+    spacePath: list[Any] | None = None
+    spaceName: str | None = None
+    identityId: str | None = None
+    identity: str | None = None
+    isHouseholder: bool | None = None
+    houseHolder: str | None = None
+    examineStatus: int | None = None
+    examineStatusName: Any = None
+    creator: str | None = None
+    operator: str | None = None
+    operatorName: str | None = None
+    gmtCreate: str | None = None
+    gmtModify: str | None = None
+    name: str | None = None
+    nickName: Any = None
+    userRegistered: bool | None = None
+    userResidentDesc: str | None = None
+    registerTime: Any = None
+    phone: str | None = None
+    verified: bool | None = None
+    verifiedName: str | None = None
+    dataSources: int | None = None
+    sex: int | None = None
+    sexName: str | None = None
+    certificatesType: str | None = None
+    certificatesTypeName: Any = None
+    certificatesNumber: str | None = None
+    age: int | None = None
+    spaceTypeId: Any = None
+    identityType: Any = None
+    telephone: str | None = None
+    tags: Any = None
+    tagNames: str | None = None
+    block: Any = None
+    buildingNum: Any = None
+    unit: Any = None
+    room: Any = None
+    relation: int | None = None
+    nation: str | None = None
+    phone1: Any = None
+    phone2: Any = None
+    phone3: Any = None
+    birthday: str | None = None
+    houseUsageState: Any = None
+    category: int | None = None
+    categoryName: str | None = None
+    type: Any = None
+    isHouseOwner: int | None = None
+    isHouseOwnerName: Any = None
+    byProcess: int | None = None
+    headPicUrl: str | None = None
+    headPic: Any = None
+
+
+class ShanshuArchivePageResponse(ShanshuPageResponse[ShanshuArchiveRecord]):
+    """业主档案分页响应模型。"""
+
+
+class ShanshuCarManageRecord(BaseModel):
+    """车辆档案记录（车辆管理分页接口 records 数组中的单条记录）。
+
+    列出已知字段，其余字段通过 ``extra="allow"`` 接收，兼容任意属性。
+    """
+
+    model_config = ConfigDict(extra="allow")
+
+    id: str | None = None
+    tenantId: str | None = None
+    communityId: str | None = None
+    communityName: str | None = None
+    spaceId: Any = None
+    standardSpaceName: str | None = None
+    ownerId: str | None = None
+    ownerName: str | None = None
+    ownerPhone: str | None = None
+    ownerType: str | None = None
+    ownerTypeName: str | None = None
+    carNum: str | None = None
+    carBrand: Any = None
+    carBrandName: Any = None
+    carColor: Any = None
+    driverLicense: Any = None
+    remark: Any = None
+    creator: str | None = None
+    creatorName: str | None = None
+    creatorPhone: Any = None
+    gmtCreate: str | None = None
+    gmtModify: str | None = None
+    operator: str | None = None
+    operatorName: str | None = None
+    deleted: int | None = None
+    userSpaceId: Any = None
+    recordCount: Any = None
+    houseNames: str | None = None
+    houseNameDesc: str | None = None
+    parkingNames: str | None = None
+    parkingNameDesc: str | None = None
+    carViolationRecord: Any = None
+
+
+class ShanshuCarManagePageResponse(ShanshuPageResponse[ShanshuCarManageRecord]):
+    """车辆档案分页响应模型。"""
+
+
+class ShanshuParkingRecord(BaseModel):
+    """车位档案记录（车位分页接口 records 数组中的单条记录）。
+
+    列出已知字段，其余字段通过 ``extra="allow"`` 接收，兼容任意属性。
+    """
+
+    model_config = ConfigDict(extra="allow")
+
+    id: int | None = None
+    type: int | None = None
+    typeName: str | None = None
+    communityId: str | None = None
+    pid: str | None = None
+    name: str | None = None
+    standardSpaceName: str | None = None
+    ownership: int | None = None
+    houseOwnership: Any = None
+    houseOwnershipName: Any = None
+    ownershipName: Any = None
+    isAsset: int | None = None
+    typeNameFlag: str | None = None
+    deleted: int | None = None
+    creatorName: str | None = None
+    operatorName: str | None = None
+    creator: str | None = None
+    operator: str | None = None
+    gmtCreate: str | None = None
+    gmtModify: str | None = None
+    sourceSys: int | None = None
+    path: list[Any] | None = None
+    disabled: int | None = None
+    province: str | None = None
+    city: str | None = None
+    district: str | None = None
+    address: str | None = None
+    longitude: Any = None
+    latitude: Any = None
+    remark: Any = None
+    sort: int | None = None
+    effectiveFlag: bool | None = None
+    spaceIndex: int | None = None
+    buildArea: Any = None
+    floor: Any = None
+    billableArea: Any = None
+    houseType: Any = None
+    houseSalesState: Any = None
+    houseDeliveryState: Any = None
+    houseDecoratState: Any = None
+    houseUsageState: Any = None
+    houseSalesName: Any = None
+    houseDeliveryName: Any = None
+    houseDecoratName: Any = None
+    blockName: Any = None
+    buildingNumberName: Any = None
+    unitName: Any = None
+    roomName: Any = None
+    isBySplitMerge: Any = None
+    operationState: int | None = None
+    parkSalesState: Any = None
+    parkDeliveryState: Any = None
+    parkSalesName: Any = None
+    parkDeliveryName: Any = None
+    paringName: Any = None
+    parkingAreaName: Any = None
+    parkingPointName: Any = None
+    num: Any = None
+    tagToExport: Any = None
+    houseTags: Any = None
+    isRent: int | None = None
+    isRentName: str | None = None
+    lease: Any = None
+    leaseName: Any = None
+    rentStandard: Any = None
+    rentUnit: Any = None
+    paymentMethod: Any = None
+    leasedArea: Any = None
+    operate: Any = None
+    operateName: Any = None
+    externalId: Any = None
+
+
+class ShanshuParkingPageResponse(ShanshuPageResponse[ShanshuParkingRecord]):
+    """车位档案分页响应模型。"""
+
+
+class ShanshuWorkOrderRecord(BaseModel):
+    """工单记录（工单分页接口 records 数组中的单条记录）。
+
+    列出已知字段，其余字段通过 ``extra="allow"`` 接收，兼容任意属性。
+    """
+
+    model_config = ConfigDict(extra="allow")
+
+    id: Any = None
+    pid: Any = None
+    children: Any = None
+    processCode: str | None = None
+    procInstId: str | None = None
+    procInstName: str | None = None
+    appCode: str | None = None
+    categoryId: Any = None
+    categoryName: str | None = None
+    instSource: str | None = None
+    customStatusCode: str | None = None
+    customStatus: str | None = None
+    sysStatusCode: str | None = None
+    tenantId: str | None = None
+    suitableTargetType: str | None = None
+    suitableTargetId: str | None = None
+    suitableTargetName: str | None = None
+    assignee: Any = None
+    candidate: Any = None
+    assigneeName: str | None = None
+    startTime: str | None = None
+    endTime: Any = None
+    dealEndTime: Any = None
+    reviewEndTime: Any = None
+    taskId: str | None = None
+    nodeId: str | None = None
+    suspendOvertime: Any = None
+    nodeBizCfg: Any = None
+    settingsD: Any = None
+    gmtModify: str | None = None
+    formData: Any = None
+    firstClaimUserId: Any = None
+    firstClaimTime: Any = None
+    endUserName: Any = None
+    endUserId: Any = None
+    endCoHandlers: Any = None
+    endCoHandlerIds: Any = None
+    dealUserName: str | None = None
+    dealUserId: Any = None
+    dealUserMobile: str | None = None
+    coHandlers: Any = None
+    coHandlersDesc: str | None = None
+    curCoHandlers: Any = None
+    actionVo: list[Any] | None = None
+    showBtnDeal: Any = None
+    showBtnTransfer: Any = None
+    showWorkOrderBack: Any = None
+    showBtnClose: Any = None
+    showBtnBack: Any = None
+    showBtnAddlog: Any = None
+    showBtnAccept: Any = None
+    showBtnNotAccept: Any = None
+    showBtnGrab: Any = None
+    showBtnPriority: Any = None
+    showBtnMatterLevel: Any = None
+    showBtnSuspend: Any = None
+    showBtnExtendSuspend: Any = None
+    showBtnActivate: Any = None
+    showBtnCancel: Any = None
+    showBtnInvalid: Any = None
+    showBtnCoHandler: Any = None
+    showBtnDelete: Any = None
+    formItems: Any = None
+    process: Any = None
+    customStatusList: Any = None
+    relateType: Any = None
+    relateTypeDesc: Any = None
+    preRelateInfo: Any = None
+    expiredInfo: Any = None
+    expiredStatusDesc: str | None = None
+    alertLevelDesc: Any = None
+    suspensionInfo: Any = None
+    nodeTimeInfoList: Any = None
+    curTaskList: list[Any] | None = None
+    allTaskList: list[Any] | None = None
+    priorityCode: str | None = None
+    priorityName: str | None = None
+    labelList: list[Any] | None = None
+    displayItemList: list[Any] | None = None
+    approvingInstIdList: Any = None
+    closedInstIdList: Any = None
+    suspendInstIdList: Any = None
+    tagsVo: Any = None
+    processIsMuilti: Any = None
+    isWorkOrderSync: Any = None
+    effective: Any = None
+    mongoId: Any = None
+    hisYear: Any = None
+    hisAppCode: Any = None
+    address: str | None = None
+    reporterName: str | None = None
+    reporterAddress: str | None = None
+    reporterMobile: str | None = None
+    desc: str | None = None
+    descFilesForExport: str | None = None
+    matterLevel: str | None = None
+    matterLevelName: str | None = None
+    msgSourceName: str | None = None
+    acceptExpired: str | None = None
+    dealExpired: str | None = None
+    settleState: Any = None
+    settleStateName: Any = None
+    isCharge: str | None = None
+    isEvaluation: Any = None
+    isEvaluationName: str | None = None
+    processPhone: Any = None
+    completionTime: Any = None
+    person: Any = None
+    shutter: Any = None
+    assistance: Any = None
+    initiator: str | None = None
+    initiatorName: str | None = None
+    initiatorMobile: str | None = None
+    closingTime: Any = None
+    laborCost: Any = None
+    materialsCost: Any = None
+    usAmount: Any = None
+    payWay: Any = None
+    payAmount: Any = None
+    payTime: Any = None
+    evaluationInformation: Any = None
+    contentReturn: Any = None
+    logArray: list[Any] | None = None
+    nodeTime: Any = None
+    nodeTiming: Any = None
+    completeTime: Any = None
+    processingTimeout: Any = None
+    receiveTimeout: Any = None
+    globalTimeout: Any = None
+    firstOrder: Any = None
+    firstman: str | None = None
+    logStr: str | None = None
+    logFilesForExport: str | None = None
+    fexStr: str | None = None
+    revisitStatus: str | None = None
+    evalStatus: str | None = None
+    serviceItemName: Any = None
+
+
+class ShanshuWorkOrderPageResponse(ShanshuPageResponse[ShanshuWorkOrderRecord]):
+    """工单分页响应模型。"""
+
+
+class ShanshuMallOrderRecord(BaseModel):
+    """园区商城订单记录（商城订单分页接口 records 数组中的单条记录）。
+
+    列出已知字段，其余字段通过 ``extra="allow"`` 接收，兼容任意属性。
+    """
+
+    model_config = ConfigDict(extra="allow")
+
+    id: str | None = None
+    orderNumber: str | None = None
+    orderTypeId: str | None = None
+    orderTypeName: str | None = None
+    orderTypeCode: str | None = None
+    itemIdList: Any = None
+    itemNameList: list[Any] | None = None
+    itemNameListStr: str | None = None
+    itemNormNameList: Any = None
+    itemNormNameListForExport: Any = None
+    amount: float | None = None
+    amountString: str | None = None
+    freight: float | None = None
+    freightString: Any = None
+    discounts: float | None = None
+    discountsString: Any = None
+    actualPayment: float | None = None
+    actualPaymentString: Any = None
+    clientType: str | None = None
+    clientRemark: str | None = None
+    merchantRemark: Any = None
+    buyerInformation: str | None = None
+    consigneeInformation: str | None = None
+    roomId: str | None = None
+    buyerId: str | None = None
+    buyerName: str | None = None
+    buyerPhone: str | None = None
+    buyerAddress: str | None = None
+    consigneeAddress: str | None = None
+    consigneeId: Any = None
+    consigneeName: str | None = None
+    consigneePhone: str | None = None
+    payTime: str | None = None
+    orderStatusId: str | None = None
+    orderStatusName: str | None = None
+    orderStatusCode: str | None = None
+    closeTime: Any = None
+    completedTime: Any = None
+    settlementStatus: str | None = None
+    settlementStatusName: str | None = None
+    customerStatus: str | None = None
+    evaluateStatus: str | None = None
+    customerStatusName: str | None = None
+    cancelType: int | None = None
+    invoiceStatus: str | None = None
+    invoiceStatusName: str | None = None
+    paymentMethod: str | None = None
+    paymentMethodName: str | None = None
+    sendGoodsModel: int | None = None
+    storeId: str | None = None
+    storeName: str | None = None
+    facilitatorId: str | None = None
+    facilitatorName: str | None = None
+    orderSource: str | None = None
+    deletedStatus: bool | None = None
+    tenantId: str | None = None
+    creator: str | None = None
+    operator: str | None = None
+    gmtCreate: str | None = None
+    gmtModify: str | None = None
+    creatorName: str | None = None
+    operatorName: str | None = None
+    appId: str | None = None
+    appName: Any = None
+    gatherBillIdList: Any = None
+    showName: Any = None
+    communityId: str | None = None
+    voucherId: Any = None
+    userVoucherId: Any = None
+    saledTelNum: Any = None
+    trackingNumber: Any = None
+    logisticsCompany: Any = None
+
+
+class ShanshuMallOrderPageResponse(ShanshuPageResponse[ShanshuMallOrderRecord]):
+    """园区商城订单分页响应模型。"""
+
+
+class ShanshuServiceOrderRecord(BaseModel):
+    """服务订单记录（服务订单分页接口 records 数组中的单条记录）。
+
+    列出已知字段，其余字段通过 ``extra="allow"`` 接收，兼容任意属性。
+    """
+
+    model_config = ConfigDict(extra="allow")
+
+    id: str | None = None
+    orderNumber: str | None = None
+    orderTypeId: str | None = None
+    orderTypeName: str | None = None
+    orderTypeCode: str | None = None
+    itemIdList: Any = None
+    itemNameList: list[Any] | None = None
+    itemNameListStr: str | None = None
+    itemNormNameList: Any = None
+    itemNormNameListForExport: Any = None
+    amount: float | None = None
+    amountString: str | None = None
+    freight: float | None = None
+    freightString: Any = None
+    discounts: float | None = None
+    discountsString: Any = None
+    actualPayment: float | None = None
+    actualPaymentString: Any = None
+    clientType: str | None = None
+    clientRemark: str | None = None
+    merchantRemark: Any = None
+    buyerInformation: str | None = None
+    consigneeInformation: str | None = None
+    roomId: str | None = None
+    buyerId: str | None = None
+    buyerName: str | None = None
+    buyerPhone: str | None = None
+    buyerAddress: str | None = None
+    consigneeAddress: str | None = None
+    consigneeId: Any = None
+    consigneeName: str | None = None
+    consigneePhone: str | None = None
+    payTime: str | None = None
+    orderStatusId: str | None = None
+    orderStatusName: str | None = None
+    orderStatusCode: str | None = None
+    closeTime: Any = None
+    completedTime: Any = None
+    settlementStatus: str | None = None
+    settlementStatusName: str | None = None
+    customerStatus: str | None = None
+    evaluateStatus: str | None = None
+    customerStatusName: str | None = None
+    cancelType: int | None = None
+    invoiceStatus: str | None = None
+    invoiceStatusName: str | None = None
+    paymentMethod: str | None = None
+    paymentMethodName: str | None = None
+    sendGoodsModel: int | None = None
+    storeId: str | None = None
+    storeName: str | None = None
+    facilitatorId: str | None = None
+    facilitatorName: str | None = None
+    orderSource: str | None = None
+    deletedStatus: bool | None = None
+    tenantId: str | None = None
+    creator: str | None = None
+    operator: str | None = None
+    gmtCreate: str | None = None
+    gmtModify: str | None = None
+    creatorName: str | None = None
+    operatorName: str | None = None
+    appId: str | None = None
+    appName: Any = None
+    gatherBillIdList: Any = None
+    showName: str | None = None
+    communityId: str | None = None
+    voucherId: Any = None
+    userVoucherId: Any = None
+    saledTelNum: Any = None
+    trackingNumber: Any = None
+    logisticsCompany: Any = None
+
+
+class ShanshuServiceOrderPageResponse(ShanshuPageResponse[ShanshuServiceOrderRecord]):
+    """服务订单分页响应模型。"""
+
+
+class ShanshuPageQueryParams(BaseModel):
+    """分页查询通用参数模型。
+
+    所有分页接口共用的请求参数抽象。
+    """
+
+    model_config = ConfigDict(extra="allow")
+
+    conditions: dict[str, Any] | None = Field(default=None, description="查询条件")
+    count: bool = Field(default=True, description="是否返回总记录数")
+    last: bool = Field(default=True, description="是否返回 last 标志")
+    order_by: list[Any] | None = Field(default=None, description="排序字段列表")
+    page_num: int = Field(default=1, description="页码")
+    page_size: int = Field(default=20, description="每页大小")
+
+
+class ShanshuApprovalUserRecord(BaseModel):
+    """审批数据 - 用户信息记录 (sponsorName/currentNodeAssign 中的 user)。"""
+
+    model_config = ConfigDict(extra="allow")
+
+    id: str | None = None
+    name: str | None = None
+    avatar: Any = None
+    type: Any = None
+    sex: Any = None
+    mobile: Any = None
+    standardDeptNames: Any = None
+
+
+class ShanshuApprovalAssignRecord(BaseModel):
+    """审批数据 - 审批分配记录 (currentNodeAssign/latestAssignedNode)。"""
+
+    model_config = ConfigDict(extra="allow")
+
+    approvalMode: str | None = None
+    user: ShanshuApprovalUserRecord | None = None
+    nodeId: str | None = None
+    taskId: str | None = None
+    result: Any = None
+    nodeName: str | None = None
+
+
+class ShanshuApprovalFormItemRecord(BaseModel):
+    """审批数据 - 表单字段记录 (formBody)。"""
+
+    model_config = ConfigDict(extra="allow")
+
+    value: Any = None
+    key: str | None = None
+
+
+class ShanshuApprovalRecord(BaseModel):
+    """审批数据记录 (records 数组中的单条记录)。"""
+
+    model_config = ConfigDict(extra="allow")
+
+    actionVo: list[Any] | None = None
+    showBtnTransfer: Any = None
+    showBtnBack: Any = None
+    showBtnAddlog: Any = None
+    showBtnAccept: Any = None
+    showBtnNotAccept: Any = None
+    showBtnCommit: Any = None
+    showBtnCommitAgain: Any = None
+    showBtnRevoke: Any = None
+    procInstId: str | None = None
+    procInstName: str | None = None
+    appCode: str | None = None
+    appName: str | None = None
+    sponsorName: ShanshuApprovalUserRecord | None = None
+    sysStatus: str | None = None
+    sysStatusName: str | None = None
+    currentNode: str | None = None
+    currentNodeAssign: list[ShanshuApprovalAssignRecord] | None = None
+    startTime: str | None = None
+    finishTime: Any = None
+    approvalCode: str | None = None
+    formKey: str | None = None
+    approvalName: Any = None
+    nodeId: Any = None
+    summary: Any = None
+    formBody: list[ShanshuApprovalFormItemRecord] | None = None
+    latestAssignedNode: list[ShanshuApprovalAssignRecord] | None = None
+
+
+class ShanshuApprovalPageResponse(ShanshuPageResponse[ShanshuApprovalRecord]):
+    """审批数据分页响应模型。"""
+
+
+class ShanshuApprovalProgressUserRecord(BaseModel):
+    """审批详情 - 进度节点中的用户信息。"""
+
+    model_config = ConfigDict(extra="allow")
+
+    id: str | None = None
+    name: str | None = None
+    avatar: Any = None
+    type: Any = None
+    sex: Any = None
+    mobile: Any = None
+    standardDeptNames: Any = None
+
+
+class ShanshuApprovalProgressCommentRecord(BaseModel):
+    """审批详情 - 进度节点中的评论记录。"""
+
+    model_config = ConfigDict(extra="allow")
+
+    text: str | None = None
+    attachments: list[Any] | None = None
+    commentType: str | None = None
+    id: str | None = None
+    taskId: str | None = None
+    type: str | None = None
+    user: ShanshuApprovalProgressUserRecord | None = None
+    createTime: str | None = None
+
+
+class ShanshuApprovalProgressRecord(BaseModel):
+    """审批详情 - 审批进度记录 (progress 数组中的单条)。"""
+
+    model_config = ConfigDict(extra="allow")
+
+    nodeId: str | None = None
+    taskId: str | None = None
+    approvalMode: Any = None
+    nodeType: str | None = None
+    name: str | None = None
+    user: ShanshuApprovalProgressUserRecord | None = None
+    action: Any = None
+    comment: list[ShanshuApprovalProgressCommentRecord] | None = None
+    result: str | None = None
+    startTime: str | None = None
+    finishTime: str | None = None
+
+
+class ShanshuApprovalFormItemRecord(BaseModel):
+    """审批详情 - 表单项记录 (formItems 数组中的单条)。"""
+
+    model_config = ConfigDict(extra="allow")
+
+    id: str | None = None
+    icon: Any = None
+    name: str | None = None
+    props: Any = None
+    title: str | None = None
+    value: Any = None
+    valueType: str | None = None
+    perm: str | None = None
+
+
+class ShanshuApprovalDetailRecord(BaseModel):
+    """审批详情 - 完整响应模型。"""
+
+    model_config = ConfigDict(extra="allow")
+
+    actionVo: list[Any] | None = None
+    showBtnTransfer: Any = None
+    showBtnBack: Any = None
+    showBtnAddlog: Any = None
+    showBtnAccept: Any = None
+    showBtnNotAccept: Any = None
+    showBtnCommit: Any = None
+    showBtnCommitAgain: Any = None
+    showBtnRevoke: Any = None
+    procInstId: str | None = None
+    instanceId: str | None = None
+    formItems: list[ShanshuApprovalFormItemRecord] | None = None
+    formData: Any = None
+    progress: list[ShanshuApprovalProgressRecord] | None = None
+    processDefName: str | None = None
+    version: int | None = None
+    status: str | None = None
+    result: str | None = None
+    staterUser: ShanshuApprovalProgressUserRecord | None = None
+    starterDept: Any = None
+    startTime: str | None = None
+    appCode: str | None = None
+    appName: str | None = None
+    sysStatus: str | None = None
+    sysStatusName: str | None = None
+    processCode: str | None = None
+    processNodeDetail: Any = None
+    currentNodeAssign: list[ShanshuApprovalAssignRecord] | None = None
+    currentNodeAssignName: str | None = None
+    communityName: str | None = None
+    communityId: str | None = None
+
+
+class ShanshuResidentVRecord(BaseModel):
+    """业主详情 - 居民基本信息 (residentV)。"""
+
+    model_config = ConfigDict(extra="allow")
+
+    userId: str | None = None
+    name: str | None = None
+    agedOrChild: int | None = None
+    phone: str | None = None
+    certificatesType: str | None = None
+    certificatesTypeName: str | None = None
+    certificatesNumber: str | None = None
+    certificates: list[Any] | None = None
+    telephone: str | None = None
+    headPicUrl: Any = None
+    userResident: bool | None = None
+    userResidentTime: Any = None
+    gmtCreate: str | None = None
+    validated: int | None = None
+    birthday: str | None = None
+    sex: int | None = None
+    nickName: Any = None
+
+
+class ShanshuResidentDetailVRecord(BaseModel):
+    """业主详情 - 居民详细信息 (residentDetailV)。"""
+
+    model_config = ConfigDict(extra="allow")
+
+    userId: str | None = None
+    nation: str | None = None
+    politicalStatus: Any = None
+    maritalStatus: str | None = None
+    education: Any = None
+    job: str | None = None
+    emergencyContact: str | None = None
+    emergencyContactNumber: str | None = None
+    telephone: str | None = None
+    file: list[Any] | None = None
+
+
+class ShanshuOwnerListRecord(BaseModel):
+    """业主详情 - 房产 ownerList 中的成员记录。"""
+
+    model_config = ConfigDict(extra="allow")
+
+    userId: str | None = None
+    name: str | None = None
+    agedOrChild: int | None = None
+    phone: str | None = None
+    sex: int | None = None
+    job: str | None = None
+    politicalStatus: Any = None
+    registerTime: str | None = None
+    identityId: Any = None
+    identityName: Any = None
+
+
+class ShanshuHousingVRecord(BaseModel):
+    """业主详情 - 房产列表记录 (housingVList)。"""
+
+    model_config = ConfigDict(extra="allow")
+
+    id: str | None = None
+    userId: str | None = None
+    communityId: str | None = None
+    communityName: str | None = None
+    spaceId: Any = None
+    externalId: Any = None
+    spaceName: str | None = None
+    spaceTypeId: Any = None
+    spaceTypeName: str | None = None
+    identityId: str | None = None
+    examineStatus: Any = None
+    identity: str | None = None
+    identityType: Any = None
+    relation: int | None = None
+    isPayer: int | None = None
+    residenceCertificate: Any = None
+    gmtJoin: Any = None
+    gmtCheckIn: Any = None
+    gmtDecorate: Any = None
+    gmtQuit: Any = None
+    gmtLiveStart: Any = None
+    gmtLiveEnd: Any = None
+    enterprise: str | None = None
+    billableArea: Any = None
+    ownerList: list[ShanshuOwnerListRecord] | None = None
+    houseStatus: int | None = None
+    houseStatusName: str | None = None
+    houseUsageState: str | None = None
+    houseUsageName: str | None = None
+    gmtCreate: Any = None
+    gmtModify: Any = None
+    isCurrent: int | None = None
+    houseHolderDate: Any = None
+    transferDate: Any = None
+    assetCertificate: Any = None
+    tenantId: str | None = None
+    prove: Any = None
+    proveFileVo: Any = None
+    location: Any = None
+    gmtExpireStart: Any = None
+    gmtExpireEnd: Any = None
+    sourceSys: Any = None
+    creatorName: Any = None
+    operatorName: str | None = None
+    category: int | None = None
+    type: Any = None
+    parkingText: Any = None
+    isHouseOwner: int | None = None
+    byProcess: Any = None
+    processInstanceId: Any = None
+    mainCall: Any = None
+    setMainCallTime: Any = None
+
+
+class ShanshuSameRelationMemberRecord(BaseModel):
+    """业主详情 - 同关系成员记录 (sameRelationMembersVList 中的单个成员)。"""
+
+    model_config = ConfigDict(extra="allow")
+
+    userId: str | None = None
+    name: str | None = None
+    agedOrChild: int | None = None
+    phone: str | None = None
+    sex: int | None = None
+    job: Any = None
+    politicalStatus: Any = None
+    registerTime: str | None = None
+    identityId: Any = None
+    identityName: Any = None
+
+
+class ShanshuSameRelationMemberGroupRecord(BaseModel):
+    """业主详情 - 同关系成员分组记录 (sameRelationMembersVList 中的分组)。"""
+
+    model_config = ConfigDict(extra="allow")
+
+    relation: int | None = None
+    members: list[ShanshuSameRelationMemberRecord] | None = None
+
+
+class ShanshuOwnerDetailRecord(BaseModel):
+    """业主详情 - 完整响应模型。"""
+
+    model_config = ConfigDict(extra="allow")
+
+    residentV: ShanshuResidentVRecord | None = None
+    residentDetailV: ShanshuResidentDetailVRecord | None = None
+    housingVList: list[ShanshuHousingVRecord] | None = None
+    spaceOwnerCarVList: list[Any] | None = None
+    spaceOwnerParkingVList: Any = None
+    spaceOwnerStoreroomVS: list[Any] | None = None
+    sameRelationMembersVList: list[ShanshuSameRelationMemberGroupRecord] | None = None
+    tags: Any = None
+
+
+__all__ = [
+    "ShanshuLoginError",
+    "ShanshuBaseResponse",
+    "ShanshuLoginResponse",
+    "ShanshuCommunityRecord",
+    "ShanshuPageResponse",
+    "ShanshuCommunityPageResponse",
+    "ShanshuPropertyRecord",
+    "ShanshuPropertyPageResponse",
+    "ShanshuYardArchiveRecord",
+    "ShanshuYardArchivePageResponse",
+    "ShanshuBuildingRecord",
+    "ShanshuBuildingPageResponse",
+    "ShanshuResidentRecord",
+    "ShanshuResidentPageResponse",
+    "ShanshuArchiveRecord",
+    "ShanshuArchivePageResponse",
+    "ShanshuCarManageRecord",
+    "ShanshuCarManagePageResponse",
+    "ShanshuParkingRecord",
+    "ShanshuParkingPageResponse",
+    "ShanshuWorkOrderRecord",
+    "ShanshuWorkOrderPageResponse",
+    "ShanshuMallOrderRecord",
+    "ShanshuMallOrderPageResponse",
+    "ShanshuServiceOrderRecord",
+    "ShanshuServiceOrderPageResponse",
+    "ShanshuOwnerDetailRecord",
+    "ShanshuApprovalUserRecord",
+    "ShanshuApprovalAssignRecord",
+    "ShanshuApprovalFormItemRecord",
+    "ShanshuApprovalRecord",
+    "ShanshuApprovalPageResponse",
+    "ShanshuApprovalProgressUserRecord",
+    "ShanshuApprovalProgressCommentRecord",
+    "ShanshuApprovalProgressRecord",
+    "ShanshuApprovalFormItemRecord",
+    "ShanshuApprovalDetailRecord",
+    "ShanshuPageQueryParams",
+]