虫虫出海三期页面与原型清单
创建日期：2026-07-28
当前状态：核心 Admin 装柜页面已部署联调；PDA 提交契约和客户端三期页面仍未完成
原型依据：参考资料/出仓流程.png、现有订单列表/详情、现有 PDA 拣货原型
已确认边界：不新增独立出仓单；国内三期终点为 LOADED/装柜完成
一、维护规则
- 页面状态统一使用：待确认、待原型、原型中、待评审、已确认、开发中、联调中、已阻塞、已完成；“已有/部分参考原型”仅表示原型覆盖程度，不表示功能完成。
- 页面只有在业务流程、角色权限和关键字段确认后才能标记“已确认”。
- 页面原型至少覆盖正常态、空态、加载态、失败态、无权限态和关键冲突态。
- 当前先列页面级大项，后续按开发进度表的大任务逐项拆交互、字段和验收。
二、管理后台
| 页面 ID |
页面/入口 |
主要能力 |
对应大任务 |
原型状态 |
依赖确认项 |
备注 |
| P3-ADM-01 |
现有订单列表三期增强 |
查询、筛选、三期主状态、异常和阻塞摘要 |
T03 订单三期编排与柜次 |
待原型 |
P3-Q2、P3-Q11 |
复用现有订单列表，不新增出仓单列表和创建入口 |
| P3-ADM-02 |
现有订单详情三期增强 |
柜次、任务、五类装柜照片、锁码、报关和时间线 |
T03 订单三期编排与柜次 |
待原型 |
P3-Q11 |
组合现有货柜和装柜清单能力，补统一编排区 |
| P3-ADM-03 |
智能排柜 |
生成建议、冲突、调整和确认 |
T04 智能排柜 |
开发中 |
P3-Q1、P3-Q2 |
Admin /container-loading/smart-loading 已部署；真实完成态受 PDA 门禁阻断 |
| P3-ADM-04 |
订舱管理 |
订舱申请、结果、变更和异常 |
T05 订舱与港务信息 |
已有参考原型 |
P3-Q9、P3-Q11 |
已有订舱列表、新增和详情 |
| P3-ADM-05 |
订舱与出仓前船期资料 |
人工维护船名航次、港口及预计时间快照 |
T05 订舱资料 |
部分参考原型 |
P3-Q9 |
出仓后的来源、更新时间和节点查询页面整体归四期 |
| P3-ADM-06 |
拖车预约 |
服务商、车辆司机、时间窗和节点 |
T06 拖车预约 |
已有参考原型 |
P3-Q3、P3-Q11 |
已有拖车列表和新增表单，需补预约及到离仓节点 |
| P3-ADM-07 |
拣货任务与复核 |
分配、进度、差异、复核和异常 |
T07 PDA 拣货与复核 |
已阻塞 |
P3-Q5 |
真实任务领取可用；PDA pick 仍返回 S0500，批量提交契约未实现 |
| P3-ADM-08 |
装柜证据复核 |
柜号、锁码文本、五类多图、Admin 上传、作废和复核 |
T08 装柜及柜封证据 |
开发中 |
P3-Q6 |
五类多图追加、作废和 Admin 上传已通过真实接口；终态复核受 PDA 阻断 |
| P3-ADM-09 |
报关协同 |
资料审核、补件、提交批次和回执上传 |
T09 报关资料与回执 |
部分参考原型 |
P3-Q7、P3-Q8、P3-Q12 |
已有报关单和单证管理，缺客户补件协同闭环 |
| P3-ADM-10 |
订单装柜完成操作区 |
门禁检查、确认装柜完成、阻塞原因和冲正 |
T10 装柜完成门禁 |
开发中 |
P3-Q10、P3-Q11、P3-Q12 |
门禁读取和阻塞原因已有真实接口；置于现有订单详情，不提供在线冲正 |
三、企业客户端
| 页面 ID |
页面/入口 |
主要能力 |
对应大任务 |
原型状态 |
依赖确认项 |
备注 |
| P3-CLI-01 |
现有订单列表三期增强 |
查看本企业订单的装柜阶段、柜次和当前节点 |
T11 客户端三期协同 |
待原型 |
P3-Q11 |
复用现有订单列表，不新增出仓单列表 |
| P3-CLI-02 |
现有订单详情三期增强 |
时间线、柜号、船期和允许公开的证据 |
T11 客户端三期协同 |
待原型 |
P3-Q6、P3-Q9 |
在现有订单详情补三期区块，不新建重复详情对象 |
| P3-CLI-03 |
报关资料上传 |
清单、上传、补件、版本和处理进度 |
T09 报关资料与回执 |
待原型 |
P3-Q7 |
文件规则确认后细化 |
| P3-CLI-04 |
报关回执下载 |
回执列表、类型、版本和授权下载 |
T09 报关资料与回执 |
待原型 |
P3-Q8、P3-Q12 |
区分客户可见回执 |
| P3-CLI-05 |
出仓前船期资料 |
订舱预计开船、到港快照和变更 |
T11 客户端三期协同 |
待原型 |
P3-Q9 |
出仓后的实时节点、来源、更新时间和过期展示归四期 |
四、PDA
| 页面 ID |
页面/入口 |
主要能力 |
对应大任务 |
原型状态 |
依赖确认项 |
备注 |
| P3-PDA-01 |
登录 |
人员登录和快捷登录 |
T07 PDA 拣货与复核 |
已有静态原型 |
- |
真实鉴权待服务端接入 |
| P3-PDA-02 |
箱号与任务选择 |
领取任务、进入即标记拣货中、选择箱号和查看进度 |
T07 PDA 拣货与复核 |
已有静态原型 |
P3-Q5、P3-Q11 |
需对接真实任务；单柜次单作业员，不支持换班接管 |
| P3-PDA-03 |
扫码拣货 |
广播扫码、持久化草稿、整拣、部分拣货、跳拣和撤销 |
T07 PDA 拣货与复核 |
开发中 |
P3-Q5、P3-Q11 |
广播 Action/Extra 已接入；真实单明细 pick 当前仍有 S0500，断网禁止正式提交 |
| P3-PDA-04 |
拣货提交 |
批量汇总、异常原因、幂等提交、版本冲突和完成统计 |
T07 PDA 拣货与复核 |
已阻塞 |
P3-Q5、P3-Q11 |
产品已确认点击提交时批量写后端；真正 batch endpoint、整批事务、幂等与回滚尚未实现 |
| P3-PDA-05 |
装柜拍照上传 |
PDA 现场拍摄五类证据、多图追加、锁码文本、预览、失败重试、作废和提交 |
T08 装柜及柜封证据 |
原型中 |
P3-Q6 |
每类至少一张有效照片；PDA 不开放相册，Admin 人工上传另设入口 |
五、下一步收口顺序
- 先修复 PDA
pick 第二处 S0500，恢复领取、拣货、复核、装柜完成和报关终态真实链路。
- 单独实现 P3-PDA-04 原子批量提交契约，覆盖整批事务、幂等、版本/库存快照和失败回滚。
- 完成 P3-PDA-05 真机拍照、多图追加、失败重试与作废验收。
- 补齐 P3-ADM-01、P3-ADM-02、P3-ADM-10 和企业客户端三期页面的最终交互验收。
- 复跑三期定向和默认全量 HTTP 验收，只有所有硬门禁真实通过后才把页面和整期标记为完成。
