2026-09-04 16:44:08 +08:00
|
|
|
# 国内货柜履约验收任务拆分与待确认清单
|
2026-08-10 11:29:00 +08:00
|
|
|
|
|
|
|
|
> 更新日期：2026-08-10
|
|
|
|
|
> 本清单只描述真实 HTTP/设备验收边界，不把原型或 mock 结果视为通过。
|
|
|
|
|
|
|
|
|
|
## 已纳入真实 HTTP 验收
|
|
|
|
|
|
|
|
|
|
| 任务 | 真实断言 | 脚本入口 |
|
|
|
|
|
|---|---|---|
|
|
|
|
|
| PDA 进入任务 | 领取后服务端任务立即进入 `IN_PROGRESS`，并绑定当前作业员 | `phase3-container-loading.mjs` |
|
|
|
|
|
| PDA 拣货提交 | 明细数量、重复扫码、旧版本冲突、`operationId` 幂等及复核完成态 | `phase3-container-loading.mjs` |
|
|
|
|
|
| 五类装柜证据 | 空仓、半仓、满仓、锁仓、带锁码照均上传真实文件并按客户/柜次绑定 | `phase3-loading.mjs` |
|
|
|
|
|
| 同类型多图 | 同一证据类型追加第二张真实图片，原记录与新增记录同时保持有效 | `phase3-loading.mjs` |
|
|
|
|
|
| 锁码门禁 | 缺少锁码照片或锁码文本为空时，完成装柜请求被拒绝 | `phase3-loading.mjs` |
|
2026-09-24 13:43:53 +08:00
|
|
|
| 统一装柜门禁 | 真实柜号缺失、PDA 未完成、数量不守恒或五类证据不完整时，真实 `LOADED` 请求被拒绝；`LOADED` 后分别验收客户报关回执确认闭环和送港/进港/甩柜事实，任何一条线都不反向阻断物理装柜 | `service-center-flow.mjs` / `phase3-loading.mjs` |
|
2026-08-10 11:29:00 +08:00
|
|
|
| 订单/柜次聚合 | 一单多柜、一个柜多订单、父子订单数量分摊及未装数量自动生成子订单可追溯 | `phase3-order-aggregate.mjs`（待补） |
|
2026-09-24 13:43:53 +08:00
|
|
|
| 实际开船后船节点查询 | 只有承运船舶真实开航后才进入海运节点；送港、进港和甩柜属于国内货柜履约并行线 | 海外仓业务沿用现有 `CarrierScheduleQuery` 设计验收入口，不再用预计 ETD 或 `DEPARTED_WAREHOUSE` 提前推进海运 |
|
2026-08-10 11:29:00 +08:00
|
|
|
| 仓库角色 | 操作员、拣货员、理货员初始化、最小权限和跨客户隔离 | `phase3-role-contract.mjs`（待补） |
|
|
|
|
|
| 伪造与交叉归属 | 不存在 `fileId`、其他证据类型的 `fileId` 不能绑定 | `phase3-loading.mjs` |
|
|
|
|
|
|
|
|
|
|
## 保留 coverageGap 的确认项
|
|
|
|
|
|
|
|
|
|
| 编号 | 待确认/待环境能力 | 保留原因 | 解除条件 |
|
|
|
|
|
|---|---|---|---|
|
2026-08-10 12:46:16 +08:00
|
|
|
| P3-PDA-D01 | PDA 断网、恢复网络和真机在线限制 | HTTP 验收器无法模拟设备网络与现场相机 | 按既定 uni-app 发布安排在目标设备执行真机脚本 |
|
2026-08-10 11:29:00 +08:00
|
|
|
| P3-PDA-D03/D04 | 设备持久化草稿、批量提交、跨账号隔离 | 当前公开服务未提供稳定的设备草稿/批量提交 HTTP 契约 | 固定草稿 DTO、提交端点、幂等键、版本字段和清理语义 |
|
|
|
|
|
|
|
|
|
|
## 并行任务拆分
|
|
|
|
|
|
|
|
|
|
1. `P3-ACCEPT-PDA-ONLINE`：PDA 真机在线/断网/前后台验收。
|
|
|
|
|
2. `P3-ACCEPT-PDA-DRAFT`：草稿持久化、批量提交、幂等、版本冲突和跨账号隔离验收。
|
|
|
|
|
3. `P3-ACCEPT-EVIDENCE-VOID`：五类证据多图追加、作废、锁码文本和 `LOADED` 门禁验收。
|
2026-08-10 12:46:16 +08:00
|
|
|
4. `P3-ACCEPT-PDA-RELEASE`：按既定 uni-app 在线更新安排完成发布与真机验收。
|
2026-08-10 11:29:00 +08:00
|
|
|
|
|
|
|
|
每个任务完成后，必须把真实请求、响应状态、业务码、`requestId/traceId` 写入报告，并删除对应 coverageGap；不得以 mock 或数据库直写替代接口验收。
|
