优化

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

@@ -49,6 +49,7 @@ paths:
         指定其他主状态时由 Firstleg 精确分页。旧 /orders/first-leg 接口保持兼容。
         列表行同时返回 customerRemark（客户下单备注）、latestInternalNote（最新一条平台内部备注）和
         relation（仅有关联时返回；PARENT 含 childCount，CHILD 含 rootOrderId、parentOrderId 与 splitSequence）。
+        coLoadGroup 仅平台响应返回，由 Order 经 Firstleg 内部批量只读契约聚合；成员业务标识由 Order 权威订单片段补齐。
       parameters:
         - {name: tenantId, in: query, required: false, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
         - $ref: '#/components/parameters/UnifiedKeyword'
@@ -83,7 +84,7 @@ paths:
   /api/platform/v1/orders/{orderId}:
     get:
       summary: 平台统一订单详情
-      description: 合并 Order 与 Firstleg 时间线并按发生时间升序返回；所有状态直接返回 Order 创建时生成的 inboundCode；平台可见内部备注。
+      description: 合并 Order 与 Firstleg 时间线并按发生时间升序返回；返回当前订单片段的 inboundCode 与同柜组摘要；平台可见内部备注。
       parameters:
         - $ref: '#/components/parameters/UnifiedOrderId'
         - $ref: '#/components/parameters/UnifiedTenantId'
@@ -483,7 +484,7 @@ components:
         destinationWarehouseName: {type: string, nullable: true}
         inboundId: {type: integer, format: int64, nullable: true}
         inboundVersion: {type: integer, nullable: true, description: C04 loading/complete 的 expectedVersion}
-        inboundCode: {type: string, nullable: true}
+        inboundCode: {type: string, nullable: true, description: 当前订单片段的权威入仓码；缺失时为 null，不得回退为 orderId 或 orderNo}
         expectedShipDate: {type: string, format: date, nullable: true}
         totalPackageCount: {type: integer, nullable: true, description: 无入仓事实时为当前订单有效货物箱数合计；存在入仓业务单元后为该单元履约总箱数，拆分后不以父单原始箱数覆盖}
         recommendedPalletType: {type: string, nullable: true, description: 当前无列表级权威事实时返回 null，不得返回固定托盘类型}
@@ -520,6 +521,7 @@ components:
         loading: {$ref: '#/components/schemas/UnifiedLoadingSummary'}
         delivery: {$ref: '#/components/schemas/UnifiedDeliverySummary'}
         transport: {$ref: '#/components/schemas/UnifiedTransportSummary'}
+        coLoadGroup: {$ref: '#/components/schemas/UnifiedCoLoadGroupSummary'}
         customerRemark: {type: string, nullable: true}
         latestInternalNote: {type: string, nullable: true, description: 客户详情不返回平台内部备注}
         createdAt: {type: string, format: date-time, nullable: true}
@@ -533,6 +535,16 @@ components:
         parentOrderId: {type: integer, format: int64, nullable: true}
         splitSequence: {type: integer, nullable: true}
         childCount: {type: integer, nullable: true}
+    UnifiedCoLoadGroupSummary:
+      type: object
+      nullable: true
+      description: 仅平台统一订单列表与详情返回；未加入同柜组时为 null
+      properties:
+        status: {type: string}
+        memberCount: {type: integer, minimum: 0}
+        memberInboundCodes:
+          type: array
+          items: {type: string, nullable: true, description: 同柜组成员订单片段的权威入仓码；缺失时保留 null，不回退内部ID}
     UnifiedMeasurementSummary:
       type: object
       nullable: true