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}