优化

lastleg-service/src/main/resources/openapi/overseas-business-v1.yaml

@@ -65,6 +65,7 @@ paths:
         - { name: orderNo, in: query, schema: { type: string } }
         - { name: fbaWarehouseCode, in: query, schema: { type: string } }
         - { name: sourceStage, in: query, schema: { type: string, enum: [PLAN, RECEIVED] } }
+        - { name: draftToken, in: query, schema: { type: string, maxLength: 64 }, description: 当前智能排车草稿标识；当前草稿已锁托盘仍可见 }
       responses:
         '200':
           description: 统一 ApiResponse 包装的候选托盘数组
@@ -98,6 +99,36 @@ paths:
       security: [{ bearerAuth: [] }]
       requestBody: { required: true, content: { application/json: { schema: { $ref: '#/components/schemas/SmartDispatchDraftRelease' } } } }
       responses: { '200': { description: 草稿锁已全部释放 } }
+  /api/platform/v1/last-leg/dispatches/drafts:
+    get:
+      summary: 查询当前操作人的有效智能排车草稿
+      description: 权限 platform:overseas-warehouse:inbound-order:smart-dispatch；只返回当前操作人未失效且未释放的草稿。
+      security: [{ bearerAuth: [] }]
+      responses:
+        '200': { description: 统一 ApiResponse 包装的智能排车草稿数组, content: { application/json: { schema: { type: array, items: { $ref: '#/components/schemas/SmartDispatchDraft' } } } } }
+  /api/platform/v1/last-leg/dispatches/drafts/snapshot:
+    post:
+      summary: 保存智能排车草稿布局快照
+      description: 权限 platform:overseas-warehouse:inbound-order:smart-dispatch；草稿仅归当前操作人。
+      security: [{ bearerAuth: [] }]
+      requestBody: { required: true, content: { application/json: { schema: { $ref: '#/components/schemas/SmartDispatchDraftSnapshot' } } } }
+      responses: { '200': { description: 草稿快照保存成功 } }
+  /api/platform/v1/last-leg/dispatches/drafts/containers:
+    post:
+      summary: 在智能排车草稿中新增车厢
+      description: 权限 platform:overseas-warehouse:inbound-order:smart-dispatch；返回服务端生成的字符串 ID。
+      security: [{ bearerAuth: [] }]
+      requestBody: { required: true, content: { application/json: { schema: { $ref: '#/components/schemas/SmartDispatchDraftContainerCreate' } } } }
+      responses: { '200': { description: 统一 ApiResponse 包装的草稿车厢, content: { application/json: { schema: { $ref: '#/components/schemas/SmartDispatchDraftContainer' } } } } }
+  /api/platform/v1/last-leg/dispatches/drafts/{draftToken}/containers/{containerId}:
+    delete:
+      summary: 删除智能排车草稿中的空车厢
+      description: 权限 platform:overseas-warehouse:inbound-order:smart-dispatch；仅允许当前操作人删除未绑定托盘的草稿车厢。
+      security: [{ bearerAuth: [] }]
+      parameters:
+        - { name: draftToken, in: path, required: true, schema: { type: string, maxLength: 64 } }
+        - { name: containerId, in: path, required: true, schema: { type: string } }
+      responses: { '200': { description: 空车厢删除成功 }, '409': { description: 车厢仍绑定托盘或草稿状态冲突 } }
   /api/platform/v1/last-leg/overseas-procurements:
     get:
       summary: 分页查询海外采购订单
@@ -352,11 +383,40 @@ components:
       properties:
         planPalletId: { type: string }
         draftToken: { type: string, minLength: 1, maxLength: 64 }
+        draftContainerId: { type: string, nullable: true, description: 托盘所在草稿车厢ID }
     SmartDispatchDraftRelease:
       type: object
       required: [draftToken]
       properties:
         draftToken: { type: string, minLength: 1, maxLength: 64 }
+    SmartDispatchDraftSnapshot:
+      type: object
+      required: [draftToken, planIds, containersJson]
+      properties:
+        draftToken: { type: string, minLength: 1, maxLength: 64 }
+        planIds: { type: array, minItems: 1, maxItems: 500, uniqueItems: true, items: { type: string } }
+        containersJson: { type: string, minLength: 1, maxLength: 20000 }
+    SmartDispatchDraftContainerCreate:
+      type: object
+      required: [draftToken, capacity]
+      properties:
+        draftToken: { type: string, minLength: 1, maxLength: 64 }
+        capacity: { type: integer, minimum: 1, maximum: 500 }
+    SmartDispatchDraft:
+      type: object
+      required: [draftToken, containers]
+      properties:
+        draftToken: { type: string }
+        planIdsJson: { type: string, nullable: true }
+        containersJson: { type: string, nullable: true }
+        containers: { type: array, items: { $ref: '#/components/schemas/SmartDispatchDraftContainer' } }
+    SmartDispatchDraftContainer:
+      type: object
+      required: [id, capacity, palletIds]
+      properties:
+        id: { type: string }
+        capacity: { type: integer }
+        palletIds: { type: array, items: { type: string } }
     DispatchResponse:
       type: object
       properties: