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}