feat: explain supplemental pallet counts

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

@@ -169,7 +169,7 @@ paths:
   /api/platform/v1/last-leg/orders:
     get:
       summary: 分页查询尾程订单
-      description: 权限 platform:overseas-warehouse:last-mile-order:list；平台管理员省略 customerId 时查询全部客户。
+      description: 权限 platform:overseas-warehouse:last-mile-order:list；平台管理员省略 customerId 时查询全部客户。containerNode 来自稳定 sourceContainerBookingId 对应的柜级船节点门禁。
       security: [{ bearerAuth: [] }]
       parameters:
         - { name: page, in: query, schema: { type: integer, minimum: 1, default: 1 } }
@@ -190,7 +190,7 @@ paths:
   /api/platform/v1/last-leg/orders/{id}:
     get:
       summary: 查询尾程订单详情
-      description: 权限 platform:overseas-warehouse:last-mile-order:list；返回订单、货物、状态历史、费用明细和操作记录。
+      description: 权限 platform:overseas-warehouse:last-mile-order:list；返回订单、货物、状态历史、费用明细和操作记录。订单中的 containerNode 来自稳定 sourceContainerBookingId 对应的柜级船节点门禁。
       security: [{ bearerAuth: [] }]
       parameters:
         - { name: id, in: path, required: true, schema: { type: integer, format: int64 } }
@@ -2806,7 +2806,7 @@ components:
         version: { type: integer }
     ContainerInboundPlanPreview:
       type: object
-      required: [sourceContainerBookingId, snapshotVersion, snapshotHash, totalOrderCount, readyOrderCount, blockedOrderCount, pendingOrderCount, pendingPalletCount, existingPlannedPalletCount, totalSuggestedPalletCount, totalPlannedPalletCount, ready, groups]
+      required: [sourceContainerBookingId, snapshotVersion, snapshotHash, totalOrderCount, readyOrderCount, blockedOrderCount, pendingOrderCount, pendingPalletCount, sourcePalletCount, supplementPalletCount, existingPlannedPalletCount, totalSuggestedPalletCount, totalPlannedPalletCount, ready, groups]
       properties:
         sourceContainerBookingId: { type: string }
         containerNo: { type: string, nullable: true }
@@ -2819,7 +2819,9 @@ components:
         readyOrderCount: { type: integer }
         blockedOrderCount: { type: integer }
         pendingOrderCount: { type: integer, description: 本次确认将新建计划的 READY 订单数 }
-        pendingPalletCount: { type: integer, description: 本次确认将向资源服务批量预留的新托盘数 }
+        pendingPalletCount: { type: integer, description: 本次确认最终向资源服务批量预留的托盘总数，包含头程已有编码及海外补充编码 }
+        sourcePalletCount: { type: integer, description: 本次处理订单随头程装柜完成事件冻结并传入的托盘码数 }
+        supplementPalletCount: { type: integer, description: 最终托数超过头程已有托盘码数时，在海外仓连续补充的托盘码数 }
         existingPlannedPalletCount: { type: integer, description: 已有有效计划的托盘总数，不计入本次新增 }
         totalSuggestedPalletCount: { type: integer }
         totalPlannedPalletCount: { type: integer }
@@ -2827,7 +2829,7 @@ components:
         groups: { type: array, items: { $ref: '#/components/schemas/ContainerInboundPlanPreviewGroup' } }
     ContainerInboundPlanPreviewGroup:
       type: object
-      required: [destinationType, orderCount, pendingOrderCount, pendingPalletCount, existingPlannedPalletCount, suggestedPalletCount, plannedPalletCount, orders]
+      required: [destinationType, orderCount, pendingOrderCount, pendingPalletCount, sourcePalletCount, supplementPalletCount, existingPlannedPalletCount, suggestedPalletCount, plannedPalletCount, orders]
       properties:
         destinationType: { type: string, enum: [FBA, ONE_CLICK_DROPSHIP, PRIVATE_ADDRESS] }
         destinationWarehouseId: { type: string, nullable: true }
@@ -2836,13 +2838,15 @@ components:
         orderCount: { type: integer }
         pendingOrderCount: { type: integer }
         pendingPalletCount: { type: integer }
+        sourcePalletCount: { type: integer }
+        supplementPalletCount: { type: integer }
         existingPlannedPalletCount: { type: integer }
         suggestedPalletCount: { type: integer }
         plannedPalletCount: { type: integer }
         orders: { type: array, items: { $ref: '#/components/schemas/ContainerInboundPlanPreviewOrder' } }
     ContainerInboundPlanPreviewOrder:
       type: object
-      required: [customerId, orderId, businessOrderNo, orderType, destinationType, packageCount, volumeCbm, orderVersion, readiness, blockers]
+      required: [customerId, orderId, businessOrderNo, orderType, destinationType, packageCount, volumeCbm, sourcePalletCount, targetPalletCount, supplementPalletCount, orderVersion, readiness, blockers]
       properties:
         customerId: { type: string }
         customerName: { type: string, nullable: true }
@@ -2858,11 +2862,14 @@ components:
         packageCount: { type: integer }
         volumeCbm: { type: number }
         suggestedPalletCount: { type: integer, nullable: true }
+        sourcePalletCount: { type: integer, description: 头程已经冻结并传入的托盘码数 }
+        targetPalletCount: { type: integer, description: 本票最终生成的托盘总数，不少于头程已有托盘码数 }
+        supplementPalletCount: { type: integer, description: 本票需要在海外仓连续补充的托盘码数 }
         plannedPalletCount: { type: integer, nullable: true }
         existingPlanNo: { type: string, nullable: true }
         planStatus: { type: string, nullable: true }
         orderVersion: { type: integer, minimum: 0 }
-        readiness: { type: string, enum: [READY, PLANNED, BLOCKED] }
+        readiness: { type: string, enum: [READY, RESOURCE_PENDING, PLANNED, BLOCKED] }
         blockers: { type: array, items: { type: string } }
     InboundPlanLine:
       type: object