优化

2026-08-13 12:22:31 +08:00
parent 16dc03a2e2
commit e742abd1cf
49 changed files with 821 additions and 50 deletions
@@ -0,0 +1,35 @@
+openapi: 3.0.3
+info:
+  title: Firstleg 客户统计 API
+  version: 1.0.0
+paths:
+  /api/platform/v1/customers/{customerId}/container-transit-summary:
+    get:
+      summary: 查询客户在途柜量（TEU）
+      description: 需要 platform:firstleg:container:list；按客户+柜次去重，整柜按订舱客户归属，拼柜按 active LoadingPlanItem.accountId 归属。
+      parameters:
+        - {name: customerId, in: path, required: true, schema: {type: integer, format: int64, minimum: 1}}
+      responses:
+        '200':
+          description: 成功或业务失败，响应体 code 为字符串 200 时成功
+          content:
+            application/json:
+              schema: {$ref: '#/components/schemas/TransitSummaryEnvelope'}
+components:
+  schemas:
+    TransitSummaryEnvelope:
+      type: object
+      properties:
+        code: {type: string, example: '200'}
+        message: {type: string}
+        data: {$ref: '#/components/schemas/TransitSummary'}
+    TransitSummary:
+      type: object
+      required: [customerId, containerCount, totalTeu, unknownContainerCount, asOf, definition]
+      properties:
+        customerId: {type: integer, format: int64, minimum: 1}
+        containerCount: {type: integer, format: int64, minimum: 0}
+        totalTeu: {type: number, format: decimal, multipleOf: 0.01, minimum: 0, description: 已知箱型TEU合计；未知箱型不计入}
+        unknownContainerCount: {type: integer, format: int64, minimum: 0}
+        asOf: {type: string, format: date-time}
+        definition: {type: string}