docs: organize contracts by business domain
This commit is contained in:
@@ -0,0 +1,56 @@
|
||||
# 虫虫出海国内货柜履约页面与原型清单
|
||||
|
||||
> 创建日期：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 人工上传另设入口 |
|
||||
|
||||
## 五、下一步收口顺序
|
||||
|
||||
1. 先修复 PDA `pick` 第二处 `S0500`，恢复领取、拣货、复核、装柜完成和报关终态真实链路。
|
||||
2. 单独实现 P3-PDA-04 原子批量提交契约，覆盖整批事务、幂等、版本/库存快照和失败回滚。
|
||||
3. 完成 P3-PDA-05 真机拍照、多图追加、失败重试与作废验收。
|
||||
4. 补齐 P3-ADM-01、P3-ADM-02、P3-ADM-10 和企业客户端国内货柜履约页面的最终交互验收。
|
||||
5. 复跑国内货柜履约定向和默认全量 HTTP 验收，只有所有硬门禁真实通过后才把页面和整期标记为完成。
|
||||
Reference in New Issue
Block a user