优化

firstleg/src/main/resources/openapi/coload-groups-v1.yaml

@@ -35,17 +35,17 @@ paths:
       responses:
         '200': {$ref: '#/components/responses/ColoadGroupResponse'}
         '403': {description: 缺少智能排柜分配权限}
-  /api/platform/v1/first-leg/coload-groups/batch-query:
-    post:
-      summary: 按订单ID批量查询同柜不可拆组
+  /api/platform/v1/first-leg/coload-groups/by-inbound-code/{inboundCode}:
+    get:
+      summary: 按入仓码查询同柜组业务摘要
       description: >-
-        需要 platform:firstleg:smart-loading:assign。最多200个订单；返回当前非取消组的组号、状态、
-        全部成员和整组满箱数，供平台订单列表批量补齐，不按单成员修改。
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema: {$ref: '#/components/schemas/BatchQueryColoadGroupRequest'}
+        需要 platform:firstleg:smart-loading:list。使用任一有效成员的全局唯一 inboundCode 查询；
+        仅返回组业务状态、有效成员数和去重后的全部成员入仓码。页面不持有或展示 groupId、groupNo、orderId。
+      parameters:
+        - name: inboundCode
+          in: path
+          required: true
+          schema: {type: string, minLength: 1, maxLength: 40}
       responses:
         '200':
           description: 业务响应
@@ -56,11 +56,8 @@ paths:
                   - {$ref: '#/components/schemas/ApiEnvelope'}
                   - type: object
                     properties:
-                      data:
-                        type: array
-                        maxItems: 200
-                        items: {$ref: '#/components/schemas/OrderColoadGroupInfo'}
-        '403': {description: 缺少智能排柜分配权限}
+                      data: {$ref: '#/components/schemas/ColoadGroupBusinessSummary'}
+        '403': {description: 缺少智能排柜列表权限}
 components:
   parameters:
     IdempotencyKey:
@@ -107,17 +104,6 @@ components:
       properties:
         expectedVersion: {type: integer, minimum: 0}
         reason: {type: string, maxLength: 500, nullable: true}
-    BatchQueryColoadGroupRequest:
-      type: object
-      additionalProperties: false
-      required: [orderIds]
-      properties:
-        orderIds:
-          type: array
-          minItems: 1
-          maxItems: 200
-          uniqueItems: true
-          items: {type: string, pattern: '^[1-9][0-9]*$'}
     ColoadGroupMember:
       type: object
       additionalProperties: false
@@ -147,10 +133,21 @@ components:
         fullPackageCount: {type: integer, minimum: 2, description: 全部成员满箱数之和}
         createdAt: {type: string, format: date-time}
         updatedAt: {type: string, format: date-time}
-    OrderColoadGroupInfo:
+    ColoadGroupBusinessMember:
       type: object
       additionalProperties: false
-      required: [orderId, group]
+      required: [inboundCode]
       properties:
-        orderId: {type: string, pattern: '^[1-9][0-9]*$'}
-        group: {$ref: '#/components/schemas/ColoadGroup'}
+        inboundCode: {type: string, minLength: 1, maxLength: 40}
+    ColoadGroupBusinessSummary:
+      type: object
+      additionalProperties: false
+      required: [status, memberCount, members]
+      properties:
+        status: {type: string, enum: [ACTIVE, LOCKED, CONSUMED]}
+        memberCount: {type: integer, minimum: 1}
+        members:
+          type: array
+          minItems: 1
+          uniqueItems: true
+          items: {$ref: '#/components/schemas/ColoadGroupBusinessMember'}