Merge remote-tracking branch 'origin/test' into dev

# Conflicts:
#	lastleg-service/src/main/java/com/baiyue/lastleg/service/LoadingCompletedConsumer.java
#	lastleg-service/src/test/java/com/baiyue/lastleg/inboundplan/pda/gateway/HttpWarehouseResourceGatewayTest.java
#	warehouse-overseas-service/src/main/java/com/baiyue/warehouse/service/WarehousePalletBatchService.java

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

@@ -74,6 +74,23 @@ paths:
         content: {application/json: {schema: {$ref: '#/components/schemas/ConfirmPreloadRequest'}}}
       responses:
         '200': {$ref: '#/components/responses/PreloadConfirmationResponse'}
+  /api/platform/v1/first-leg/loading-plans/{planId}/pallet-labels/prepare:
+    post:
+      summary: 生成并查询散货托盘码清单
+      description: 预装确认且已有真实柜号后，按柜号-FBA仓编码-三位序号生成稳定清单；一件代发不参与。
+      parameters: [{$ref: '#/components/parameters/PlanId'}, {$ref: '#/components/parameters/WarehouseId'}]
+      responses:
+        '200': {description: 按 FBA 仓分组的散货托盘码清单, content: {application/json: {schema: {type: object}}}}
+  /api/platform/v1/first-leg/loading-plans/{planId}/pallet-labels/print:
+    post:
+      summary: 打印散货托盘码
+      description: 仓码和张数均为空时打印全部；均有值时打印该 FBA 仓从第1张开始的指定数量，用于补打。
+      parameters: [{$ref: '#/components/parameters/PlanId'}, {$ref: '#/components/parameters/WarehouseId'}]
+      requestBody:
+        required: true
+        content: {application/json: {schema: {$ref: '#/components/schemas/PalletLabelPrintRequest'}}}
+      responses:
+        '200': {description: 100mm × 100mm 托盘码 PDF, content: {application/pdf: {schema: {type: string, format: binary}}}}
   /api/platform/v1/first-leg/loading-lists:
     get:
       summary: 分页查询装柜清单
@@ -430,3 +447,9 @@ components:
         voyageNo: {type: string, maxLength: 64, nullable: true, description: 航次}
         expectedVersion: {type: integer, format: int32, minimum: 0, description: 当前乐观锁版本}
         operationReason: {type: string, minLength: 1, maxLength: 500, nullable: true, description: 纠正已有真实集装箱号时必填；首次补录或保持当前柜号时可省略}
+    PalletLabelPrintRequest:
+      type: object
+      additionalProperties: false
+      properties:
+        destinationWarehouseCode: {type: string, maxLength: 64, nullable: true}
+        count: {type: integer, minimum: 1, maximum: 999, nullable: true}

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

@@ -55,7 +55,7 @@ paths:
   /api/platform/v1/terminal-drayages/{containerBookingId}/pickup-email:
     post:
       summary: 将当前车队提柜邮件加入发送队列
-      description: 初次选择车队不发信；此命令携带版本和幂等键，发送成功是任务已入队，不表示已送达。首次更换车队自动原子入队取消和新提柜两封邮件。同一车队重复选择不发信。
+      description: 初次选择车队不发信；此命令携带版本和幂等键，发送成功是任务已入队，不表示已送达。人工可使用最新版本重复发送提柜请求。更换车队时，原车队存在提柜请求邮件记录才原子入队取消邮件，并始终为新车队入队提柜请求；原车队从未下发时不发送取消邮件。同一车队重复选择不发信。
       x-permission: platform:firstleg:terminal-drayage:fleet:edit
       parameters: [{$ref: '#/components/parameters/ContainerBookingId'}, {$ref: '#/components/parameters/IdempotencyKey'}]
       requestBody: {required: true, content: {application/json: {schema: {type: object, required: [expectedVersion], properties: {expectedVersion: {type: integer, minimum: 0}}}}}}