优化

firstleg/src/main/resources/openapi/firstleg-v1.yaml

@@ -363,6 +363,8 @@ paths:
       description: >-
         需要 platform:firstleg:smart-loading:push 权限。真实柜号必须已录入，
         否则不得推送预装清单或创建 PDA作业任务；计划必须处于 EDITING 且版本匹配。
+        推送事务会先为所有已分配入库单建立 PENDING 预装计划与 EDITING 柜次计划的正式关联，
+        任一关联缺失、版本冲突或分配数量为零都会整体失败并禁止 PDA/LOADING；不得在 LOADING 后补关联。
       parameters:
         - {name: planId, in: path, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
         - {$ref: '#/components/parameters/IdempotencyKey'}

firstleg/src/main/resources/openapi/phase3-loading-model-bridge-v1.yaml

@@ -2,6 +2,7 @@ openapi: 3.0.3
 info:
   title: Phase 3 Preload and Container Loading Bridge API
   version: 1.0.0
+  description: Links must be created while preload=PENDING and loadingPlan=EDITING. Smart-loading push creates all allocated links atomically before PDA task creation; LOADING plans cannot be repaired through post-hoc binding.
 paths:
   /api/platform/v1/inbounds/{inboundId}/preload/loading-plans:
     get:
@@ -12,7 +13,7 @@ paths:
   /api/platform/v1/inbounds/{inboundId}/preload/loading-plans/{loadingPlanId}:
     post:
       summary: Atomically link an inbound preload and a container loading plan
-      description: Both optimistic-lock versions must match; either conflict rolls back the whole link operation.
+      description: Both optimistic-lock versions must match; either conflict rolls back the whole link operation. This endpoint never permits post-hoc binding after the loading plan enters LOADING.
       parameters: [{$ref: '#/components/parameters/InboundId'}, {$ref: '#/components/parameters/LoadingPlanId'}, {$ref: '#/components/parameters/TenantId'}, {$ref: '#/components/parameters/IdempotencyKey'}]
       requestBody:
         required: true