40 lines
3.6 KiB
Markdown
40 lines
3.6 KiB
Markdown
# 甩柜与改配接入设计（F23.3）
|
||
|
||
## 最新确认
|
||
|
||
柜子不会变。平台人员在原柜子的船期信息上人工修改船名、航次和预计时间即可；保留修改前后内容、修改人和时间。报关资料、回执、完成文件和客户确认保持不变。
|
||
|
||
## 操作流程
|
||
|
||
1. 退税报关完成后进入待发区，等待船舶承运。
|
||
2. 原船装满导致甩柜时，平台编辑该柜当前船期，填写实际安排的船名、航次和预计开船/到港时间。
|
||
3. 保存后继续使用原柜次和原船期查询任务；保留已经发生的离仓、进港事实。
|
||
4. 货柜实际随船开航后，再记录实际开航节点。修改预计船期本身不表示已经开船。
|
||
|
||
不新建柜子、订舱关联或航次变更审批对象，不重建船期任务，也不重新上传或确认报关资料。此前建议的 voyage-changes 接口和批次评估状态已取消。
|
||
|
||
## 现有接入入口与待验收项
|
||
|
||
入口放在原柜详情的“船名航次信息”区域，通过“船期维护与历史”打开居中弹框；不依赖已退出路由的独立 `PortSchedulesView.vue`。后端返回与当前运输展示来自同一条记录的只读 `currentPortScheduleId`，前端按此加载详情；不得自行从其他柜或全量船期中选择记录。`PortScheduleService.update` 保持客户、订舱和柜次归属不变，并保存版本和修改前后历史。
|
||
|
||
已有记录只修改船名、航次、ETD、ETA及本次原因，其余来源与有效期字段保留；提交携带原版本和幂等键，网络结果不明时重试原请求，未改运输值不重复发送。只读权限可查看历史，新增和编辑权限分别校验。无当前记录时，允许在原客户、原订舱和原柜上登记船期信息，来源、确认时间、信息有效至及截港时间须明确填写，不自动编造门禁有效期。
|
||
|
||
交互依据沿用既有船期维护的居中表单和货柜详情分区；已有记录使用1000px弹框，首次登记使用1120px三列表单，原因跨列，历史展示修改前后四项运输字段、修改人、原因和时间。实际1920×1080页面验收及发布证据仅维护在测试环境主契约，不以此设计说明替代验收结果。
|
||
|
||
当前船期展示已改为读取同一客户、订舱和柜次下最新船期记录，不再固定读取订舱初始快照。平台人工改船后，客户端会同步显示最新船名、航次和预计时间。
|
||
|
||
## 验收要求
|
||
|
||
- 修改后柜次、柜号、装柜清单、订舱关联和船期查询任务不变。
|
||
- 船名、航次和预计时间正确更新，平台与客户可见的当前船期一致。
|
||
- 修改前后历史、操作人和时间可追溯，重复请求和版本冲突有明确结果。
|
||
- 报关状态、资料、回执、完成文件、客户确认与修改前一致。
|
||
- 已发生的物理节点不重置，预计时间调整不推进实际开航。
|
||
|
||
## 真实联调证据（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`。
|