优化

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

@@ -231,6 +231,25 @@ paths:
       responses:
         '200': {description: 成功或业务失败，按响应体 code 判断}
         '403': {description: 需要 platform:order:create 权限}
+  /api/platform/v1/orders/first-leg/tenant-statistics:
+    get:
+      tags: [Platform first-leg orders]
+      summary: 查询客户累计及本月运单数
+      description: 仅统计 submitted_at 非空的 MASTER 根运单，草稿和 CHILD 拆分单不计入；累计不受取消或驳回影响；月份按 Asia/Shanghai 半开区间计算。
+      parameters:
+        - {$ref: '#/components/parameters/TenantId'}
+      responses:
+        '200':
+          description: 成功；需要 platform:order:list 权限
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  code: {type: string, example: '200'}
+                  data: {$ref: '#/components/schemas/TenantOrderStatisticsResponse'}
+        '403': {description: 需要平台身份和 platform:order:list 权限}
+
   /api/platform/v1/orders/first-leg/tenant-counts:
     get:
       summary: 批量查询客户运单数
@@ -327,6 +346,18 @@ paths:
         '403': {description: 需要 merchant:order:view 权限}
 
 components:
+  schemas:
+    TenantOrderStatisticsResponse:
+      type: object
+      required: [tenantId, totalSubmittedOrders, currentMonthSubmittedOrders, monthStart, nextMonthStart, zoneId, asOf]
+      properties:
+        tenantId: {type: string, pattern: '^[1-9][0-9]*$', description: Long 按字符串序列化以避免 JavaScript 精度丢失}
+        totalSubmittedOrders: {type: string, pattern: '^[0-9]+$', description: Long 按字符串序列化}
+        currentMonthSubmittedOrders: {type: string, pattern: '^[0-9]+$', description: Long 按字符串序列化}
+        monthStart: {type: string, format: date-time}
+        nextMonthStart: {type: string, format: date-time}
+        zoneId: {type: string, example: Asia/Shanghai}
+        asOf: {type: string, format: date-time}
   securitySchemes:
     bearerAuth:
       type: http