32 lines
3.2 KiB
Markdown
32 lines
3.2 KiB
Markdown
# 国内货柜履约开工门禁
|
||
|
||
> 本文维护国内货柜履约跨端开发的稳定门禁。实时任务进度见 `国内货柜履约开发进度表.md`；产品决策以 `国内货柜履约需求确认表.md` 为准。
|
||
|
||
## 可直接开展的范围
|
||
|
||
- 已确认规则可进入契约、数据、接口、页面和测试拆分，不需要等待整期所有模块完成。
|
||
- 订单继续承载国内货柜履约主状态，不新建独立出仓单；支持父订单、子订单与柜次关系，以及一单多柜和多订单拼柜。
|
||
- 智能排柜、订舱与船期、拖车预约、PDA 在线拣货、五类装柜证据、`LOADED` 后客户报关确认闭环、送港/甩柜和实际开船按本轮确认流程执行。
|
||
- 国内货柜履约的国内终点为 `LOADED`；`DELIVERED` 只由海外仓可信回传推进。
|
||
|
||
## 跨端硬边界
|
||
|
||
- `LOADED` 前必须由服务端校验真实柜号、PDA 拣货与数量守恒、五类有效证据和未解决异常。`LOADED` 后报关线和送港线分别校验：报关线按客户资料、报关行回执、客户确认/打回、所有客户通过、整柜正式申报和海关结果推进；送港线按订舱/拖车、离仓、进港、甩柜和实际开船推进。客户确认不阻断送港，进港不代表报关完成。国内 Admin/PDA 不提供在线冲正或手工推进 `DELIVERED`。
|
||
- PDA 正式作业仅在线；单柜次只允许一名作业员，不支持多人并行、任务接管或换班释放。进入任务即由服务端标记拣货中，扫描草稿按作业员、任务和柜次隔离，提交时批量写入。
|
||
- 每类证据至少一张有效照片，允许同类型追加；错误照片只能作废并保留审计。客户不可见照片与锁码。
|
||
- 报关在 `LOADED` 后正式启动：每个客户经历资料上传、报关行回执、客户确认或打回重做，所有客户通过后才提交整柜资料给报关行正式申报；送港线独立记录拖车、进港、甩柜和实际开船。费用确认不阻断排柜/装柜，装柜完成后对已装范围的当前有效已发布费用版本记录系统默认确认，来源和客户主动确认必须分开审计。
|
||
- 前端页面、菜单和路由只能在对应服务端契约、权限和数据模型稳定后发布；原型中的完整 WMS、海外仓及未确认能力不属于国内货柜履约默认范围。
|
||
|
||
## 局部阻断项
|
||
|
||
- PDA 采用 uni-app 开发并支持在线更新；Android 广播扫描已接入。设备型号不构成开发、发布或验收门禁；扫描适配保持厂商无关，按既定发布安排完成常规真机验收。
|
||
- 未冻结的字段、权限码、错误码、迁移方案或跨服务调用，只阻断依赖它们的模块；不得以模拟成功或前端猜测替代服务端契约。
|
||
- 修改任一跨服务契约时，必须同步检查生产者、调用方、OpenAPI、权限、迁移脚本和实际前端消费者。
|
||
|
||
## 使用方式
|
||
|
||
1. 先读 `README.md`、`国内货柜履约需求确认表.md` 和本文件，确认任务属于已确认范围。
|
||
2. 再进入目标应用或服务的 `AGENTS.md`，按本地模块入口实现。
|
||
3. 发现新的产品决策或门禁变化时，先更新确认表与本文，再更新受影响模块指引；不要将短期进度、联调故障或环境地址写回模块规则。
|
||
|