提交

docs/firstleg-loading-to-lastleg-orders.md

@@ -88,7 +88,6 @@ PDA 部分拣货会生成本柜实装 `LOADED` 分片以及可继续分柜的 `R
   "loadingPlanNo": "LP202608130001",
   "containerBookingId": "208500001",
   "containerNo": "MSCU1234567",
-  "cabinetNo": "CAB20260813001",
   "containerType": "40HQ",
   "sealNo": "SEAL001",
   "voyageNo": "V001",
@@ -142,12 +141,20 @@ PDA 部分拣货会生成本柜实装 `LOADED` 分片以及可继续分柜的 `R
 - 文件只传不可变文件引用、区域和摘要，不传二进制内容。
 - V1 消费者忽略未知字段；已有字段不改变含义或类型。
 
+### 5.1 订单类型分支
+
+`orderType`、`pallets`、`palletNo`、`skuPackages` 和 `cartonMarks` 必须正式加入头程公共事件契约及发送端，不能长期依赖尾程读取原始 JSON 扩展字段。三个服务升级到同一 `common-event-contract` 版本后再启用生产流量。
+
+`ONE_CLICK_DROPSHIP` 的一笔最终实装入仓单可包含一个或多个来源托盘快照。消费时必须满足：所有托盘的 SKU 箱数之和等于订单箱数、SKU 数量之和等于订单数量、每个 SKU 的箱唛数等于其箱数、同一托盘内 SKU 不重复、同一订单内来源托盘号和箱唛不重复。通过后按来源托盘创建一件代发档案及托盘级 SKU 库存，并创建箱唛记录和不可变箱唛流水。`source_pallet_no` 是头程冻结快照；`warehouse_pallet_id/pallet_no` 是 Warehouse API 分配的海外仓实物托盘，两者不得混用。
+
+非 `ONE_CLICK_DROPSHIP` 类型只创建 `ll_order`、冻结明细和初始状态历史，来源 `palletCount` 按 0 入库，不创建一件代发 SKU/箱唛库存。后续入仓 PDA 分配的托盘属于海外仓作业资源。
+
 ## 6. 尾程建单幂等
 
 尾程订单表必须有以下唯一约束：
 
 ```text
-UNIQUE (tenant_id, source_region, source_inbound_id)
+UNIQUE (customer_id, source_region, source_inbound_id)
 ```
 
 建议同时保存：
@@ -170,6 +177,8 @@ UNIQUE (tenant_id, source_region, source_inbound_id)
 
 事件内任意一笔订单建单失败时，整个事件消费事务回滚，不允许出现同一客户同一柜次只生成部分尾程订单。
 
+同一实际集装箱的订单共享 `order_no`、`container_no` 和 `source_loading_plan_id`；`ll_order.id` 仍是每条订单独立的雪花 ID。整柜查询、整柜操作和转入库计划统一以 `containerNo` 聚合，不使用虚拟柜号 `cabinetNo`。数据库必须保留 `KEY idx_ll_order_container (customer_id, container_no)`。
+
 ## 7. 尾程订单初始状态
 
 事件自动生成的订单建议使用：