加入了 GVSDSDK 模块，进行了 QModel 兼容层的尝试，生产环境可用
This commit is contained in:
340
gvsdsdk/__init__.py
Normal file
340
gvsdsdk/__init__.py
Normal file
@@ -0,0 +1,340 @@
|
||||
"""GVS-DSDK — GVS Distributed SDK
|
||||
|
||||
GVS 分布式服务间通信 SDK，作为子服务器（如 ATestCServer）和主服务器（gvsds）
|
||||
之间的统一通信桥梁。
|
||||
|
||||
设计原则：
|
||||
1. 薄封装：直接包装 gvsds.apps.msync 原生层
|
||||
2. 纯转发：方法签名 1:1 对应原生层
|
||||
3. PascalCase：全部公开 API 使用 PascalCase
|
||||
4. 协议兼容：完全兼容 gvsds/apps/msync 现有协议
|
||||
5. 惰性加载：仅在访问属性时才 import 原生层（避免 Django 未初始化时报错）
|
||||
|
||||
包结构：
|
||||
gvsdsdk/
|
||||
├── auth/ # ELT 用户认证模块
|
||||
│ ├── elt_auth.py # ELT 认证后端
|
||||
│ ├── cookie.py # Cookie 管理
|
||||
│ ├── crypto.py # 密码哈希 + AES 加密
|
||||
│ ├── middleware.py # ELTAuthMiddleware + CurrentRoleMiddleware
|
||||
│ ├── permissions.py # RBAC/ABAC 权限
|
||||
│ └── managers.py # UserManager + RoleManager
|
||||
├── msync/ # MSYNC 服务间通信
|
||||
├── commission/ # 分佣引擎
|
||||
│ ├── models.py # 分佣数据模型
|
||||
│ ├── manager.py # CommissionEngine 编排器
|
||||
│ └── strategies/ # 分账策略
|
||||
├── payment/ # 支付网关
|
||||
│ ├── models.py # 支付数据模型
|
||||
│ ├── manager.py # PaymentManager 编排器
|
||||
│ └── gateways/ # 支付渠道适配器
|
||||
├── order/ # 订单模板与订单
|
||||
│ └── models.py # 订单数据模型
|
||||
├── models.py # SAAS 核心数据模型
|
||||
├── model_base.py # QModel
|
||||
├── model_utils.py # UUIDObj
|
||||
└── fluent.py # FluentQuery ORM 查询层
|
||||
|
||||
使用示例：
|
||||
from gvsdsdk import ServiceRegistry, OGMManager, TransactionManager
|
||||
from gvsdsdk.auth import ELTAuthentication, PermissionVerifier
|
||||
from gvsdsdk.commission import CommissionEngine
|
||||
from gvsdsdk.payment import PaymentManager
|
||||
print(gvsdsdk.__version__) # '1.0.0'
|
||||
"""
|
||||
|
||||
import os as _os
|
||||
import sys as _sys
|
||||
import platform as _platform
|
||||
from typing import Optional, Tuple
|
||||
|
||||
|
||||
# === 版本定义（单一来源） ===
|
||||
|
||||
#: 主版本号
|
||||
VERSION_MAJOR = 1
|
||||
#: 次版本号
|
||||
VERSION_MINOR = 0
|
||||
#: 补丁版本号
|
||||
VERSION_PATCH = 0
|
||||
#: 预发布标签（如 'a1', 'b2', 'rc1'）
|
||||
VERSION_PRERELEASE = ''
|
||||
|
||||
#: 完整版本字符串（PEP 440 兼容）
|
||||
__version__ = f'{VERSION_MAJOR}.{VERSION_MINOR}.{VERSION_PATCH}{VERSION_PRERELEASE}'
|
||||
|
||||
|
||||
# === 包元数据 ===
|
||||
|
||||
#: 物理安装路径（pkg.__file__ 所在目录）
|
||||
_PKG_DIR = _os.path.dirname(_os.path.abspath(__file__))
|
||||
|
||||
|
||||
def get_version() -> str:
|
||||
"""返回 SDK 版本字符串"""
|
||||
return __version__
|
||||
|
||||
|
||||
def get_version_info() -> dict:
|
||||
"""返回详细版本信息字典
|
||||
|
||||
Returns:
|
||||
包含 version, location, python_version, platform 等字段
|
||||
"""
|
||||
return {
|
||||
'Version': __version__,
|
||||
'Major': VERSION_MAJOR,
|
||||
'Minor': VERSION_MINOR,
|
||||
'Patch': VERSION_PATCH,
|
||||
'Prerelease': VERSION_PRERELEASE,
|
||||
'Location': _PKG_DIR,
|
||||
'Python': _sys.version.split()[0],
|
||||
'Platform': _platform.platform(),
|
||||
'Machine': _platform.machine(),
|
||||
}
|
||||
|
||||
|
||||
def check_min_version(min_version: str) -> Tuple[bool, str]:
|
||||
"""检查当前版本是否 >= 给定最低版本
|
||||
|
||||
Args:
|
||||
min_version: 形如 '1.0.0' 的最低版本字符串
|
||||
|
||||
Returns:
|
||||
(is_ok, message) 元组
|
||||
"""
|
||||
def parse(v: str):
|
||||
parts = v.split('.')
|
||||
major = int(parts[0]) if len(parts) > 0 else 0
|
||||
minor = int(parts[1]) if len(parts) > 1 else 0
|
||||
patch_str = parts[2] if len(parts) > 2 else '0'
|
||||
digits = ''
|
||||
for c in patch_str:
|
||||
if c.isdigit():
|
||||
digits += c
|
||||
else:
|
||||
break
|
||||
patch = int(digits) if digits else 0
|
||||
return (major, minor, patch)
|
||||
|
||||
current = parse(__version__)
|
||||
required = parse(min_version)
|
||||
|
||||
if current >= required:
|
||||
return True, f'OK: SDK {__version__} >= {min_version}'
|
||||
return False, f'FAIL: SDK {__version__} < {min_version} (required)'
|
||||
|
||||
|
||||
# === 惰性加载（PEP 562）===
|
||||
|
||||
def _load_msync():
|
||||
from gvsdsdk import msync as _mod
|
||||
return _mod
|
||||
|
||||
|
||||
def _load_auth():
|
||||
from gvsdsdk import auth as _mod
|
||||
return _mod
|
||||
|
||||
|
||||
def _load_commission():
|
||||
from gvsdsdk import commission as _mod
|
||||
return _mod
|
||||
|
||||
|
||||
def _load_payment():
|
||||
from gvsdsdk import payment as _mod
|
||||
return _mod
|
||||
|
||||
|
||||
def _load_order():
|
||||
from gvsdsdk import order as _mod
|
||||
return _mod
|
||||
|
||||
|
||||
def _load_models():
|
||||
from gvsdsdk import models as _mod
|
||||
return _mod
|
||||
|
||||
|
||||
def _load_fluent():
|
||||
from gvsdsdk import fluent as _mod
|
||||
return _mod
|
||||
|
||||
|
||||
def _load_model_base():
|
||||
from gvsdsdk import model_base as _mod
|
||||
return _mod
|
||||
|
||||
|
||||
def _load_model_utils():
|
||||
from gvsdsdk import model_utils as _mod
|
||||
return _mod
|
||||
|
||||
|
||||
_LAZY_SYMBOLS = {
|
||||
# ── MSYNC 服务间通信 ──────────────────────────────────
|
||||
'SignPayload': ('msync', 'SignPayload'),
|
||||
'VerifySignature': ('msync', 'VerifySignature'),
|
||||
'GenerateChallenge': ('msync', 'GenerateChallenge'),
|
||||
'BuildAuthPayload': ('msync', 'BuildAuthPayload'),
|
||||
'SignAuthPayload': ('msync', 'SignAuthPayload'),
|
||||
'VerifyAuthPayload': ('msync', 'VerifyAuthPayload'),
|
||||
'ServiceTokenEncoder': ('msync', 'ServiceTokenEncoder'),
|
||||
'AuthenticateService': ('msync', 'AuthenticateService'),
|
||||
'RefreshServiceToken': ('msync', 'RefreshServiceToken'),
|
||||
'ValidateAccessToken': ('msync', 'ValidateAccessToken'),
|
||||
'IssueServiceToken': ('msync', 'IssueServiceToken'),
|
||||
'ServiceRegistry': ('msync', 'ServiceRegistry'),
|
||||
'RegistryError': ('msync', 'RegistryError'),
|
||||
'OGMManager': ('msync', 'OGMManager'),
|
||||
'OGMError': ('msync', 'OGMError'),
|
||||
'TransactionManager': ('msync', 'TransactionManager'),
|
||||
'TransactionError': ('msync', 'TransactionError'),
|
||||
'StepExecutionError': ('msync', 'StepExecutionError'),
|
||||
'LocalTransactionManager': ('msync', 'LocalTransactionManager'),
|
||||
'StepHandler': ('msync', 'StepHandler'),
|
||||
'local_tx': ('msync', 'local_tx'),
|
||||
'ServiceClient': ('msync', 'ServiceClient'),
|
||||
'ServiceClientError': ('msync', 'ServiceClientError'),
|
||||
|
||||
# ── ELT 用户认证 ──────────────────────────────────────
|
||||
'ELTAuthentication': ('auth', 'ELTAuthentication'),
|
||||
'ELT_COOKIE_NAME': ('auth', 'ELT_COOKIE_NAME'),
|
||||
'ELT_COOKIE_DOMAIN': ('auth', 'ELT_COOKIE_DOMAIN'),
|
||||
'ELT_COOKIE_MAX_AGE': ('auth', 'ELT_COOKIE_MAX_AGE'),
|
||||
'SetELTCookie': ('auth', 'SetELTCookie'),
|
||||
'DeleteELTCookie': ('auth', 'DeleteELTCookie'),
|
||||
'HashPassword': ('auth', 'HashPassword'),
|
||||
'VerifyPassword': ('auth', 'VerifyPassword'),
|
||||
'SymmetricEncrypt': ('auth', 'SymmetricEncrypt'),
|
||||
'SymmetricDecrypt': ('auth', 'SymmetricDecrypt'),
|
||||
'FileSHA1': ('auth', 'FileSHA1'),
|
||||
'FileSHA256': ('auth', 'FileSHA256'),
|
||||
'BytesSHA1': ('auth', 'BytesSHA1'),
|
||||
'BytesSHA256': ('auth', 'BytesSHA256'),
|
||||
'ELTAuthMiddleware': ('auth', 'ELTAuthMiddleware'),
|
||||
'CurrentRoleMiddleware': ('auth', 'CurrentRoleMiddleware'),
|
||||
'IsAdminUser': ('auth', 'IsAdminUser'),
|
||||
'IsCompanyMember': ('auth', 'IsCompanyMember'),
|
||||
'CompanyScopedMixin': ('auth', 'CompanyScopedMixin'),
|
||||
'PermissionVerifier': ('auth', 'PermissionVerifier'),
|
||||
'RoleManager': ('auth', 'RoleManager'),
|
||||
'ShopManager': ('auth', 'ShopManager'),
|
||||
'PositionManager': ('auth', 'PositionManager'),
|
||||
|
||||
# ── 分佣引擎 ──────────────────────────────────────────
|
||||
'CommissionEngine': ('commission', 'CommissionEngine'),
|
||||
'CommissionError': ('commission', 'CommissionError'),
|
||||
'CommissionEvent': ('commission', 'CommissionEvent'),
|
||||
'RateTable': ('commission', 'RateTable'),
|
||||
'RateEntry': ('commission', 'RateEntry'),
|
||||
'CommissionRule': ('commission', 'CommissionRule'),
|
||||
'CommissionRecord': ('commission', 'CommissionRecord'),
|
||||
'PreSettlement': ('commission', 'PreSettlement'),
|
||||
'CreateStrategy': ('commission', 'CreateStrategy'),
|
||||
'PercentageStrategy': ('commission', 'PercentageStrategy'),
|
||||
'FixedStrategy': ('commission', 'FixedStrategy'),
|
||||
'TieredStrategy': ('commission', 'TieredStrategy'),
|
||||
'RemainderStrategy': ('commission', 'RemainderStrategy'),
|
||||
'WithdrawalFeeStrategy': ('commission', 'WithdrawalFeeStrategy'),
|
||||
|
||||
# ── 支付网关 ──────────────────────────────────────────
|
||||
'PaymentManager': ('payment', 'PaymentManager'),
|
||||
'PaymentError': ('payment', 'PaymentError'),
|
||||
'PaymentGatewayConfig': ('payment', 'PaymentGatewayConfig'),
|
||||
'PaymentTransaction': ('payment', 'PaymentTransaction'),
|
||||
'EncryptField': ('payment', 'EncryptField'),
|
||||
'PaymentCredentials': ('payment', 'PaymentCredentials'),
|
||||
'PaymentRequest': ('payment', 'PaymentRequest'),
|
||||
'PaymentResponse': ('payment', 'PaymentResponse'),
|
||||
'RefundRequest': ('payment', 'RefundRequest'),
|
||||
'RefundResponse': ('payment', 'RefundResponse'),
|
||||
'TransferRequest': ('payment', 'TransferRequest'),
|
||||
'TransferResponse': ('payment', 'TransferResponse'),
|
||||
'QueryResponse': ('payment', 'QueryResponse'),
|
||||
'AbstractPaymentGateway': ('payment', 'AbstractPaymentGateway'),
|
||||
'GatewayRegistry': ('payment', 'GatewayRegistry'),
|
||||
'payment_registry': ('payment', 'payment_registry'),
|
||||
'WechatPaymentGateway': ('payment', 'WechatPaymentGateway'),
|
||||
'AlipayPaymentGateway': ('payment', 'AlipayPaymentGateway'),
|
||||
'BankPaymentGateway': ('payment', 'BankPaymentGateway'),
|
||||
|
||||
# ── 订单模板与订单 ────────────────────────────────────
|
||||
'OrderTemplate': ('order', 'OrderTemplate'),
|
||||
'OrderTemplateItem': ('order', 'OrderTemplateItem'),
|
||||
'OrderLevel': ('order', 'OrderLevel'),
|
||||
'Order': ('order', 'Order'),
|
||||
'OrderItem': ('order', 'OrderItem'),
|
||||
|
||||
# ── 数据模型 ──────────────────────────────────────────
|
||||
'User': ('models', 'User'),
|
||||
'Role': ('models', 'Role'),
|
||||
'Permission': ('models', 'Permission'),
|
||||
'UserRole': ('models', 'UserRole'),
|
||||
'UUIDField': ('models', 'UUIDField'),
|
||||
'UserManager': ('models', 'UserManager'),
|
||||
'EphemeralToken': ('models', 'EphemeralToken'),
|
||||
'User2FA': ('models', 'User2FA'),
|
||||
'UserPending2FA': ('models', 'UserPending2FA'),
|
||||
'UserAvatar': ('models', 'UserAvatar'),
|
||||
'UserLoginLog': ('models', 'UserLoginLog'),
|
||||
'AccountActivation': ('models', 'AccountActivation'),
|
||||
'RolePermission': ('models', 'RolePermission'),
|
||||
'UserABAC': ('models', 'UserABAC'),
|
||||
'Password': ('models', 'Password'),
|
||||
'Shop': ('models', 'Shop'),
|
||||
'RoleShop': ('models', 'RoleShop'),
|
||||
'Position': ('models', 'Position'),
|
||||
'PositionTemplate': ('models', 'PositionTemplate'),
|
||||
'PositionTemplatePermission': ('models', 'PositionTemplatePermission'),
|
||||
'UserDept': ('models', 'UserDept'),
|
||||
'FixedBinaryField': ('models', 'FixedBinaryField'),
|
||||
'QModel': ('model_base', 'QModel'),
|
||||
'QModelBase': ('model_base', 'QModelBase'),
|
||||
|
||||
# ── ORM 查询层 ────────────────────────────────────────
|
||||
'FluentQuery': ('fluent', 'FluentQuery'),
|
||||
'Session': ('fluent', 'Session'),
|
||||
'db': ('fluent', 'db'),
|
||||
'func': ('fluent', 'func'),
|
||||
'FQ': ('fluent', 'FQ'),
|
||||
'FieldExpression': ('model_base', 'FieldExpression'),
|
||||
|
||||
# ── 工具 ──────────────────────────────────────────────
|
||||
'UUIDObj': ('model_utils', 'UUIDObj'),
|
||||
}
|
||||
|
||||
_LOADERS = {
|
||||
'msync': _load_msync,
|
||||
'auth': _load_auth,
|
||||
'commission': _load_commission,
|
||||
'payment': _load_payment,
|
||||
'order': _load_order,
|
||||
'models': _load_models,
|
||||
'fluent': _load_fluent,
|
||||
'model_base': _load_model_base,
|
||||
'model_utils': _load_model_utils,
|
||||
}
|
||||
|
||||
|
||||
def __getattr__(name):
|
||||
"""惰性加载——仅在被访问时才 import 真正的模块"""
|
||||
if name in _LAZY_SYMBOLS:
|
||||
module_name, attr = _LAZY_SYMBOLS[name]
|
||||
mod = _LOADERS[module_name]()
|
||||
value = getattr(mod, attr)
|
||||
globals()[name] = value
|
||||
return value
|
||||
raise AttributeError(f"module 'gvsdsdk' has no attribute {name!r}")
|
||||
|
||||
|
||||
__all__ = list(_LAZY_SYMBOLS.keys()) + [
|
||||
'get_version',
|
||||
'get_version_info',
|
||||
'check_min_version',
|
||||
'__version__',
|
||||
'VERSION_MAJOR',
|
||||
'VERSION_MINOR',
|
||||
'VERSION_PATCH',
|
||||
]
|
||||
Reference in New Issue
Block a user