first commit
This commit is contained in:
strepsiades
@@ -0,0 +1,8 @@
|
||||
"""
|
||||
Contract Settlement Detail Domain
|
||||
"""
|
||||
from .sync_node import ContractSettlementDetailSyncNode
|
||||
from .sync_strategy import ContractSettlementDetailSyncStrategy
|
||||
from .jsonl_handler import ContractSettlementDetailJsonlHandler
|
||||
|
||||
__all__ = ["ContractSettlementDetailSyncNode", "ContractSettlementDetailSyncStrategy", "ContractSettlementDetailJsonlHandler"]
|
||||
@@ -0,0 +1,288 @@
|
||||
"""
|
||||
Contract Settlement Detail API Handler
|
||||
|
||||
职责：
|
||||
- 加载合同结算明细列表（依赖 ContractSettlement）
|
||||
- 合同结算明细创建/更新/删除（批量接口）
|
||||
"""
|
||||
|
||||
from typing import List, Dict, Any
|
||||
from ...datasource.api.handler import BaseApiHandler
|
||||
from ...datasource.task_result import TaskResult
|
||||
from ...common.sync_node import SyncNode
|
||||
from ...datasource.api.errors import ERROR_NODE_DATA_NONE, ERROR_VALIDATION_FAILED, ERROR_ID_NOT_FOUND
|
||||
from .sync_node import ContractSettlementDetailSyncNode
|
||||
from schemas.contract_settlement.contract_settlement_detail import (
|
||||
ContractSettlementDetailResponse,
|
||||
ContractSettlementDetailCreate,
|
||||
ContractSettlementDetailUpdate
|
||||
)
|
||||
|
||||
|
||||
class ContractSettlementDetailApiHandler(BaseApiHandler):
|
||||
"""合同结算明细 API Handler"""
|
||||
|
||||
def __init__(self):
|
||||
super().__init__()
|
||||
self._node_type = "contract_settlement_detail"
|
||||
self._node_class = ContractSettlementDetailSyncNode
|
||||
self._schema = ContractSettlementDetailResponse
|
||||
self.update_schemas = [ContractSettlementDetailCreate, ContractSettlementDetailUpdate]
|
||||
|
||||
async def load(self) -> List[SyncNode]:
|
||||
"""加载合同结算明细列表（依赖 ContractSettlement）"""
|
||||
settlements = self._collection.filter(node_type="contract_settlement")
|
||||
settlement_ids = [s.data_id for s in settlements if s.data_id]
|
||||
|
||||
if not settlement_ids:
|
||||
return []
|
||||
|
||||
all_details = []
|
||||
for settlement_id in settlement_ids:
|
||||
try:
|
||||
details = await api_get_contract_settlement_detail_list(self.api_client, settlement_id)
|
||||
for detail_model in details:
|
||||
detail_data = detail_model.model_dump()
|
||||
all_details.append(self._create_node(detail_data))
|
||||
except Exception as e:
|
||||
print(f"❌ Failed to load settlement details for {settlement_id}: {e}")
|
||||
|
||||
return all_details
|
||||
|
||||
async def create_all(self, nodes: List[SyncNode]) -> List[TaskResult]:
|
||||
"""批量创建合同结算明细"""
|
||||
from pydantic import ValidationError
|
||||
|
||||
results = []
|
||||
for node in nodes:
|
||||
data = node.get_data()
|
||||
if not data:
|
||||
results.append(TaskResult.failed(node_id=node.node_id, error=ERROR_NODE_DATA_NONE))
|
||||
continue
|
||||
|
||||
# 从data的parent_id获取settlement_id
|
||||
settlement_id = data.get("parent_id")
|
||||
if not settlement_id:
|
||||
results.append(TaskResult.failed(node_id=node.node_id, error=ERROR_ID_NOT_FOUND))
|
||||
continue
|
||||
|
||||
try:
|
||||
create_data = {"settlement_id": settlement_id, **data}
|
||||
create_model = ContractSettlementDetailCreate.model_validate(create_data)
|
||||
except ValidationError as e:
|
||||
results.append(TaskResult.failed(node_id=node.node_id, error=f"{ERROR_VALIDATION_FAILED}: {e}"))
|
||||
continue
|
||||
|
||||
push_id = self._generate_push_id()
|
||||
|
||||
try:
|
||||
response = await api_create_contract_settlement_detail(self.api_client, create_model, push_id)
|
||||
if self.poll_mode == "sync":
|
||||
created_id = self._extract_created_id_from_response(response)
|
||||
if not created_id:
|
||||
results.append(
|
||||
TaskResult.failed(
|
||||
node_id=node.node_id,
|
||||
error="Missing created_id in create response"
|
||||
)
|
||||
)
|
||||
continue
|
||||
results.append(TaskResult.success(node_id=node.node_id, data_id=created_id))
|
||||
else:
|
||||
results.append(TaskResult.in_progress(node_id=node.node_id, task_id=push_id))
|
||||
except Exception as e:
|
||||
results.append(TaskResult.failed(node_id=node.node_id, error=str(e)))
|
||||
|
||||
return results
|
||||
|
||||
async def update_all(self, nodes: List[SyncNode]) -> List[TaskResult]:
|
||||
"""
|
||||
批量更新合同结算明细
|
||||
|
||||
按 settlement_id 分组，每组使用同一个 push_id 批量提交
|
||||
"""
|
||||
from pydantic import ValidationError
|
||||
from collections import defaultdict
|
||||
|
||||
results = []
|
||||
|
||||
# 按 settlement_id 分组
|
||||
groups: Dict[str, List[tuple[SyncNode, Dict[str, Any]]]] = defaultdict(list)
|
||||
|
||||
for node in nodes:
|
||||
data = node.get_data()
|
||||
if not data:
|
||||
results.append(TaskResult.failed(node_id=node.node_id, error=ERROR_NODE_DATA_NONE))
|
||||
continue
|
||||
|
||||
origin_data = node.get_origin_data() or {}
|
||||
|
||||
# 使用 _get_schema_diff 检查差异并打印日志
|
||||
diff_fields = self._get_schema_diff(ContractSettlementDetailUpdate, data, origin_data, node.node_id)
|
||||
if not diff_fields:
|
||||
from ...common.types import SyncAction
|
||||
results.append(TaskResult.skipped(node_id=node.node_id, reason="No updatable fields changed"))
|
||||
continue
|
||||
|
||||
# 获取 settlement_id（parent_id）
|
||||
settlement_id = data.get("parent_id") or node.context.get("settlement_id")
|
||||
if not settlement_id:
|
||||
results.append(TaskResult.failed(node_id=node.node_id, error="Missing settlement_id (parent_id)"))
|
||||
continue
|
||||
|
||||
# 需要完整的 schema 数据（包括必填字段）
|
||||
update_data = self._filter_update_data(data, origin_data, ContractSettlementDetailUpdate)
|
||||
|
||||
try:
|
||||
update_model = ContractSettlementDetailUpdate.model_validate(update_data)
|
||||
groups[settlement_id].append((node, update_model))
|
||||
except ValidationError as e:
|
||||
results.append(TaskResult.failed(node_id=node.node_id, error=f"{ERROR_VALIDATION_FAILED}: {e}"))
|
||||
|
||||
# 逐组批量更新
|
||||
for settlement_id, group_items in groups.items():
|
||||
push_id = self._generate_push_id()
|
||||
|
||||
# 准备批量数据
|
||||
detail_list = [model.model_dump(mode='json', exclude_unset=True) for node, model in group_items]
|
||||
|
||||
# 使用第一个节点的 biz_id（对于批量更新，通常使用 parent_id）
|
||||
biz_id = settlement_id
|
||||
|
||||
try:
|
||||
# 批量调用 API
|
||||
await api_update_contract_settlement_detail(
|
||||
self.api_client,
|
||||
{"detail_list": detail_list},
|
||||
push_id,
|
||||
biz_id,
|
||||
)
|
||||
# 整组成功
|
||||
for node, _ in group_items:
|
||||
results.append(TaskResult.success(node_id=node.node_id, push_id=push_id))
|
||||
except Exception as e:
|
||||
# 整组失败
|
||||
error_msg = str(e)
|
||||
for node, _ in group_items:
|
||||
results.append(TaskResult.failed(node_id=node.node_id, error=error_msg))
|
||||
|
||||
return results
|
||||
|
||||
async def delete_all(self, nodes: List[SyncNode]) -> List[TaskResult]:
|
||||
"""批量删除合同结算明细"""
|
||||
results = []
|
||||
for node in nodes:
|
||||
push_id = self._generate_push_id()
|
||||
biz_id = node.data_id
|
||||
if not biz_id:
|
||||
results.append(TaskResult.failed(node_id=node.node_id, error="Missing biz_id for delete"))
|
||||
continue
|
||||
|
||||
try:
|
||||
await api_delete_contract_settlement_detail(self.api_client, biz_id, push_id)
|
||||
results.append(TaskResult.success(node_id=node.node_id))
|
||||
except Exception as e:
|
||||
results.append(TaskResult.failed(node_id=node.node_id, error=str(e)))
|
||||
|
||||
return results
|
||||
|
||||
async def poll_tasks(self, task_ids: List[str]) -> Dict[str, TaskResult]:
|
||||
"""轮询异步任务状态（占位）"""
|
||||
return await super().poll_tasks(task_ids)
|
||||
|
||||
def _create_node(self, data: Dict[str, Any]) -> SyncNode:
|
||||
node = self._create_basic_node(data, depend_ids=[])
|
||||
|
||||
if data.get("settlement_id"):
|
||||
node.context["settlement_id"] = data["settlement_id"]
|
||||
|
||||
return node
|
||||
|
||||
|
||||
# ========== 静态 API 函数 ==========
|
||||
|
||||
async def api_get_contract_settlement_detail_list(client, settlement_id: str) -> List[ContractSettlementDetailResponse]:
|
||||
"""
|
||||
获取合同结算明细列表
|
||||
|
||||
Args:
|
||||
client: API 客户端
|
||||
settlement_id: 结算ID
|
||||
|
||||
Returns:
|
||||
List[ContractSettlementDetailResponse]: 验证过的明细列表
|
||||
|
||||
Raises:
|
||||
Exception: API 返回错误或数据验证失败
|
||||
"""
|
||||
from pydantic import ValidationError
|
||||
|
||||
response = await client.request(
|
||||
method="GET",
|
||||
endpoint="/contract_settlement/detail/list",
|
||||
params={"settlement_id": settlement_id}
|
||||
)
|
||||
if response.get("code") != 200:
|
||||
raise Exception(f"API error: {response.get('message', 'Unknown error')}")
|
||||
|
||||
items = response.get("data", [])
|
||||
|
||||
validated_items = []
|
||||
for item in items:
|
||||
try:
|
||||
validated_item = ContractSettlementDetailResponse.model_validate(item)
|
||||
validated_items.append(validated_item)
|
||||
except ValidationError as e:
|
||||
print(f"⚠️ Skipping invalid detail item: {e}")
|
||||
continue
|
||||
|
||||
return validated_items
|
||||
|
||||
|
||||
async def api_create_contract_settlement_detail(client, data: ContractSettlementDetailCreate, push_id: str) -> Dict[str, Any]:
|
||||
"""
|
||||
创建合同结算明细
|
||||
|
||||
Args:
|
||||
client: API 客户端
|
||||
data: 创建数据（Pydantic model）
|
||||
push_id: 推送ID
|
||||
biz_id: 业务ID
|
||||
|
||||
Returns:
|
||||
str: push_id
|
||||
|
||||
Raises:
|
||||
Exception: API 返回错误
|
||||
"""
|
||||
request_data = {"push_id": push_id, "data": data.model_dump(mode='json')}
|
||||
response = await client.request(method="POST", endpoint="/contract_settlement/detail/create", data=request_data)
|
||||
if response.get("code") != 200:
|
||||
raise Exception(f"API error: {response.get('message', 'Unknown error')}")
|
||||
return response
|
||||
|
||||
|
||||
async def api_update_contract_settlement_detail(client, data: Dict[str, Any], push_id: str, biz_id: str) -> None:
|
||||
"""
|
||||
更新合同结算明细
|
||||
|
||||
Args:
|
||||
client: API 客户端
|
||||
data: 更新数据（Pydantic model）
|
||||
push_id: 推送ID
|
||||
biz_id: 业务ID
|
||||
|
||||
Raises:
|
||||
Exception: API 返回错误
|
||||
"""
|
||||
request_data = {"push_id": push_id, "biz_id": biz_id, "data": data}
|
||||
response = await client.request(method="PUT", endpoint="/contract_settlement/detail/update", data=request_data)
|
||||
if response.get("code") != 200:
|
||||
raise Exception(f"API error: {response.get('message', 'Unknown error')}")
|
||||
|
||||
|
||||
async def api_delete_contract_settlement_detail(client, detail_id: str, push_id: str) -> None:
|
||||
request_data = {"push_id": push_id, "biz_id": detail_id}
|
||||
response = await client.request(method="DELETE", endpoint="/contract_settlement/detail/delete", data=request_data)
|
||||
if response.get("code") != 200:
|
||||
raise Exception(f"API error: {response.get('message', 'Unknown error')}")
|
||||
@@ -0,0 +1,12 @@
|
||||
"""
|
||||
Contract Settlement Detail JSONL Handler
|
||||
"""
|
||||
from ...datasource import BaseJsonlHandler, JsonlDataSource
|
||||
from .sync_node import ContractSettlementDetailSyncNode
|
||||
from schemas.contract_settlement.contract_settlement_detail import ContractSettlementDetailResponse
|
||||
|
||||
|
||||
class ContractSettlementDetailJsonlHandler(BaseJsonlHandler):
|
||||
"""合同结算明细 JSONL Handler"""
|
||||
def __init__(self, datasource: JsonlDataSource):
|
||||
super().__init__(datasource, "contract_settlement_detail", ContractSettlementDetailSyncNode, ContractSettlementDetailResponse)
|
||||
@@ -0,0 +1,17 @@
|
||||
"""Contract settlement detail domain registration"""
|
||||
from ...common.registry import DomainRegistry
|
||||
from schemas.contract_settlement.contract_settlement_detail import ContractSettlementDetailResponse
|
||||
from .sync_node import ContractSettlementDetailSyncNode
|
||||
from .sync_strategy import ContractSettlementDetailSyncStrategy
|
||||
from .jsonl_handler import ContractSettlementDetailJsonlHandler
|
||||
from .api_handler import ContractSettlementDetailApiHandler
|
||||
|
||||
# 注册 contract_settlement_detail domain
|
||||
DomainRegistry.register(
|
||||
node_type="contract_settlement_detail",
|
||||
schema=ContractSettlementDetailResponse,
|
||||
node_class=ContractSettlementDetailSyncNode,
|
||||
strategy_class=ContractSettlementDetailSyncStrategy,
|
||||
jsonl_handler_class=ContractSettlementDetailJsonlHandler,
|
||||
api_handler_class=ContractSettlementDetailApiHandler,
|
||||
)
|
||||
@@ -0,0 +1,11 @@
|
||||
"""
|
||||
Contract Settlement Detail Domain
|
||||
"""
|
||||
from ...common import SyncNode
|
||||
from schemas.contract_settlement.contract_settlement_detail import ContractSettlementDetailResponse
|
||||
|
||||
|
||||
class ContractSettlementDetailSyncNode(SyncNode[ContractSettlementDetailResponse]):
|
||||
"""合同结算明细同步节点"""
|
||||
node_type = "contract_settlement_detail"
|
||||
schema = ContractSettlementDetailResponse
|
||||
@@ -0,0 +1,20 @@
|
||||
from ...sync_system.strategy import DefaultSyncStrategy
|
||||
from ...sync_system.config import StrategyConfig, OrphanAction, UpdateDirection
|
||||
from schemas.contract_settlement.contract_settlement_detail import ContractSettlementDetailResponse
|
||||
|
||||
|
||||
class ContractSettlementDetailSyncStrategy(DefaultSyncStrategy[ContractSettlementDetailResponse]):
|
||||
"""
|
||||
Contract Settlement Detail 同步策略（合同子业务明细）。
|
||||
"""
|
||||
|
||||
schema = ContractSettlementDetailResponse
|
||||
|
||||
default_config = StrategyConfig(
|
||||
auto_bind=True,
|
||||
auto_bind_fields=["parent_id", "date"],
|
||||
depend_fields={"parent_id": "contract_settlement"},
|
||||
local_orphan_action=OrphanAction.CREATE_REMOTE,
|
||||
remote_orphan_action=OrphanAction.NONE,
|
||||
update_direction=UpdateDirection.PUSH,
|
||||
)
|
||||
Reference in New Issue
Block a user