优化

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

@@ -6,6 +6,34 @@ info:
 security:
   - bearerAuth: []
 paths:
+  /internal/order/v1/pending-review-orders:
+    get:
+      security: []
+      summary: Firstleg 分页读取 Order 权威待审核订单
+      description: >-
+        仅接受内部服务令牌。只返回 ord_order 中未删除且 status=SUBMITTED 的头程订单，
+        mainStatus 固定为 PENDING_REVIEW。createdStart/createdEnd 按 Asia/Shanghai 自然日闭区间过滤
+        ord_order.created_at，稳定按 created_at DESC、id DESC 分页；不读取或修复 Firstleg 投影。
+      parameters:
+        - name: X-Internal-Service-Token
+          in: header
+          required: true
+          schema: {type: string}
+        - {name: channelCodes, in: query, required: false, style: form, explode: true, schema: {type: array, items: {type: string, maxLength: 64}}}
+        - {name: warehouseId, in: query, required: false, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
+        - {name: customerId, in: query, required: false, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
+        - {name: inboundCode, in: query, required: false, schema: {type: string, maxLength: 40}}
+        - {name: createdStart, in: query, required: false, schema: {type: string, format: date}}
+        - {name: createdEnd, in: query, required: false, schema: {type: string, format: date}}
+        - {name: page, in: query, required: true, schema: {type: integer, format: int64, minimum: 1}}
+        - {name: size, in: query, required: true, schema: {type: integer, format: int64, minimum: 1, maximum: 200}}
+      responses:
+        '200':
+          description: Order 权威待审核订单页
+          content:
+            application/json:
+              schema: {$ref: '#/components/schemas/PendingReviewOrderPageEnvelope'}
+        '403': {description: 内部服务令牌无效}
   /internal/exports/v1/DOMESTIC_WAREHOUSE_ORDER_LIST/batches:
     post:
       security: []
@@ -1001,6 +1029,35 @@ components:
           description: 前端外层行标识；同一批次内必须唯一，用于幂等重试和结果关联
         draft:
           $ref: '#/components/schemas/FirstLegOrderDraft'
+    PendingReviewOrderPageEnvelope:
+      type: object
+      properties:
+        code: {type: string, example: '200'}
+        message: {type: string}
+        data:
+          type: object
+          required: [records, page, size, total, pages]
+          properties:
+            records: {type: array, items: {$ref: '#/components/schemas/PendingReviewOrderRow'}}
+            page: {type: integer, format: int64, minimum: 1}
+            size: {type: integer, format: int64, minimum: 1}
+            total: {type: integer, format: int64, minimum: 0}
+            pages: {type: integer, format: int64, minimum: 0}
+    PendingReviewOrderRow:
+      type: object
+      required: [orderId, orderNo, inboundCode, customerId, customerName, warehouseId, channelCode, channelName, totalPackageCount, createdAt, mainStatus]
+      properties:
+        orderId: {type: string, pattern: '^[1-9][0-9]*$'}
+        orderNo: {type: string}
+        inboundCode: {type: string}
+        customerId: {type: string, pattern: '^[1-9][0-9]*$'}
+        customerName: {type: string}
+        warehouseId: {type: string, pattern: '^[1-9][0-9]*$'}
+        channelCode: {type: string}
+        channelName: {type: string}
+        totalPackageCount: {type: integer, minimum: 0}
+        createdAt: {type: string, format: date-time}
+        mainStatus: {type: string, enum: [PENDING_REVIEW]}
     FirstLegBatchDraftResponse:
       type: object
       required: [total, succeeded, failed, items]