增加了项目侧关于steps的处理。允许保存和提取steps信息。

sync_state_machine/domain/personnel/api_handler.py

@@ -63,7 +63,12 @@ class PersonnelApiHandler(BaseApiHandler):
             try:
                 request_data = {"project_id": project_id, **data}
                 PowerCreate.model_validate(request_data)
-                response = await api_create_personnel(self.api_client, request_data, push_id)
+                response = await api_create_personnel(
+                    self.api_client,
+                    request_data,
+                    push_id,
+                    steps=self._get_request_steps(node),
+                )
                 if self.poll_mode == "sync":
                     created_id = self._extract_created_id_from_response(response)
                     if not created_id:
@@ -111,14 +116,31 @@ class PersonnelApiHandler(BaseApiHandler):
             
             node_updated = False
             error = None
+            steps_payload = self._get_request_steps(node)
+            steps_sent = False
             
             # 1. 基础信息更新 (PowerUpdate)
-            base_diff = self._get_schema_diff(PowerUpdate, data, origin_data, node.node_id)
+            force_steps_update = self._steps_changed(node)
+            base_diff = self._get_schema_diff(
+                PowerUpdate,
+                data,
+                origin_data,
+                node.node_id,
+                force_full_schema=force_steps_update,
+            )
             if base_diff:
                 try:
                     update_model = PowerUpdate.model_validate(data)
                     push_id = self._generate_push_id()
-                    await api_update_personnel(self.api_client, update_model.model_dump(), push_id, biz_id)
+                    await api_update_personnel(
+                        self.api_client,
+                        update_model.model_dump(),
+                        push_id,
+                        biz_id,
+                        steps=steps_payload if not steps_sent else [],
+                    )
+                    self._mark_approval_snapshot_synced(node)
+                    steps_sent = steps_sent or bool(steps_payload)
                     node_updated = True
                 except ValidationError as e:
                     error = f"Validation failed: {e}"
@@ -144,7 +166,10 @@ class PersonnelApiHandler(BaseApiHandler):
                         plan_model.model_dump(),
                         push_id,
                         biz_id,
+                        steps=steps_payload if not steps_sent else [],
                     )
+                    self._mark_approval_snapshot_synced(node)
+                    steps_sent = steps_sent or bool(steps_payload)
                     node_updated = True
                 except ValidationError as e:
                     error = f"Validation failed: {e}"
@@ -207,18 +232,31 @@ async def api_get_personnel(client, personnel_id: str) -> Dict[str, Any]:
     return response.get("data", {})
 
 
-async def api_create_personnel(client, data: Dict[str, Any], push_id: str) -> Dict[str, Any]:
+async def api_create_personnel(
+    client,
+    data: Dict[str, Any],
+    push_id: str,
+    *,
+    steps: List[Dict[str, Any]] | None = None,
+) -> Dict[str, Any]:
     """创建力能 POST /personnel/create"""
-    request_data = {"push_id": push_id, "data": data}
+    request_data = {"push_id": push_id, "data": data, "steps": steps or []}
     response = await client.request(method="POST", endpoint="/personnel/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_personnel(client, data: Dict[str, Any], push_id: str, biz_id: str) -> None:
+async def api_update_personnel(
+    client,
+    data: Dict[str, Any],
+    push_id: str,
+    biz_id: str,
+    *,
+    steps: List[Dict[str, Any]] | None = None,
+) -> None:
     """更新力能 PUT /personnel/update"""
-    request_data = {"push_id": push_id, "biz_id": biz_id, "data": data}
+    request_data = {"push_id": push_id, "biz_id": biz_id, "data": data, "steps": steps or []}
     response = await client.request(method="PUT", endpoint="/personnel/update", data=request_data)
     if response.get("code") != 200:
         raise Exception(f"API error: {response.get('message', 'Unknown error')}")
@@ -252,9 +290,16 @@ async def api_delete_personnel(client, personnel_id: str, push_id: str) -> None:
         raise Exception(f"API error: {response.get('message', 'Unknown error')}")
 
 
-async def api_update_personnel_plan(client, data: Dict[str, Any], push_id: str, biz_id: str) -> None:
+async def api_update_personnel_plan(
+    client,
+    data: Dict[str, Any],
+    push_id: str,
+    biz_id: str,
+    *,
+    steps: List[Dict[str, Any]] | None = None,
+) -> None:
     """更新力能计划 PUT /personnel/plan"""
-    request_data = {"push_id": push_id, "biz_id": biz_id, "data": data}
+    request_data = {"push_id": push_id, "biz_id": biz_id, "data": data, "steps": steps or []}
     response = await client.request(method="PUT", endpoint="/personnel/plan", data=request_data)
     if response.get("code") != 200:
         raise Exception(f"API error: {response.get('message', 'Unknown error')}")