优化

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

@@ -127,12 +127,16 @@ paths:
   /api/platform/inbounds:
     get:
       summary: 分页查询入库单
-      description: 需要 platform:firstleg:inbound:list 权限；仅使用 V2 四个页签
+      description: 需要 platform:firstleg:inbound:list 权限；默认查询全部企业，可选 tenantId 筛选；仅使用 V2 四个页签
       parameters:
-        - {name: tenantId, in: query, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
+        - {name: tenantId, in: query, required: false, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
         - {name: tab, in: query, schema: {type: string, enum: [WAIT_MEASURE, WAIT_REVIEW, WAIT_FEE_SEND, INBOUNDED]}}
       responses:
-        '200': {description: 成功或业务失败，按响应体 code 判断}
+        '200':
+          description: 成功或业务失败，按响应体 code 判断；每条记录携带后续租户隔离操作所需的 tenantId
+          content:
+            application/json:
+              schema: {$ref: '#/components/schemas/InboundOrderPageEnvelope'}
         '403': {description: 无查询权限}
   /api/platform/inbounds/{inboundId}:
     get:
@@ -251,6 +255,34 @@ components:
       in: query
       schema: {type: integer, format: int64, minimum: 1, maximum: 200, default: 20}
   schemas:
+    InboundOrderPageEnvelope:
+      type: object
+      properties:
+        code: {type: string, example: '200'}
+        message: {type: string}
+        data: {$ref: '#/components/schemas/InboundOrderPage'}
+    InboundOrderPage:
+      type: object
+      properties:
+        records:
+          type: array
+          items: {$ref: '#/components/schemas/InboundOrderSummary'}
+        page: {type: integer, minimum: 1}
+        size: {type: integer, minimum: 1}
+        total: {type: integer, format: int64, minimum: 0}
+        pages: {type: integer, format: int64, minimum: 0}
+    InboundOrderSummary:
+      type: object
+      required: [id, tenantId]
+      properties:
+        id: {type: string, pattern: '^[1-9][0-9]*$'}
+        tenantId: {type: string, pattern: '^[1-9][0-9]*$', description: 记录所属企业租户 ID，用于详情和处理接口的租户隔离}
+        orderId: {type: string, nullable: true}
+        orderNo: {type: string, nullable: true}
+        inboundCode: {type: string, nullable: true}
+        processStatus: {type: string}
+        customerId: {type: string, nullable: true}
+        companyId: {type: string, nullable: true}
     InboundMeasurementCallbackRequest:
       type: object
       required: [eventNo, externalDetailNo, warehouseCode, inboundCode, inboundDetailId, deviceCode, measuredAt, boxSpecification, packageCount, lengthCm, widthCm, heightCm]