fix(events): allow container nodes before ocean booking

common-event-contract/src/main/java/com/baiyue/common/event/FirstLegContainerShippingNodeRecordedV1.java

@@ -31,8 +31,10 @@ public record FirstLegContainerShippingNodeRecordedV1(
         if (queryId != null && queryId.isBlank()) {
             throw new IllegalArgumentException("船节点跟踪任务标识不能为空字符串");
         }
-        if (oceanBookingId == null || oceanBookingId.isBlank()
-            || containerBookingId == null || containerBookingId.isBlank()
+        if (oceanBookingId != null && oceanBookingId.isBlank()) {
+            throw new IllegalArgumentException("船节点订舱标识不能为空字符串");
+        }
+        if (containerBookingId == null || containerBookingId.isBlank()
             || containerNo == null || containerNo.isBlank()) {
             throw new IllegalArgumentException("船节点交接业务标识不能为空");
         }

common-event-contract/src/main/resources/openapi/cross-region-events-v1.yaml

@@ -42,10 +42,10 @@ components:
         destinationType: {type: string, enum: [FBA, OVERSEAS]}
     FirstLegContainerShippingNodeRecordedV1:
       type: object
-      required: [oceanBookingId, sourceContainerBookingId, containerNo, standardNode, nodeSequence, observedAt, actualAt, providerCode, providerEventId, providerNodeCode, rawPayloadHash]
+      required: [sourceContainerBookingId, containerNo, standardNode, nodeSequence, observedAt, actualAt, providerCode, providerEventId, providerNodeCode, rawPayloadHash]
       properties:
         queryId: {type: [string, 'null'], description: Automatic tracking task ID; null for a direct platform manual node.}
-        oceanBookingId: {type: string}
+        oceanBookingId: {type: [string, 'null'], description: Ocean booking ID when the physical container has already been linked; null is valid for a direct manual node.}
         sourceContainerBookingId: {type: string, minLength: 1}
         containerNo: {type: string, minLength: 1, description: Uppercase normalized physical container number; never cabinetNo or a technical identity}
         standardNode: {type: string}

common-event-contract/src/test/java/com/baiyue/common/event/FirstLegContainerShippingNodeRecordedV1Test.java

@@ -39,12 +39,13 @@ class FirstLegContainerShippingNodeRecordedV1Test {
     void acceptsDirectManualNodeWithoutTrackingQuery() {
         var payload = payload();
         var manual = new FirstLegContainerShippingNodeRecordedV1(
-            null, payload.oceanBookingId(), payload.containerBookingId(), payload.containerNo(),
+            null, null, payload.containerBookingId(), payload.containerNo(),
             payload.standardNode(), payload.nodeSequence(), payload.observedAt(), payload.actualAt(),
             payload.locationCode(), payload.locationName(), "MANUAL", "manual-event", payload.providerNodeCode(),
             "MANUAL:7", payload.rawPayloadHash());
 
         assertThat(manual.queryId()).isNull();
+        assertThat(manual.oceanBookingId()).isNull();
     }
 
     @Test