feat: freeze and propagate first-leg pallet labels

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}