2026-09-28 16:01:16 +08:00
10 changed files with 440 additions and 134 deletions
@@ -1,6 +1,6 @@
 # 三期文档

-三期以头程物流“03 出仓”为范围，完成从排柜、订舱、拖车和仓内拣货，到封柜、报关、国内出仓并等待装船的业务闭环。
+三期以国内头程后程作业为范围，完成从排柜、订舱、拖车和仓内拣货，到装柜证据齐全并进入 `LOADED`/装柜完成的业务闭环。`DELIVERED`/派送完成由到达海外仓后的可信回传推进，不属于国内三期操作范围。

 ## 当前主体模型与开工禁令

@@ -11,6 +11,8 @@
 ## 文档

 - [三期闭环审计报告（2026-08-08）](三期闭环审计报告-2026-08-08.md)：基于当前代码、接口、自动化和测试环境证据的闭环审计，列出阻断项、优先级和 GO 准入标准。
+- [三期装柜闭环产品确认表（2026-08-08）](三期装柜闭环产品确认表-2026-08-08.md)：提供给产品直接填写的纯业务确认表，不包含技术实现细节。
+- [三期装柜闭环开发前确认单（2026-08-08）](三期装柜闭环开发前确认单-2026-08-08.md)：用于产品确认直接开发前的状态、门禁、PDA 取证、冲正和验收细节。
 - [三期开发规划：国内出仓](三期开发规划.md)
 - [三期开发进度表](三期开发进度表.md)：参考一期采用“大任务 → 详细任务 → 里程碑 → 未确认事项 → 开工准入 → 验收”结构维护。
 - [虫虫出海三期开发进度表（Excel）](虫虫出海三期开发进度表.xlsx)：可筛选、可下拉维护并使用公式汇总的项目进度工作簿。
@@ -20,4 +22,13 @@

 ## 当前状态

-三期已有排柜/预装/PDA 拣货/装柜清单子链路，订舱和拖车子模块 API 也已实现并完成独立环境验证；但 2026-08-08 闭环审计结论仍为 `NO-GO`。已确认不新建出仓单，现有订单列表承载待分柜、装柜中、装柜完成和派送完成等主状态。当前缺少订单三期统一编排、五张装柜照片真实上传与硬门禁、报关协同、冲正、Client 三期协同及 PDA 真实身份/真机验收，暂不具备整期验收条件。详细缺口和 GO 标准以最新闭环审计报告为准。
+三期已有排柜/预装/PDA 拣货/装柜清单子链路，订舱和拖车子模块 API 也已实现并完成独立环境验证；但 2026-08-08 闭环审计结论仍为 `NO-GO`。已确认不新建出仓单，现有订单列表承载待分柜、装柜中和装柜完成等国内三期主状态。当前缺少订单三期统一编排、五类装柜照片多图追加/作废与真实门禁、报关协同、冲正、Client 三期协同及 PDA 真实身份/真机验收，暂不具备整期验收条件。现有平台手工“确认派送完成”接口与已确认边界不一致，应改为海外仓可信回传或从国内三期入口移除。
+
+### PDA 当前确认口径（2026-08-09）
+
+- Android 扫描广播方式已接入；具体设备型号、系统版本、打包发布和真机验收仍待确认。
+- 正式作业仅支持在线：进入任务即标记“拣货中”，扫描保存在绑定作业员+任务+柜次的设备持久化草稿，点击提交时批量写后端。
+- 允许部分拣货或跳拣，但每个未完成项必须填写异常原因；存在未解决异常时不能完成或进入 `LOADED`。
+- 重复提交返回原结果，版本冲突提示员工刷新重试。
+- PDA 只能现场拍照，Admin 可人工上传；五类证据各至少 1 张有效照片，可同类型多张追加，错图只作废不硬删除。
+- 一柜多人并行、退出/换班释放、最终 `LOADED` 触发人、Admin 上传角色、照片可见范围和留存期限仍待产品确认。
@@ -0,0 +1,55 @@
+# 三期 Wave 1 开发任务卡
+
+整理日期：2026-08-09  
+用途：产品确认后用于研发排期和任务分派。  
+当前范围：只做低风险基础能力；不提前实现未确认的主状态机规则。
+
+## 一、统一范围口径
+
+- 不新增独立出仓单主对象、列表或详情页面。
+- 现有订单是三期唯一主对象；柜次是执行对象。
+- 订单与柜次通过履约分片/分配关系表达一单多柜、一柜多单和部分履约。
+- 国内三期终点是 `LOADED`/装柜完成；国内端不能手工推进 `DELIVERED`。
+- 五类装柜照片为：空仓、半仓、满仓、锁仓、带锁码照；锁码文本单独保存。
+
+## 二、第一批可立即开发
+
+| 编号 | 端/模块 | 任务 | 目标文件或范围 | 验收标准 | 依赖 |
+|---|---|---|---|---|---|
+| W1-BE-01-R | 后端 | 订单-柜次-履约分片契约设计 | 现有 order/firstleg/loading DTO、关系表和 OpenAPI；不得创建 `fl_outbound_order` | 支持多对多关系、快照、版本和客户隔离；形成评审稿 | 产品确认 Q2/Q11 后冻结实现 |
+| W1-BE-06 | 后端 | 拖车幂等与实际节点修复 | TruckAppointmentService、Controller、Mapper、测试 | 缺少幂等键时拒绝；同键重放返回原结果；冲突返回 409；到仓/离仓时间可追溯 | 无 |
+| W1-BE-08 | 后端 | OpenAPI 盘点与集成测试骨架 | 订舱、拖车、排柜、PDA、文件、门禁接口文档和契约测试 | 文档路径与 Controller 一致；建立二期终点到装柜完成的测试骨架 | 仅依赖现有接口 |
+| A-01 | Admin | 订舱 DTO、版本和动作权限对齐 | `apps/admin-web/src/modules/ocean-bookings/` | 创建、编辑、提交、确认、放舱、变更、取消均使用真实字段、版本和权限 | 后端现有契约 |
+| A-02 | Admin | 订单详情挂载三期作业组件 | `apps/admin-web/src/modules/unified-orders/` | 从订单详情可进入分柜、预装、拣货、装柜；刷新可恢复；错误和无权限有明确提示 | 订单与入库关联字段确认 |
+| PDA-01 | PDA | 五证据槽位和上传队列基础 | `apps/pda-uniapp/pages/` 及文件上传适配 | 五类槽位固定；临时路径不作为业务证据；失败可重试；重复提交不产生重复有效记录 | File 上传接口 |
+| CLI-01 | Client | 内部证据字段脱敏 | `apps/client-web/src/modules/first-leg/` | Client 不返回、不展示照片、锁码和 `sealNo`；订单状态仍可正常展示 | 后端响应兼容 |
+
+## 三、必须等产品确认
+
+| 编号 | 决策 | 未确认前的处理 |
+|---|---|---|
+| Q1 | 排柜硬约束、软偏好和人工确认 | 不升级算法、不生成正式拣货任务 |
+| Q2 | 拼柜、一单多柜、部分拣货是否开放 | 只做关系查询，不冻结聚合规则 |
+| Q3 | `LOADING` 触发时点 | 保留现状，暂不改状态触发代码 |
+| Q4 | PDA 设备、扫描头和仓库权限 | 先做接口适配，不做真机上线承诺 |
+| Q5 | 是否实时校验库存/库位 | 不新增库存扣减逻辑 |
+| Q7/Q8/Q12 | 报关资料、代理批次、回执及门禁关系 | 只做范围设计，不建正式业务状态机 |
+| Q9 | 港务字段、来源、更新时间 | 不新增客户实时承诺 |
+| Q10 | `LOADED` 后冲正和证据修正 | 不实现直接覆盖或冲正接口 |
+| Q11 | 订舱、拖车、报关等强制前置 | 不把并行子状态写成硬门禁 |
+| Q13 | 国内终点及海外仓回传映射 | 国内端移除人工 `DELIVERED` 操作 |
+
+## 四、后续波次
+
+1. Wave 0：完成 Q1～Q13 契约冻结和订单详情低保真确认。
+2. Wave 1：完成本表第一批基础能力。
+3. Wave 2：实现柜次级证据包、PDA 真实上传和服务端 `LOADED` 门禁。
+4. Wave 3：实现报关协同、Client 只读展示和海外仓可信回传接口。
+5. Wave 4：用同一真实订单完成正向、负向、权限、并发、幂等和弱网验收。
+
+## 五、禁止误开工项
+
+- 新建独立出仓单或独立出仓菜单。
+- 允许无拣货、缺照片或缺锁码进入 `LOADED`。
+- 国内 Admin/PDA 手工推进 `DELIVERED`。
+- 在产品未确认前固化部分拣货拆单和一单多柜聚合规则。
@@ -2,10 +2,10 @@

 > 创建日期：2026-07-28  
 > 状态：范围规划中  
-> 流程依据：[出仓流程](参考资料/出仓流程.png)中的头程物流“03 出仓”；当前以图片中的“完成国内出仓，等待装船”为阶段终点  
+> 流程依据：[出仓流程](参考资料/出仓流程.png)中的头程物流“03 出仓”；用户已于 2026-08-08 确认国内三期以 `LOADED`/装柜完成为阶段终点
 > 前置阶段：[一期文档](../一期/README.md) · [二期文档](../二期/README.md)

-> 2026-08-08 已确认调整：三期不新建独立出仓单，现有订单列表承载全部主状态，柜次、订舱、拖车、拣货、证据和报关作为订单关联子对象。PDA 拣货后必传空仓、半仓、满仓、锁仓、带锁码照共 5 张图片，并必填锁码文本；全部真实上传成功后 PDA 装柜任务才能完结。
+> 2026-08-09 已确认调整：三期不新建独立出仓单，现有订单列表承载全部主状态，柜次、订舱、拖车、拣货、证据和报关作为订单关联子对象。空仓、半仓、满仓、锁仓、带锁码照五类证据各至少 1 张有效照片，可同类型多张追加；带锁码照必须同时保存锁码文本。PDA 只能现场拍照，Admin 可人工上传，错图只作废不硬删除。

 > 主体模型与硬约束：三期只实现“平台—客户”两级，业务 `tenant_id > 0` / `tenantId` 当前表示客户 ID；`tenant_id=0` 是平台身份、平台 RBAC 和平台公共仓储资源技术作用域，客户往来单位、订单、文件和费用归属客户 `tenant_id>0`。禁止新增租户主表、租户选择器、客户所属租户配置、租户切换、租户级 RBAC 或租户级配置，禁止把现有 `tenant_id` 改义为上级租户 ID；历史类名、路径和字段继续兼容。

@@ -24,10 +24,10 @@ PDA 拣货 → 装柜并上传货柜/铅封照片
    ↓
 查询或维护预计开船、到港等港务/船期信息
    ↓
-完成国内出仓，等待装船
+国内三期完成：`LOADED`/装柜完成
 ```

-三期完成标准不是“订单改成已出仓”，而是每个柜次能够回答：装了哪些订单和货物、依据什么方案排柜、订了什么舱、谁承运拖车、仓库实际拣装了什么、柜号与铅封是什么、报关资料和回执在哪里、实际何时出仓、当前等待哪一班船。
+三期完成标准是同一订单/柜次已完成排柜和 PDA 拣货，空仓、半仓、满仓、锁仓、带锁码照五类证据各至少 1 张有效照片已真实上传，锁码文本已保存，服务端门禁通过并将订单推进为 `LOADED`/装柜完成。`DELIVERED`/派送完成必须等货物到达海外仓后由海外仓可信回传推进，不是国内三期人工操作。

 ### 原型动作覆盖

@@ -37,7 +37,7 @@ PDA 拣货 → 装柜并上传货柜/铅封照片
 | 2. 订舱 | 订舱与港务/船期信息 | P3-BOOK-01 | 已覆盖 |
 | 3. 预约托车 | 预约拖车 | P3-TRUCK-01 | 已覆盖，用词待 P3-Q3 确认 |
 | 4. PDA 拣货 | PDA 拣货与复核 | P3-PICK-01、P3-PDA-01、P3-PDA-02 | 已覆盖 |
-| 5. 拍货柜及铅封照上传 | 装柜及柜封证据 | P3-LOAD-01、P3-LOAD-02 | 已确认空仓、半仓、满仓、锁仓、带锁码照共 5 张必传，锁码文本必填 |
+| 5. 拍货柜及铅封照上传 | 装柜及柜封证据 | P3-LOAD-01、P3-LOAD-02 | 已确认五类证据各至少 1 张有效照片、同类型可多张，锁码文本必填 |
 | 6. 客户上传报关资料 | 报关资料协同 | P3-CUS-01 | 已覆盖 |
 | 7. 整理给到报关代理报关 | 报关资料协同 | P3-CLEAR-01 | 已覆盖 |
 | 8. 回执上传到系统供客户下载 | 报关回执与客户下载 | P3-CLEAR-01、P3-CUS-02 | 已覆盖，回执类型待 P3-Q12 确认 |
@@ -54,7 +54,7 @@ PDA 拣货 → 装柜并上传货柜/铅封照片
 - 装柜、柜号、铅封号及货柜/铅封照片证据。
 - 客户上传报关资料、平台审核补件、整理并提交报关代理。
 - 报关回执上传、版本、客户可见范围和授权下载。
- 国内出仓门禁、确认、冲正、时间线和站内通知。
+- 装柜完成门禁、确认、冲正、时间线和站内通知。

 ### 明确不纳入三期

@@ -89,18 +89,18 @@ PDA 拣货 → 装柜并上传货柜/铅封照片
 |---|---|---|
 | `WAIT_SPLIT` | 待分柜 | 二期已完成，等待排柜/预装 |
 | `LOADING` | 装柜中 | 预装已确认，PDA 执行拣货和装柜证据上传 |
-| `LOADED` | 装柜完成 | 拣货已完成，5 张必传照片和锁码文本已通过服务端门禁 |
-| `DELIVERED` | 派送完成 | 当前订单列表终态；具体触发动作和与三期终点的关系待 P3-Q13 确认 |
+| `LOADED` | 装柜完成 | 拣货已完成，五类证据各至少 1 张有效照片和锁码文本已通过服务端门禁 |
+| `DELIVERED` | 派送完成 | 货物到达海外仓后由海外仓可信回传推进；属于三期之后的只读状态 |

 ### 2. 子流程状态

 - 订舱：待订舱、订舱中、已订舱、订舱失败、已取消。
 - 拖车：待预约、已预约、车辆已到仓、装柜中、已离仓、改约、已取消。
 - 拣货：待分配、待拣货、拣货中、待复核、已完成、异常挂起、已取消。
- 报关：资料待上传、资料待审核、待补件、待提交、已提交代理、回执待上传、回执已上传、已退回、已取消。海关放行如需管理，作为待确认的回执类型或后续状态，不默认作为三期出仓门禁。
+- 报关：资料待上传、资料待审核、待补件、待提交、已提交代理、回执待上传、回执已上传、已退回、已取消。海关放行如需管理，作为待确认的回执类型或后续状态，不默认作为三期装柜完成门禁。
 - 港务/船期：待维护、已确认、信息变更、已开船；“已开船”属于三期之后的运输阶段，不是当前三期完成条件。

-主状态由服务端根据已确认的必要子流程推进。客户端不得通过传任意目标状态跳过拣货复核、柜封证据或已配置的出仓门禁。
+主状态由服务端根据已确认的必要子流程推进。客户端不得通过传任意目标状态跳过拣货复核、装柜证据或已配置的装柜完成门禁。

 ## 五、业务模块

@@ -141,19 +141,22 @@ PDA 拣货 → 装柜并上传货柜/铅封照片
 ### 5. PDA 拣货与复核

 - 按已确认排柜方案生成仓库、柜次、订单和货物明细级任务。
- PDA 支持登录、领取、箱号选择、扫码、数量确认、部分拣货、跳拣、撤销和异常上报。
- 服务端校验任务归属、状态、重复扫码、超量、错货和重复提交。
- 拣货完成后必须复核；差异未处理前不得进入待出仓。
+- PDA 支持登录、领取、箱号选择、扫码、数量确认、部分拣货、跳拣、撤销和异常上报；进入任务即标记“拣货中”。
+- 正式作业必须联网；断网不能开始正式拣货、提交、完成任务或推进 `LOADED`，不建设离线业务提交队列。
+- 扫描只更新绑定作业员、任务和柜次的设备持久化草稿；员工点击提交时才将全部明细批量写入后端，成功或明确放弃后清理，其他账号不得继承。
+- 服务端校验任务归属、状态、重复扫码、超量、错货和批量提交；重复提交返回原结果，版本冲突提示刷新后重试。
+- 允许部分拣货和跳拣，但每个未完成项必须填写异常原因；存在未解决差异时任务挂起，不能完成或进入 `LOADED`。
+- 一柜多人并行、退出/换班释放规则、最终完成触发人和是否需要后台复核仍待确认。
 - 扫描器、声音、震动、网络和缓存通过设备适配层实现，不直接绑定单一厂商 SDK。

 ### 6. 装柜及柜封证据

 - 维护柜号、铅封号、装柜开始/完成时间、操作人和异常说明。
- 必须上传空仓、半仓、满仓、锁仓、带锁码照共 5 张图片，并必填锁码文本。
- 现场执行端支持直接拍照或从相册选择后上传，上传前显示柜次、柜号、铅封号和照片类型，防止证据关联错误。
- 支持上传进度、失败重试、重复照片提示和提交前预览；弱网下不得因重复点击产生多份有效证据。
- 照片记录文件哈希、上传人、上传时间、关联柜次和客户可见范围。
- 铅封号重复、已确认的必传照片缺失或复核未通过时禁止确认出仓。
+- 空仓、半仓、满仓、锁仓、带锁码照五类证据各至少上传 1 张有效照片，可同类型多张追加；带锁码照同时要求锁码文本。
+- PDA 只能现场拍照；Admin 可通过独立受权入口人工上传。上传前展示柜次、柜号、铅封号和照片类型，防止证据关联错误。
+- 每张照片作为独立记录，支持上传进度、失败重试和提交前预览；错误或重复照片不硬删除，标记作废并记录原因、操作人和时间。
+- 照片记录文件哈希、上传人、上传时间、关联柜次、有效/作废状态和客户可见范围；Admin 上传角色、可见范围和留存期限仍待确认。
+- 锁码重复、已确认的必传照片缺失或复核未通过时禁止确认装柜完成。
 - 修改柜号或铅封号需要二次确认、原因和完整审计。

 ### 7. 报关资料协同
@@ -166,19 +169,18 @@ PDA 拣货 → 装柜并上传货柜/铅封照片

 ### 8. 报关回执与客户下载

- 上传代理回传的报关回执并关联提交批次；回执类型可区分接收、申报、退单、查验或放行等，实际类型及出仓门禁以 P3-Q12 为准。
+- 上传代理回传的报关回执并关联提交批次；回执类型可区分接收、申报、退单、查验或放行等，实际类型及装柜完成门禁以 P3-Q12 为准。
 - 替换文件产生新版本，不覆盖原记录；退单或补件形成明确任务。
 - 客户只能下载本企业且标记为客户可见的回执。
 - 文件下载使用授权地址并记录审计，不暴露内部存储路径。

-### 9. 国内出仓确认
+### 9. 装柜完成确认与海外回传边界

- 服务端校验排柜已确认、拣货复核完成、已确认的柜封证据齐全、车辆已离仓，以及已配置的报关回执和港务/船期信息门禁。
- 当前不默认要求“海关已放行”后才能确认国内出仓；是否需要放行或其他特定回执作为门禁，以 P3-Q12 的业务结论为准。
- 授权人员执行确认出仓，记录实际出仓时间、车辆、柜号、铅封号和说明。
- 确认操作具备幂等、权限、版本和并发校验，重复请求只产生一次有效事件。
- 完成后进入“等待装船”，企业客户可查看允许公开的节点、港务/船期信息和回执。
- 出仓后发现错误不得直接回退数据库状态，必须使用授权冲正动作和反向审计事件。
+- 服务端校验排柜已确认、PDA 拣货已完成、五类证据各至少 1 张有效且未作废的图片已取得真实 `fileId`、锁码文本已保存。
+- 门禁通过后仅将订单推进为 `LOADED`/装柜完成，记录柜次、柜号、锁码、操作人、时间和证据版本。
+- 该操作必须幂等、乐观锁、完整审计和失败回复，禁止从前端跳过门禁。
+- 装柜完成后发现错误不得直接回退数据库状态，必须使用授权冲正动作和反向审计事件。
+- `DELIVERED`/派送完成只接受海外仓可信回传，必须有来源身份、签名/防重放、幂等键、请求摘要和审计；国内 Admin/PDA 不提供手工“确认派送完成”操作。

 ## 六、核心数据对象

@@ -205,7 +207,7 @@ PDA 拣货 → 装柜并上传货柜/铅封照片
 - 按已确认的排柜规则提供建议、冲突展示、人工调整、版本对比和确认。
 - 订舱、船期、拖车预约、装柜、柜号、铅封和照片。
 - 报关资料审核、补件、提交批次、回执上传和客户可见控制。
- 权限至少拆分为查看、排柜、订舱、拖车、仓内复核、报关、确认出仓和冲正。
+- 权限至少拆分为查看、排柜、订舱、拖车、仓内复核、报关、确认装柜完成和冲正；国内端不提供确认派送完成权限。

 ### 企业客户端 `apps/client-web`

@@ -217,10 +219,11 @@ PDA 拣货 → 装柜并上传货柜/铅封照片
 ### PDA `apps/pda-uniapp`

 - 仓库人员登录、任务领取、箱号选择、扫码拣货和数量确认。
- 部分拣货、跳拣、撤销、异常上报、待复核和完成提交。
- 按授权柜次拍摄或选择货柜、铅封照片，确认关联信息后上传，并处理进度、失败重试和重复提交。
- 弱网、断网、前后台切换、重复提交和换班清理。
- 真实设备、扫描头和发布方式确认前，不绑定厂商 SDK。
+- 进入任务即标记“拣货中”；允许部分拣货、跳拣和异常上报，未完成项原因必填并阻断完成。
+- 扫描保存在设备持久化草稿，点击提交时批量写后端；草稿绑定作业员、任务和柜次。
+- PDA 仅现场拍摄五类装柜照片，同类型可多张追加；确认关联信息后上传，并处理进度、失败重试和作废。
+- 在线作业、前后台切换、重复提交、版本冲突和换班清理；断网不允许正式作业或提交。
+- Android 广播扫描已按 Action=`android.intent.action.SCANRESULT`、Extra=`value` 接入；真实设备型号、Android 版本、打包发布方式和真机验收仍待确认。

 ### 服务端 `baiyue-firstleg`

@@ -236,10 +239,10 @@ PDA 拣货 → 装柜并上传货柜/铅封照片
 | P3-M0 规则与设备锁定 | 流程、角色、状态、排柜规则、PDA、文件和验收确认 | 二期到仓契约稳定 |
 | P3-M1 订单与排柜 | 现有订单可进入待分柜，并按确认范围提供柜次建议、人工确认与追溯 | 排柜规则确认 |
 | P3-M2 订舱与拖车 | 订舱、船期、拖车预约和异常处理可用 | 服务商与权限可用 |
-| P3-M3 PDA 拣货 | 任务生成、扫码、差异、复核和幂等提交可用 | 目标设备与仓库流程确认 |
+| P3-M3 PDA 拣货 | 在线任务、持久化草稿、批量提交、差异、复核和幂等可用 | 目标设备、多人协作与仓库流程确认 |
 | P3-M4 装柜封柜 | 柜号、铅封和照片证据完整，门禁生效 | 文件能力与必传清单确认 |
 | P3-M5 报关协同 | 客户上传、平台审核、补件、提交和回执下载闭环 | 报关资料清单确认 |
-| P3-M6 国内出仓 | 必要子流程满足后可确认出仓并进入等待装船 | 出仓门禁和冲正规则确认 |
+| P3-M6 装柜完成 | PDA 拣货、五类证据各至少 1 张有效照片和锁码文本满足门禁后进入 `LOADED`/装柜完成 | 装柜完成门禁和冲正规则确认 |
 | P3-M7 联调验收 | 跨端、设备、安全、弱网、性能、迁移和发布完成 | P3-M1 至 P3-M6 验收通过 |

 ## 九、建议开发任务
@@ -255,14 +258,15 @@ PDA 拣货 → 装柜并上传货柜/铅封照片
 | P3-PORT-01 | 后台/服务端 | 港务信息查询 | 查询系统内预计开船、到港等信息，记录来源和更新时间，并提供授权人工维护兜底 | P0 | P3-BOOK-01、P3-Q9 |
 | P3-TRUCK-01 | 后台 | 拖车预约 | 服务商、车辆司机、时间窗、到离仓和异常 | P0 | P3-DSP-01 |
 | P3-PICK-01 | 公共 | 拣货任务 | 按排柜方案生成任务、明细、差异和复核规则 | P0 | P3-PLAN-02 |
-| P3-PDA-01 | PDA | 扫码拣货 | 领取、扫描、部分拣货、跳拣、撤销和异常 | P0 | P3-PICK-01 |
-| P3-PDA-02 | PDA/服务端 | 弱网幂等 | 重试、去重、冲突、换班和设备缓存清理 | P0 | P3-PDA-01 |
-| P3-LOAD-01 | 后台 | 装柜封柜 | 柜号、锁码文本、装柜节点、5 张必传照片和门禁复核 | P0 | P3-PICK-01 |
-| P3-LOAD-02 | PDA/服务端 | 柜封拍照上传 | 空仓、半仓、满仓、锁仓、带锁码照的拍摄/相册选择、真实文件上传、预览、失败重试、去重和提交 | P0 | P3-LOAD-01、文件能力可用 |
+| P3-PDA-01 | PDA | 在线扫码拣货 | 进入任务标记拣货中、扫描草稿、部分/跳拣异常原因和批量提交 | P0 | P3-PICK-01 |
+| P3-PDA-02 | PDA/服务端 | 草稿与提交安全 | 作业员+任务+柜次持久化草稿、幂等重试、版本冲突、成功/放弃清理 | P0 | P3-PDA-01 |
+| P3-LOAD-01 | 后台 | 装柜封柜 | 柜号、锁码文本、装柜节点、五类多图证据和门禁复核 | P0 | P3-PICK-01 |
+| P3-LOAD-02 | PDA/Admin/服务端 | 柜封拍照上传 | PDA 现场拍摄、Admin 人工上传、五类证据多图追加、真实文件上传、预览、失败重试、作废和提交 | P0 | P3-LOAD-01、文件能力可用 |
 | P3-CUS-01 | 客户端 | 报关资料 | 清单、上传、补件、版本和进度查看 | P0 | 文件能力可用 |
 | P3-CLEAR-01 | 后台 | 报关协同 | 审核、退回、提交代理、批次、回执和可见范围 | P0 | P3-CUS-01 |
 | P3-CUS-02 | 客户端 | 回执及港务信息 | 回执下载、预计开船/到港信息、数据来源、更新时间和变更时间线 | P0 | P3-PORT-01、P3-CLEAR-01 |
-| P3-GATE-01 | 服务端 | 出仓门禁 | 按确认规则校验必要子流程、确认出仓、等待装船和冲正 | P0 | P3-PORT-01、P3-TRUCK-01、P3-LOAD-01、P3-LOAD-02、P3-CLEAR-01、P3-Q11、P3-Q12 |
+| P3-GATE-01 | 服务端 | 装柜完成门禁 | 校验 PDA 拣货、五类证据各至少 1 张有效照片和锁码文本，幂等推进 `LOADED` 并支持授权冲正 | P0 | P3-PICK-01、P3-LOAD-01、P3-LOAD-02、P3-Q10 |
+| P3-OVERSEAS-01 | 服务端 | 海外仓派送完成回传 | 只接受海外仓可信回传，校验身份、签名、时间窗、防重放和幂等，推进 `DELIVERED` | P1/后续阶段 | 海外仓契约 |
 | P3-NOTIFY-01 | 公共 | 通知异常 | 站内通知、阻塞、责任人、时限和失败补偿 | P1 | 核心流程完成 |
 | P3-TEST-01 | 公共 | 自动化测试 | 权限、排柜、幂等、并发、文件、门禁和状态测试 | P0 | 所有 P0 模块 |
 | P3-DEVICE-01 | PDA | 真机验收 | 扫描头、弱网、性能、电量、前后台和发布验证 | P0 | 目标设备确认 |
@@ -272,15 +276,16 @@ PDA 拣货 → 装柜并上传货柜/铅封照片

 - 系统排柜符合已确认的业务规则；如启用建议解释、人工调整、版本或原因记录，对应结果可追溯。
 - 多订单拼柜和一单多柜的件数、重量、体积能与二期实测版本对账。
- PDA 重复扫码、超量、错货、断网重试和重复提交不产生重复扣减或完成事件。
- 柜封照片能够在现场完成拍摄、关联确认和上传；失败重试或重复提交不产生多份有效证据。
- 未完成复核、缺少已确认的必传柜封证据或存在关键阻塞时不能确认出仓。
+- PDA 重复扫码、超量、错货和重复提交不产生重复扣减或完成事件；断网时禁止正式作业和提交。
+- 本地草稿在应用重启后可由同一作业员、任务和柜次恢复，不能被其他账号继承；批量提交成功后清理。
+- 柜封照片能够在 PDA 现场拍摄或由 Admin 受权上传；同类型可多张追加，失败重试不重复创建同一记录，错图只作废不硬删除。
+- 未完成 PDA 拣货、缺少任意一张必传照片或锁码文本时不能进入 `LOADED`/装柜完成。
 - 企业 A 无法查看、上传或下载企业 B 的报关资料和回执。
 - 报关资料替换、退回、补件、提交和回执均能追溯到明确版本。
 - 港务/船期查询结果展示来源和更新时间；变更保留历史并通知授权用户，旧信息不被无痕覆盖。
- 确认出仓的并发请求只产生一次状态变化和一次有效审计事件。
+- 确认装柜完成的并发请求只产生一次状态变化和一次有效审计事件。
 - 管理后台覆盖加载、空态、失败、无权限和数据冲突；PDA 覆盖弱网、前后台切换和硬件扫描。
- 当前三期验收基线为“完成国内出仓，等待装船”，不以海上运输或海外签收作为完成条件；最终以 P3-Q13 确认结果为准。
+- 三期验收基线为 `LOADED`/装柜完成；`DELIVERED`/派送完成只由海外仓回传推进，不属于国内三期验收条件。

 ## 十一、启动前待确认事项

@@ -289,16 +294,16 @@ PDA 拣货 → 装柜并上传货柜/铅封照片
 | P3-Q1 | 智能排柜需考虑哪些硬约束和软偏好？ | 业务先提供可执行规则表；建议必须可解释且人工确认 |
 | P3-Q2 | 是否存在拼柜、一单多柜和拆批出仓？ | 数据模型全部支持，页面按实际高频场景逐步开放 |
 | P3-Q3 | “预约托车”是否统一为“预约拖车”？ | 建议统一使用行业常用的“拖车”，并确认业务实际含义 |
-| P3-Q4 | 目标 PDA 型号、系统和扫描头接入方式是什么？ | 设备确认前保持适配层，不绑定厂商 SDK |
+| P3-Q4 | 目标 PDA 型号、系统和扫描头接入方式是什么？ | 广播接入已确认并完成；设备型号、Android 版本、打包发布和真机验收仍待确认 |
 | P3-Q5 | 拣货是否依赖实时库存和库位可用量？ | 若需要，完整 WMS 前置范围会显著扩大，必须单独评估 |
-| P3-Q6 | 柜封照片有哪些必传角度和留存期限？ | 已确认空仓、半仓、满仓、锁仓、带锁码照共 5 张必传，锁码文本必填；留存期限尚待确认 |
+| P3-Q6 | 柜封照片有哪些必传角度和留存期限？ | 已确认五类各至少 1 张、可多张追加、PDA 仅拍照、Admin 可上传、错图作废；Admin 角色、可见范围和留存期限尚待确认 |
 | P3-Q7 | 报关资料清单是否按国家、渠道和货物类型变化？ | 建议配置化，并保留下单使用的清单版本 |
 | P3-Q8 | 报关代理如何接收资料和返回回执？ | 首版系统内整理加线下提交，正式接口后续评估 |
 | P3-Q9 | 原型中的“港务信息”具体指船期、港口作业状态还是两者，包含哪些字段，由谁维护？ | 先确认业务词义和字段；首版建议平台人工维护并审计，外部接口仅预留适配层 |
-| P3-Q10 | 确认出仓后发现错误如何处理？ | 不直接回退状态，使用授权冲正动作和反向审计事件 |
-| P3-Q11 | 九个动作中哪些是强制前置，哪些允许并行？ | 确认前按原型编号顺序规划，不承诺固定并行关系 |
+| P3-Q10 | 进入装柜完成后发现错误如何处理？ | 不直接回退状态，使用授权冲正动作和反向审计事件 |
+| P3-Q11 | 九个动作中哪些是强制前置，哪些允许并行？ | PDA 进入任务、批量提交和异常阻断已确认；多人协作、最终完成触发和跨模块门禁仍待确认 |
 | P3-Q12 | “报关回执”具体包含哪些类型，海关放行是否为国内出仓硬门禁？ | 当前不默认以放行为门禁；由业务明确接收、申报、退单、查验和放行的含义及门禁 |
-| P3-Q13 | 三期终点以“等待装船”还是“装船发运”为准？ | 当前以本期出仓图片的“完成国内出仓，等待装船”为基线，完整流程 SVG 的不同表述待产品确认 |
+| P3-Q13 | 三期终点以什么状态为准？ | 已确认为 `LOADED`/装柜完成；`DELIVERED`/派送完成由海外仓回传，不属于国内三期 |

 ## 十二、建议实施顺序

@@ -8,25 +8,25 @@

 ## 一、三期目标

-三期承接二期到仓、实测、差异处理、处理单元编码和当前位置记录，完成智能排柜、订舱、拖车预约、PDA 拣货、柜封拍照、报关协同、港务信息查询和国内出仓闭环。
+三期承接二期到仓、实测、差异处理、处理单元编码和当前位置记录，完成智能排柜、订舱、拖车预约、PDA 拣货、装柜拍照、报关协同、港务信息查询，并将现有订单推进到 `LOADED`/装柜完成。

-当前验收基线为“完成国内出仓，等待装船”。在 P3-Q13 最终确认前，不把装船发运纳入三期完成条件。
+当前验收基线已确认为 `LOADED`/装柜完成。`DELIVERED`/派送完成只能在货物到达海外仓后由海外仓可信回传推进，不属于国内三期操作和验收范围。

 ## 二、总体进度（大任务）

 | 大任务 ID | 大任务 | 范围 | 状态 | 进度 | 计划开始 | 计划完成 | 负责人 | 关键依赖/备注 |
 |---|---|---|---|---:|---|---|---|---|
 | T01 | 需求确认与原型 | 锁定阶段边界、流程依赖、排柜规则、设备、文件、报关和港务信息；完成页面原型 | 进行中 | 40% | 2026-07-28 | 待排期 | 待分配 | 已盘点 `docs/悦` 三期相关原型；后台有较完整参考，客户端三期页面和 PDA 柜封拍照仍待补 |
-| T02 | 公共契约与数据模型 | 主/子状态、权限、事件、错误码、出仓单、柜次、任务、证据、报关和审计模型 | 待确认 | 0% | 待排期 | 待排期 | 待分配 | 依赖 T01、二期输出契约 |
-| T03 | 出仓单与柜次 | 出仓单创建、列表、详情、订单拆分/拼柜、柜次和时间线 | 待确认 | 0% | 待排期 | 待排期 | 待分配 | 依赖 T02、P3-Q2、P3-Q11 |
+| T02 | 公共契约与数据模型 | 主/子状态、权限、事件、错误码、订单三期投影、柜次、任务、证据、报关和审计模型 | 待确认 | 0% | 待排期 | 待排期 | 待分配 | 依赖 T01、二期输出契约 |
+| T03 | 订单三期编排与柜次 | 增强现有订单列表/详情，建立订单-柜次关系、拆分/拼柜和时间线 | 待确认 | 0% | 待排期 | 待排期 | 待分配 | 依赖 T02、P3-Q2、P3-Q11；不新建出仓单 |
 | T04 | 智能排柜 | 排柜规则、系统建议、冲突、人工确认和追溯 | 待确认 | 0% | 待排期 | 待排期 | 待分配 | 依赖 T03、P3-Q1、P3-Q2 |
 | T05 | 订舱与港务信息 | 订舱、变更异常、预计开船/到港信息、来源和更新时间 | 待确认 | 0% | 待排期 | 待排期 | 待分配 | 依赖 T03、P3-Q9、P3-Q11 |
 | T06 | 拖车预约 | 服务商、车辆司机、预约时间窗、到离仓节点和异常 | 待确认 | 0% | 待排期 | 待排期 | 待分配 | 依赖 T03、一期往来单位、P3-Q3 |
-| T07 | PDA 拣货与复核 | 任务生成、领取、扫码、部分拣货、异常、弱网幂等和后台复核 | 待确认 | 0% | 待排期 | 待排期 | 待分配 | 依赖 T04、二期处理单元/位置、P3-Q4、P3-Q5 |
-| T08 | 装柜及柜封证据 | 装柜节点、柜号、铅封号、PDA 拍照上传、照片清单和复核 | 待确认 | 0% | 待排期 | 待排期 | 待分配 | 依赖 T07、文件能力、P3-Q6 |
+| T07 | PDA 拣货与复核 | 在线进入任务、持久化扫描草稿、批量提交、部分拣货、异常、幂等和后台复核 | 待确认 | 0% | 待排期 | 待排期 | 待分配 | 在线、草稿、批量提交和异常阻断已确认；依赖 T04、二期处理单元/位置、P3-Q4、P3-Q5，多人协作待确认 |
+| T08 | 装柜及柜封证据 | 装柜节点、柜号、铅封号、PDA 现场拍照、Admin 上传、多图追加、作废和复核 | 待确认 | 0% | 待排期 | 待排期 | 待分配 | 五类证据规则已确认；Admin 角色、可见范围和留存依赖后续确认 |
 | T09 | 报关资料与回执 | 客户上传、后台审核补件、提交代理、回执上传和客户下载 | 待确认 | 0% | 待排期 | 待排期 | 待分配 | 依赖文件能力、P3-Q7、P3-Q8、P3-Q12 |
-| T10 | 国内出仓门禁 | 必要条件校验、确认出仓、阻塞、通知、冲正和审计 | 待确认 | 0% | 待排期 | 待排期 | 待分配 | 依赖 T05～T09、P3-Q10～P3-Q13 |
-| T11 | 客户端出仓协同 | 出仓进度、柜次、回执、预计开船/到港和变更时间线 | 待确认 | 0% | 待排期 | 待排期 | 待分配 | 依赖 T05、T09、T10；客户可见范围 |
+| T10 | 装柜完成门禁 | 校验 PDA 拣货、五类证据各至少 1 张有效照片和锁码文本，推进 `LOADED`，并提供阻塞、冲正和审计 | 待确认 | 0% | 待排期 | 待排期 | 待分配 | 最低门禁已确认；其他前置依赖 P3-Q11/P3-Q12 |
+| T11 | 客户端三期协同 | 装柜进度、柜次、回执、预计开船/到港和变更时间线 | 待确认 | 0% | 待排期 | 待排期 | 待分配 | 依赖 T05、T09、T10；客户可见范围 |
 | T12 | 联调测试与发布 | 跨端联调、自动化测试、PDA 真机、安全、弱网、迁移、验收和发布 | 待开始 | 0% | 待排期 | 待排期 | 待分配 | 依赖 T02～T11 完成 |

 ## 三、详细任务表
@@ -37,41 +37,41 @@
 |---|---|---|---|---|---|---|---:|---|---|---|
 | P3-T01-00 | T01 | 公共 | 需求确认与原型 | 完成需求确认表、页面清单和原型评审，锁定开工阻断项 | P0 | 进行中 | 40% | - | 待分配 | 已建立文档骨架并完成 `docs/悦` 原型初审，后续逐项确认和裁剪 |
 | P3-T02-00 | T02 | 公共 | 公共契约与数据模型 | 待 T01 确认后拆分 | P0 | 待确认 | 0% | P3-T01-00 | 待分配 | 下一层将拆状态、权限、数据模型、接口和审计 |
-| P3-T03-00 | T03 | 后台/服务端 | 出仓单与柜次 | 待 T02 契约明确后拆分 | P0 | 待确认 | 0% | P3-T02-00 | 待分配 | - |
+| P3-T03-00 | T03 | 后台/服务端 | 订单三期编排与柜次 | 待 T02 契约明确后拆分 | P0 | 待确认 | 0% | P3-T02-00 | 待分配 | 复用现有订单，不创建独立出仓单 |
 | P3-T04-00 | T04 | 后台/服务端 | 智能排柜 | 待排柜规则确认后拆分 | P0 | 待确认 | 0% | P3-T03-00、P3-Q1 | 待分配 | - |
 | P3-T05-00 | T05 | 后台/服务端 | 订舱与港务信息 | 待港务范围和字段确认后拆分 | P0 | 待确认 | 0% | P3-T03-00、P3-Q9 | 待分配 | - |
 | P3-T06-00 | T06 | 后台/服务端 | 拖车预约 | 待流程依赖确认后拆分 | P0 | 待确认 | 0% | P3-T03-00、P3-Q11 | 待分配 | - |
-| P3-T07-00 | T07 | PDA/后台/服务端 | PDA 拣货与复核 | 待拣货输入和设备确认后拆分 | P0 | 待确认 | 0% | P3-T04-00、P3-Q4、P3-Q5 | 待分配 | 已有静态 PDA 原型可复用 |
-| P3-T08-00 | T08 | PDA/后台/服务端 | 装柜及柜封证据 | 待照片清单确认后拆分 | P0 | 待确认 | 0% | P3-T07-00、P3-Q6 | 待分配 | 需新增柜封拍照原型 |
+| P3-T07-00 | T07 | PDA/后台/服务端 | PDA 拣货与复核 | 按已确认的在线草稿+批量提交规则拆分，补多人协作和最终复核结论 | P0 | 待确认 | 0% | P3-T04-00、P3-Q4、P3-Q5 | 待分配 | 广播模式已接入；持久化草稿和真实批量契约仍需核验 |
+| P3-T08-00 | T08 | PDA/后台/服务端 | 装柜及柜封证据 | 实现五类多图追加、PDA 拍照、Admin 上传、作废和完整性门禁 | P0 | 待确认 | 0% | P3-T07-00、P3-Q6 | 待分配 | 当前代码仍需核对是否按追加而非替换实现 |
 | P3-T09-00 | T09 | 客户端/后台/服务端 | 报关资料与回执 | 待资料和回执规则确认后拆分 | P0 | 待确认 | 0% | P3-Q7、P3-Q8、P3-Q12 | 待分配 | - |
-| P3-T10-00 | T10 | 后台/服务端 | 国内出仓门禁 | 待流程、回执和终点确认后拆分 | P0 | 待确认 | 0% | P3-T05-00～P3-T09-00 | 待分配 | 高风险状态操作 |
-| P3-T11-00 | T11 | 客户端/服务端 | 客户端出仓协同 | 待客户可见字段确认后拆分 | P0 | 待确认 | 0% | P3-T05-00、P3-T09-00、P3-T10-00 | 待分配 | - |
+| P3-T10-00 | T10 | 后台/服务端 | 装柜完成门禁 | 实现最低硬门禁、`LOADED` 推进、阻塞、冲正和审计 | P0 | 待确认 | 0% | P3-T07-00、P3-T08-00、P3-Q10、P3-Q11 | 待分配 | 国内端不得推进 `DELIVERED` |
+| P3-T11-00 | T11 | 客户端/服务端 | 客户端三期协同 | 待客户可见字段确认后拆分 | P0 | 待确认 | 0% | P3-T05-00、P3-T09-00、P3-T10-00 | 待分配 | - |
 | P3-T12-00 | T12 | 公共 | 联调测试与发布 | 待各模块拆分完成后细化测试与发布任务 | P0 | 待开始 | 0% | P3-T02-00～P3-T11-00 | 待分配 | - |
 | P3-T01-PROTO-01 | T01 | 公共 | 原型盘点 | 盘点流程图、后台、企业客户端和 PDA 中与三期相关的页面及交互 | P0 | 已完成 | 100% | - | 待分配 | 2026-07-28 已完成首次盘点，来源为 `docs/悦` |
-| P3-T03-PROTO-01 | T03 | 后台 | 出仓单原型核验 | 对照通用 WMS 出库单、货柜和装柜清单，确定三期出仓单可复用字段与需重做部分 | P0 | 进行中 | 50% | P3-T01-PROTO-01、P3-Q11 | 待分配 | 通用“出库”不能直接等同三期“国内出仓” |
+| P3-T03-PROTO-01 | T03 | 后台 | 订单三期编排原型 | 在现有订单列表/详情中设计柜次、子流程摘要、阻塞原因、时间线和操作入口 | P0 | 进行中 | 50% | P3-T01-PROTO-01、P3-Q11 | 待分配 | 不新建出仓单页面 |
 | P3-T04-PROTO-01 | T04 | 后台 | 智能排柜原型核验 | 映射智能装柜的线路页签、筛选、智能锁定、订单分柜、拖放调整和集装箱详情 | P0 | 已完成 | 100% | P3-T01-PROTO-01 | 待分配 | 原型叫“智能装柜”，与“智能排柜”的业务边界待 P3-Q1 确认 |
 | P3-T05-PROTO-01 | T05 | 后台 | 订舱港务原型核验 | 映射订舱列表、新增/详情、放舱、船名航次、港口和 ETD/ATD/ETA/ATA 字段 | P0 | 已完成 | 100% | P3-T01-PROTO-01 | 待分配 | 港务信息是否独立模块仍待 P3-Q9 确认 |
 | P3-T06-PROTO-01 | T06 | 后台 | 拖车原型核验 | 映射拖车列表、新增表单、运输公司、司机、车头号、装箱日期、费用和附件 | P0 | 已完成 | 100% | P3-T01-PROTO-01 | 待分配 | 预约时间窗和到离仓节点仍需按三期流程补充 |
-| P3-T07-PROTO-01 | T07 | 后台/PDA | 拣货原型核验 | 对照通用 WMS 出库拣货和现有 PDA 集装箱拣货，锁定可复用交互与真实接口缺口 | P0 | 已完成 | 100% | P3-T01-PROTO-01 | 待分配 | PDA 静态交互已有，任务、鉴权、持久化和弱网仍待开发 |
+| P3-T07-PROTO-01 | T07 | 后台/PDA | 拣货原型核验 | 对照通用 WMS 出库拣货和现有 PDA 集装箱拣货，锁定可复用交互与真实接口缺口 | P0 | 已完成 | 100% | P3-T01-PROTO-01 | 待分配 | 已确认在线作业、进入即开始、持久化草稿和批量提交；真实任务、鉴权与契约仍需完成 |
 | P3-T08-PROTO-01 | T08 | 后台 | 装柜证据原型核验 | 映射货柜列表、预装清单、装柜清单、柜号、单证、船期和装柜明细 | P0 | 已完成 | 100% | P3-T01-PROTO-01 | 待分配 | 后台参考较完整，但现场拍照上传原型缺失 |
-| P3-T08-PROTO-02 | T08 | PDA | 柜封拍照原型 | 新增柜次确认、货柜/铅封拍照、照片类型、预览、重试和提交页面原型 | P0 | 待开始 | 0% | P3-Q4、P3-Q6 | 待分配 | `docs/悦` 暂无对应原型 |
+| P3-T08-PROTO-02 | T08 | PDA | 装柜拍照原型 | 新增柜次确认、五类证据多图追加、锁码文本、预览、重试、作废和提交页面原型 | P0 | 待开始 | 0% | P3-Q4、P3-Q6 | 待分配 | PDA 仅拍照、Admin 可上传、每类至少一张和错图作废已确认 |
 | P3-T09-PROTO-01 | T09 | 后台 | 报关单证原型核验 | 映射报关单列表、单证管理、报关/清关/放行资料及装柜清单附件 | P0 | 已完成 | 100% | P3-T01-PROTO-01 | 待分配 | 客户上传和回执下载页面仍需新建 |
-| P3-T10-PROTO-01 | T10 | 后台 | 出仓门禁原型 | 设计统一门禁检查、阻塞原因、确认出仓和冲正页面 | P0 | 进行中 | 30% | P3-Q10～P3-Q13 | 待分配 | 现有原型只有分散状态和放行字段，无统一出仓门禁页 |
-| P3-T11-PROTO-01 | T11 | 客户端 | 客户端三期原型 | 新增出仓进度、报关资料上传/补件、回执下载和港务/船期页面原型 | P0 | 待开始 | 0% | P3-Q7～P3-Q9、P3-Q12、P3-Q13 | 待分配 | 现有客户端原型未覆盖三期专用页面 |
+| P3-T10-PROTO-01 | T10 | 后台 | 装柜完成门禁原型 | 在现有订单详情设计门禁检查、阻塞原因、确认装柜完成和冲正交互 | P0 | 进行中 | 30% | P3-Q10～P3-Q12 | 待分配 | 不需要独立门禁页面，可作为订单详情操作区 |
+| P3-T11-PROTO-01 | T11 | 客户端 | 客户端三期原型 | 新增装柜进度、报关资料上传/补件、回执下载和港务/船期页面原型 | P0 | 待开始 | 0% | P3-Q7～P3-Q9、P3-Q12 | 待分配 | 现有客户端原型未覆盖三期专用页面 |

 ## 四、原型对照与开发影响

 | 大任务 | `docs/悦` 现有原型 | 覆盖判断 | 开发处理 |
 |---|---|---|---|
-| T03 出仓单与柜次 | 通用 WMS 出库单、货柜列表、装柜清单 | 部分参考 | 保留列表、状态和明细交互，按国内出仓业务重新定义对象和门禁 |
+| T03 订单三期编排与柜次 | 现有订单列表/详情、货柜列表、装柜清单 | 部分参考 | 增强现有订单页并建立订单-柜次关联，不新增出仓单页面 |
 | T04 智能排柜 | 入库单列表中的“智能装柜”弹窗 | 已有参考 | 复用线路、筛选、锁定、分柜和拖放交互，按 P3-Q1 裁剪规则 |
 | T05 订舱与港务信息 | 订舱列表、新增/详情、放舱、货柜船期字段 | 已有参考 | 复用订舱字段和页面结构，确认港务信息范围及来源后裁剪 |
 | T06 拖车预约 | 拖车列表、新增拖车 | 已有参考 | 复用车辆司机和费用字段，补预约时间窗、到仓及离仓节点 |
-| T07 PDA 拣货与复核 | 通用 WMS 出库、PDA 集装箱拣货 | 已有参考 | 保留 PDA 交互，重做真实任务、权限、幂等、弱网和后台复核 |
-| T08 装柜及柜封证据 | 货柜列表、预装清单、装柜清单 | 部分参考 | 后台页面裁剪复用；PDA 货柜/铅封拍照页面新建 |
+| T07 PDA 拣货与复核 | 通用 WMS 出库、PDA 集装箱拣货 | 已有参考 | 保留扫描交互，按在线作业、持久化草稿、批量提交、异常阻断和轻量冲突提示重做真实契约 |
+| T08 装柜及柜封证据 | 货柜列表、预装清单、装柜清单 | 部分参考 | 后台页面裁剪复用；PDA 只拍照，Admin 可上传，同类型多张追加，错图作废 |
 | T09 报关资料与回执 | 报关单列表、单证管理、装柜清单附件 | 部分参考 | 后台裁剪复用；客户上传、补件和回执下载页面新建 |
-| T10 国内出仓门禁 | 分散的出库状态、国内报关成功和放行资料 | 部分参考 | 新建统一门禁检查和确认出仓页面，避免直接照搬“已放行”规则 |
-| T11 客户端出仓协同 | 头程下单客户端只有船期字段和出仓时间展示 | 覆盖不足 | 新建三期客户端出仓进度、报关和港务信息页面 |
+| T10 装柜完成门禁 | 现有订单状态操作和分散证据字段 | 部分参考 | 在订单详情补门禁检查、确认装柜完成和冲正交互；不提供国内确认派送 |
+| T11 客户端三期协同 | 头程下单客户端只有船期字段和少量装柜摘要 | 覆盖不足 | 新建三期客户端装柜进度、报关和港务信息页面 |

 > `货代SaaS平台原型.html` 是全量平台参考原型，其中海外仓、完整 WMS、费用和清关能力不自动纳入三期；所有复用项仍需经过三期范围裁剪。

@@ -94,31 +94,31 @@
 |---|---|---|---|
 | P3-M0 需求与原型锁定 | 阶段边界、流程、规则、设备、文件和页面原型确认 | 待确认 | 待排期 |
 | P3-M1 公共契约 | 二三期输入、状态、权限、数据模型和接口契约稳定 | 待排期 | 待排期 |
-| P3-M2 出仓编排 | 出仓单、排柜、订舱、港务和拖车可用 | 待排期 | 待排期 |
+| P3-M2 订单三期编排 | 现有订单、柜次、排柜、订舱、港务和拖车可关联追溯 | 待排期 | 待排期 |
 | P3-M3 仓内出仓 | PDA 拣货、复核、装柜和柜封证据闭环 | 待排期 | 待排期 |
 | P3-M4 报关协同 | 客户资料、后台审核、提交代理、回执上传下载闭环 | 待排期 | 待排期 |
-| P3-M5 国内出仓 | 门禁满足后可确认出仓并进入当前约定终点 | 待排期 | 待排期 |
+| P3-M5 装柜完成 | 最低门禁满足后进入 `LOADED`，支持阻塞提示和授权冲正 | 待排期 | 待排期 |
 | P3-M6 三期上线 | 联调、真机、安全、测试、验收和生产发布完成 | 待排期 | 待排期 |

 ## 七、未确认事项（需求确认进度）

-当前共 13 项待确认事项，其中 7 项为开工阻断、5 项为模块阻断、1 项为非阻断。完整建议、负责人、计划确认日期和最终结论统一维护在 [三期需求确认表](三期需求确认表.md)；开工阻断项未确认前，受影响的大任务保持“待确认”。
+当前共 13 项主确认事项：P3-Q13 已确认；P3-Q4、P3-Q6、P3-Q11 已取得可直接开发的 PDA 子结论但主项仍在确认中；其余事项待确认。完整结论统一维护在 [三期需求确认表](三期需求确认表.md)，不得因为主项仍有残留问题而忽略其中已经确认的规则。

 | 编号 | 阻断级别 | 待确认事项 | 状态 | 主要影响 |
 |---|---|---|---|---|
 | P3-Q1 | 开工阻断 | 智能排柜的硬约束和软偏好 | 待确认 | T04 智能排柜、T07 拣货任务 |
-| P3-Q2 | 开工阻断 | 是否支持拼柜、一单多柜和拆批出仓 | 待确认 | T03 出仓单与柜次、T04 智能排柜 |
+| P3-Q2 | 开工阻断 | 是否支持拼柜、一单多柜和拆批装柜 | 待确认 | T03 订单三期编排与柜次、T04 智能排柜 |
 | P3-Q3 | 非阻断 | “预约托车”是否统一为“预约拖车” | 待确认 | T06 拖车预约、页面与接口文案 |
-| P3-Q4 | 模块阻断 | PDA 型号、系统和扫描头接入方式 | 待确认 | T07 PDA 拣货、T08 柜封拍照、真机验收 |
+| P3-Q4 | 模块阻断 | PDA 型号、系统和扫描头接入方式 | 确认中 | 广播模式已接入；设备型号、Android 版本、发布和真机验收待确认 |
 | P3-Q5 | 开工阻断 | 拣货是否依赖实时库存和库位可用量 | 待确认 | T02 二三期契约、T07 PDA 拣货 |
-| P3-Q6 | 模块阻断 | 柜封照片必传类型、角度、数量和留存期限 | 待确认 | T08 装柜证据、T10 出仓门禁 |
+| P3-Q6 | 模块阻断 | 装柜照片和锁码规则 | 确认中 | 五类最少一张、多图追加、PDA 拍照、Admin 上传和作废已确认；角色、可见范围、留存待确认 |
 | P3-Q7 | 模块阻断 | 报关资料清单是否按国家、渠道和货物类型变化 | 待确认 | T09 报关资料、文件版本 |
 | P3-Q8 | 模块阻断 | 报关代理接收资料和返回回执的方式 | 待确认 | T09 报关协同、回执上传 |
 | P3-Q9 | 开工阻断 | 港务信息的业务含义、字段和维护方 | 待确认 | T05 订舱港务、T11 客户端展示 |
-| P3-Q10 | 模块阻断 | 确认出仓后的错误处理和冲正方式 | 待确认 | T10 出仓门禁、权限和审计 |
-| P3-Q11 | 开工阻断 | 九个动作的强制前置和并行关系 | 待确认 | T03～T10 全流程和状态机 |
-| P3-Q12 | 开工阻断 | 报关回执类型及海关放行是否为出仓硬门禁 | 待确认 | T09 报关状态、T10 出仓门禁 |
-| P3-Q13 | 开工阻断 | 三期终点是等待装船还是装船发运 | 待确认 | 阶段边界、状态、里程碑和验收 |
+| P3-Q10 | 模块阻断 | 装柜完成后的错误处理和冲正方式 | 待确认 | T10 装柜完成门禁、权限和审计 |
+| P3-Q11 | 开工阻断 | 九个动作的强制前置和并行关系 | 确认中 | PDA 进入任务、批量提交、异常阻断已确认；多人协作、最终触发和跨模块门禁待确认 |
+| P3-Q12 | 开工阻断 | 报关回执类型及海关放行是否为装柜完成硬门禁 | 待确认 | T09 报关状态、T10 装柜完成门禁 |
+| P3-Q13 | 开工阻断 | 三期终点 | 已确认 | `LOADED`/装柜完成；`DELIVERED` 由海外仓回传，移出三期验收 |

 ## 八、开工准入清单

@@ -128,7 +128,7 @@
 |---|---|---|---|---|
 | P3-GO-01 | P3-Q1～P3-Q13 均形成明确结论，7 项开工阻断全部解除 | 进行中 | 产品、业务 | `三期需求确认表.md` 状态均为已确认并填写最终结论 |
 | P3-GO-02 | 确认结论已同步开发规划、进度表、页面清单和验收范围 | 待开始 | 产品、项目负责人 | 四份文档口径一致，无未标注的候选规则 |
-| P3-GO-03 | 关键缺失原型已补齐并评审，包括出仓门禁、客户端三期页面和 PDA 柜封拍照 | 进行中 | 产品、设计、业务 | 页面清单中的关键页面达到已确认状态 |
+| P3-GO-03 | 关键缺失原型已补齐并评审，包括订单装柜完成门禁、客户端三期页面和 PDA 五类多图拍照 | 进行中 | 产品、设计、业务 | 页面清单中的关键页面达到已确认状态 |
 | P3-GO-04 | T02 公共契约完成，二期输入、状态机、权限、数据模型、接口、错误码和审计口径稳定 | 待开始 | 前后端、架构/技术负责人 | 契约评审记录及稳定的数据/API 定义 |
 | P3-GO-05 | T03～T12 已拆成 RULE、DATA、API、ADM/CLI/PDA、TEST、ACCEPT 任务，并填写负责人和计划 | 待开始 | 项目负责人、研发、测试 | 详细任务可独立开发、联调和验收 |
 | P3-GO-06 | 产品、业务、研发和测试完成开工评审，确认范围、依赖、风险和首批任务 | 待开始 | 项目负责人 | 开工评审纪要及明确的 GO 结论 |
@@ -0,0 +1,66 @@
+# 三期装柜闭环产品确认表
+
+> 确认方式：产品只需在“产品确认”一列填写“同意”，或写明修改后的规则。  
+> 会议目标：本表确认后直接进入开发，不再补完整高保真原型。
+
+## 一、已经确认
+
+| 事项 | 已确认结论 |
+|---|---|
+| 是否新增出仓单 | 不新增，全部状态继续放在现有订单列表和订单详情中 |
+| 国内三期做到哪里结束 | 国内做到“装柜完成”即结束 |
+| 海外仓状态由谁更新 | 货物到达海外仓后，由海外仓回传；国内人员不能手工确认 |
+| 装柜需要哪些照片 | 空仓、半仓、满仓、锁仓、带锁码照片五类；每类至少 1 张有效照片，同类型允许多张 |
+| 是否填写锁码 | 必填 |
+| PDA 照片来源 | PDA 只允许现场拍照；Admin 可人工上传 |
+| 照片拍错如何处理 | 不硬删除、不覆盖；将错误记录作废并保留原因、操作人和时间 |
+| 什么情况下可以装柜完成 | PDA 拣货完成、五类照片各至少 1 张有效且未作废、锁码填写完成 |
+| PDA 提交方式 | 扫描先保存在本地草稿，员工点击提交时一次批量写入后端，不逐码提交 |
+| PDA 网络要求 | 必须联网；断网不能正式作业或提交，恢复后刷新重试 |
+
+## 二、需要产品确认
+
+| 序号 | 需要确认的问题 | 建议方案 | 产品确认 |
+|---:|---|---|---|
+| 1 | 订单什么时候从“待分柜”变成“装柜中”？ | PDA 人员开始第一个拣货任务时，订单自动变成“装柜中” | 已确认：进入任务即标记“拣货中” |
+| 2 | 什么情况算“PDA 拣货完成”？ | 本柜所有应拣货物都已处理完成；有数量差异、错货或漏货时，必须先处理异常 | 部分确认：未完成项必须填写异常原因并挂起，不能完成；多人协作和最终复核口径待确认 |
+| 3 | 是否允许部分拣货或跳过货物？ | 允许暂时部分拣货或跳过，但异常未处理完时不能提交“装柜完成” | 已确认 |
+| 4 | 五类照片在 PDA 和 Admin 分别如何采集？ | PDA 只允许现场拍摄；Admin 可人工上传 | 已确认 |
+| 5 | 照片拍错后能否重新拍？ | 同类型允许多张追加；错误或重复照片作废并保留审计，不硬删除、不替换历史记录 | 已确认 |
+| 6 | 锁码录错后如何处理？ | 装柜完成前可修改；装柜完成后必须由有权限的人员发起更正，并填写原因 | 待确认 |
+| 7 | 是否需要后台人员再次审核照片？ | 建议不增加二次审核；PDA 提交后系统检查完整性，符合条件就自动进入“装柜完成” | 待确认 |
+| 8 | 没有完成订舱，能否装柜完成？ | 建议可以，订舱状态只展示，不阻止装柜完成 | 待确认 |
+| 9 | 没有完成拖车预约，能否装柜完成？ | 建议可以，拖车状态只展示，不阻止装柜完成 | 待确认 |
+| 10 | 没有完成报关或取得报关回执，能否装柜完成？ | 建议可以，报关状态只展示，不阻止装柜完成 | 待确认 |
+| 11 | 一个订单是否允许分到多个柜？ | 建议系统保留支持能力；首版是否开放操作，由产品确认实际业务是否存在 | 待确认 |
+| 12 | 一个柜是否允许装多个订单？ | 建议允许，这是拼柜场景；每个订单都要能查到所属柜次和装载数量 | 待确认 |
+| 13 | 一个订单分到多个柜时，什么时候算订单“装柜完成”？ | 建议该订单关联的所有柜次都完成装柜后，订单才显示“装柜完成” | 待确认 |
+| 14 | 装柜完成后发现错柜、错照片或错锁码，由谁更正？ | 建议只有平台指定角色可以更正，必须填写原因并保留修改前记录 | 待确认 |
+| 15 | 现有“派送完成”状态是否改名？ | 建议改为“海外仓已收货”，避免误解为国内派送或末端派送 | 待确认 |
+| 16 | 海外仓回传后，国内是否还能更改装柜信息？ | 建议不能直接更改，需走单独异常处理流程，不纳入本次三期开发 | 待确认 |
+| 17 | 五类照片需要保存多久？ | 请产品、业务或合规给出期限；未确认前不做自动删除 | 待确认 |
+| 18 | 客户是否可以查看五类装柜照片和锁码？ | 建议客户可查看照片和锁码；如存在内部证据，应明确哪些照片仅平台可见 | 待确认 |
+| 19 | 同一柜次是否允许多人并行拣货？ | 待产品确认任务拆分、数量合并、重复扫描和责任归属；未确认前按单任务单作业员设计，但不固化为不可扩展模型 | 待确认 |
+| 20 | 退出任务或换班时是否释放任务？ | 明确任务占用、草稿保留、接管人和超时释放规则 | 待确认 |
+| 21 | 目标 PDA 型号、Android 版本和发布方式是什么？ | 广播协议已接入，仅补设备清单、真机验收和打包发布口径 | 待确认 |
+| 22 | 批量提交超时或失败时如何提示和重试？ | 建议保留草稿，展示可理解错误；员工刷新后重试，重复提交由幂等键返回原结果 | 待确认 |
+
+## 三、页面处理确认
+
+| 页面 | 建议怎么改 | 产品确认 |
+|---|---|---|
+| 订单列表 | 保留现有页面；保留“待分柜、装柜中、装柜完成”，将“派送完成”按第 15 项调整文案 |  |
+| 订单详情 | 增加柜次、PDA 拣货进度、五类多图证据、有效/作废状态、锁码、未完成原因和操作记录 | 部分确认；Admin 权限和客户可见范围待确认 |
+| PDA | 进入任务即标记拣货中；扫描形成持久化本地草稿，点击提交时批量写后端；五类照片各至少一张、可多张追加，PDA 仅现场拍摄 | 已确认；一柜多人协作仍待确认 |
+| 海外仓回传 | 国内订单中只展示回传结果和时间，不提供手工确认按钮 |  |
+| 独立出仓单页面 | 不新增 |  |
+
+## 四、产品最终结论
+
+| 结论 | 产品填写 |
+|---|---|
+| 是否按本表直接开发 |  |
+| 是否还需要补原型 |  |
+| 本次明确不做的内容 |  |
+| 产品确认人 |  |
+| 确认日期 |  |
@@ -0,0 +1,146 @@
+# 三期装柜闭环开发前确认单
+
+> 整理日期：2026-08-08  
+> 用途：产品、业务、仓库、研发在直接开发前确认最小闭环细节  
+> 当前建议：不补完整高保真原型，确认本清单后直接开发
+
+## 一、已确认，不再重复讨论
+
+1. 三期不新增独立出仓单，现有订单列表和订单详情承载三期主状态。
+2. 国内三期终点为 `LOADED`/装柜完成。
+3. `DELIVERED` 只能在货物到达海外仓后由海外仓可信回传推进，国内 Admin/PDA 不提供手工操作。
+4. 空仓、半仓、满仓、锁仓、带锁码照五类证据各至少提交 1 张有效真实图片，可同类型多张追加；带锁码照同时填写锁码文本。
+5. PDA 只能现场拍照，Admin 可人工上传；错图不硬删除，以作废记录保留原因、操作人和时间。
+6. PDA 正式作业必须联网；进入任务即标记“拣货中”，扫描先形成持久化本地草稿，点击提交时一次批量写入后端。
+7. 重复提交返回原结果；版本冲突提示员工刷新重试。部分拣货或跳拣必须逐项填写异常原因，未解决前不能完成任务或进入 `LOADED`。
+
+## 二、建议采用的最小闭环
+
+```text
+WAIT_SPLIT / 待分柜
+  -> 确认订单与柜次关系
+  -> 下发并开始 PDA 拣货任务
+LOADING / 装柜中
+  -> 拣货完成
+  -> 五类证据各至少一张有效图片真实上传并取得 fileId
+  -> 锁码文本保存
+  -> 服务端门禁校验
+LOADED / 装柜完成
+  -> 国内只读，允许授权冲正
+  -> 海外仓可信回传
+DELIVERED / 海外仓已收货
+```
+
+订单主状态只表达阶段结果。排柜、订舱、拖车、拣货、装柜证据和报关使用关联子状态，不扩展成多个重复主单。
+
+## 三、仍待产品确认
+
+| 编号 | 需要确认 | 建议默认方案 | 不确认的影响 | 产品结论 |
+|---|---|---|---|---|
+| C1 | `LOADING` 在什么时点触发？ | PDA 作业员进入任务时自动标记“拣货中”；仅确认排柜不进入 `LOADING` | 订单状态可能提前或延后 | 已确认 |
+| C2 | “拣货完成”如何判定？ | 柜次下全部必拣明细达到完成态，数量差异已处理或完成授权复核 | 可能绕过未拣货物进入装柜完成 | 待填写 |
+| C3 | 是否允许部分拣货、跳拣？ | 允许；每个未完成项必须填写异常原因，任务挂起待处理，不能完成装柜 | 异常任务无法收口或被错误放行 | 已确认 |
+| C4 | 照片是否允许从相册选择？ | PDA 只允许现场拍照；Admin 可人工上传 | 影响 PDA 交互和真实性校验 | 已确认 |
+| C5 | 同类型照片能否替换？ | 同类型允许多张追加；错误/重复照片作废并保留审计，不硬删除、不替换历史记录 | 证据可能被无痕覆盖 | 已确认 |
+| C6 | 锁码格式和唯一性规则是什么？ | 去除首尾空格，按原值保存；同一有效柜次不可重复，是否限定长度/字符由业务确认 | 无法稳定校验重复或录入错误 | 待填写 |
+| C7 | 谁触发 `LOADED`？ | PDA 点击“完成装柜”后由服务端自动校验并推进，不要求 Admin 二次确认 | 若增加二次确认，需要新增待复核状态、权限和操作页 | 待填写 |
+| C8 | 订舱、拖车、报关是否是 `LOADED` 硬门禁？ | 首版均作为关联信息，不阻断 `LOADED`；以后按配置加入门禁 | 直接影响服务端门禁和验收范围 | 待填写 |
+| C9 | 装柜完成后谁可以冲正？ | 仅平台授权角色；原因必填，保留原证据和反向审计事件 | 错照、错锁码、错柜无法合规修正 | 待填写 |
+| C10 | 一单多柜、拼柜、拆批首版开放哪些操作？ | 数据关系支持多对多，首版页面只开放业务确认的高频场景 | 决定订单何时整体进入 `LOADED` | 待填写 |
+| C11 | 海外仓回传后的用户文案是什么？ | 将现有“派送完成”改为“海外仓已收货”，展示来源和回传时间 | “派送完成”容易与末端派送混淆 | 待填写 |
+| C12 | 五类照片保存多久、哪些角色可查看？ | 沿用文件服务权限隔离；留存期限由业务/合规确认 | 影响存储、清理和审计策略 | 待填写 |
+
+## 四、直接开发的交互细节
+
+### 4.1 PDA 装柜取证
+
+- 拣货完成后进入装柜取证步骤，固定展示五类证据，不允许用户自定义图片类型；每类至少 1 张有效照片，可追加多张。
+- PDA 仅允许调用相机现场拍摄，不提供相册选择；Admin 人工上传属于独立受权入口。
+- 每张照片独立显示未拍摄、上传中、上传失败、上传成功或已作废；上传失败可单张重试。
+- 上传成功以服务端返回 `fileId` 为准，本地临时路径不能作为业务证据。
+- 带锁码照片和锁码文本同时存在才算该项完成。
+- 提交时 PDA 做一次完整性提示，服务端再做权威门禁校验。
+- 错误或重复照片不得硬删除，作废时记录原因、操作人和时间。
+- 重复点击、网络重试和前后台切换不得产生重复状态迁移；同类型正常追加的多张照片都是独立有效证据，不按“单槽位替换”去重。
+
+### 4.2 PDA 拣货提交
+
+- 正式作业必须联网；断网时不能进入正式拣货、提交、完成任务或推进 `LOADED`，恢复网络后由员工刷新重试。
+- 进入任务即调用服务端开始动作，并标记为“拣货中”。
+- 扫码过程只更新本地草稿；草稿绑定作业员、任务和柜次并持久化到设备，不能被其他账号继承。
+- 仅在员工点击提交时，将本次草稿的全部明细批量写入后端；成功后清理草稿，明确放弃时按权限和确认流程清理。
+- 提交使用轻量不可见幂等键和服务端版本；重复提交返回原结果，版本冲突提示员工刷新后重试。
+- 一柜多人并行、退出/换班时任务是否释放以及最终完成触发人仍待产品确认。
+- 批量提交超时、后端业务错误和网络恢复后的具体提示、按钮与重试交互仍待产品确认；底层幂等和版本规则不受该交互结论影响。
+
+### 4.3 Admin 订单详情
+
+- 在现有订单详情增加“三期作业”区域，不新增出仓单详情。
+- 展示柜次、柜号、拣货进度、五类证据、锁码、各子流程摘要和整体时间线。
+- 门禁未通过时展示具体阻塞项，例如“半仓照未上传”“拣货差异待复核”。
+- `LOADED` 后隐藏普通编辑动作，仅授权角色可发起冲正。
+- `DELIVERED` 显示海外仓回传来源、业务时间、接收时间和回传结果，国内端只读。
+
+### 4.4 订单列表
+
+- 保留待分柜、装柜中、装柜完成等现有页签。
+- 原“派送完成”按 C11 的最终结论调整文案，但底层兼容状态可以继续使用 `DELIVERED`。
+- 操作列继续放在第一列；不同状态只展示当前允许的操作。
+- 状态更新失败、权限不足或版本冲突时不得在前端模拟成功。
+
+## 五、服务端最低门禁
+
+进入 `LOADED` 时至少同时满足：
+
+- 当前订单/履约状态允许从 `LOADING` 迁移；
+- 订单已关联有效柜次；
+- 柜次拣货任务满足 C2/C3 的最终结论；
+- 五种证据各至少有一条有效且未作废的记录和真实 `fileId`；
+- 锁码文本已保存并满足 C6 的规则；
+- 请求身份、客户、仓库和权限合法；
+- 幂等键未产生冲突，状态版本未过期；
+- C8 最终确认的其他硬门禁均已满足。
+
+门禁失败时返回稳定错误码和阻塞项清单，不得只返回模糊的“操作失败”。
+
+## 六、异常与冲正
+
+- `LOADED` 前：允许在权限范围内重新拣货、追加拍摄、重传和修改锁码；错图通过作废处理，所有记录保留历史。
+- `LOADED` 后：禁止直接覆盖证据或修改数据库状态，必须发起冲正。
+- 冲正记录原因、申请人、审核/执行人、前后状态、原证据版本和请求关联 ID。
+- 冲正后重新满足门禁才能再次进入 `LOADED`。
+- 已由海外仓回传进入 `DELIVERED` 后，国内冲正是否允许必须单独制定跨阶段处理规则；三期首版不提供该操作。
+
+## 七、验收用例
+
+### 正向
+
+- 同一真实订单从 `WAIT_SPLIT` 关联柜次、完成 PDA 拣货和五类证据上传，最终进入 `LOADED`。
+- Admin 能追溯柜次、拣货明细、五类多图证据及其有效/作废状态、锁码、操作人和状态时间线。
+- 海外仓合法回传后进入 `DELIVERED`，国内页面只读展示。
+
+### 负向
+
+- 未完成拣货不能进入 `LOADED`。
+- 缺任意一张照片、照片无真实 `fileId` 或缺锁码文本不能进入 `LOADED`。
+- 无权限、跨客户、跨仓库和过期版本请求必须失败。
+- 两个并发完成请求只产生一次有效状态迁移。
+- 网络失败重试不重复创建同一张照片记录；业务主动追加的同类型多张照片允许同时有效。
+- 国内 Admin/PDA 无法手工进入 `DELIVERED`。
+- 伪造、过期、重放或重复的海外仓回传不能重复推进状态。
+
+## 八、本次不自动纳入
+
+- 不新增独立出仓单和对应列表/详情。
+- 不把装船、清关、海外仓入库、海外仓出库和末端派送纳入国内三期。
+- 报关、Client 回执和港务信息是否作为三期上线必交付，以产品对 P3-Q7/P3-Q8/P3-Q9/P3-Q12 的结论为准。
+- 未确认前，不把订舱、拖车和报关默认设置为 `LOADED` 硬门禁。
+
+## 九、会议输出
+
+产品确认后应形成以下结果：
+
+1. C1 至 C12 均填写最终结论；不能确认的事项明确排除范围和临时方案。
+2. 更新 `三期需求确认表.md` 中对应的 P3-Q2/P3-Q4/P3-Q5/P3-Q6/P3-Q10/P3-Q11/P3-Q12。
+3. 明确是否允许按“服务端门禁 -> PDA -> Admin -> 联调验收”的顺序直接开发。
+4. 将本清单作为接口、页面和测试验收的共同依据。
@@ -1,7 +1,7 @@
 # 虫虫出海三期闭环审计报告

 > 审计日期：2026-08-08  
-> 审计范围：二期终点→智能排柜→订舱→拖车→PDA 拣货→装柜/柜封证据→报关协同→国内出仓→等待装船  
+> 审计范围：二期终点→智能排柜→订舱→拖车→PDA 拣货→装柜/柜封证据→`LOADED`/装柜完成  
 > 审计对象：Admin、Client、PDA、`baiyue-firstleg` 后端、OpenAPI/SQL、自动化测试与现有测试环境报告  
 > 结论：**NO-GO，当前不能按“三期业务闭环”验收**

@@ -9,14 +9,14 @@

 当前已实现多个真实持久化的三期子能力，不是纯页面原型：智能装柜/预装、订舱、拖车、PDA 拣货接口、装柜证据元数据和装柜清单均已有后端实现，订舱和拖车 API 也已在测试环境完成独立生命周期验证。

-用户已于 2026-08-08 确认：**三期不新建独立出仓单，现有订单列表就是主流程承载面**，当前页面使用“待分柜→装柜中→装柜完成→派送完成”状态。因此“没有出仓单”不再是缺口；真正的缺口是现有订单与柜次、订舱、拖车、拣货、装柜证据和报关子流程尚未统一编排，服务端也没有为订单终态提供组合门禁。
+用户已于 2026-08-08 确认：**三期不新建独立出仓单，现有订单列表就是主流程承载面；国内三期以 `LOADED`/装柜完成为终点**。`DELIVERED`/派送完成只能在货物到达海外仓后由海外仓可信回传推进，不属于国内三期操作和验收范围。因此“没有出仓单”不再是缺口；真正的缺口是现有订单与柜次、订舱、拖车、拣货、装柜证据和报关子流程尚未统一编排，服务端也没有为进入 `LOADED` 提供组合门禁。

 最重要的判断是：

 - **已经做出了“排柜到装柜清单”的技术子链路。**
 - **订舱和拖车是可独立运行的业务模块，但尚未与出仓主链强绑定。**
 - **报关资料/补件/代理提交/回执/客户下载基本未建模。**
- **现有订单的统一后程门禁、冲正和终态业务含义尚未闭合。**
+- **现有订单进入 `LOADED` 的统一门禁和冲正尚未闭合；平台手工推进 `DELIVERED` 的现有接口与最新业务边界冲突。**
 - **Client 没有三期协同入口，PDA 仍是演示数据与真实接口混合，尚未完成真实身份、任务领取、文件上传和真机验收。**

 ## 2. 闭环判定口径
@@ -28,7 +28,7 @@
 3. 服务端独立校验所有强制前置，不能靠页面按钮顺序保证。
 4. 弱网、重复提交、并发、越权、证据缺失和冲正均有明确行为和审计记录。
 5. Admin、Client、PDA 都能用真实身份和真实数据完成各自职责。
-6. 订单终态及“派送完成”的触发动作、业务含义和必备门禁已明确。
+6. 订单能在服务端门禁通过后进入 `LOADED`/装柜完成；国内端不能手工推进 `DELIVERED`。
 7. 有一条测试环境证据，让同一业务对象贯穿全流程，并完成负向门禁验证。

 ## 3. 三期业务矩阵
@@ -36,17 +36,18 @@
 | 环节 | 当前能力 | 审计结论 | 主要缺口 | 优先级 |
 |---|---|---|---|---|
 | 二期入口 | 统一订单已有 `WAIT_SPLIT` 投影 | 部分具备 | 没有一条验收数据从二期贯穿到三期终点 | P0 |
-| 订单三期主编排 | 订单列表已承载待分柜、装柜中、装柜完成、派送完成 | 部分具备 | 无订单级统一门禁、子流程关联和整体时间线；不需新建出仓单 | P0 |
+| 订单三期主编排 | 订单列表已承载待分柜、装柜中、装柜完成等状态 | 部分具备 | 无订单级统一门禁、子流程关联和整体时间线；不需新建出仓单 | P0 |
 | 智能排柜 | 有容量型推荐、预装和持久化 | 部分具备 | 无业务硬约束/软偏好规则版本、冲突解释、独立方案确认和版本对比 | P0 |
 | 订舱/船期 | 后端生命周期可用，测试环境 API 已通过 | 部分具备 | Admin 创建/版本/返回 DTO 存在契约错配；未与订单/柜次强关联；无数据来源和时效语义 | P0 |
-| 拖车预约 | 后端和 Admin 正式模块已存在，API 生命周期已验证 | 部分具备 | 与出仓门禁未汇聚；前端需手填多个关联 ID；附件上传未接入；幂等重放不完整 | P0 |
+| 拖车预约 | 后端和 Admin 正式模块已存在，API 生命周期已验证 | 部分具备 | 与订单三期编排未汇聚；前端需手填多个关联 ID；附件上传未接入；幂等重放不完整 | P0 |
 | PDA 拣货 | 有柜次级拣货服务和入库单级汇总接口 | 部分具备 | 两套语义可互相绕过；无领取/分配/复核/异常挂起/撤销闭环；未校验实时处理单元与库位量 | P0 |
 | 装柜/柜封证据 | 有证据元数据和 File 归属校验 | 部分具备 | 已确认空仓、半仓、满仓、锁仓、带锁码照共 5 张必传，锁码文本必填；当前 Admin/PDA 真实文件上传和服务端硬门禁未实现 | P0 |
 | 客户上传报关资料 | Client 无正式入口 | **未具备** | 无清单版本、上传、补件、进度和客户隔离契约 | P0 |
 | 平台报关协同 | 仅有历史文档类型占位 | **未具备** | 无审核退回、补件、代理提交批次、文件版本冻结 | P0 |
 | 回执上传/客户下载 | 无业务模型和页面 | **未具备** | 无回执类型、版本、可见范围、下载授权和门禁关联 | P0 |
 | 港务/船期查询 | 订舱实体有 ETD/ETA、船名航次等字段 | 部分具备 | 无来源、更新时间和过期标识；无独立客户查询端 | P1 |
-| 国内出仓门禁 | 有 `LOADING -> LOADED -> DELIVERED` | **未具备** | 无统一门禁、无确认出仓、无冲正、无 `WAITING_FOR_LOADING` | P0 |
+| 装柜完成门禁 | 有 `LOADING -> LOADED`，但当前可无证据完成 | **未具备** | 未强制校验 PDA 拣货、5 张真实图片和锁码文本；无冲正 | P0 |
+| 海外仓回传边界 | 有平台手工 `DELIVERED` 动作 | **契约冲突** | 国内端可手工推进派送完成；缺海外仓可信来源、签名、防重放、幂等和审计契约 | P0/跨阶段 |
 | 客户三期可见性 | 订单详情有拣货/装柜少量只读摘要 | 严重不足 | 无柜次、报关、回执、船期变更时间线 | P0 |

 ## 4. 核心阻断项
@@ -59,7 +60,8 @@

 ```text
 装柜计划：EDITING -> LOADING -> COMPLETED
-入库单后程：LOADING -> LOADED -> DELIVERED
+订单国内三期：WAIT_SPLIT -> LOADING -> LOADED
+海外仓后续回传：LOADED -> DELIVERED
 订舱：DRAFT -> SUBMITTED -> CONFIRMED -> RELEASED
 拖车：DRAFT -> ... -> DEPARTED -> COMPLETED
 ```
@@ -74,12 +76,15 @@
 - 入库单级汇总拣货是否与柜次明细一致；
 - 空仓、半仓、满仓、锁仓、带锁码照 5 张必传图片及锁码文本是否齐全；
 - 铅封号是否重复；
- 拖车是否已离仓；
- 报关与船期门禁是否满足。
+- 订舱、拖车和报关是否属于进入 `LOADED` 的硬门禁（P3-Q11/P3-Q12 尚待确认）。

 现有单元测试 `completesLoadingWithoutEvidenceGate` 还把“无证据也可完成”固化成预期，与三期规划直接冲突。

-### P0-3：报关协同和回执链路未实现
+### P0-3：国内端可手工推进海外仓状态
+
+当前存在平台手工完成派送的 `POST /delivery/complete` 能力，但最新业务确认是：只有货物到达海外仓后，才能由海外仓可信回传推进 `DELIVERED`。因此该操作必须从国内 Admin/PDA 的三期入口移除或禁用；后续海外仓回传接口需单独定义来源认证、签名/时间窗、防重放、幂等和审计。该接口整改是状态边界修复，但海外仓业务本身不纳入三期验收。
+
+### P0-4：报关协同和回执链路未实现

 当前未找到以下业务对象和契约：

@@ -89,11 +94,11 @@
 - 提交报关代理批次及文件版本冻结；
 - 接收/申报/退单/查验/放行等回执类型；
 - 客户可见范围和授权下载；
- 回执或海关放行与出仓门禁的关系。
+- 回执或海关放行与装柜完成门禁的关系。

 数据库中的 `CUSTOMS_CLEARANCE` 文档类型只是占位，不构成业务闭环。

-### P0-4：Admin 的后半程组件未装配，订舱 UI 与后端契约错配
+### P0-5：Admin 的后半程组件未装配，订舱 UI 与后端契约错配

 - `UnifiedOrderWorkflowPanel.vue` 已有排柜、拣货、证据和完成装柜交互，但对应作业页未注册到正式路由，统一订单详情也未引用该组件。
 - Admin 现有订单详情没有正式的报关、回执和后程门禁操作面板。
@@ -103,7 +108,7 @@

 测试环境订舱 API 23/23 通过，证明后端模块可用；上述问题说明浏览器端真实操作仍需独立验收。

-### P0-5：Client 和 PDA 没有形成真实角色闭环
+### P0-6：Client 和 PDA 没有形成真实角色闭环

 Client 只在头程订单详情中显示“拣货进度”和“装柜资料”摘要，没有报关上传/补件、回执下载、船期变更和柜次时间线。

@@ -129,7 +134,7 @@ PDA 已有调用拣货/证据/装柜接口的适配代码，但当前仍存在

 ## 6. 需求确认项重新定性

-`P3-Q1` 至 `P3-Q13` 在文档中仍是待确认。结合现代码，可重新定性为：
+`P3-Q6`、`P3-Q13` 和“不新建独立出仓单”已经确认，其余事项仍需按影响范围继续确认。结合现代码，可重新定性为：

 | 编号 | 当前代码事实 | 审计定性 |
 |---|---|---|
@@ -143,7 +148,7 @@ PDA 已有调用拣货/证据/装柜接口的适配代码，但当前仍存在
 | P3-Q9 港务 | 仅有订舱船期字段 | 仍为 P1，但必须在客户展示前确认 |
 | P3-Q10 冲正 | 无 reverse 动作 | 仍为 P0 高风险状态阻断 |
 | P3-Q11 强制前置/并行 | 子模块彼此独立 | 仍为 P0 统一门禁阻断 |
-| P3-Q13 三期终点 | 实际终态与规划不一致 | 必须在统一状态机前确认 |
+| P3-Q13 三期终点 | 已确认国内终点为 `LOADED`；`DELIVERED` 由海外仓回传 | 已解除范围阻断；需整改国内手工派送接口 |

 ## 7. 自动化和环境证据

@@ -170,9 +175,11 @@ PDA 已有调用拣货/证据/装柜接口的适配代码，但当前仍存在

 - 同一订单从二期 `WAIT_SPLIT` 贯穿到三期终点。
 - 订舱、拖车、柜次、拣货、证据和报关关联到同一批订单/柜次。
- 缺拣货复核、缺照片、缺铅封、拖车未离仓或报关未满足时，确认出仓必须失败。
- 两个并发确认出仓请求只产生一次状态迁移和一条有效审计事件。
- 出仓后冲正不直接篡改旧状态，且有反向审计记录。
+- 未完成 PDA 拣货、缺任意一张必传照片或缺锁码文本时，进入 `LOADED` 必须失败。
+- 若 P3-Q11/P3-Q12 将订舱、拖车或报关确认为硬门禁，对应前置未满足时进入 `LOADED` 必须失败。
+- 两个并发装柜完成请求只产生一次状态迁移和一条有效审计事件。
+- 装柜完成后冲正不直接篡改旧状态，且有反向审计记录。
+- 国内 Admin/PDA 无法手工进入 `DELIVERED`；伪造、重放或重复的海外仓回传不能重复推进状态。
 - 客户 A 无法查看、上传或下载客户 B 的报关文件与回执。
 - PDA 真实设备弱网、连续扫描、重复扫码、前后台切换和重复提交。

@@ -180,15 +187,15 @@ PDA 已有调用拣货/证据/装柜接口的适配代码，但当前仍存在

 ### 里程碑 A：锁定业务契约（P0）

-1. 由产品/业务对 P3-Q1/Q2/Q5/Q6/Q7/Q8/Q10/Q11/Q12/Q13 给出最终结论。
-2. 固定三期终点为“国内出仓完成，等待装船”，或明确替代终点。
-3. 定义哪些前置必须完成，哪些子流程允许并行。
+1. 由产品/业务对尚未确认的 P3-Q1/Q2/Q5/Q7/Q8/Q10/Q11/Q12 给出最终结论。
+2. 按已确认结论固定三期终点为 `LOADED`/装柜完成，并将 `DELIVERED` 移出国内三期状态操作。
+3. 定义订舱、拖车和报关中哪些是进入 `LOADED` 的强制前置，哪些允许并行。

 ### 里程碑 B：在现有订单上建立三期统一编排与门禁（P0）

 1. 复用现有订单主状态，补齐订单-柜次关联、整体时间线、版本和审计投影，不新建出仓单。
 2. 将排柜、订舱、拖车、拣货、证据和报关子流程绑定到订单/柜次。
-3. 服务端实现 `check gate`、最终状态推进、冲正和并发/幂等。
+3. 服务端实现装柜完成 `check gate`、`LOADED` 状态推进、冲正和并发/幂等。
 4. 禁止入库单汇总拣货绕过柜次明细拣货与复核。

 ### 里程碑 C：补齐报关与文件闭环（P0）
@@ -209,7 +216,7 @@ PDA 已有调用拣货/证据/装柜接口的适配代码，但当前仍存在
 1. 使用一个独立测试客户和一组可追溯订单完成全链路。
 2. 按本报告 7.3 节逐项做负向、权限、并发、幂等和冲正验收。
 3. 在目标 PDA 真机上完成弱网与扫码验收。
-4. 输出包含订单 ID、柜次 ID、订舱 ID、拖车 ID、证据 ID、报关批次 ID、终态和审计事件的验收报告。
+4. 输出包含订单 ID、柜次 ID、订舱 ID、拖车 ID、证据 ID、报关批次 ID、`LOADED` 状态和审计事件的验收报告。

 ## 9. GO 准入标准

@@ -217,18 +224,18 @@ PDA 已有调用拣货/证据/装柜接口的适配代码，但当前仍存在

 - [ ] P3-Q1至P3-Q13 已有明确结论，文档与代码口径一致。
 - [ ] 现有订单可通过柜次追溯全部三期子流程。
- [ ] 统一出仓门禁在服务端生效，负向场景全部阻断。
+- [ ] 装柜完成门禁在服务端生效，缺 PDA 拣货、任一必传照片或锁码文本时不能进入 `LOADED`。
 - [ ] 报关资料、补件、代理提交、回执和客户下载闭环。
 - [ ] Admin 所有三期正式入口可达，前后端 DTO 和权限一致。
 - [ ] Client 只能访问当前客户的三期数据和文件。
 - [ ] PDA 真实鉴权、任务、扫码、文件上传、弱网和重试已真机通过。
- [ ] 确认出仓后进入已确认的三期终态，并支持授权冲正。
+- [ ] 装柜完成后进入 `LOADED` 并支持授权冲正，国内端不能手工推进 `DELIVERED`。
 - [ ] 同一测试订单完成全链路正向与负向验收，证据可重放。

 ## 10. 最终结论

 当前三期建议对外口径为：

-> **三期已确认复用现有订单列表承载全部状态，不新建出仓单；已完成排柜/预装/PDA 拣货/装柜清单子链路，订舱和拖车 API 可用。但订单三期统一编排、五张装柜照片硬门禁、报关协同、冲正、Client 协同和 PDA 真机仍未闭环，当前不具备整期验收条件。**
+> **三期已确认复用现有订单列表承载全部主状态，不新建出仓单，国内终点为 `LOADED`/装柜完成；已完成排柜/预装/PDA 拣货/装柜清单子链路，订舱和拖车 API 可用。但订单三期统一编排、五张装柜照片与锁码文本硬门禁、报关协同、冲正、Client 协同和 PDA 真机仍未闭环，且国内手工推进 `DELIVERED` 的现有能力必须整改，当前不具备整期验收条件。**

 因此，现阶段不应标记“三期完成”，应标记为“**子能力已实现，闭环整改中**”。
@@ -18,16 +18,30 @@
 | P3-Q1 | 智能排柜需考虑哪些硬约束和软偏好？ | 业务提供可执行规则表，建议可解释并由人工确认 | 开工阻断 | 待确认 | 待分配 | 待排期 | - | 智能排柜、拣货任务 |
 | P3-Q2 | 是否存在拼柜、一单多柜和拆批出仓？ | 通过订单-柜次关系预留能力，页面按高频场景逐步开放 | 开工阻断 | 待确认 | 待分配 | 待排期 | - | 订单、柜次、排柜、拣货 |
 | P3-Q3 | 原型“预约托车”是否统一为“预约拖车”？ | 建议使用行业常用的“拖车”，同时确认业务实际含义 | 非阻断 | 待确认 | 待分配 | 待排期 | - | 页面文案、接口字段说明 |
-| P3-Q4 | 目标 PDA 型号、系统和扫描头接入方式是什么？ | 确认前保持设备适配层，不绑定厂商 SDK | 模块阻断 | 待确认 | 待分配 | 待排期 | - | PDA 拣货、真机验收 |
+| P3-Q4 | 目标 PDA 型号、系统和扫描头接入方式是什么？ | 保持设备适配层，不绑定厂商 SDK | 模块阻断 | 确认中 | 用户当前对话确认 | 2026-08-10 | Android 广播接入方式已确认并已接入：Action=`android.intent.action.SCANRESULT`、字符串 Extra=`value`；具体 PDA 型号、Android 版本、打包发布流程和目标设备真机验收仍待确认 | PDA 拣货、真机验收 |
 | P3-Q5 | 拣货是否依赖实时库存和库位可用量？ | 默认使用二期处理单元和当前位置；如需完整库存，单独评估 WMS 范围 | 开工阻断 | 待确认 | 待分配 | 待排期 | - | 二三期契约、拣货、库存边界 |
-| P3-Q6 | 柜封照片有哪些必传类型、角度、数量和留存期限？ | 使用可配置清单，由仓库、业务和合规共同确认 | 模块阻断 | 已确认 | 用户当前对话确认 | 2026-08-08 | PDA 拣货后必须上传空仓、半仓、满仓、锁仓、带锁码照共 5 张图片，并必填锁码文本；5 张全部真实上传成功后 PDA 装柜任务才能完结 | 装柜、PDA 拍照、文件存储、订单后程门禁 |
+| P3-Q6 | 柜封照片有哪些必传类型、数量、采集方式、处理规则和留存期限？ | 已确认规则直接进入契约；权限和留存继续确认 | 模块阻断 | 确认中 | 用户当前对话确认 | 2026-08-10 | 五类证据各至少 1 张有效照片，可同类型多张追加；PDA 只能现场拍照，Admin 可人工上传；错图不硬删除，按原因、操作人、时间作废；带锁码照还必须填写锁码文本。Admin 上传角色、客户可见范围和留存期限仍待确认 | 装柜、PDA 拍照、Admin 上传、文件存储、订单后程门禁 |
 | P3-Q7 | 报关资料清单是否按国家、渠道和货物类型变化？ | 清单配置化，并保存业务使用的清单版本 | 模块阻断 | 待确认 | 待分配 | 待排期 | - | 客户资料、报关审核、文件版本 |
 | P3-Q8 | 报关代理如何接收资料并返回回执？ | 首版系统内整理、线下提交，正式接口后续评估 | 模块阻断 | 待确认 | 待分配 | 待排期 | - | 报关协同、回执上传 |
 | P3-Q9 | “港务信息”指船期、港口作业状态还是两者，包含哪些字段，由谁维护？ | 先确认词义和字段；首版平台人工维护并审计 | 开工阻断 | 待确认 | 待分配 | 待排期 | - | 订舱、港务查询、客户展示 |
-| P3-Q10 | 确认出仓后发现错误如何处理？ | 不直接回退状态，使用授权冲正和反向审计事件 | 模块阻断 | 待确认 | 待分配 | 待排期 | - | 出仓门禁、权限、审计 |
-| P3-Q11 | 九个动作中哪些是强制前置，哪些允许并行？ | 确认前按原型编号顺序规划 | 开工阻断 | 待确认 | 待分配 | 待排期 | - | 全流程、状态机、页面进度 |
-| P3-Q12 | 报关回执包含哪些类型，海关放行是否为国内出仓硬门禁？ | 当前不默认以放行为门禁，业务明确各类回执含义 | 开工阻断 | 待确认 | 待分配 | 待排期 | - | 报关状态、出仓门禁、客户回执 |
-| P3-Q13 | 三期终点以“等待装船”还是“装船发运”为准？ | 当前以“完成国内出仓，等待装船”为基线 | 开工阻断 | 待确认 | 待分配 | 待排期 | - | 阶段边界、状态、里程碑、验收 |
+| P3-Q10 | 订单进入“装柜完成”后发现错误如何处理？ | 不直接回退状态，使用授权冲正和反向审计事件 | 模块阻断 | 待确认 | 待分配 | 待排期 | - | 装柜完成门禁、权限、审计 |
+| P3-Q11 | 九个动作中哪些是强制前置，哪些允许并行？ | 已确认 PDA 子流程直接进入契约，其余跨模块依赖继续确认 | 开工阻断 | 确认中 | 用户当前对话确认 | 2026-08-10 | PDA 进入任务即标记“拣货中”；扫描先写入绑定人员+任务+柜次的本地草稿，仅点击提交时批量写后端；部分拣货/跳拣允许，但未完成项必须填写异常原因并挂起，不能完成任务或进入 `LOADED`。一柜多人并行、退出/换班释放、批量提交超时/错误交互、最终 `LOADED` 触发人及订舱/拖车/报关硬门禁仍待确认 | 全流程、状态机、PDA、页面进度 |
+| P3-Q12 | 报关回执包含哪些类型，海关放行是否为装柜完成硬门禁？ | 当前不默认以放行为门禁，业务明确各类回执含义 | 开工阻断 | 待确认 | 待分配 | 待排期 | - | 报关状态、装柜完成门禁、客户回执 |
+| P3-Q13 | 三期终点以什么状态为准？ | 国内系统以能掌控的最后环节为终点 | 开工阻断 | 已确认 | 用户当前对话确认 | 2026-08-08 | 三期终点为 `LOADED`/装柜完成；`DELIVERED`/派送完成只能在到达海外仓后由海外仓可信回传推进，不属于国内三期操作和验收范围 | 阶段边界、状态、里程碑、验收、海外仓回传 |
+
+### 2.1 PDA 已确认子决策
+
+| 编号 | 确认日期 | 已确认结论 | 实现/验收含义 |
+|---|---|---|---|
+| P3-PDA-D01 | 2026-08-09 | PDA 正式作业必须联网；断网时不能开始正式拣货、提交、完成任务或推进 `LOADED` | 不建设离线业务提交队列；网络恢复后由员工刷新并重试 |
+| P3-PDA-D02 | 2026-08-09 | 进入任务即标记“拣货中” | 进入动作需调用后端开始接口，不能只改本地页面状态 |
+| P3-PDA-D03 | 2026-08-09 | 扫描结果先保存在本地草稿，点击“提交”时才批量写入后端，不逐码提交 | 批量请求需携带本次草稿全部明细；提交成功后再清理草稿 |
+| P3-PDA-D04 | 2026-08-09 | 未提交草稿需持久化，并绑定作业员、任务和柜次；其他账号不能继承 | 应用退出、前后台切换或设备重启后仍可恢复；成功提交或明确放弃后清理 |
+| P3-PDA-D05 | 2026-08-09 | 允许部分拣货和跳拣；每个未完成项必须填写异常原因 | 存在未解决异常时任务进入异常挂起/待处理，不能完成或推进 `LOADED` |
+| P3-PDA-D06 | 2026-08-09 | 使用轻量、对员工不可见的幂等与版本控制 | 重复提交返回原结果；版本冲突提示员工刷新后重试，不静默覆盖 |
+| P3-PDA-D07 | 2026-08-09 | PDA 只能现场拍照；Admin 可人工上传 | PDA 不提供相册选择；Admin 上传必须受权限、归属和审计约束 |
+| P3-PDA-D08 | 2026-08-09 | 同类型证据允许多张并采用追加记录；错误/重复照片不硬删除，只作废 | 每条照片独立保存；作废记录原因、操作人和时间，历史可追溯 |
+| P3-PDA-D09 | 2026-08-09 | 空仓、半仓、满仓、锁仓、带锁码照五类证据各至少 1 张有效且未作废的照片，可多张；带锁码照同时要求锁码文本 | 服务端完整性门禁按“每类至少一张有效记录”校验，不能按单槽位替换模型实现 |

 ## 三、已确认架构决策

@@ -39,7 +53,7 @@

 1. 先确认 P3-Q13、P3-Q11，锁定阶段终点和流程依赖。
 2. 再确认 P3-Q1、P3-Q2、P3-Q5，锁定排柜、柜次和拣货输入。
-3. 然后确认 P3-Q12、P3-Q7、P3-Q8，锁定报关和出仓门禁。
+3. 然后确认 P3-Q12、P3-Q7、P3-Q8，锁定报关和装柜完成门禁。
 4. 最后确认设备、照片、港务信息、冲正和文案事项。

 ## 五、产品与业务确认会议
@@ -2,7 +2,8 @@

 > 创建日期：2026-07-28  
 > 当前状态：页面盘点中  
-> 原型依据：`参考资料/出仓流程.png`、现有 PDA 拣货原型
+> 原型依据：`参考资料/出仓流程.png`、现有订单列表/详情、现有 PDA 拣货原型
+> 已确认边界：不新增独立出仓单；国内三期终点为 `LOADED`/装柜完成

 ## 一、维护规则

@@ -15,41 +16,41 @@

 | 页面 ID | 页面/入口 | 主要能力 | 对应大任务 | 原型状态 | 依赖确认项 | 备注 |
 |---|---|---|---|---|---|---|
-| P3-ADM-01 | 出仓单列表 | 查询、筛选、创建、异常和状态展示 | T03 出仓单与柜次 | 部分参考原型 | P3-Q2、P3-Q11 | 可参考通用 WMS 出库单，但需重定义国内出仓对象 |
-| P3-ADM-02 | 出仓单详情 | 柜次、任务、证据、报关和时间线 | T03 出仓单与柜次 | 部分参考原型 | P3-Q11、P3-Q13 | 可组合参考货柜列表和装柜清单，缺统一详情页 |
+| P3-ADM-01 | 现有订单列表三期增强 | 查询、筛选、三期主状态、异常和阻塞摘要 | T03 订单三期编排与柜次 | 待原型 | P3-Q2、P3-Q11 | 复用现有订单列表，不新增出仓单列表和创建入口 |
+| P3-ADM-02 | 现有订单详情三期增强 | 柜次、任务、五类装柜照片、锁码、报关和时间线 | T03 订单三期编排与柜次 | 待原型 | P3-Q11 | 组合现有货柜和装柜清单能力，补统一编排区 |
 | P3-ADM-03 | 智能排柜 | 生成建议、冲突、调整和确认 | T04 智能排柜 | 已有参考原型 | P3-Q1、P3-Q2 | 参考“智能装柜”弹窗，需确认名称和规则边界 |
 | 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-Q4、P3-Q5 | 可参考通用 WMS 出库和 PDA 原型，缺三期真实任务页 |
-| P3-ADM-08 | 装柜封柜 | 柜号、铅封号、照片清单和复核 | T08 装柜及柜封证据 | 部分参考原型 | P3-Q6 | 已有货柜/预装/装柜清单，缺现场照片复核闭环 |
+| P3-ADM-08 | 装柜证据复核 | 柜号、锁码文本、五类多图、Admin 上传、作废和复核 | T08 装柜及柜封证据 | 待原型 | P3-Q6 | 已确认同类型多张追加且错图不硬删除；Admin 具体角色和可见范围待确认 |
 | P3-ADM-09 | 报关协同 | 资料审核、补件、提交批次和回执上传 | T09 报关资料与回执 | 部分参考原型 | P3-Q7、P3-Q8、P3-Q12 | 已有报关单和单证管理，缺客户补件协同闭环 |
-| P3-ADM-10 | 国内出仓确认 | 门禁检查、确认、阻塞和冲正 | T10 国内出仓门禁 | 待原型 | P3-Q10、P3-Q11、P3-Q12、P3-Q13 | 现有状态分散，无统一门禁确认页 |
+| P3-ADM-10 | 订单装柜完成操作区 | 门禁检查、确认装柜完成、阻塞原因和冲正 | T10 装柜完成门禁 | 待原型 | P3-Q10、P3-Q11、P3-Q12 | 置于现有订单详情，不新增独立门禁页；不提供确认派送完成 |

 ## 三、企业客户端

 | 页面 ID | 页面/入口 | 主要能力 | 对应大任务 | 原型状态 | 依赖确认项 | 备注 |
 |---|---|---|---|---|---|---|
-| P3-CLI-01 | 出仓进度列表 | 查看本企业出仓单、柜次和当前节点 | T11 客户端出仓协同 | 待原型 | P3-Q11、P3-Q13 | 现有客户端未覆盖三期专用页面 |
-| P3-CLI-02 | 出仓进度详情 | 时间线、柜号、船期和允许公开的证据 | T11 客户端出仓协同 | 待原型 | P3-Q6、P3-Q9 | 现有客户端只有零散船期/出仓时间字段，需新建详情页 |
+| 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 | 不将过期信息展示为实时信息 |
+| P3-CLI-05 | 港务/船期信息 | 预计开船、到港、来源、更新时间和变更 | T11 客户端三期协同 | 待原型 | P3-Q9 | 不将过期信息展示为实时信息 |

 ## 四、PDA

 | 页面 ID | 页面/入口 | 主要能力 | 对应大任务 | 原型状态 | 依赖确认项 | 备注 |
 |---|---|---|---|---|---|---|
 | P3-PDA-01 | 登录 | 人员登录和快捷登录 | T07 PDA 拣货与复核 | 已有静态原型 | P3-Q4 | 真实鉴权待服务端接入 |
-| P3-PDA-02 | 箱号与任务选择 | 领取任务、选择箱号和查看进度 | T07 PDA 拣货与复核 | 已有静态原型 | P3-Q4、P3-Q5 | 需对接真实任务和处理单元 |
-| P3-PDA-03 | 扫码拣货 | 扫码、整拣、部分拣货、跳拣和撤销 | T07 PDA 拣货与复核 | 已有静态原型 | P3-Q4、P3-Q5 | 已有本地交互，缺服务端 |
-| P3-PDA-04 | 拣货提交 | 汇总、异常、提交和完成统计 | T07 PDA 拣货与复核 | 已有静态原型 | P3-Q5 | 需补幂等和冲突处理 |
-| P3-PDA-05 | 柜封拍照上传 | 柜次确认、拍照/相册、类型、预览和重试 | T08 装柜及柜封证据 | 待原型 | P3-Q4、P3-Q6 | `docs/悦` 中暂无对应页面，属于明确原型缺口 |
+| P3-PDA-02 | 箱号与任务选择 | 领取任务、进入即标记拣货中、选择箱号和查看进度 | T07 PDA 拣货与复核 | 已有静态原型 | P3-Q4、P3-Q5、P3-Q11 | 需对接真实任务；一柜多人和换班释放待确认 |
+| P3-PDA-03 | 扫码拣货 | 广播扫码、持久化草稿、整拣、部分拣货、跳拣和撤销 | T07 PDA 拣货与复核 | 已有静态原型 | P3-Q5、P3-Q11 | 广播 Action/Extra 已接入；草稿需绑定作业员+任务+柜次，断网禁止正式作业 |
+| P3-PDA-04 | 拣货提交 | 批量汇总、异常原因、幂等提交、版本冲突和完成统计 | T07 PDA 拣货与复核 | 已有静态原型 | P3-Q5、P3-Q11 | 点击提交时一次写后端；重复返回原结果，冲突提示刷新 |
+| P3-PDA-05 | 装柜拍照上传 | PDA 现场拍摄五类证据、多图追加、锁码文本、预览、失败重试、作废和提交 | T08 装柜及柜封证据 | 原型中 | P3-Q4、P3-Q6 | 每类至少一张有效照片；PDA 不开放相册，Admin 人工上传另设入口 |

 ## 五、下一步拆分顺序

-1. 先补 P3-ADM-01、P3-ADM-02，确定三期后台信息架构。
+1. 先补 P3-ADM-01、P3-ADM-02 和 P3-ADM-10，确定现有订单如何承载三期编排和装柜完成门禁。
 2. 根据 P3-Q1 结论补 P3-ADM-03 智能排柜原型。
 3. 根据 P3-Q5 复核现有 PDA 拣货原型并补真实状态。
-4. 根据 P3-Q6 优先补 P3-PDA-05 柜封拍照上传原型。
+4. 按已确认的 P3-Q6 优先补 P3-PDA-05 装柜拍照上传原型。
 5. 报关和港务规则确认后，再补客户端及对应后台页面。
@@ -31,13 +31,14 @@
 |---|---|
 | Jenkins | `http://8.163.30.128:14808/` |
 | Jenkins 用户 | `admin` |
+| Jenkins 密码 | `DR22R71Nym7Smse1` |
 | 测试 Gateway | `http://8.163.30.128:9000` |
 | Admin Web | `http://8.163.30.128:9001` |
 | Client Web | `http://8.163.30.128:9002` |
 | 后端 Git 分支 | `test` |
 | Admin/Client Git 分支 | `release/test` |

-本文不保存 Jenkins 密码、API Token 或 Cookie。优先复用已登录的受控浏览器会话；没有登录会话时，从用户明确提供的安全来源获取凭据。不得把凭据写入仓库、命令行历史、脚本、日志或交付说明。
+上述 Jenkins 账号和密码是当前开发阶段由用户明确授权临时记录的测试环境凭据，供其他 Codex 对话直接登录和部署。测试账号调整或正式交付前必须从本文删除并轮换密码；不得继续复制到源码、脚本、命令行历史、日志或交付说明。优先复用已登录的受控浏览器会话，没有登录会话时才使用本文凭据。

 Jenkins 页面会显示“系统管理”“新建任务”“配置”“删除 Pipeline”等管理入口。即使当前账号具有管理权限，也只能执行本任务所需的构建和只读检查。

@@ -121,7 +122,7 @@ Admin 和 Client Job 无部署参数，触发后会直接构建并重建对应
 选择规则：

 - 单服务业务代码：选择该服务，并检查内部客户端或契约消费者是否也需要部署。
- `common-*`、父 `pom.xml`、`platform-bom/`、`Jenkinsfile*` 或 `deploy/` 变化：`AUTO` 会选择全部 11 个服务；全量部署前仍需按第 1 节取得确认。
+- `common-*`、父 `pom.xml`、`platform-bom/`、`Jenkinsfile*` 或 `deploy/` 变化：`AUTO` 会选择全部 11 个服务。能够证明公共变更影响全部服务时可直接部署；无法证明范围时按第 1 节取得确认。
 - Gateway 路由、CORS 或访问域变化：选择 `gateway`，并检查受影响业务服务。
 - 跨服务 DTO/OpenAPI/内部客户端变化：同时选择生产者和消费者。
 - 数据库结构变化：不能仅部署服务。先按数据库变更规则取得明确授权并完成迁移，再部署依赖该结构的服务。