优化

头程到尾程分阶段流程/README.md

@@ -4,6 +4,8 @@
 
 当前六个阶段的现状基线均已完成。下一步按阶段组织业务、产品、运营、国内仓、海外仓和技术评审；每阶段确认后，再将评审结论转入易用性和数据流转优化方案。
 
+端到端节点评审先使用[《头程到尾程流程节点梳理》](../头程到尾程流程节点梳理.md)。该主表保留 F01～F40 稳定编号，统一阶段出口、客户进度投影、后台对象、数据交接和异常门禁；本目录的六份阶段文档继续承载各节点的现状操作与字段细节。
+
 ## 分阶段计划
 
 | 阶段 | 范围 | 对应全景流程 | 文档 |

头程到尾程分阶段流程/阶段三-国内货柜履约与出仓.md

@@ -2,8 +2,8 @@
 
 > 对应全景流程：F14～F23。  
 > 阶段起点：入库单主状态为 `WAIT_SPLIT`，不存在有效 HOLD。  
-> 阶段终点：整柜满足国内出仓门禁，产生唯一实际 `DEPARTED_WAREHOUSE` 节点并开始出仓后的船节点查询。  
-> 本阶段复用订单、入库单、柜次和装柜计划，不新建独立“出仓单”。
+> 阶段终点：装柜后完成送港线的仓库离开/进港事实，报关线保留客户确认、正式申报和海关结果；实际开船 `VESSEL_DEPARTED` 由阶段四承接。  
+> 本阶段复用订单、入库单、柜次和装柜计划，不新建独立“出仓单”。`LOADED` 后报关线和送港线并行；费用确认是并行事实，装柜完成后对已装范围的当前有效费用版本执行系统默认确认。
 
 ## 1. 阶段目标和边界
 
@@ -15,12 +15,12 @@
 4. 模拟柜与订舱柜型需求、真实集装箱号关联；
 5. 预装确认、动态增减和普通散货托盘标签；
 6. 国内 PDA 拣货、整托装柜和异常闭环；
-7. 四步装柜照片、铅封照片与铅封号；
+7. 空仓、半仓、满仓、锁仓、带锁码照五类装柜证据与锁码文本；
 8. 装柜完成、部分装载分片和跨区交接快照；
-9. 客户资料、整柜出口报关与放行；
-10. 国内出仓门禁、离仓确认和拖车费用归集。
+9. `LOADED` 后通知报关行、客户资料收集、回执确认、整柜正式申报和海关结果；
+10. 送港、进港、甩柜/改配、实际离仓和拖车费用归集。
 
-`LOADED` 表示货物已经完成实际装柜，不等于柜子已经离开国内仓。报关放行等条件在国内出仓环节统一校验；国内 Admin/PDA 不得把订单推进到海外派送完成 `DELIVERED`。
+`LOADED` 表示货物已经完成实际装柜。此时同时触发报关线和送港线：报关线收集客户资料、发送报关行、处理回执和客户确认；送港线安排拖车、离仓和进港。两条线谁先到都保留各自事实，客户未确认不阻断送港，已进港不代表报关完成。容量不足时记录甩柜和改配船次；只有实际开船后才进入海运节点。国内 Admin/PDA 不得把订单推进到海外派送完成 `DELIVERED`。
 
 ## 2. 角色、终端和对象
 
@@ -55,7 +55,7 @@
 - 柜型规格、国内中转仓、有效渠道和供应商主档可用；
 - 操作员理解模拟柜、真实柜号、订舱和拖车是不同对象；
 - 同柜不可拆组、已占用数量和版本冲突均以服务端返回为准；
-- 费用仍可并行维护，但已经确认/发送或客户已确认版本不得被静默改写。
+- 费用仍可并行维护，客户未确认不阻断排柜、预装、PDA 或装柜；装柜完成后对已装范围的当前有效已发布版本记录系统默认确认。客户确认和系统默认确认来源分开审计；缺少有效费用版本不伪造确认，部分装载不得把余量一起确认。
 
 ## 4. F14 模拟柜与智能排柜
 
@@ -225,13 +225,13 @@ PDA 装柜完成不推进拖车状态。只有订舱要求的全部柜型数量
 
 ## 10. F20 装柜证据与铅封
 
-PDA 按现场顺序拍摄：
+PDA 按现场要求采集五类证据：
 
-1. `PHOTO_STEP_1`：装柜初始/空柜；
-2. `PHOTO_STEP_2`：装载过程；
-3. `PHOTO_STEP_3`：接近完成；
-4. `PHOTO_STEP_4`：满柜/关门前；
-5. `SEAL`：带有效铅封号的封柜照片。
+1. `EMPTY`：空仓照片；
+2. `HALF`：半仓照片；
+3. `FULL`：满仓照片；
+4. `LOCKED`：锁仓照片；
+5. `SEAL`：带有效铅封号的带锁码照片。
 
 每类至少一张有效照片，同类允许追加。PDA 仅允许现场相机拍摄；有权限的 Admin 操作员/理货员可人工补充，普通拣货员不开放后台上传。
 
@@ -245,7 +245,7 @@ PDA 点击“完成装柜”时，服务端重新校验：
 - 真实集装箱号存在；
 - 所有普通箱码或一件代发整托均核平；
 - 没有未解决异常；
-- 四步照片和带铅封号的 `SEAL` 完整；
+- 空仓、半仓、满仓、锁仓、带锁码照五类证据和锁码文本完整；
 - 计划明细、已拣数量和最终实装数量守恒。
 
 校验通过后：
@@ -260,45 +260,53 @@ PDA 点击“完成装柜”时，服务端重新校验：
 
 ## 12. F22 客户资料与整柜出口报关
 
-### 12.1 客户上传资料
+### 12.1 F22-A `LOADED` 后通知报关并建立客户案例
 
-入口：Client → 头程订单 → 报关资料。
+入口：`LOADED` 事件 → Admin/Client → 报关资料。
 
-客户只可对本企业订单上传退税/报关资料，选择资料类型并填写说明。文件归属、订单归属和客户身份由服务端校验，文件名不能代替合法文件 ID。
+1. 装柜完成后按最终实装清单通知报关行，建立本柜报关批次和每个客户/入仓码的 `customerCustomsCase`；
+2. 客户上传本企业资料，平台校验客户、订单、入仓码、实际装载数量和文件归属；
+3. 平台将资料发送给报关行，记录发送时间、资料版本和 `roundNo`；
+4. 报关行返回本轮回执，平台保存文件和回执字段，并向对应客户展示确认任务。
 
-### 12.2 平台整柜报关
+柜前可以存在资料准备或历史附件，但不创建本柜正式客户确认轮次，也不能显示“已通知报关”。客户资料缺失只形成报关线补件待办，不阻断送港线。
 
-入口：Admin → 柜次详情 → 出口报关。
+### 12.2 F22-B 报关行回执与客户确认循环
 
-1. 查看柜内所有入仓码及其资料覆盖情况；
-2. 对退税资料逐项核对，缺件时联系对应客户补充；
-3. 开始报关时冻结当前参与资料和版本；
-4. 线下向报关代理提交；首版不做外部系统直连；
-5. 完成后为每份退税资料上传一一对应的完成文件；
-6. 全买单柜由平台确认买单，并从导出中心获取最终实装买单明细；
-7. 点击完成整柜报关，写入放行结果和历史。
+客户查看报关行回执后有两个结果：
 
-报关完成后系统立即尝试国内出仓；若其他门禁尚未齐全，保留明确阻断项并由受控补偿重试，不能伪装为已离仓。
+1. **确认**：当前客户案例进入 `CUSTOMER_CONFIRMED`，保存确认人、确认时间、回执版本和幂等键；
+2. **打回**：当前案例进入 `NEEDS_RESUBMIT`，保存打回原因；客户重新上传/替换资料，平台重新发送报关行，报关行生成新回执，`roundNo` 加一后再次发客户确认。
 
-## 13. F23 国内出仓
+客户打回只重开对应客户案例，不重置其他客户已经确认的轮次。直到柜内所有客户案例都为 `CUSTOMER_CONFIRMED`，才允许进入整柜正式提交。
+
+### 12.3 F22-C 所有客户通过后的整柜正式申报
+
+1. 平台检查所有客户案例均已确认，冻结本柜最终实装和资料版本，生成整柜正式申报批次；
+2. 将整柜资料提交报关行确认，报关行完成正式申报；首版不做外部系统直连，保留人工提交和审计记录；
+3. 海关结果独立记录为查验、免查验放行、补件/退回、扣货等，不把客户确认回执直接当成海关放行；
+4. 报关线的任一结果都不覆盖送港线的离仓、进港、甩柜事实。送港线可以先到港，报关线也可以先完成客户确认或正式申报。
+
+## 13. F23 送港、进港与甩柜
 
 ### 13.1 出仓硬门禁
 
-整柜所有关联入库单逐项检查：
+送港线的离仓/进港门禁逐项检查：
 
 - 无有效 HOLD；
 - 入库单为 `LOADED`；
 - 装柜计划为 `COMPLETED`；
 - PDA 柜次任务为 `COMPLETED`；
 - 订舱已 `RELEASED` 且分配当前柜次；
-- 四步照片与有效铅封完整；
-- 整柜报关已完成并放行。
+- 五类证据与有效锁码文本完整；
+- 送港任务和当前船次分配完整；
+- 报关客户确认或海关结果不作为仓库离开、送港和进港的前置。
 
-独立拖车状态和独立船期字段提供调度参考，但不是当前确认离仓的硬门禁。拖车在全部订舱柜次离仓后自动完成。
+订舱、拖车、仓库离开和港口进场属于送港线事实。报关线可以先完成客户确认或正式申报，也可以晚于进港；两条线各自展示阻断项。容量不足时记录 `ROLLED_OVER`，保存原船次、滚动次数、新船次、预计开船时间和客户通知。
 
 ### 13.2 自动与人工确认离仓
 
-报关完成或其他门禁变化时系统自动尝试收敛。未自动完成时，平台在柜次/国内出仓页面：
+送港状态变化或其他送港门禁满足时系统自动尝试收敛。未自动完成时，平台在柜次/送港页面：
 
 1. 打开门禁清单；
 2. 逐项处理未通过原因；
@@ -309,13 +317,13 @@ PDA 点击“完成装柜”时，服务端重新校验：
 成功后系统：
 
 - 写入整柜唯一国内离仓事实；
-- 创建 `CarrierScheduleQuery`；
 - 写入实际 `DEPARTED_WAREHOUSE` 节点；
-- 触发出仓后船节点查询；
+- 写入 `PORT_RECEIVED` 或 `ROLLED_OVER`；
+- 维护船次和开船前等待，不把预计 ETD 记成海运在途；
 - 检查并尝试完成订舱级拖车；
 - 保持跨区交接事件可重试且不重复建单。
 
-实际离仓节点产生后禁止撤销。发现错误转入线下和后续阶段异常处理，不提供修改历史伪装未离仓的能力。
+实际离仓和进港节点产生后禁止撤销。发现错误转入线下和后续阶段异常处理，不提供修改历史伪装未离仓或未进港的能力。报关线的客户打回、重新发送和海关查验单独记录，不回滚送港事实。
 
 ## 14. 状态和动作总表
 
@@ -325,8 +333,9 @@ PDA 点击“完成装柜”时，服务端重新校验：
 | 装柜计划 | `EDITING → LOADING → COMPLETED` | 预装调整/PDA 作业/最终完成 |
 | 订舱 | `DRAFT → RELEASED` | 补齐资料并放舱 |
 | 拖车 | 非终态 → `COMPLETED` | 所有要求柜次实际离仓后自动完成 |
-| 报关 | 资料收集 → 已冻结办理中 → 已完成/放行 | 客户上传、平台开始、上传回执并完成 |
-| 国内出仓 | 等待门禁 → 可出仓 → 已离仓 | 自动尝试或平台确认 |
+| 报关 | `WAITING_DOCUMENTS → SENT_TO_BROKER → RECEIPT_PENDING_CUSTOMER_CONFIRM → CUSTOMER_CONFIRMED / NEEDS_RESUBMIT → ALL_CUSTOMERS_CONFIRMED → FORMAL_SUBMITTED → INSPECTION/RELEASED` | 装柜后通知报关行；回执必须经对应客户确认，打回则新资料/新回执轮次 |
+| 送港 | `PORT_DELIVERY_PENDING → DEPARTED_WAREHOUSE → IN_TRANSIT_TO_PORT → PORT_RECEIVED / ROLLED_OVER` | 独立安排拖车和进港；容量不足记录甩柜和改配，不等待报关客户确认 |
+| 海运 | `WAITING_SAILING → VESSEL_DEPARTED → IN_TRANSIT` | 只有承运船舶真实开航才进入海运节点 |
 
 主状态只表达阶段结果。订舱、拖车、PDA、证据和报关保持关联子状态，页面应汇聚展示，但不能互相覆盖。
 
@@ -358,8 +367,11 @@ WAIT_SPLIT 入库单/已封托托盘
   → 预装确认/动态调整
   → PDA 实装 + 五类证据
   → COMPLETED / LOADED + 数量分片 + 跨区快照
-  → 整柜报关放行
-  → 国内离仓 + DEPARTED_WAREHOUSE + 船节点查询任务
+      ├─ 报关线：通知报关 → 客户资料 → 报关行回执 → 客户确认/打回重做
+      │             → 所有客户通过 → 整柜正式申报 → 查验/放行
+      └─ 送港线：拖车 → DEPARTED_WAREHOUSE → PORT_RECEIVED
+                    → 甩柜/改配（如发生）→ 等待实际开船
+  → VESSEL_DEPARTED → 海运节点查询
 ```
 
 阶段完成必须同时满足：
@@ -367,14 +379,14 @@ WAIT_SPLIT 入库单/已封托托盘
 - [ ] 最终柜次、装柜计划、订舱、真实柜号关联可追溯
 - [ ] 全部实装箱/托盘/SKU 与入库单数量守恒
 - [ ] PDA 任务完成且无未解决异常
-- [ ] 四步照片、铅封照片和铅封号完整有效
+- [ ] 五类证据和锁码文本完整有效
 - [ ] 装柜计划 `COMPLETED`，实装入库单 `LOADED`
 - [ ] 部分装载时已装子单和余量子单正确
-- [ ] 整柜报关已完成并放行
-- [ ] 所有入库单无 HOLD
-- [ ] 唯一国内离仓历史存在
-- [ ] 第一条实际 `DEPARTED_WAREHOUSE` 存在
-- [ ] 船节点查询任务和跨区事件可幂等重试
+- [ ] 报关线已为每个客户建立案例，回执、确认/打回和每轮资料版本可追溯
+- [ ] 送港线已记录唯一国内离仓历史；如已进港，存在 `PORT_RECEIVED`，如甩柜，存在原船次/改配船次历史
+- [ ] 客户全部确认后才允许整柜正式提交；正式申报后的查验/放行结果单独记录
+- [ ] 船舶实际开航后才写入 `VESSEL_DEPARTED` 并启动海运节点查询
+- [ ] 跨区事件可幂等重试；送港线和报关线任一先完成都不覆盖另一条线
 
 ## 17. 易用性与数据流评审问题
 

头程到尾程分阶段流程/阶段四-海运目的港与尾程计划.md

@@ -1,7 +1,7 @@
 # 阶段四：海运、目的港与尾程入仓计划
 
 > 对应全景流程：F24～F27。  
-> 阶段起点：柜次已确认国内离仓，存在实际 `DEPARTED_WAREHOUSE` 节点和可查询的真实订舱/柜次。  
+> 阶段起点：柜次已完成送港/进港或甩柜处理，并产生承运船舶实际 `VESSEL_DEPARTED`/`DEPARTED_ORIGIN_PORT` 节点；真实 `DEPARTED_WAREHOUSE` 和 `PORT_RECEIVED` 属于阶段三送港线事实。  
 > 阶段终点：跨区尾程订单完整生成，整柜每票入仓计划及托盘/库位资源已生成或有明确资源失败待办，订单进入 `INBOUND_PLANNED`。  
 > 本阶段同时维护船舶/货柜轨迹和尾程业务准备，但两类状态不得互相冒充。
 
@@ -9,7 +9,7 @@
 
 本阶段完成四条相互关联但独立的链路：
 
-1. 从国内离仓开始查询并保存十个标准船节点；
+1. 从承运船舶实际开航开始查询并保存十个标准船节点；
 2. 管理目的港清关、海外码头车队、提柜、预计到仓和还空；
 3. 将国内最终实装快照可靠投递到海外区域并创建尾程订单；
 4. 按整柜维护每票计划并转换为可执行的海外入仓计划和资源。
@@ -35,9 +35,9 @@
 
 ## 3. 阶段前置检查
 
-- 柜次存在真实集装箱号、订舱、提单号和国内离仓事实；
+- 柜次存在真实集装箱号、订舱、提单号、送港/进港事实和实际开船节点；
 - 装柜完成事件包含最终实装订单、入仓单、目的类型、箱数及必要托盘/SKU/箱唛快照；
-- 国内四步照片和铅封证据已经冻结；
+- 国内五类装柜证据和锁码文本已经冻结；
 - 接柜海外仓是 Warehouse 中 `ACTIVE + OVERSEAS + RECEIVING` 的平台共享物理仓；
 - FBA 目的仓是 Warehouse 有效公共主档，不能用接柜仓或国内仓代替；
 - 船司/轨迹查询标识足以唯一指向目标订舱和柜次；
@@ -47,9 +47,11 @@
 
 ### 4.1 查询任务创建
 
-国内出仓确认事务幂等创建 `CarrierScheduleQuery`。任务必须绑定真实订舱、柜次以及可用的船司、船名航次、提单号或柜号，不创建脱离业务单据的孤立轮询任务。
+承运船舶实际开航事务幂等创建 `CarrierScheduleQuery`。任务必须绑定真实订舱、柜次以及可用的船司、船名航次、提单号或柜号，不创建脱离业务单据的孤立轮询任务。送港、进港、甩柜和客户报关确认在阶段三分别记录，不能用预计 ETD 提前创建“海运中”展示。
 
-首个实际节点由国内出仓写入：
+标准节点保留国内送港事实，但海运查询的起点是实际开船：
+
+`DEPARTED_WAREHOUSE`、`AT_ORIGIN_PORT` 和 `LOADED_ON_VESSEL` 可以作为送港/装船历史补录；客户的“海运中”节点和定时船节点查询以真实 `DEPARTED_ORIGIN_PORT`/`VESSEL_DEPARTED` 为起点。
 
 ```text
 10 DEPARTED_WAREHOUSE       已离开国内仓