feat(firstleg): link simulated containers to real bookings

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

@@ -238,16 +238,29 @@ paths:
               schema: {$ref: '#/components/schemas/ContainerBookingPageEnvelope'}
         '403': {description: 无货柜查询权限}
     post:
-      summary: 新增平台货柜
-      description: 需要 platform:firstleg:container:create 权限；新增后聚合状态为 WAIT_LOADING（待装柜）
+      summary: 新增内部模拟柜
+      description: 需要 platform:firstleg:container:create 权限；服务端生成稳定 containerBookingId/cabinetNo，不要求真实柜号或订舱
       requestBody:
         required: true
         content:
           application/json:
-            schema: {$ref: '#/components/schemas/ContainerSaveRequest'}
+            schema: {$ref: '#/components/schemas/ContainerSimulationCreateRequest'}
       responses:
         '200': {description: 成功或重复号、参数校验等业务失败}
         '403': {description: 无新增按钮权限}
+  /api/platform/v1/containers/{id}/ocean-booking-link:
+    post:
+      summary: 将内部模拟柜关联到真实已确认订舱柜
+      description: 需要 platform:firstleg:container:edit；首次关联允许 WAIT_LOADING 或已有预排货的 EDITING 柜，保留原 containerBookingId/cabinetNo/loadingPlanId/items；存在 PDA、有效装柜证据、业务单证或已进入 LOADING/COMPLETED 等不可逆事实时拒绝。
+      parameters: [{$ref: '#/components/parameters/ContainerBookingId'}]
+      requestBody: {required: true, content: {application/json: {schema: {$ref: '#/components/schemas/ContainerOceanBookingLinkRequest'}}}}
+      responses: {'200': {description: 关联后的同一 containerBookingId/cabinetNo}}
+    delete:
+      summary: 解除内部模拟柜的真实订舱关联
+      description: 需要 platform:firstleg:container:edit；解绑或换绑仅允许完全空的 WAIT_LOADING 模拟柜；任何排货、PDA、有效装柜证据或业务单证事实均拒绝。
+      parameters: [{$ref: '#/components/parameters/ContainerBookingId'}]
+      requestBody: {required: true, content: {application/json: {schema: {$ref: '#/components/schemas/ContainerOceanBookingUnlinkRequest'}}}}
+      responses: {'200': {description: 解除后的同一 containerBookingId/cabinetNo}}
   /api/platform/v1/containers/{id}:
     get:
       summary: 查询平台货柜详情
@@ -1405,3 +1418,25 @@ components:
         assigneeId: {type: integer, format: int64}
         assigneeName: {type: string, maxLength: 64}
         reason: {type: string, maxLength: 500}
+    ContainerSimulationCreateRequest:
+      type: object
+      required: [channelCode, warehouseId, containerType, capacityCbm, maxWeightKg]
+      properties:
+        channelCode: {type: string, maxLength: 64, description: 当前 ACTIVE 价格簿中的真实物流渠道}
+        warehouseId: {type: integer, format: int64, minimum: 1}
+        containerType: {type: string, maxLength: 32}
+        capacityCbm: {type: number, minimum: 0, exclusiveMinimum: true}
+        maxWeightKg: {type: number, minimum: 0, exclusiveMinimum: true}
+    ContainerOceanBookingLinkRequest:
+      type: object
+      required: [oceanBookingId, requirementId, expectedVersion]
+      properties:
+        oceanBookingId: {type: integer, format: int64, minimum: 1}
+        requirementId: {type: integer, format: int64, minimum: 1}
+        expectedVersion: {type: integer, minimum: 0}
+    ContainerOceanBookingUnlinkRequest:
+      type: object
+      required: [expectedVersion, reason]
+      properties:
+        expectedVersion: {type: integer, minimum: 0}
+        reason: {type: string, minLength: 1, maxLength: 500}

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