优化

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

@@ -9,7 +9,7 @@ paths:
   /api/merchant/v1/orders/first-leg:
     get:
       summary: 客户端入库订单聚合列表
-      description: 按当前登录租户分页返回订单、货物汇总、收货方快照及头程入仓编码，需要 merchant:order:list 权限。
+      description: 按当前登录客户分页返回订单、货物汇总、收货方快照及头程入仓编码，需要 merchant:order:list 权限；客户 ID 从 JWT 的 tenantId 兼容字段取得。
       parameters:
         - {name: keyword, in: query, required: false, schema: {type: string, maxLength: 64}}
         - {name: orderNo, in: query, required: false, schema: {type: string, maxLength: 64}}
@@ -53,12 +53,12 @@ paths:
   /api/platform/v1/orders/first-leg:
     get:
       summary: 平台分页查询头程订单
-      description: tenantId 省略时查询全部客户租户订单，传入时仅查询指定租户。
+      description: tenantId 是目标客户 ID 的兼容参数名；省略时查询全部客户订单，传入时仅查询指定客户。
       parameters:
         - name: tenantId
           in: query
           required: false
-          description: 可选的目标租户筛选
+          description: 可选的目标客户筛选；tenantId 为历史兼容参数名
           schema: {type: integer, format: int64, minimum: 1}
       responses:
         '200': {description: 查询成功或业务失败，按响应体 code 判断}
@@ -79,7 +79,7 @@ paths:
   /api/platform/v1/orders/first-leg/tenant-counts:
     get:
       summary: 批量查询客户运单数
-      description: 按客户租户 ID 返回真实头程运单数量，最多 200 个租户。
+      description: 按客户 ID 返回真实头程运单数量，tenantIds 为历史兼容参数名；最多 200 个客户。
       parameters:
         - name: tenantIds
           in: query
@@ -133,5 +133,5 @@ components:
       name: Idempotency-Key
       in: header
       required: true
-      description: 同一租户和操作者重试同一请求时必须保持不变
+      description: 同一客户和操作者重试同一请求时必须保持不变
       schema: {type: string, minLength: 1, maxLength: 128}