# 甩柜与改配接入设计（F23.3）

## 最新确认

柜子不会变。平台人员在原柜子的船期信息上人工修改船名、航次和预计时间即可；保留修改前后内容、修改人和时间。报关资料、回执、完成文件和客户确认保持不变。

## 操作流程

1. 退税报关完成后进入待发区，等待船舶承运。
2. 原船装满导致甩柜时，平台编辑该柜当前船期，填写实际安排的船名、航次和预计开船/到港时间。
3. 保存后继续使用原柜次和原船期查询任务；保留已经发生的离仓、进港事实。
4. 货柜实际随船开航后，再记录实际开航节点。修改预计船期本身不表示已经开船。

不新建柜子、订舱关联或航次变更审批对象，不重建船期任务，也不重新上传或确认报关资料。此前建议的 voyage-changes 接口和批次评估状态已取消。

## 现有接入入口与待验收项

现有平台船期页面 `PortSchedulesView.vue` 提供编辑船名、航次、预计开船和到港时间的入口；后端 `PortScheduleService.update` 保持客户、订舱和柜次归属不变，并保存版本和修改前后历史。优先复用该能力。

当前船期展示已改为读取同一客户、订舱和柜次下最新船期记录，不再固定读取订舱初始快照。平台人工改船后，客户端会同步显示最新船名、航次和预计时间。

## 验收要求

- 修改后柜次、柜号、装柜清单、订舱关联和船期查询任务不变。
- 船名、航次和预计时间正确更新，平台与客户可见的当前船期一致。
- 修改前后历史、操作人和时间可追溯，重复请求和版本冲突有明确结果。
- 报关状态、资料、回执、完成文件、客户确认与修改前一致。
- 已发生的物理节点不重置，预计时间调整不推进实际开航。

## 真实联调证据（2026-09-27）

测试柜 `TSTU0152125`（`containerBookingId=2104006600809353218`）的退税报关计划
`2104006600830324737` 已完成资料、回执确认和完税文件闭环。平台创建一次原柜船期改配记录后，客户端同一订单立即读到新船名、航次和预计时间；柜号、柜次不变，报关状态、退税客户数量、资料/回执/完成文件 ID 与版本均未变化。随后已用版本更新恢复原船信息，恢复后的客户端投影再次一致。完整证据见
`baiyue-firstleg/reports/platform-and-client-transport-projection-20260927.json`（平台与客户端同时回读）以及
`baiyue-firstleg/reports/transport-projection-after-schedule-update-20260927.json`。