This commit is contained in:
2026-08-10 11:29:00 +08:00
parent 01496f77ae
commit 82c3ef8413
5 changed files with 151 additions and 97 deletions
+9 -3
View File
@@ -18,17 +18,23 @@
- [虫虫出海三期开发进度表(Excel)](虫虫出海三期开发进度表.xlsx):可筛选、可下拉维护并使用公式汇总的项目进度工作簿。
- [三期需求确认表](三期需求确认表.md):集中跟踪 P3-Q1~P3-Q13、负责人和最终结论。
- [三期页面与原型清单](三期页面与原型清单.md):按管理后台、企业客户端和 PDA 维护页面范围及原型状态。
- [三期验收任务拆分与待确认清单](三期验收任务拆分与待确认清单.md):真实 HTTP/真机验收覆盖、coverageGap 解除条件和并行任务入口。
- `参考资料/出仓流程.png`:本期 9 个核心动作及业务终点的原始参考图。
## 当前状态
三期已有排柜/预装/PDA 拣货/装柜清单子链路,订舱和拖车子模块 API 也已实现并完成独立环境验证;但 2026-08-08 闭环审计结论仍为 `NO-GO`。已确认不新建出仓单,现有订单列表承载待分柜、装柜中和装柜完成等国内三期主状态。当前缺少订单三期统一编排、五类装柜照片多图追加/作废与真实门禁、报关协同、冲正、Client 三期协同及 PDA 真实身份/真机验收,暂不具备整期验收条件。现有平台手工“确认派送完成”接口与已确认边界不一致,应改为海外仓可信回传或从国内三期入口移除。
三期已从“等待产品确认”转入分模块开发规划。已确认不新建独立出仓单,现有订单列表/详情承载主状态;支持一单多柜、一个柜拼多个订单,并采用“父订单→子订单→柜次”关系,已装载数量形成子订单,未装载数量自动生成后续子订单。进入 `LOADED`/装柜完成前,订舱完成、拖车完成、报关放行回执、PDA 拣货完成及五类证据完整均为服务端硬门禁;`LOADED` 后错误统一线下人工处理,国内 Admin/PDA 不提供在线冲正或手工推进 `DELIVERED`。
### PDA 当前确认口径(2026-08-09)
船期首版按船公司官网查询,每 3 天一次、最多 3 次,记录来源、查询/更新时间和过期标识。首批来源为美森、SML、ZIM、COSCO、EMC、合德;外部页面不可用时保留最近结果并标记过期。报关首版不做系统对接,全部由人工整理、线下提交和人工上传回执。仓库初始化角色包括操作员、拣货员、理货员,具体权限矩阵由 IAM 契约任务落表。
当前仅 P3-Q4 的设备型号/Android/打包真机口径、P3-Q5 的实时库存与库位数据源仍需技术澄清;这些问题只阻断对应实现,不影响已确认模块进入契约设计和并行开发。
### PDA 当前确认口径(2026-08-10)
- Android 扫描广播方式已接入;具体设备型号、系统版本、打包发布和真机验收仍待确认。
- 正式作业仅支持在线:进入任务即标记“拣货中”,扫描保存在绑定作业员+任务+柜次的设备持久化草稿,点击提交时批量写后端。
- 允许部分拣货或跳拣,但每个未完成项必须填写异常原因;存在未解决异常时不能完成或进入 `LOADED`。
- 重复提交返回原结果,版本冲突提示员工刷新重试。
- PDA 只能现场拍照,Admin 可人工上传;五类证据各至少 1 张有效照片,可同类型多张追加,错图只作废不硬删除。
- 一柜多人并行、退出/换班释放、最终 `LOADED` 触发人、Admin 上传角色、照片可见范围和留存期限仍待产品确认。
- 单柜次只允许一名作业员作业,不做多人并行和任务接管;进入任务即标记“拣货中”,扫描草稿按作业员+任务+柜次隔离,点击提交时批量写入后端。
- 后台操作员、拣货员、理货员可按权限人工上传证据;照片无限期保留,客户不可见照片和锁码。