fix(firstleg): allow optional ocean booking customer

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

@@ -32,7 +32,7 @@ paths:
   /api/platform/v1/ocean-bookings/{oceanBookingId}/release:
     post:
       summary: Validate and permanently release a DRAFT
-      description: Release validates the persisted aggregate plus at least one active booking-owned BOOKING_CONFIRMATION or BILL_OF_LADING file. It never requires or creates a real container number.
+      description: Release validates the persisted aggregate plus at least one active booking-owned BOOKING_CONFIRMATION or BILL_OF_LADING file. The customer is optional; a supplied customer must remain ACTIVE. Null denotes no single customer snapshot, never public access. It never requires or creates a real container number.
       parameters: [{$ref: '#/components/parameters/OceanBookingId'}, {$ref: '#/components/parameters/IdempotencyKey'}]
       requestBody: {required: true, content: {application/json: {schema: {$ref: '#/components/schemas/ReleaseRequest'}}}}
       responses: {'200': {description: RELEASED detail}}
@@ -45,7 +45,7 @@ paths:
         '200': {description: Booking document history, content: {application/json: {schema: {$ref: '#/components/schemas/DocumentListResponse'}}}}
     post:
       summary: Reference an existing File object in a DRAFT booking
-      description: File scope must be customerId + OCEAN_BOOKING_DOCUMENT + oceanBookingId. The booking version is incremented atomically.
+      description: File scope must be platform tenantId=0 + OCEAN_BOOKING_DOCUMENT + oceanBookingId, independent of the optional customer snapshot. The booking version is incremented atomically.
       x-permission: platform:firstleg:ocean-booking:edit
       parameters: [{$ref: '#/components/parameters/OceanBookingId'}, {$ref: '#/components/parameters/IdempotencyKey'}]
       requestBody: {required: true, content: {application/json: {schema: {$ref: '#/components/schemas/DocumentRequest'}}}}
@@ -162,8 +162,8 @@ components:
       type: object
       description: Fields may be incomplete in DRAFT. RELEASE validates the complete persisted aggregate.
       properties:
-        customerId: {type: integer, format: int64, nullable: true}
-        customerName: {type: string, nullable: true}
+        customerId: {type: integer, format: int64, minimum: 1, nullable: true, description: 可选启用客户ID；多客户订舱留空，空值不是公开访问授权}
+        customerName: {type: string, nullable: true, description: 可选名称提示；有客户ID时由服务端校验并保存客户主数据名称，清空客户时同时置null}
         channelCode: {type: string, nullable: true}
         warehouseId: {type: integer, format: int64, nullable: true}
         billOfLadingNo: {type: string, nullable: true}
@@ -279,7 +279,7 @@ components:
         requiredQuantity: {type: integer, minimum: 1}
         allocatedQuantity: {type: integer, format: int64, minimum: 0}
         remainingQuantity: {type: integer, format: int64, minimum: 1}
-        customerName: {type: string}
+        customerName: {type: string, nullable: true}
         warehouseName: {type: string}
         channelName: {type: string}
     LinkCandidatePage: