优化

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

@@ -755,11 +755,14 @@ paths:
     get:
       summary: 查询称重可选托盘快照
       description: >-
-        需要入库测量查看或称重编辑权限。Firstleg 按入库单 warehouseId 查询 Warehouse 公共托盘快照；
-        仅限定同仓且未删除，不校验托盘状态或占用资格，Admin 不需要 platform:pallet:list。
+        需要入库测量查看或称重编辑权限。Firstleg 按入库单 warehouseId 分页查询 Warehouse 当前称重托盘候选；
+        Warehouse 校验平台公共作用域、启用国内仓、同仓归属和当前未删除资格。托盘可复用，不按预占或占用过滤，Admin 不需要 platform:pallet:list。
       parameters:
         - {name: tenantId, in: query, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
         - {name: inboundId, in: path, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
+        - {name: page, in: query, required: false, schema: {type: integer, format: int64, minimum: 1, default: 1}}
+        - {name: size, in: query, required: false, schema: {type: integer, format: int64, minimum: 1, maximum: 100, default: 20}}
+        - {name: keyword, in: query, required: false, description: 匹配托盘编码或类型, schema: {type: string, maxLength: 50}}
       responses:
         '200':
           description: 成功或业务失败，按响应体 code 判断
@@ -770,7 +773,7 @@ paths:
                 properties:
                   code: {type: string}
                   message: {type: string}
-                  data: {type: array, items: {$ref: '#/components/schemas/WeightPalletSnapshot'}}
+                  data: {$ref: '#/components/schemas/WeightPalletSnapshotPage'}
         '403': {description: 无入库测量查看或称重编辑权限}
   /api/platform/v1/first-leg/inbounds/{inboundId}/weight-results:
     post:
@@ -1294,6 +1297,18 @@ components:
         palletType: {type: string}
         capacityCbm: {type: number, format: double, minimum: 0.0001}
         tareWeightKg: {type: number, format: double, minimum: 0, multipleOf: 0.001}
+    WeightPalletSnapshotPage:
+      type: object
+      required: [records, page, size, total, pages]
+      properties:
+        records:
+          type: array
+          maxItems: 100
+          items: {$ref: '#/components/schemas/WeightPalletSnapshot'}
+        page: {type: integer, format: int64, minimum: 1}
+        size: {type: integer, format: int64, minimum: 1, maximum: 100}
+        total: {type: integer, format: int64, minimum: 0}
+        pages: {type: integer, format: int64, minimum: 0}
     CreateWeightResultRequest:
       type: object
       required: [fileId, palletId]