fix: align ocean booking link eligibility

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

@@ -2,7 +2,12 @@ openapi: 3.0.3
 info: {title: Ocean Booking API, version: 2.0.0}
 paths:
   /api/platform/v1/ocean-bookings:
-    get: {summary: List DRAFT and RELEASED bookings, responses: {'200': {description: Booking page}}}
+    get:
+      summary: List DRAFT and RELEASED bookings
+      description: containerCount is the sum of quantity across all container requirements for the booking. It is zero when no requirement exists and never represents linked or ACTIVE containers.
+      responses:
+        '200':
+          description: Booking page; each row uses the frozen requirement-total containerCount semantic
     post:
       summary: Create an editable DRAFT
       description: Creates only the booking aggregate and container requirements; no containerNo, container row, or allocation is created.
@@ -31,14 +36,12 @@ paths:
   /api/platform/v1/ocean-bookings/link-candidates:
     get:
       summary: Page released booking requirement candidates for one container
-      description: Requires platform:firstleg:ocean-booking:list. Returns only exact warehouse, channel and fixed container specification matches with remainingQuantity greater than zero. Allocation counts are calculated by one bounded set query; booking detail calls are not used.
+      description: Requires platform:firstleg:ocean-booking:list. Eligibility matches only warehouseId, channelCode and containerType, with remainingQuantity greater than zero. Capacity and max weight are derived display snapshots and never eligibility fields. Allocated quantity counts only ACTIVE containers still pointing to the same booking requirement and is calculated by one bounded set query; booking detail calls are not used.
       x-permission: platform:firstleg:ocean-booking:list
       parameters:
         - {name: warehouseId, in: query, required: true, schema: {type: integer, format: int64, minimum: 1}}
         - {name: channelCode, in: query, required: true, schema: {type: string, maxLength: 64}}
         - {name: containerType, in: query, required: true, schema: {type: string, maxLength: 32}}
-        - {name: capacityCbm, in: query, required: true, schema: {type: number, exclusiveMinimum: true, minimum: 0}}
-        - {name: maxWeightKg, in: query, required: true, schema: {type: number, exclusiveMinimum: true, minimum: 0}}
         - {name: page, in: query, required: false, schema: {type: integer, format: int64, minimum: 1, default: 1}}
         - {name: size, in: query, required: false, schema: {type: integer, format: int64, minimum: 1, maximum: 200, default: 20}}
       responses:
@@ -145,6 +148,14 @@ components:
         code: {type: string, example: '200'}
         message: {type: string, nullable: true}
         data: {$ref: '#/components/schemas/LinkCandidatePage'}
+    OceanBookingListRow:
+      type: object
+      properties:
+        containerCount:
+          type: integer
+          format: int64
+          minimum: 0
+          description: Sum of all container requirement quantities; independent of allocation, linking or unlinking.
     Detail:
       type: object
       required: [oceanBooking, parties, containerRequirements, containers, histories]