规范了update data的构建方式,统一使用build_update_request_data方法来处理更新数据的构建和过滤逻辑。这个方法会根据提供的原始数据、更新数据和对应的schema来生成最终的更新请求数据,同时会自动排除掉未变化的字段和空值字段,从而确保只发送必要的更新信息到后端接口。这种方式不仅简化了代码逻辑,还提高了代码的可维护性和一致性。

This commit is contained in:
strepsiades
2026-03-30 14:51:01 +08:00
parent f50dc1aed0
commit bdc7bd5069
28 changed files with 416 additions and 129 deletions
+2 -2
View File
@@ -131,8 +131,8 @@ API 数据源中,校验分为三层:
- 例如 `ContractCreate.model_validate(...)``ContractUpdate.model_validate(...)`
- load 响应也会在解析后转为领域 schema
2. 通用更新过滤与差异识别
- `_filter_update_data`仅在 schema 相关字段有变化时提交更新
- `_get_schema_diff`:用于差异字段识别与调试输出
- `build_update_request_data`update 入口,仅在 schema 相关字段有变化时提交更新
- `get_update_schema_diff`update 入口,用于差异字段识别与调试输出
3. 轮询接口输入校验
- `PushIdsSchema` 校验 push_ids 格式后再请求 `/push/result`
+4
View File
@@ -76,10 +76,14 @@ def _apply_strategy_overrides(
runtime_cfg.config = ConfigPresets.get_preset(str(preset))
skip_sync = override.pop("skip_sync", None)
skip_post_check = override.pop("skip_post_check", None)
if skip_sync is not None:
runtime_cfg.skip_sync = bool(skip_sync)
if skip_post_check is not None:
runtime_cfg.skip_post_check = bool(skip_post_check)
if "config" in override and isinstance(override["config"], dict):
runtime_cfg.config = runtime_cfg.config.model_validate(
_deep_merge(runtime_cfg.config.model_dump(), override.pop("config"))
@@ -59,6 +59,10 @@ class StrategyConfig(BaseModel):
# schema diff / validate 时忽略的顶层字段。
compare_ignore_fields: List[str] = Field(default_factory=list)
# 当 auto-bind 命中“多对一”候选时,允许稳定选择一条进行绑定,剩余候选按 orphan/create 流程继续处理。
# 默认关闭,避免在一般场景下引入隐式匹配。
allow_many_to_one_auto_bind: bool = False
class StrategyRuntimeConfig(BaseModel):
"""Pipeline 层策略运行配置(按 node_type)。"""
@@ -67,6 +71,7 @@ class StrategyRuntimeConfig(BaseModel):
node_type: str
skip_sync: bool = False
skip_post_check: bool = False
config: StrategyConfig = Field(default_factory=StrategyConfig)
+64 -58
View File
@@ -17,7 +17,7 @@ import asyncio
from abc import abstractmethod
from copy import deepcopy
from typing import ClassVar, Dict, List, Any, Optional, TYPE_CHECKING, TypeVar
from pydantic import BaseModel
from pydantic import BaseModel, ValidationError
from ...common.type_safety import get_pydantic_model_fields
from ..handler import BaseNodeHandler
@@ -51,9 +51,6 @@ class BaseApiHandler(BaseNodeHandler[T]):
# post-check 将只比较这些 schema 覆盖的字段,过滤后端只读的派生字段。
self.update_schemas: List[type] = []
def set_collection(self, collection: 'DataCollection') -> None:
self._collection = collection
def get_update_fields(self, *, exclude: frozenset = frozenset({'id'})) -> List[str]:
"""从 update_schemas 中提取所有可写字段名,排除标识键(默认排除 id)。"""
fields: set = set()
@@ -167,10 +164,6 @@ class BaseApiHandler(BaseNodeHandler[T]):
payload["steps"] = self._get_request_steps(node) if node is not None else []
return payload
def _build_full_update_data(self, new_data: Dict[str, Any], schema: Any) -> Dict[str, Any]:
validated = schema.model_validate(new_data)
return validated.model_dump(exclude_none=True)
def _mark_approval_snapshot_synced(self, node: 'SyncNode') -> None:
snapshot = self._get_active_approval_snapshot(node)
if snapshot:
@@ -256,7 +249,52 @@ class BaseApiHandler(BaseNodeHandler[T]):
except Exception as e:
return str(e)
def _get_schema_diff(
def _get_update_schema_payload(
self,
schema: Any,
data: Dict[str, Any],
*,
require_valid: bool,
) -> Dict[str, Any] | None:
"""Update 内部实现:提取指定 schema 下的 payload。
这里明确只服务“update schema”,不负责 response model 一致性校验。
这个方法只给 BaseApiHandler 的 update 入口方法复用,不作为 handler 入口。
处理顺序:
1. 先尝试用 update schema 校验,成功则直接使用校验后的 model_dump。
2. 如果校验失败且 require_valid=False,则退化为只抽取 schema 定义的字段。
之所以允许退化,是因为 update 比较时两边快照常常不完整:
某些字段在旧快照缺失,但新数据已经有值。此时应该继续比较 schema
相关字段,而不是把它误判成“无差异”。
空字符串和 None 会被统一过滤掉,因为当前 update handler 并不把它们
当成“清空字段”的显式语义,而是当作“不参与本次更新”。
"""
try:
validated = schema.model_validate(data)
payload = validated.model_dump(exclude_unset=True)
except ValidationError:
if require_valid:
return None
schema_fields = get_pydantic_model_fields(schema)
if not schema_fields:
return {}
payload = {
field_name: data.get(field_name)
for field_name in schema_fields.keys()
if field_name in data
}
return {
field_name: value
for field_name, value in payload.items()
if value not in (None, "")
}
def get_update_schema_diff(
self,
schema,
data: Dict[str, Any],
@@ -264,8 +302,7 @@ class BaseApiHandler(BaseNodeHandler[T]):
node_id: Optional[str] = None,
force_full_schema: bool = False,
) -> Dict[str, Any] | None:
"""
获取数据在指定 schema 下的差异字段
"""Update 入口:获取指定 update schema 下的差异字段。
Args:
schema: Pydantic schema 类
@@ -276,25 +313,21 @@ class BaseApiHandler(BaseNodeHandler[T]):
Returns:
Dict[str, Any] | None: 有差异返回差异字段字典,无差异或字段不全返回 None
"""
from pydantic import ValidationError
# 当前待发送的数据必须能构成合法 update payload;允许旧快照不完整。
new_dict = self._get_update_schema_payload(schema, data, require_valid=True)
origin_dict = self._get_update_schema_payload(schema, origin_data, require_valid=False)
try:
new_model = schema.model_validate(data)
origin_model = schema.model_validate(origin_data)
new_dict = new_model.model_dump(exclude_unset=True)
origin_dict = origin_model.model_dump(exclude_unset=True)
if new_dict is None or origin_dict is None:
return None
if new_dict == origin_dict:
if force_full_schema:
return new_dict
return None
# 返回有差异的字段
diff_fields = {k: v for k, v in new_dict.items() if origin_dict.get(k) != v}
if diff_fields:
# 打印差异详情
node_info = f"[{node_id}]" if node_id else ""
print(f" [DIFF] {self.node_type}{node_info} schema={schema.__name__}")
for k, v in diff_fields.items():
@@ -303,19 +336,14 @@ class BaseApiHandler(BaseNodeHandler[T]):
return diff_fields if diff_fields else None
except ValidationError:
# schema 字段不全,视为无差异
return None
def _filter_update_data(
def build_update_request_data(
self,
new_data: Dict[str, Any],
original_data: Dict[str, Any],
schema: Optional[Any] = None,
force_full_schema: bool = False,
) -> Dict[str, Any]:
"""
过滤出需要更新的字段
"""Update 入口:构造最终要发送给更新接口的请求数据。
规则:
1. 提取 schema 定义的所有字段(包括必填)
@@ -342,29 +370,10 @@ class BaseApiHandler(BaseNodeHandler[T]):
update_data[key] = new_value
return update_data
# 1. 提取 schema 定义的所有字段
schema_fields = set(schema_fields.keys())
schema_data = {}
has_change = False
schema_data = self._get_update_schema_payload(schema, new_data, require_valid=True) or {}
origin_schema_data = self._get_update_schema_payload(schema, original_data, require_valid=False) or {}
for key in schema_fields:
new_value = new_data.get(key)
# 排除空值
if new_value == "" or new_value is None:
continue
schema_data[key] = new_value
# 检查是否变化
original_value = original_data.get(key)
if new_value != original_value:
# 记录具体差异以便排查
# print(f" [DEBUG] Field '{key}' changed: '{original_value}' -> '{new_value}'")
has_change = True
# 2. 只有存在变化时才返回数据
if has_change or force_full_schema:
if force_full_schema or schema_data != origin_schema_data:
return schema_data
return {}
@@ -374,16 +383,12 @@ class BaseApiHandler(BaseNodeHandler[T]):
new_data: Dict[str, Any],
origin_data: Dict[str, Any],
) -> List[str]:
schema_fields = get_pydantic_model_fields(schema)
if not schema_fields:
return []
changed: List[str] = []
for field_name in schema_fields.keys():
if new_data.get(field_name) != origin_data.get(field_name):
changed.append(field_name)
return changed
new_payload = self._get_update_schema_payload(schema, new_data, require_valid=True) or {}
origin_payload = self._get_update_schema_payload(schema, origin_data, require_valid=False) or {}
field_names = sorted(set(new_payload) | set(origin_payload))
return [field_name for field_name in field_names if new_payload.get(field_name) != origin_payload.get(field_name)]
def _build_update_schema_status(
def build_update_schema_status(
self,
*,
schema_name: str,
@@ -393,6 +398,7 @@ class BaseApiHandler(BaseNodeHandler[T]):
will_update: bool,
update_error: Optional[str] = None,
) -> str:
"""Update 入口:生成 update schema 的状态说明文本。"""
new_error = self._validate_schema(new_data, schema)
origin_error = self._validate_schema(origin_data, schema)
changed_fields = self._schema_changed_fields(schema, new_data, origin_data)
@@ -190,7 +190,7 @@ class ConstructionTaskApiHandler(BaseApiHandler):
base_update_error = "show_name changed but task_type != QT"
schema_status_lines.append(
self._build_update_schema_status(
self.build_update_schema_status(
schema_name="ConstructionUpdate",
schema=ConstructionUpdate,
new_data=data,
@@ -238,7 +238,7 @@ class ConstructionTaskApiHandler(BaseApiHandler):
plan_update_error = str(e)
schema_status_lines.append(
self._build_update_schema_status(
self.build_update_schema_status(
schema_name="ConstructionPlanUpdate",
schema=ConstructionPlanUpdate,
new_data=data,
@@ -124,9 +124,9 @@ class ConstructionTaskDetailApiHandler(BaseApiHandler):
origin_data = node.get_origin_data() or {}
# 使用 _get_schema_diff 检查差异并打印日志
# 使用 get_update_schema_diff 作为 update 入口检查差异并打印日志
force_steps_update = self._steps_changed(node)
diff_fields = self._get_schema_diff(
diff_fields = self.get_update_schema_diff(
ConstructionDetailUpdate,
data,
origin_data,
@@ -145,7 +145,7 @@ class ConstructionTaskDetailApiHandler(BaseApiHandler):
continue
# 需要完整的 schema 数据(包括必填字段)
update_data = self._filter_update_data(
update_data = self.build_update_request_data(
data,
origin_data,
ConstructionDetailUpdate,
@@ -256,7 +256,7 @@ class ContractApiHandler(BaseApiHandler):
# 过滤出需要更新的字段(排除空值、未变化的字段)
origin_data = node.get_origin_data() or {}
force_steps_update = self._steps_changed(node)
update_data = self._filter_update_data(
update_data = self.build_update_request_data(
new_data=data,
original_data=origin_data,
schema=ContractUpdate,
@@ -93,7 +93,7 @@ class ContractChangeApiHandler(BaseApiHandler):
origin_data = node.get_origin_data() or {}
force_steps_update = self._steps_changed(node)
update_data = self._filter_update_data(
update_data = self.build_update_request_data(
node_data,
origin_data,
PostContractChange,
@@ -140,7 +140,7 @@ class ContractSettlementApiHandler(BaseApiHandler):
# 1. 基础信息更新 (ContractSettlementUpdate)
force_steps_update = self._steps_changed(node)
base_diff = self._get_schema_diff(
base_diff = self.get_update_schema_diff(
ContractSettlementUpdate,
data,
origin_data,
@@ -167,7 +167,7 @@ class ContractSettlementApiHandler(BaseApiHandler):
error = f"API error: {e}"
# 2. 计划信息更新 (ContractSettlementPlanUpdate)
plan_diff = self._get_schema_diff(ContractSettlementPlanUpdate, data, origin_data, node.node_id)
plan_diff = self.get_update_schema_diff(ContractSettlementPlanUpdate, data, origin_data, node.node_id)
if not error and plan_diff:
try:
plan_model = ContractSettlementPlanUpdate.model_validate(data)
@@ -122,9 +122,9 @@ class ContractSettlementDetailApiHandler(BaseApiHandler):
origin_data = node.get_origin_data() or {}
# 使用 _get_schema_diff 检查差异并打印日志
# 使用 get_update_schema_diff 作为 update 入口检查差异并打印日志
force_steps_update = self._steps_changed(node)
diff_fields = self._get_schema_diff(
diff_fields = self.get_update_schema_diff(
ContractSettlementDetailUpdate,
data,
origin_data,
@@ -143,7 +143,7 @@ class ContractSettlementDetailApiHandler(BaseApiHandler):
continue
# 需要完整的 schema 数据(包括必填字段)
update_data = self._filter_update_data(
update_data = self.build_update_request_data(
data,
origin_data,
ContractSettlementDetailUpdate,
+1 -1
View File
@@ -118,7 +118,7 @@ class LarApiHandler(BaseApiHandler):
for schema, api_func in update_configs:
# 获取过滤后的更新数据
update_data = self._filter_update_data(
update_data = self.build_update_request_data(
node_data,
origin_data,
schema,
@@ -104,7 +104,7 @@ class LarChangeApiHandler(BaseApiHandler):
continue
origin_data = node.get_origin_data() or {}
force_steps_update = self._steps_changed(node)
update_data = self._filter_update_data(
update_data = self.build_update_request_data(
node_data,
origin_data,
LarChangeUpdateSchema,
@@ -106,7 +106,7 @@ class MaterialApiHandler(BaseApiHandler):
# 1. 基础信息更新 (MaterialUpdate)
force_steps_update = self._steps_changed(node)
base_diff = self._get_schema_diff(
base_diff = self.get_update_schema_diff(
MaterialUpdate,
data,
origin_data,
@@ -131,7 +131,7 @@ class MaterialApiHandler(BaseApiHandler):
error = f"{ERROR_VALIDATION_FAILED}: {e}"
# 2. 计划信息更新 (MaterialPlanUpdate)
plan_diff = self._get_schema_diff(MaterialPlanUpdate, data, origin_data, node.node_id)
plan_diff = self.get_update_schema_diff(MaterialPlanUpdate, data, origin_data, node.node_id)
if not error and plan_diff:
try:
plan_model = MaterialPlanUpdate.model_validate(data)
@@ -144,9 +144,9 @@ class MaterialDetailApiHandler(BaseApiHandler):
origin_data = node.get_origin_data() or {}
# 使用 _get_schema_diff 检查差异并打印日志
# 使用 get_update_schema_diff 作为 update 入口检查差异并打印日志
force_steps_update = self._steps_changed(node)
diff_fields = self._get_schema_diff(
diff_fields = self.get_update_schema_diff(
MaterialDetailUpdate,
data,
origin_data,
@@ -165,7 +165,7 @@ class MaterialDetailApiHandler(BaseApiHandler):
continue
# 需要完整的 schema 数据(包括必填字段)
update_data = self._filter_update_data(
update_data = self.build_update_request_data(
data,
origin_data,
MaterialDetailUpdate,
@@ -121,7 +121,7 @@ class PersonnelApiHandler(BaseApiHandler):
# 1. 基础信息更新 (PowerUpdate)
force_steps_update = self._steps_changed(node)
base_diff = self._get_schema_diff(
base_diff = self.get_update_schema_diff(
PowerUpdate,
data,
origin_data,
@@ -111,9 +111,9 @@ class PersonnelDetailApiHandler(BaseApiHandler):
origin_data = node.get_origin_data() or {}
# 使用 _get_schema_diff 检查差异并打印日志
# 使用 get_update_schema_diff 作为 update 入口检查差异并打印日志
force_steps_update = self._steps_changed(node)
diff_fields = self._get_schema_diff(
diff_fields = self.get_update_schema_diff(
PowerDetailUpdate,
data,
origin_data,
@@ -132,7 +132,7 @@ class PersonnelDetailApiHandler(BaseApiHandler):
continue
# 需要完整的 schema 数据(包括必填字段)
update_data = self._filter_update_data(
update_data = self.build_update_request_data(
data,
origin_data,
PowerDetailUpdate,
@@ -94,7 +94,7 @@ class PreparationApiHandler(BaseApiHandler):
origin_data = node.get_origin_data() or {}
force_steps_update = self._steps_changed(node)
update_data = self._filter_update_data(
update_data = self.build_update_request_data(
node_data,
origin_data,
PostPreparation,
@@ -99,7 +99,7 @@ class ProductionApiHandler(BaseApiHandler):
# 获取过滤后的更新数据
force_steps_update = self._steps_changed(node)
update_data = self._filter_update_data(
update_data = self.build_update_request_data(
node_data,
origin_data,
PostProduction,
@@ -234,7 +234,7 @@ class ProjectApiHandler(BaseApiHandler):
# 遍历所有更新 schema,检查差异并更新
for schema, api_func in update_configs:
update_data = self._get_schema_diff(
update_data = self.get_update_schema_diff(
schema,
data,
original_data,
@@ -244,9 +244,9 @@ class ProjectApiHandler(BaseApiHandler):
if not update_data:
continue
# 执行更新(差异已由 _get_schema_diff 打印)
# 执行更新(差异已由 get_update_schema_diff 打印)
try:
full_update_data = self._filter_update_data(
full_update_data = self.build_update_request_data(
data,
original_data,
schema,
@@ -94,7 +94,7 @@ class UnitsApiHandler(BaseApiHandler):
origin_data = node.get_origin_data() or {}
force_steps_update = self._steps_changed(node)
update_data = self._filter_update_data(
update_data = self.build_update_request_data(
node_data,
origin_data,
PostGeneratorUnits,
+1
View File
@@ -264,6 +264,7 @@ def _build_strategies(
if runtime_cfg is not None:
strategy.set_config(runtime_cfg.config.model_copy(deep=True))
strategy.skip_sync = bool(runtime_cfg.skip_sync)
strategy.skip_post_check = bool(runtime_cfg.skip_post_check)
strategies.append(strategy)
return strategies
@@ -509,8 +509,22 @@ class FullSyncPipeline:
else:
self._logger.info("🔄 Post-check: reloading all node types for final consistency evaluation...")
for node_type in self.node_types:
strategy = next((item for item in self.strategies if item.node_type == node_type), None)
if strategy is not None and strategy.skip_post_check:
self._logger.info("⏭️ Post-check reload skipped: node_type=%s", node_type)
continue
await self._reload_node_type(node_type, reason="post-check final reload")
for node_type in self.node_types:
strategy = next((item for item in self.strategies if item.node_type == node_type), None)
if strategy is not None and strategy.skip_post_check:
self._logger.info("⏭️ Post-check skipped: node_type=%s", node_type)
self._consistency_by_type[node_type] = {
"ok": True,
"checked_pairs": 0,
"mismatch_count": 0,
"skipped": True,
}
continue
await self._evaluate_consistency_for_node_type(node_type)
self.stats["consistency"] = {
@@ -45,6 +45,7 @@ class BaseSyncStrategy(Generic[T]):
skip_sync: bool - 如果为 True,则跳过该类型的 bind/create/update/sync 阶段
数据仍会被加载,但不会执行任何同步操作
适用于只需要加载数据供其他类型引用的场景(如 supplier)
skip_post_check: bool - 如果为 True,则跳过该类型最终 post-check 的 reload 与一致性校验
"""
# 类变量:默认配置(子类可覆盖)
default_config: StrategyConfig = StrategyConfig()
@@ -52,6 +53,8 @@ class BaseSyncStrategy(Generic[T]):
schema: Type[T] = None # type: ignore
# 类变量:是否默认跳过同步(子类可覆盖)
default_skip_sync: bool = False
# 类变量:是否默认跳过 post-check(子类可覆盖)
default_skip_post_check: bool = False
def __init__(
self,
@@ -71,6 +74,8 @@ class BaseSyncStrategy(Generic[T]):
self.config = self.default_config.model_copy(deep=True)
# 是否跳过同步(可运行时修改)
self.skip_sync = self.default_skip_sync
# 是否跳过 post-check(可运行时修改)
self.skip_post_check = self.default_skip_post_check
# 统一由 Pipeline 注入 runtime;未注入时在执行阶段显式报错
self.sm_runtime: Optional[StateMachineRuntime] = None
self._schema_diff_validator: Optional[SchemaDiffValidator] = None
@@ -16,6 +16,12 @@ if TYPE_CHECKING:
logger = logging.getLogger(__name__)
def _stable_pick_bind_pair(local_candidates: List["SyncNode"], remote_candidates: List["SyncNode"]):
local_node = sorted(local_candidates, key=lambda item: ((item.data_id or ""), item.node_id))[0]
remote_node = sorted(remote_candidates, key=lambda item: ((item.data_id or ""), item.node_id))[0]
return local_node, remote_node
async def run_bind(strategy, **kwargs):
logger.info(f"[{strategy.node_type}] Starting Binding Pipeline...")
@@ -519,6 +525,55 @@ async def phase_auto_binding(strategy, local_nodes: List["SyncNode"], remote_nod
}
)
many_local_one_remote = len(l_remain) > 1 and len(r_remain) == 1
one_local_many_remote = len(l_remain) == 1 and len(r_remain) > 1
if strategy.config.allow_many_to_one_auto_bind and (many_local_one_remote or one_local_many_remote):
chosen_local, chosen_remote = _stable_pick_bind_pair(l_remain, r_remain)
if chosen_local.binding_status == BindingStatus.MISSING:
pending_auto_bind_updates.append(
{
"node": chosen_local,
"outcome": "ONE_TO_ONE",
"create_enabled": None,
"bind_remote_node_id": chosen_remote.node_id,
}
)
if chosen_remote.binding_status == BindingStatus.MISSING:
pending_auto_bind_updates.append(
{
"node": chosen_remote,
"outcome": "ONE_TO_ONE",
"create_enabled": None,
"bind_remote_node_id": None,
}
)
for n in l_remain:
if n.node_id == chosen_local.node_id or n.binding_status != BindingStatus.MISSING:
continue
pending_auto_bind_updates.append(
{
"node": n,
"outcome": "ZERO",
"create_enabled": local_create_enabled,
"bind_remote_node_id": None,
}
)
for n in r_remain:
if n.node_id == chosen_remote.node_id or n.binding_status != BindingStatus.MISSING:
continue
pending_auto_bind_updates.append(
{
"node": n,
"outcome": "ZERO",
"create_enabled": remote_create_enabled,
"bind_remote_node_id": None,
}
)
else:
if (len(l_remain) > 1 and len(r_remain) >= 1) or (len(l_remain) == 1 and len(r_remain) > 1):
for n in l_remain:
if n.binding_status == BindingStatus.MISSING:
@@ -572,3 +627,25 @@ async def phase_auto_binding(strategy, local_nodes: List["SyncNode"], remote_nod
reason = f"{reason} | detail={detail}"
node.error = reason
logger.debug(f"[{strategy.node_type}] 自动绑定阻断: node={node.node_id}, reason={reason}")
outcome_counts: Dict[str, int] = {}
create_enabled_count = 0
bound_pairs = 0
for item in pending_auto_bind_updates:
outcome = str(item.get("outcome") or "NONE")
outcome_counts[outcome] = outcome_counts.get(outcome, 0) + 1
if item.get("create_enabled"):
create_enabled_count += 1
if item.get("bind_remote_node_id"):
bound_pairs += 1
if pending_auto_bind_updates:
ordered = ", ".join(f"{key}={outcome_counts[key]}" for key in sorted(outcome_counts))
logger.info(
"[%s] Auto-bind summary: candidates=%d, bind_pairs=%d, create_enabled=%d, outcomes={%s}",
strategy.node_type,
len(pending_auto_bind_updates),
bound_pairs,
create_enabled_count,
ordered,
)
@@ -193,6 +193,30 @@ async def test_auto_binding_skip_on_ambiguous_migrated(setup_env):
assert await bm.get_local_id("test_project", "r1") is None
@pytest.mark.asyncio
async def test_auto_binding_many_to_one_can_bind_stable_pick_and_leave_rest_for_create(setup_env):
local, remote, bm, _ = setup_env
strategy = TestProjectStrategy("test_project", local, remote, bm)
strategy.update_config(
auto_bind=True,
auto_bind_fields=["code"],
depend_fields={},
local_orphan_action=OrphanAction.CREATE_REMOTE,
allow_many_to_one_auto_bind=True,
)
await local.add(build_project_node("l2", "P2", name="B", code="AMB-2"))
await local.add(build_project_node("l1", "P1", name="A", code="AMB-2"))
await remote.add(build_project_node("r1", "RP1", name="A", code="AMB-2"))
await strategy.bind()
assert await bm.get_remote_id("test_project", "l1") == "r1"
assert await bm.get_remote_id("test_project", "l2") is None
assert await bm.get_local_id("test_project", "r1") == "l1"
@pytest.mark.asyncio
async def test_pre_bind_data_id_works_when_auto_bind_disabled(setup_env):
local, remote, bm, _ = setup_env
@@ -0,0 +1,94 @@
from __future__ import annotations
from typing import Any
from pydantic import BaseModel
from sync_state_machine.datasource.api.handler import BaseApiHandler
from sync_state_machine.datasource.task_result import TaskResult
class _UpdateSchema(BaseModel):
id: str
required_value: float
optional_text: str | None = None
class _DummyApiHandler(BaseApiHandler[BaseModel]):
_node_type = "dummy"
_node_class = object # type: ignore[assignment]
_schema = BaseModel
async def create_all(self, nodes):
return [TaskResult.success(node_id="dummy")]
async def update_all(self, nodes):
return [TaskResult.success(node_id="dummy")]
async def delete_all(self, nodes):
return [TaskResult.success(node_id="dummy")]
async def load(self):
return []
def test_get_update_schema_diff_falls_back_to_schema_fields_when_origin_is_incomplete() -> None:
handler = _DummyApiHandler()
diff = handler.get_update_schema_diff(
_UpdateSchema,
{"id": "node-1", "required_value": 4.0, "optional_text": "ok"},
{"id": "node-1"},
node_id="node-1",
)
assert diff == {"required_value": 4.0, "optional_text": "ok"}
def test_build_update_request_data_uses_same_schema_projection_as_diff() -> None:
handler = _DummyApiHandler()
payload = handler.build_update_request_data(
{"id": "node-1", "required_value": 4.0, "optional_text": "ok", "ignored": "x"},
{"id": "node-1"},
schema=_UpdateSchema,
)
assert payload == {"id": "node-1", "required_value": 4.0, "optional_text": "ok"}
def test_schema_changed_fields_matches_update_payload_comparison() -> None:
handler = _DummyApiHandler()
changed_fields = handler._schema_changed_fields(
_UpdateSchema,
{"id": "node-1", "required_value": 4.0, "optional_text": "ok"},
{"id": "node-1", "required_value": 4.0},
)
assert changed_fields == ["optional_text"]
def test_update_schema_payload_filters_empty_values() -> None:
handler = _DummyApiHandler()
payload = handler._get_update_schema_payload(
_UpdateSchema,
{"id": "node-1", "required_value": 4.0, "optional_text": ""},
require_valid=False,
)
assert payload == {"id": "node-1", "required_value": 4.0}
def test_get_update_schema_diff_skips_schema_when_new_data_is_still_incomplete() -> None:
handler = _DummyApiHandler()
diff = handler.get_update_schema_diff(
_UpdateSchema,
{"id": "node-1"},
{"id": "node-1", "required_value": 2.0},
node_id="node-1",
)
assert diff is None
@@ -31,6 +31,7 @@ class _StubStrategy:
def __init__(self, node_type: str):
self.node_type = node_type
self.skip_sync = False
self.skip_post_check = False
self.config = SimpleNamespace(
depend_fields={},
update_direction=None,
@@ -194,3 +195,54 @@ async def test_evaluate_consistency_merges_compare_and_post_check_ignore_fields(
assert captured["ignore_fields"] == ["updated_at", "code", "audit_status"]
assert result["ignore_fields"] == ["updated_at", "code", "audit_status"]
@pytest.mark.asyncio
async def test_phase_post_check_skips_configured_node_types(monkeypatch: pytest.MonkeyPatch) -> None:
supplier_strategy = _StubStrategy("supplier")
supplier_strategy.skip_post_check = True
project_strategy = _StubStrategy("project")
pipeline = FullSyncPipeline(
local_datasource=_FakeDataSource(),
remote_datasource=_FakeDataSource(),
strategies=[supplier_strategy, project_strategy],
persistence=_FakePersistence(),
local_collection=DataCollection("local"),
remote_collection=DataCollection("remote"),
binding_manager=BindingManager(_FakePersistence(), auto_persist=False),
node_types=["supplier", "project"],
load_order=["supplier", "project"],
sync_order=["supplier", "project"],
enable_persistence=False,
)
reload_calls: list[str] = []
evaluated: list[str] = []
async def fake_reload(node_type: str, *, reason: str) -> None:
del reason
reload_calls.append(node_type)
async def fake_evaluate(node_type: str):
evaluated.append(node_type)
return {"ok": True, "checked_pairs": 1, "mismatch_count": 0}
async def fake_print_summary() -> None:
return None
monkeypatch.setattr(pipeline, "_reload_node_type", fake_reload)
monkeypatch.setattr(pipeline, "_evaluate_consistency_for_node_type", fake_evaluate)
monkeypatch.setattr(pipeline, "print_summary", fake_print_summary)
result = await pipeline.phase_post_check()
assert result is True
assert reload_calls == ["project"]
assert evaluated == ["project"]
assert pipeline._consistency_by_type["supplier"] == {
"ok": True,
"checked_pairs": 0,
"mismatch_count": 0,
"skipped": True,
}
@@ -8,6 +8,7 @@ def test_strategy_runtime_config_skip_sync_defaults_false() -> None:
runtime_config = StrategyRuntimeConfig(node_type="project")
assert runtime_config.skip_sync is False
assert runtime_config.skip_post_check is False
def test_apply_strategy_overrides_allows_skip_sync_override() -> None:
@@ -16,6 +17,7 @@ def test_apply_strategy_overrides_allows_skip_sync_override() -> None:
strategy_overrides={
"project": {
"skip_sync": True,
"skip_post_check": True,
}
},
)
@@ -23,6 +25,7 @@ def test_apply_strategy_overrides_allows_skip_sync_override() -> None:
assert len(resolved) == 1
assert resolved[0].node_type == "project"
assert resolved[0].skip_sync is True
assert resolved[0].skip_post_check is True
def test_strategy_config_supports_both_post_check_ignore_fields() -> None:
@@ -30,8 +33,10 @@ def test_strategy_config_supports_both_post_check_ignore_fields() -> None:
{
"post_check_ignore_fields": ["code"],
"post_check_ignore_list_item_fields": {"plan_node": ["is_audit"]},
"allow_many_to_one_auto_bind": True,
}
)
assert config.post_check_ignore_fields == ["code"]
assert config.post_check_ignore_list_item_fields == {"plan_node": ["is_audit"]}
assert config.allow_many_to_one_auto_bind is True