优化

common-event-contract/AGENTS.md

@@ -18,6 +18,7 @@
 | 头程装柜完成 V1 解析模型 | `FirstLegLoadingPlanCompletedV1.java`；用于消费端冻结字段映射，新增生产不得回退为 V1 |
 | 海外卸柜完成 V1 | `OverseasContainerUnloadedV1.java`；按来源柜预订 ID 做柜级聚合/幂等，同一柜只发布一次，信封固定使用 `tenantId=0` 平台技术范围；`unloadingCompletedAt` 必须是全柜 complete 时刻，不得用签收拍照时刻代替；海外生产者见 `../lastleg-service/src/main/java/com/baiyue/lastleg/inboundplan/pda/service/InboundUnloadCompletedOutboxService.java`，国内消费者见 `../firstleg/src/main/java/com/baiyue/firstleg/service/OverseasContainerEventConsumer.java` |
 | 海外入仓单暂扣变更 V1 | `OverseasInboundOrderDetainedChangedV1.java`；聚合键固定为来源头程入仓单 ID，暂扣与解除暂扣均由尾程 Outbox 回传，国内按入仓单绑定、客户归属及聚合版本单调消费 |
+| 海外派送完成 V1 | `OverseasDeliveryCompletedV1.java`、`EventTypes.OVERSEAS_DELIVERY_COMPLETED`；每个按 FBA 仓拆分的派送单完成后，按关联来源入仓单分别发布，携带来源订单、入仓码、FBA 仓和签收时间，国内幂等推进对应 Firstleg 入仓单与 Order 完成 |
 | 国内船节点记录 V1 | `FirstLegContainerShippingNodeRecordedV1.java`；按 `containerBookingId` 柜级聚合，不携带客户，信封固定使用 `tenantId=0` 平台技术范围；只接受十节点中带实际时间和完整供应商审计字段的事实，国内生产者 `../firstleg/src/main/java/com/baiyue/firstleg/portschedule/service/CarrierScheduleNodeOutboxService.java`，海外消费者 `../lastleg-service/src/main/java/com/baiyue/lastleg/shipping/service/ContainerShippingNodeConsumer.java` |
 | 海外业务费用来源变更 V1 | `BusinessFeeSourceChangedV1.java`、`EventTypes.BUSINESS_FEE_SOURCE_CHANGED`；携带可独立校验入池的完整不可变客户、业务、方向、供应商、付款、来源版本与哈希快照，长整型标识使用字符串；海外生产者见 `../lastleg-service/src/main/java/com/baiyue/lastleg/financefee/`，Event Bridge 定向投递国内 `finance/`，Finance 不跨区同步回查 |
 | 海外业务资金指令与结果 V1 | `WalletCommandRequestedV1.java`、`WalletCommandCompletedV1.java`；海外业务通过 Outbox 请求国内 Finance 冻结、结算或释放，Finance 执行后再经 Outbox 回传结果，双方以事件与业务幂等键防重，不跨区域同步调用钱包 |

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

@@ -14,6 +14,7 @@ public final class EventTypes {
         "FirstLegContainerShippingNodeRecorded";
     public static final String OVERSEAS_CONTAINER_UNLOADED = "OverseasContainerUnloaded";
     public static final String OVERSEAS_INBOUND_ORDER_DETAINED_CHANGED = "OverseasInboundOrderDetainedChanged";
+    public static final String OVERSEAS_DELIVERY_COMPLETED = "OverseasDeliveryCompleted";
     public static final String BUSINESS_FEE_SOURCE_CHANGED = "BusinessFeeSourceChanged";
     public static final String WALLET_COMMAND_REQUESTED = "WalletCommandRequested";
     public static final String WALLET_COMMAND_COMPLETED = "WalletCommandCompleted";

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

@@ -0,0 +1,19 @@
+package com.baiyue.common.event;
+
+import java.time.Instant;
+
+/** 海外派送单按目的 FBA 仓签收后，回传对应国内入仓单和订单的完成事实。 */
+public record OverseasDeliveryCompletedV1(
+    String deliveryOrderId,
+    String deliveryNo,
+    String lastlegOrderId,
+    String lastlegOrderNo,
+    String sourceInboundId,
+    String inboundCode,
+    String sourceOrderId,
+    String sourceOrderNo,
+    String rootOrderId,
+    String fbaWarehouseCode,
+    Instant completedAt
+) {
+}

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

@@ -0,0 +1,26 @@
+package com.baiyue.common.event;
+
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
+import org.junit.jupiter.api.Test;
+
+import java.time.Instant;
+
+import static org.assertj.core.api.Assertions.assertThat;
+
+class OverseasDeliveryCompletedV1Test {
+    private final ObjectMapper mapper = new ObjectMapper().registerModule(new JavaTimeModule());
+
+    @Test
+    void roundTripsStableSourceIdentifiers() throws Exception {
+        var value = new OverseasDeliveryCompletedV1("31", "DL-31", "41", "LM-41", "51",
+            "NYEXX2609080022", "61", "FL-61", "61", "ACY2",
+            Instant.parse("2026-09-15T08:00:00Z"));
+
+        var restored = mapper.readValue(mapper.writeValueAsBytes(value), OverseasDeliveryCompletedV1.class);
+
+        assertThat(restored).isEqualTo(value);
+        assertThat(restored.sourceInboundId()).isEqualTo("51");
+        assertThat(restored.sourceOrderId()).isEqualTo("61");
+    }
+}