feat(firstleg): link simulated containers to real bookings

firstleg/src/main/resources/openapi/ocean-bookings-v1.yaml

@@ -9,6 +9,16 @@ paths:
         - {name: originWarehouseId, in: query, required: true, schema: {type: integer, format: int64, minimum: 1}}
       responses: {'200': {description: Available channel options, content: {application/json: {schema: {type: array, items: {$ref: '#/components/schemas/ChannelOption'}}}}}}
   /api/platform/v1/ocean-bookings:
+    get:
+      summary: List only real confirmed booking records
+      description: 'Requires platform:firstleg:ocean-booking:list. The operational list exposes only CONFIRMED, CHANGE_PENDING, RELEASED and CANCELLED bookings; DRAFT, SUBMITTED and FAILED are excluded even when a status query is supplied.'
+      parameters:
+        - {name: customerId, in: query, schema: {type: integer, format: int64, minimum: 1}}
+        - {name: status, in: query, schema: {type: string, enum: [CONFIRMED, CHANGE_PENDING, RELEASED, CANCELLED]}}
+        - {name: keyword, in: query, schema: {type: string, maxLength: 128}}
+        - {name: page, in: query, schema: {type: integer, minimum: 1, default: 1}}
+        - {name: size, in: query, schema: {type: integer, minimum: 1, maximum: 200, default: 20}}
+      responses: {'200': {description: Operational real booking page}}
     post:
       summary: Create an ocean booking draft with immutable channel and warehouse snapshots
       parameters: [{$ref: '#/components/parameters/IdempotencyKey'}]
@@ -16,10 +26,10 @@ paths:
       responses: {'200': {description: Draft detail}}
   /api/platform/v1/ocean-bookings/{oceanBookingId}/confirm:
     post:
-      summary: Confirm booking and atomically create one stable cabinet and editing loading plan per requested quantity
+      summary: Confirm a real booked container record without creating internal cabinets
       parameters: [{$ref: '#/components/parameters/OceanBookingId'}, {$ref: '#/components/parameters/IdempotencyKey'}]
       requestBody: {required: true, content: {application/json: {schema: {$ref: '#/components/schemas/ActionRequest'}}}}
-      responses: {'200': {description: CONFIRMED detail; no real container number required}}
+      responses: {'200': {description: CONFIRMED real booking detail; internal cabinets are linked explicitly from the container API}}
   /api/platform/v1/ocean-bookings/{oceanBookingId}/release:
     post:
       summary: Confirm released transport data and synchronize associated cabinet transport snapshots