优化

firstleg/src/main/resources/openapi/phase3-outbound-dispatch-v1.yaml

@@ -11,7 +11,14 @@ paths:
         - {$ref: '#/components/parameters/InboundId'}
         - {$ref: '#/components/parameters/ContainerBookingId'}
       responses:
-        '200': {description: Business envelope containing matching aggregates}
+        '200':
+          description: Business envelope containing matching aggregates, each with stable cabinetNo and real containerNo
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  data: {type: array, items: {$ref: '#/components/schemas/Aggregate'}}
   /api/platform/v1/first-leg/outbound-dispatches/detail:
     get:
       summary: Query one aggregate and its unified timeline
@@ -20,7 +27,17 @@ paths:
         - {$ref: '#/components/parameters/InboundId'}
         - {$ref: '#/components/parameters/ContainerBookingId'}
       responses:
-        '200': {description: Business envelope containing aggregate detail}
+        '200':
+          description: Business envelope containing aggregate detail
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  data:
+                    type: object
+                    properties:
+                      aggregate: {$ref: '#/components/schemas/Aggregate'}
   /api/platform/v1/first-leg/outbound-dispatches/check-gate:
     get:
       summary: Evaluate the fail-closed domestic outbound gate
@@ -59,6 +76,32 @@ components:
     ContainerBookingId: {name: containerBookingId, in: query, schema: {type: integer, format: int64, minimum: 1}}
     IdempotencyKey: {name: Idempotency-Key, in: header, required: true, schema: {type: string, maxLength: 128}}
   schemas:
+    Aggregate:
+      type: object
+      required: [orderId, orderNo, inboundId, inboundCode, tenantId, inboundStatus, containerBookingId, cabinetNo, loadingPlanId, loadingPlanStatus, dispatchStatus, version, gate]
+      properties:
+        orderId: {type: integer, format: int64}
+        orderNo: {type: string}
+        inboundId: {type: integer, format: int64}
+        inboundCode: {type: string}
+        tenantId: {type: integer, format: int64}
+        customerId: {type: integer, format: int64, nullable: true}
+        customerName: {type: string, nullable: true}
+        inboundStatus: {type: string}
+        containerBookingId: {type: integer, format: int64}
+        cabinetNo: {type: string, description: 稳定柜次号}
+        containerNo: {type: string, nullable: true, description: 真实集装箱号}
+        loadingPlanId: {type: integer, format: int64}
+        loadingPlanStatus: {type: string}
+        pickTaskId: {type: integer, format: int64, nullable: true}
+        pickTaskStatus: {type: string, nullable: true}
+        oceanBookingId: {type: integer, format: int64, nullable: true}
+        oceanBookingStatus: {type: string, nullable: true}
+        truckAppointmentId: {type: integer, format: int64, nullable: true}
+        truckAppointmentStatus: {type: string, nullable: true}
+        dispatchStatus: {type: string}
+        version: {type: integer, minimum: 0}
+        gate: {type: object}
     ActionRequest:
       type: object
       required: [inboundId, containerBookingId, expectedVersion]