docs: initialize documentation repository

三期/README.md

@@ -0,0 +1,16 @@
+# 三期文档
+
+三期以头程物流“03 出仓”为范围，完成从排柜、订舱、拖车和仓内拣货，到封柜、报关、国内出仓并等待装船的业务闭环。
+
+## 文档
+
+- [三期开发规划：国内出仓](三期开发规划.md)
+- [三期开发进度表](三期开发进度表.md)：参考一期采用“大任务 → 详细任务 → 里程碑 → 未确认事项 → 开工准入 → 验收”结构维护。
+- [虫虫出海三期开发进度表（Excel）](虫虫出海三期开发进度表.xlsx)：可筛选、可下拉维护并使用公式汇总的项目进度工作簿。
+- [三期需求确认表](三期需求确认表.md)：集中跟踪 P3-Q1～P3-Q13、负责人和最终结论。
+- [三期页面与原型清单](三期页面与原型清单.md)：按管理后台、企业客户端和 PDA 维护页面范围及原型状态。
+- `参考资料/出仓流程.png`：本期 9 个核心动作及业务终点的原始参考图。
+
+## 当前状态
+
+三期处于范围规划阶段，当前开工结论为 `NO-GO`。当前以原型图片中的“完成国内出仓，等待装船”为阶段终点。动作依赖与并行关系、排柜规则、PDA 设备、拖车协作、柜封照片清单、报关回执及放行门禁、港务/船期信息范围和来源仍需在启动前确认。产品和业务完成确认后先进入契约与任务准备，六项开工准入全部通过后再进入全面功能开发。

三期/三期开发规划.md

@@ -0,0 +1,310 @@
+# 虫虫出海三期开发规划：国内出仓
+
+> 创建日期：2026-07-28  
+> 状态：范围规划中  
+> 流程依据：[出仓流程](参考资料/出仓流程.png)中的头程物流“03 出仓”；当前以图片中的“完成国内出仓，等待装船”为阶段终点  
+> 前置阶段：[一期文档](../一期/README.md) · [二期文档](../二期/README.md)
+
+## 一、三期目标
+
+三期承接二期“货物完成到仓、实测、差异处理和指定库位”的结果，将已受理货物转化为可执行、可追踪、可审计的国内出仓任务。
+
+流程覆盖九个动作：
+
+```text
+智能排柜 → 订舱 → 预约拖车
+    ↓
+PDA 拣货 → 装柜并上传货柜/铅封照片
+    ↓
+客户上传报关资料 → 平台整理提交报关代理 → 上传回执供客户下载
+    ↓
+查询或维护预计开船、到港等港务/船期信息
+    ↓
+完成国内出仓，等待装船
+```
+
+三期完成标准不是“订单改成已出仓”，而是每个柜次能够回答：装了哪些订单和货物、依据什么方案排柜、订了什么舱、谁承运拖车、仓库实际拣装了什么、柜号与铅封是什么、报关资料和回执在哪里、实际何时出仓、当前等待哪一班船。
+
+### 原型动作覆盖
+
+| 原型动作 | 规划模块 | 开发任务 | 覆盖结果 |
+|---|---|---|---|
+| 1. 智能排柜 | 智能排柜 | P3-PLAN-01、P3-PLAN-02 | 已覆盖，规则待 P3-Q1 确认 |
+| 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 | 已补充现场拍照上传任务，清单待 P3-Q6 确认 |
+| 6. 客户上传报关资料 | 报关资料协同 | P3-CUS-01 | 已覆盖 |
+| 7. 整理给到报关代理报关 | 报关资料协同 | P3-CLEAR-01 | 已覆盖 |
+| 8. 回执上传到系统供客户下载 | 报关回执与客户下载 | P3-CLEAR-01、P3-CUS-02 | 已覆盖，回执类型待 P3-Q12 确认 |
+| 9. 查港务信息（预计开船、到港等） | 订舱与港务/船期信息 | P3-PORT-01、P3-CUS-02 | 已补充独立查询任务，范围和数据源待 P3-Q9 确认 |
+
+## 二、阶段边界
+
+### 纳入三期
+
+- 出仓单、柜次、智能排柜建议、人工调整和版本确认。
+- 订舱申请、舱位结果，以及原型所述预计开船、到港等港务/船期信息；具体字段和数据源待确认。
+- 预约拖车、车辆司机、到仓装柜和离仓记录。
+- PDA 任务领取、扫码拣货、部分拣货、异常、复核和幂等提交。
+- 装柜、柜号、铅封号及货柜/铅封照片证据。
+- 客户上传报关资料、平台审核补件、整理并提交报关代理。
+- 报关回执上传、版本、客户可见范围和授权下载。
+- 国内出仓门禁、确认、冲正、时间线和站内通知。
+
+### 明确不纳入三期
+
+- 入库、上架、实时库存、移库、盘点、冻结、补货和完整 WMS。
+- 港区闸口、车队、船公司、海关单一窗口的正式自动化接口。
+- GPS 实时跟车、电子铅封、称重设备、摄像头 OCR 和 IoT 自动采集。
+- 自动报关、关税计算、退税、完整清关业务和自动单证识别。
+- 海上运输、海外清关、目的港提柜、海外仓入库和末端派送。
+- 无人工确认的全自动排柜、自动订舱和不可逆业务操作。
+
+## 三、参与角色与数据边界
+
+| 角色 | 数据范围 | 主要操作 |
+|---|---|---|
+| 企业订单操作员 | 当前企业订单与出仓单 | 上传/补充报关资料、查看出仓和港务/船期进度、下载回执 |
+| 平台运营 | 授权客户、订单和出仓单 | 创建出仓单、确认排柜、订舱、维护港务/船期信息和协调异常 |
+| 仓库主管 | 被授权的平台收货仓 | 分配拣货任务、复核差异、确认装柜和出仓条件 |
+| 仓库作业员 | 分配给本人或本仓的任务 | PDA 扫码、数量确认、异常上报和任务提交 |
+| 拖车调度员 | 授权出仓单与车辆范围 | 预约车辆、维护司机/车牌、到仓和离仓节点 |
+| 报关专员 | 授权客户、订单和报关批次 | 审核、退回、整理、提交资料并上传回执 |
+| 平台管理员 | 平台授权范围 | 维护权限、规则、服务商和高风险冲正 |
+
+服务端必须依据登录身份确定企业、仓库、客户和数据范围。前端传入的订单 ID、出仓单 ID、仓库 ID、客户 ID、作业员 ID 或报关批次 ID 不能单独作为授权依据。
+
+## 四、流程与状态设计
+
+原型以 1 至 9 编号表达动作顺序，但尚未说明哪些是强制前置、哪些允许并行。当前按原型顺序规划业务节点，同时使用主状态和子流程状态保留后续调整空间；在 P3-Q11 确认前，不把并行关系写成固定业务规则。
+
+### 1. 出仓单主状态
+
+| 稳定编码 | 中文名称 | 含义 |
+|---|---|---|
+| `DRAFT` | 草稿 | 出仓单已创建，排柜方案尚未确认 |
+| `PLANNING` | 排柜中 | 系统生成建议或人工调整方案 |
+| `PREPARING` | 出仓准备中 | 按已确认的依赖关系处理订舱、拖车、拣货和报关 |
+| `READY_TO_DISPATCH` | 待出仓 | 必要子流程和证据已满足 |
+| `DISPATCHED` | 已出仓 | 货柜已离开国内仓库 |
+| `WAITING_FOR_LOADING` | 等待装船 | 国内出仓已完成，等待对应船班装船 |
+| `CANCELLED` | 已取消 | 按规则取消并保留原因与历史 |
+| `BLOCKED` | 已阻塞 | 存在必须人工解除的关键异常 |
+
+### 2. 子流程状态
+
+- 订舱：待订舱、订舱中、已订舱、订舱失败、已取消。
+- 拖车：待预约、已预约、车辆已到仓、装柜中、已离仓、改约、已取消。
+- 拣货：待分配、待拣货、拣货中、待复核、已完成、异常挂起、已取消。
+- 报关：资料待上传、资料待审核、待补件、待提交、已提交代理、回执待上传、回执已上传、已退回、已取消。海关放行如需管理，作为待确认的回执类型或后续状态，不默认作为三期出仓门禁。
+- 港务/船期：待维护、已确认、信息变更、已开船；“已开船”属于三期之后的运输阶段，不是当前三期完成条件。
+
+主状态由服务端根据已确认的必要子流程推进。客户端不得通过传任意目标状态跳过拣货复核、柜封证据或已配置的出仓门禁。
+
+## 五、业务模块
+
+### 1. 出仓单
+
+- 从已上架且允许出仓的头程订单创建一张或多张出仓单。
+- 支持一张订单分多个柜次，也支持多个订单拼柜，具体开放范围由产品确认。
+- 保存订单、客户、仓库、货物、往来单位和计量数据快照。
+- 维护计划出仓时间、优先级、负责人、异常和整体时间线。
+- 重复创建和确认使用幂等键，并通过版本字段防止并发覆盖。
+
+### 2. 智能排柜
+
+- 原型仅明确“智能排柜”，具体硬约束、软偏好、输入数据和输出结果以 P3-Q1 的业务规则表为准。
+- 柜型容量、重量、体积、箱数、同票/混票、不可混装、装载顺序和利用率暂列为候选能力，不作为未经确认的固定验收项。
+- 当前建议首版采用“系统建议、人工确认”；是否允许调整、是否强制填写原因由排柜规则确认。
+- 建议排柜方案保留版本、规则版本、输入快照、操作者和前后差异，以支持追溯。
+- 未确认方案不得生成正式拣货任务或执行不可逆状态变化。
+
+### 3. 订舱与港务/船期信息
+
+- 原型明确需要查询预计开船、到港等港务信息；“港务信息”的准确业务含义、字段范围和归属以 P3-Q9 为准。
+- 船公司/订舱代理、航线、订舱号、船名航次、起运港、目的港、截单、截关、截港、ETD 和 ETA 暂列为候选字段。
+- 订舱失败、改船、甩柜、船期延误和取消暂列为候选异常场景，按业务确认结果实现。
+- 港务信息查询与人工维护分开设计：三期至少支持查询系统内已维护的信息，并记录查询条件、数据来源和更新时间；如后续确认可靠外部数据源，再通过预留适配边界接入，不在三期默认承诺正式接口。
+- 客户查看预计开船、到港等信息时展示数据来源和最近更新时间，避免把过期结果显示为实时信息。
+- 当前建议首版由平台人工维护，外部港务或船期接口只预留适配边界。
+- 建议关键信息变更保留旧值、新值、原因，并向授权用户发送站内提醒。
+
+### 4. 预约拖车
+
+- 从往来单位选择已启用拖车服务商，维护车牌、司机、电话和预约时间窗。
+- 记录提柜、到仓、装柜、离仓、还柜节点和交接说明。
+- 支持改约、取消、迟到、未到、车辆更换和柜号变更。
+- 司机手机号等个人信息按最小权限展示，不进入不必要的客户响应。
+- 图片原文“预约托车”建议统一为行业常用的“预约拖车”，需产品最终确认。
+
+### 5. PDA 拣货与复核
+
+- 按已确认排柜方案生成仓库、柜次、订单和货物明细级任务。
+- PDA 支持登录、领取、箱号选择、扫码、数量确认、部分拣货、跳拣、撤销和异常上报。
+- 服务端校验任务归属、状态、重复扫码、超量、错货和重复提交。
+- 拣货完成后必须复核；差异未处理前不得进入待出仓。
+- 扫描器、声音、震动、网络和缓存通过设备适配层实现，不直接绑定单一厂商 SDK。
+
+### 6. 装柜及柜封证据
+
+- 维护柜号、铅封号、装柜开始/完成时间、操作人和异常说明。
+- 支持按可配置清单上传货柜及铅封照片；柜体、开门空柜、装柜过程、满柜、关门和铅封照仅为候选类型，必传类型、角度和数量以 P3-Q6 为准。
+- 现场执行端支持直接拍照或从相册选择后上传，上传前显示柜次、柜号、铅封号和照片类型，防止证据关联错误。
+- 支持上传进度、失败重试、重复照片提示和提交前预览；弱网下不得因重复点击产生多份有效证据。
+- 照片记录文件哈希、上传人、上传时间、关联柜次和客户可见范围。
+- 铅封号重复、已确认的必传照片缺失或复核未通过时禁止确认出仓。
+- 修改柜号或铅封号需要二次确认、原因和完整审计。
+
+### 7. 报关资料协同
+
+- 客户按资料清单上传发票、箱单、合同、委托书和申报要素等文件。
+- 资料清单可按国家/地区、渠道和货物类型配置，并保存订单使用的清单版本。
+- 平台报关专员审核完整性，可退回具体文件并记录补件原因和时限。
+- 提交报关代理时生成提交批次，冻结该批次关联的文件版本。
+- 首版采用系统内整理加线下提交，不直接对接海关单一窗口。
+
+### 8. 报关回执与客户下载
+
+- 上传代理回传的报关回执并关联提交批次；回执类型可区分接收、申报、退单、查验或放行等，实际类型及出仓门禁以 P3-Q12 为准。
+- 替换文件产生新版本，不覆盖原记录；退单或补件形成明确任务。
+- 客户只能下载本企业且标记为客户可见的回执。
+- 文件下载使用授权地址并记录审计，不暴露内部存储路径。
+
+### 9. 国内出仓确认
+
+- 服务端校验排柜已确认、拣货复核完成、已确认的柜封证据齐全、车辆已离仓，以及已配置的报关回执和港务/船期信息门禁。
+- 当前不默认要求“海关已放行”后才能确认国内出仓；是否需要放行或其他特定回执作为门禁，以 P3-Q12 的业务结论为准。
+- 授权人员执行确认出仓，记录实际出仓时间、车辆、柜号、铅封号和说明。
+- 确认操作具备幂等、权限、版本和并发校验，重复请求只产生一次有效事件。
+- 完成后进入“等待装船”，企业客户可查看允许公开的节点、港务/船期信息和回执。
+- 出仓后发现错误不得直接回退数据库状态，必须使用授权冲正动作和反向审计事件。
+
+## 六、核心数据对象
+
+| 数据对象 | 关键内容 |
+|---|---|
+| 出仓单 | 订单、企业、仓库、计划/实际时间、主状态、负责人和版本 |
+| 排柜方案 | 经确认的规则版本、输入快照、柜次、货物分配、规则计算结果和确认记录 |
+| 柜次 | 柜型、柜号、铅封号、装载顺序、重量、体积和关联订单 |
+| 订舱记录 | 船公司/代理、订舱号、船名航次、港口、舱位和异常 |
+| 港务/船期节点 | 经确认的信息字段、变更历史和来源；候选字段包括截单、截关、截港、ETD 和 ETA |
+| 拖车预约 | 服务商、车辆、司机、预约时间窗、到离仓节点和异常 |
+| 拣货任务 | 柜次、货物明细、分配人、作业员、扫描、数量、差异和复核 |
+| 装柜证据 | 柜号、铅封号、照片类型、文件、上传人、时间和可见范围 |
+| 报关批次 | 资料清单版本、文件版本、补件、提交代理和回执 |
+| 出仓时间线 | 事件、前后状态、操作者、发生时间、说明和请求关联 ID |
+
+基础资料引用必须同时保存稳定 ID 和必要快照。订单、客户、仓库、往来单位、港务/船期信息或文件后续修改时，不得改变历史出仓记录。
+
+## 七、应用范围
+
+### 管理后台 `apps/admin-web`
+
+- 出仓单列表、筛选、详情、异常和状态操作。
+- 按已确认的排柜规则提供建议、冲突展示、人工调整、版本对比和确认。
+- 订舱、船期、拖车预约、装柜、柜号、铅封和照片。
+- 报关资料审核、补件、提交批次、回执上传和客户可见控制。
+- 权限至少拆分为查看、排柜、订舱、拖车、仓内复核、报关、确认出仓和冲正。
+
+### 企业客户端 `apps/client-web`
+
+- 查看本企业出仓单、柜次和允许公开的进度时间线。
+- 上传、补充和查看报关资料及处理结果。
+- 下载客户可见的报关回执。
+- 查看预计开船、到港和船期变更，不暴露内部成本、供应商敏感信息和内部备注。
+
+### PDA `apps/pda-uniapp`
+
+- 仓库人员登录、任务领取、箱号选择、扫码拣货和数量确认。
+- 部分拣货、跳拣、撤销、异常上报、待复核和完成提交。
+- 按授权柜次拍摄或选择货柜、铅封照片，确认关联信息后上传，并处理进度、失败重试和重复提交。
+- 弱网、断网、前后台切换、重复提交和换班清理。
+- 真实设备、扫描头和发布方式确认前，不绑定厂商 SDK。
+
+### 服务端 `services/api`
+
+- 最终保证身份、租户、仓库数据范围、权限、状态、门禁、幂等、并发和审计。
+- 管理出仓、排柜、订舱、拖车、拣货、装柜、报关和时间线的事务边界。
+- 文件上传校验类型、大小、内容和权限；使用不可预测标识和授权下载。
+- 为船期、车队、海关等外部接口预留适配层，但三期不承诺正式对接。
+
+## 八、建议里程碑
+
+| 里程碑 | 交付目标 | 进入条件 |
+|---|---|---|
+| P3-M0 规则与设备锁定 | 流程、角色、状态、排柜规则、PDA、文件和验收确认 | 二期到仓契约稳定 |
+| P3-M1 出仓单与排柜 | 出仓单可创建，并按确认范围提供排柜建议、人工确认与追溯 | 排柜规则确认 |
+| P3-M2 订舱与拖车 | 订舱、船期、拖车预约和异常处理可用 | 服务商与权限可用 |
+| P3-M3 PDA 拣货 | 任务生成、扫码、差异、复核和幂等提交可用 | 目标设备与仓库流程确认 |
+| P3-M4 装柜封柜 | 柜号、铅封和照片证据完整，门禁生效 | 文件能力与必传清单确认 |
+| P3-M5 报关协同 | 客户上传、平台审核、补件、提交和回执下载闭环 | 报关资料清单确认 |
+| P3-M6 国内出仓 | 必要子流程满足后可确认出仓并进入等待装船 | 出仓门禁和冲正规则确认 |
+| P3-M7 联调验收 | 跨端、设备、安全、弱网、性能、迁移和发布完成 | P3-M1 至 P3-M6 验收通过 |
+
+## 九、建议开发任务
+
+| ID | 端 | 模块 | 交付内容 | 优先级 | 依赖 |
+|---|---|---|---|---|---|
+| P3-BASE-01 | 公共 | 出仓契约 | 主/子状态、权限、事件、错误码、门禁和快照模型 | P0 | 二期到仓契约 |
+| P3-BASE-02 | 公共 | 数据模型 | 出仓单、排柜、柜次、订舱、拖车、拣货、装柜、报关和时间线 | P0 | P3-BASE-01 |
+| P3-DSP-01 | 后台 | 出仓单 | 列表、筛选、创建、详情、异常和取消 | P0 | P3-BASE-02 |
+| P3-PLAN-01 | 公共 | 排柜规则 | 按已确认规则实现输入、约束、偏好和冲突判断 | P0 | P3-BASE-02、P3-Q1 |
+| P3-PLAN-02 | 后台 | 智能排柜 | 按已确认范围实现建议、人工确认和追溯 | P0 | P3-PLAN-01 |
+| P3-BOOK-01 | 后台 | 订舱 | 订舱和经确认的船名航次、港口、变更及异常 | P0 | P3-DSP-01、P3-Q9 |
+| 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 | 后台 | 装柜封柜 | 柜号、铅封号、装柜节点、可配置照片清单和复核 | P0 | P3-PICK-01、P3-Q6 |
+| P3-LOAD-02 | PDA/服务端 | 柜封拍照上传 | 现场拍照/相册选择、关联确认、进度、预览、失败重试、去重和提交 | 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-NOTIFY-01 | 公共 | 通知异常 | 站内通知、阻塞、责任人、时限和失败补偿 | P1 | 核心流程完成 |
+| P3-TEST-01 | 公共 | 自动化测试 | 权限、排柜、幂等、并发、文件、门禁和状态测试 | P0 | 所有 P0 模块 |
+| P3-DEVICE-01 | PDA | 真机验收 | 扫描头、弱网、性能、电量、前后台和发布验证 | P0 | 目标设备确认 |
+| P3-REL-01 | 公共 | 发布验收 | 初始化规则、迁移、联调、演练、灰度和生产发布 | P0 | P3-TEST-01、P3-DEVICE-01 |
+
+## 十、测试与验收重点
+
+- 系统排柜符合已确认的业务规则；如启用建议解释、人工调整、版本或原因记录，对应结果可追溯。
+- 多订单拼柜和一单多柜的件数、重量、体积能与二期实测版本对账。
+- PDA 重复扫码、超量、错货、断网重试和重复提交不产生重复扣减或完成事件。
+- 柜封照片能够在现场完成拍摄、关联确认和上传；失败重试或重复提交不产生多份有效证据。
+- 未完成复核、缺少已确认的必传柜封证据或存在关键阻塞时不能确认出仓。
+- 企业 A 无法查看、上传或下载企业 B 的报关资料和回执。
+- 报关资料替换、退回、补件、提交和回执均能追溯到明确版本。
+- 港务/船期查询结果展示来源和更新时间；变更保留历史并通知授权用户，旧信息不被无痕覆盖。
+- 确认出仓的并发请求只产生一次状态变化和一次有效审计事件。
+- 管理后台覆盖加载、空态、失败、无权限和数据冲突；PDA 覆盖弱网、前后台切换和硬件扫描。
+- 当前三期验收基线为“完成国内出仓，等待装船”，不以海上运输或海外签收作为完成条件；最终以 P3-Q13 确认结果为准。
+
+## 十一、启动前待确认事项
+
+| 编号 | 待确认问题 | 当前建议 |
+|---|---|---|
+| P3-Q1 | 智能排柜需考虑哪些硬约束和软偏好？ | 业务先提供可执行规则表；建议必须可解释且人工确认 |
+| P3-Q2 | 是否存在拼柜、一单多柜和拆批出仓？ | 数据模型全部支持，页面按实际高频场景逐步开放 |
+| P3-Q3 | “预约托车”是否统一为“预约拖车”？ | 建议统一使用行业常用的“拖车”，并确认业务实际含义 |
+| P3-Q4 | 目标 PDA 型号、系统和扫描头接入方式是什么？ | 设备确认前保持适配层，不绑定厂商 SDK |
+| P3-Q5 | 拣货是否依赖实时库存和库位可用量？ | 若需要，完整 WMS 前置范围会显著扩大，必须单独评估 |
+| P3-Q6 | 柜封照片有哪些必传角度和留存期限？ | 启动前由仓库、业务和合规共同锁定 |
+| P3-Q7 | 报关资料清单是否按国家、渠道和货物类型变化？ | 建议配置化，并保留下单使用的清单版本 |
+| P3-Q8 | 报关代理如何接收资料和返回回执？ | 首版系统内整理加线下提交，正式接口后续评估 |
+| P3-Q9 | 原型中的“港务信息”具体指船期、港口作业状态还是两者，包含哪些字段，由谁维护？ | 先确认业务词义和字段；首版建议平台人工维护并审计，外部接口仅预留适配层 |
+| P3-Q10 | 确认出仓后发现错误如何处理？ | 不直接回退状态，使用授权冲正动作和反向审计事件 |
+| P3-Q11 | 九个动作中哪些是强制前置，哪些允许并行？ | 确认前按原型编号顺序规划，不承诺固定并行关系 |
+| P3-Q12 | “报关回执”具体包含哪些类型，海关放行是否为国内出仓硬门禁？ | 当前不默认以放行为门禁；由业务明确接收、申报、退单、查验和放行的含义及门禁 |
+| P3-Q13 | 三期终点以“等待装船”还是“装船发运”为准？ | 当前以本期出仓图片的“完成国内出仓，等待装船”为基线，完整流程 SVG 的不同表述待产品确认 |
+
+## 十二、建议实施顺序
+
+1. 锁定待确认事项、业务规则、目标设备和协作责任人。
+2. 统一出仓单、柜次、订舱、拖车、拣货、报关和港务/船期信息的稳定编码。
+3. 先实现服务端权限、状态、门禁、幂等、并发和审计，再接各端页面。
+4. 完成管理后台的出仓编排，再接 PDA 现场执行和客户资料协同。
+5. 使用脱敏数据演练拼柜、一单多柜、错拣、补件、改船和冲正。
+6. 在真实 PDA 和代表性仓库网络环境中完成联调、验收和灰度发布。

三期/三期开发进度表.md

@@ -0,0 +1,152 @@
+# 虫虫出海三期开发进度表
+
+> 创建日期：2026-07-28  
+> 当前阶段：范围规划与大任务拆分  
+> 总体状态：待确认  
+> 规划依据：`三期开发规划.md`  
+> 维护方式：参考一期进度表，采用“总体大任务 → 详细任务 → 里程碑 → 未确认事项 → 开工准入 → 验收”的结构。
+
+## 一、三期目标
+
+三期承接二期到仓、实测、差异处理、处理单元编码和当前位置记录，完成智能排柜、订舱、拖车预约、PDA 拣货、柜封拍照、报关协同、港务信息查询和国内出仓闭环。
+
+当前验收基线为“完成国内出仓，等待装船”。在 P3-Q13 最终确认前，不把装船发运纳入三期完成条件。
+
+## 二、总体进度（大任务）
+
+| 大任务 ID | 大任务 | 范围 | 状态 | 进度 | 计划开始 | 计划完成 | 负责人 | 关键依赖/备注 |
+|---|---|---|---|---:|---|---|---|---|
+| T01 | 需求确认与原型 | 锁定阶段边界、流程依赖、排柜规则、设备、文件、报关和港务信息；完成页面原型 | 进行中 | 40% | 2026-07-28 | 待排期 | 待分配 | 已盘点 `docs/悦` 三期相关原型；后台有较完整参考，客户端三期页面和 PDA 柜封拍照仍待补 |
+| 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 |
+| T09 | 报关资料与回执 | 客户上传、后台审核补件、提交代理、回执上传和客户下载 | 待确认 | 0% | 待排期 | 待排期 | 待分配 | 依赖文件能力、P3-Q7、P3-Q8、P3-Q12 |
+| T10 | 国内出仓门禁 | 必要条件校验、确认出仓、阻塞、通知、冲正和审计 | 待确认 | 0% | 待排期 | 待排期 | 待分配 | 依赖 T05～T09、P3-Q10～P3-Q13 |
+| T11 | 客户端出仓协同 | 出仓进度、柜次、回执、预计开船/到港和变更时间线 | 待确认 | 0% | 待排期 | 待排期 | 待分配 | 依赖 T05、T09、T10；客户可见范围 |
+| T12 | 联调测试与发布 | 跨端联调、自动化测试、PDA 真机、安全、弱网、迁移、验收和发布 | 待开始 | 0% | 待排期 | 待排期 | 待分配 | 依赖 T02～T11 完成 |
+
+## 三、详细任务表
+
+详细任务按大任务逐项拆分。当前先建立任务骨架；每次拆分一个大任务，确认交付内容、优先级和依赖后再进入开发。
+
+| ID | 大任务 | 端 | 模块 | 功能/交付内容 | 优先级 | 状态 | 进度 | 依赖 | 负责人 | 备注 |
+|---|---|---|---|---|---|---|---:|---|---|---|
+| 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-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-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-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-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-T08-PROTO-01 | T08 | 后台 | 装柜证据原型核验 | 映射货柜列表、预装清单、装柜清单、柜号、单证、船期和装柜明细 | P0 | 已完成 | 100% | P3-T01-PROTO-01 | 待分配 | 后台参考较完整，但现场拍照上传原型缺失 |
+| P3-T08-PROTO-02 | T08 | PDA | 柜封拍照原型 | 新增柜次确认、货柜/铅封拍照、照片类型、预览、重试和提交页面原型 | P0 | 待开始 | 0% | P3-Q4、P3-Q6 | 待分配 | `docs/悦` 暂无对应原型 |
+| 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 | 待分配 | 现有客户端原型未覆盖三期专用页面 |
+
+## 四、原型对照与开发影响
+
+| 大任务 | `docs/悦` 现有原型 | 覆盖判断 | 开发处理 |
+|---|---|---|---|
+| T03 出仓单与柜次 | 通用 WMS 出库单、货柜列表、装柜清单 | 部分参考 | 保留列表、状态和明细交互，按国内出仓业务重新定义对象和门禁 |
+| T04 智能排柜 | 入库单列表中的“智能装柜”弹窗 | 已有参考 | 复用线路、筛选、锁定、分柜和拖放交互，按 P3-Q1 裁剪规则 |
+| T05 订舱与港务信息 | 订舱列表、新增/详情、放舱、货柜船期字段 | 已有参考 | 复用订舱字段和页面结构，确认港务信息范围及来源后裁剪 |
+| T06 拖车预约 | 拖车列表、新增拖车 | 已有参考 | 复用车辆司机和费用字段，补预约时间窗、到仓及离仓节点 |
+| T07 PDA 拣货与复核 | 通用 WMS 出库、PDA 集装箱拣货 | 已有参考 | 保留 PDA 交互，重做真实任务、权限、幂等、弱网和后台复核 |
+| T08 装柜及柜封证据 | 货柜列表、预装清单、装柜清单 | 部分参考 | 后台页面裁剪复用；PDA 货柜/铅封拍照页面新建 |
+| T09 报关资料与回执 | 报关单列表、单证管理、装柜清单附件 | 部分参考 | 后台裁剪复用；客户上传、补件和回执下载页面新建 |
+| T10 国内出仓门禁 | 分散的出库状态、国内报关成功和放行资料 | 部分参考 | 新建统一门禁检查和确认出仓页面，避免直接照搬“已放行”规则 |
+| T11 客户端出仓协同 | 头程下单客户端只有船期字段和出仓时间展示 | 覆盖不足 | 新建三期客户端出仓进度、报关和港务信息页面 |
+
+> `货代SaaS平台原型.html` 是全量平台参考原型，其中海外仓、完整 WMS、费用和清关能力不自动纳入三期；所有复用项仍需经过三期范围裁剪。
+
+## 五、建议拆分模板
+
+每个大任务按照同一顺序拆成可开发、可验收的小任务：
+
+1. `RULE`：业务规则、状态、权限和异常。
+2. `DATA`：数据表、字段、快照、版本和审计。
+3. `API`：接口、鉴权、幂等、并发和错误码。
+4. `ADM` / `CLI` / `PDA`：各端页面与交互。
+5. `TEST`：单元、接口、端到端、权限和边界测试。
+6. `ACCEPT`：业务验收、证据和遗留问题。
+
+例如 T04 智能排柜后续可使用 `P3-T04-RULE-01`、`P3-T04-DATA-01`、`P3-T04-API-01`、`P3-T04-ADM-01`、`P3-T04-TEST-01` 编号。
+
+## 六、建议里程碑
+
+| 里程碑 | 交付目标 | 状态 | 计划完成 |
+|---|---|---|---|
+| P3-M0 需求与原型锁定 | 阶段边界、流程、规则、设备、文件和页面原型确认 | 待确认 | 待排期 |
+| P3-M1 公共契约 | 二三期输入、状态、权限、数据模型和接口契约稳定 | 待排期 | 待排期 |
+| P3-M2 出仓编排 | 出仓单、排柜、订舱、港务和拖车可用 | 待排期 | 待排期 |
+| P3-M3 仓内出仓 | PDA 拣货、复核、装柜和柜封证据闭环 | 待排期 | 待排期 |
+| P3-M4 报关协同 | 客户资料、后台审核、提交代理、回执上传下载闭环 | 待排期 | 待排期 |
+| P3-M5 国内出仓 | 门禁满足后可确认出仓并进入当前约定终点 | 待排期 | 待排期 |
+| P3-M6 三期上线 | 联调、真机、安全、测试、验收和生产发布完成 | 待排期 | 待排期 |
+
+## 七、未确认事项（需求确认进度）
+
+当前共 13 项待确认事项，其中 7 项为开工阻断、5 项为模块阻断、1 项为非阻断。完整建议、负责人、计划确认日期和最终结论统一维护在 [三期需求确认表](三期需求确认表.md)；开工阻断项未确认前，受影响的大任务保持“待确认”。
+
+| 编号 | 阻断级别 | 待确认事项 | 状态 | 主要影响 |
+|---|---|---|---|---|
+| P3-Q1 | 开工阻断 | 智能排柜的硬约束和软偏好 | 待确认 | T04 智能排柜、T07 拣货任务 |
+| P3-Q2 | 开工阻断 | 是否支持拼柜、一单多柜和拆批出仓 | 待确认 | T03 出仓单与柜次、T04 智能排柜 |
+| P3-Q3 | 非阻断 | “预约托车”是否统一为“预约拖车” | 待确认 | T06 拖车预约、页面与接口文案 |
+| P3-Q4 | 模块阻断 | PDA 型号、系统和扫描头接入方式 | 待确认 | T07 PDA 拣货、T08 柜封拍照、真机验收 |
+| P3-Q5 | 开工阻断 | 拣货是否依赖实时库存和库位可用量 | 待确认 | T02 二三期契约、T07 PDA 拣货 |
+| P3-Q6 | 模块阻断 | 柜封照片必传类型、角度、数量和留存期限 | 待确认 | T08 装柜证据、T10 出仓门禁 |
+| P3-Q7 | 模块阻断 | 报关资料清单是否按国家、渠道和货物类型变化 | 待确认 | T09 报关资料、文件版本 |
+| P3-Q8 | 模块阻断 | 报关代理接收资料和返回回执的方式 | 待确认 | T09 报关协同、回执上传 |
+| P3-Q9 | 开工阻断 | 港务信息的业务含义、字段和维护方 | 待确认 | T05 订舱港务、T11 客户端展示 |
+| P3-Q10 | 模块阻断 | 确认出仓后的错误处理和冲正方式 | 待确认 | T10 出仓门禁、权限和审计 |
+| P3-Q11 | 开工阻断 | 九个动作的强制前置和并行关系 | 待确认 | T03～T10 全流程和状态机 |
+| P3-Q12 | 开工阻断 | 报关回执类型及海关放行是否为出仓硬门禁 | 待确认 | T09 报关状态、T10 出仓门禁 |
+| P3-Q13 | 开工阻断 | 三期终点是等待装船还是装船发运 | 待确认 | 阶段边界、状态、里程碑和验收 |
+
+## 八、开工准入清单
+
+产品和业务完成需求确认后，先进入“开工准备”；以下准入项全部通过后，三期才能从范围规划正式切换到全面开发。
+
+| 准入编号 | 准入条件 | 当前状态 | 责任方 | 完成证据 |
+|---|---|---|---|---|
+| P3-GO-01 | P3-Q1～P3-Q13 均形成明确结论，7 项开工阻断全部解除 | 进行中 | 产品、业务 | `三期需求确认表.md` 状态均为已确认并填写最终结论 |
+| P3-GO-02 | 确认结论已同步开发规划、进度表、页面清单和验收范围 | 待开始 | 产品、项目负责人 | 四份文档口径一致，无未标注的候选规则 |
+| 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 结论 |
+
+准入口径：`P3-GO-01` 完成后可以进入 T02 契约设计和详细任务拆分；`P3-GO-01～P3-GO-06` 全部通过后，才进入全面功能开发。
+
+## 九、状态维护规则
+
+- 状态统一使用：待确认、待开始、进行中、联调中、测试中、已完成、已阻塞。
+- 进度填写 `0%～100%`；只有开发、测试和业务验收均完成后才能填写 `100%`。
+- 开始开发时填写负责人、计划开始和计划完成日期。
+- 出现阻塞时在备注中填写阻塞原因、责任人和预计解除时间。
+- 大任务进度应由其详细任务加权汇总；当前骨架阶段先人工维护，拆分完成后再确定权重。
+
+## 十、下一步拆分顺序
+
+1. 先处理 T01，逐项确认 P3-Q1～P3-Q13，并补齐关键页面原型。
+2. 拆 T02 公共契约与数据模型，固定二期输入和三期核心对象。
+3. 按业务顺序拆 T03～T10，每个模块补齐规则、数据、接口、页面和测试。
+4. 拆 T11 客户端可视范围和交互。
+5. 最后拆 T12 联调、真机、验收和发布任务。

三期/三期需求确认表.md

@@ -0,0 +1,69 @@
+# 虫虫出海三期需求确认表
+
+> 创建日期：2026-07-28  
+> 当前状态：确认中  
+> 用途：记录会影响三期范围、流程、数据模型、页面和验收的产品决策。
+
+## 一、维护规则
+
+- 状态统一使用：待确认、确认中、已确认、已取消。
+- 阻断级别统一使用：开工阻断、模块阻断、非阻断。
+- 结论确认后同步更新 `三期开发规划.md`、`三期开发进度表.md` 和受影响的页面原型。
+- 未确认事项只能作为候选方案，不能直接写成固定开发或验收承诺。
+
+## 二、确认事项
+
+| 编号 | 决策/问题 | 当前建议 | 阻断级别 | 状态 | 负责人 | 计划确认 | 最终结论 | 影响模块 |
+|---|---|---|---|---|---|---|---|---|
+| P3-Q1 | 智能排柜需考虑哪些硬约束和软偏好？ | 业务提供可执行规则表，建议可解释并由人工确认 | 开工阻断 | 待确认 | 待分配 | 待排期 | - | 智能排柜、拣货任务 |
+| P3-Q2 | 是否存在拼柜、一单多柜和拆批出仓？ | 数据模型预留能力，页面按高频场景逐步开放 | 开工阻断 | 待确认 | 待分配 | 待排期 | - | 出仓单、柜次、排柜、拣货 |
+| P3-Q3 | 原型“预约托车”是否统一为“预约拖车”？ | 建议使用行业常用的“拖车”，同时确认业务实际含义 | 非阻断 | 待确认 | 待分配 | 待排期 | - | 页面文案、接口字段说明 |
+| P3-Q4 | 目标 PDA 型号、系统和扫描头接入方式是什么？ | 确认前保持设备适配层，不绑定厂商 SDK | 模块阻断 | 待确认 | 待分配 | 待排期 | - | PDA 拣货、真机验收 |
+| P3-Q5 | 拣货是否依赖实时库存和库位可用量？ | 默认使用二期处理单元和当前位置；如需完整库存，单独评估 WMS 范围 | 开工阻断 | 待确认 | 待分配 | 待排期 | - | 二三期契约、拣货、库存边界 |
+| P3-Q6 | 柜封照片有哪些必传类型、角度、数量和留存期限？ | 使用可配置清单，由仓库、业务和合规共同确认 | 模块阻断 | 待确认 | 待分配 | 待排期 | - | 装柜、PDA 拍照、文件存储、出仓门禁 |
+| P3-Q7 | 报关资料清单是否按国家、渠道和货物类型变化？ | 清单配置化，并保存业务使用的清单版本 | 模块阻断 | 待确认 | 待分配 | 待排期 | - | 客户资料、报关审核、文件版本 |
+| P3-Q8 | 报关代理如何接收资料并返回回执？ | 首版系统内整理、线下提交，正式接口后续评估 | 模块阻断 | 待确认 | 待分配 | 待排期 | - | 报关协同、回执上传 |
+| P3-Q9 | “港务信息”指船期、港口作业状态还是两者，包含哪些字段，由谁维护？ | 先确认词义和字段；首版平台人工维护并审计 | 开工阻断 | 待确认 | 待分配 | 待排期 | - | 订舱、港务查询、客户展示 |
+| P3-Q10 | 确认出仓后发现错误如何处理？ | 不直接回退状态，使用授权冲正和反向审计事件 | 模块阻断 | 待确认 | 待分配 | 待排期 | - | 出仓门禁、权限、审计 |
+| P3-Q11 | 九个动作中哪些是强制前置，哪些允许并行？ | 确认前按原型编号顺序规划 | 开工阻断 | 待确认 | 待分配 | 待排期 | - | 全流程、状态机、页面进度 |
+| P3-Q12 | 报关回执包含哪些类型，海关放行是否为国内出仓硬门禁？ | 当前不默认以放行为门禁，业务明确各类回执含义 | 开工阻断 | 待确认 | 待分配 | 待排期 | - | 报关状态、出仓门禁、客户回执 |
+| P3-Q13 | 三期终点以“等待装船”还是“装船发运”为准？ | 当前以“完成国内出仓，等待装船”为基线 | 开工阻断 | 待确认 | 待分配 | 待排期 | - | 阶段边界、状态、里程碑、验收 |
+
+## 三、建议确认顺序
+
+1. 先确认 P3-Q13、P3-Q11，锁定阶段终点和流程依赖。
+2. 再确认 P3-Q1、P3-Q2、P3-Q5，锁定排柜、柜次和拣货输入。
+3. 然后确认 P3-Q12、P3-Q7、P3-Q8，锁定报关和出仓门禁。
+4. 最后确认设备、照片、港务信息、冲正和文案事项。
+
+## 四、产品与业务确认会议
+
+### 4.1 参会角色
+
+- 产品负责人：逐项说明问题、候选方案和影响范围，维护最终结论。
+- 业务负责人：确认流程、规则、例外、责任边界和客户可见范围。
+- 仓库/运营代表：确认现场作业、PDA、照片、拖车、装柜和冲正可执行性。
+- 研发与测试代表：识别数据、接口、设备、权限和验收风险，不代替业务作决定。
+
+### 4.2 会议输入
+
+- 本确认表中的 P3-Q1～P3-Q13。
+- `三期开发规划.md` 的流程、状态、里程碑和任务骨架。
+- `三期页面与原型清单.md` 中已有参考原型和待补页面。
+- 二期输出契约、目标 PDA 信息、文件存储能力及报关/港务协作现状。
+
+### 4.3 每项确认要求
+
+1. 必须填写负责人、计划确认日期和可执行的最终结论，不能只记录“按建议处理”。
+2. 最终结论需明确正常流程、异常/冲正、权限责任和验收口径。
+3. 暂缓事项必须写明本期是否排除、临时方案、影响模块和再次确认日期。
+4. 开工阻断项未解除时，不得将受影响模块标记为可开发。
+5. 会议结束后，将结论同步到开发规划、开发进度表、页面原型和后续验收任务。
+
+### 4.4 会议输出
+
+- 13 项确认事项的状态和最终结论。
+- 需要新增或调整的原型清单。
+- 三期范围内/范围外清单及跨期依赖。
+- 仍有风险的事项、责任人和完成日期。
+- 是否允许进入 T02 契约设计与任务拆分的明确结论。

三期/三期页面与原型清单.md

@@ -0,0 +1,55 @@
+# 虫虫出海三期页面与原型清单
+
+> 创建日期：2026-07-28  
+> 当前状态：页面盘点中  
+> 原型依据：`参考资料/出仓流程.png`、现有 PDA 拣货原型
+
+## 一、维护规则
+
+- 页面状态统一使用：待确认、待原型、原型中、待评审、已确认、开发中、已完成。
+- 页面只有在业务流程、角色权限和关键字段确认后才能标记“已确认”。
+- 页面原型至少覆盖正常态、空态、加载态、失败态、无权限态和关键冲突态。
+- 当前先列页面级大项，后续按开发进度表的大任务逐项拆交互、字段和验收。
+
+## 二、管理后台
+
+| 页面 ID | 页面/入口 | 主要能力 | 对应大任务 | 原型状态 | 依赖确认项 | 备注 |
+|---|---|---|---|---|---|---|
+| P3-ADM-01 | 出仓单列表 | 查询、筛选、创建、异常和状态展示 | T03 出仓单与柜次 | 部分参考原型 | P3-Q2、P3-Q11 | 可参考通用 WMS 出库单，但需重定义国内出仓对象 |
+| P3-ADM-02 | 出仓单详情 | 柜次、任务、证据、报关和时间线 | T03 出仓单与柜次 | 部分参考原型 | P3-Q11、P3-Q13 | 可组合参考货柜列表和装柜清单，缺统一详情页 |
+| 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-09 | 报关协同 | 资料审核、补件、提交批次和回执上传 | T09 报关资料与回执 | 部分参考原型 | P3-Q7、P3-Q8、P3-Q12 | 已有报关单和单证管理，缺客户补件协同闭环 |
+| P3-ADM-10 | 国内出仓确认 | 门禁检查、确认、阻塞和冲正 | T10 国内出仓门禁 | 待原型 | P3-Q10、P3-Q11、P3-Q12、P3-Q13 | 现有状态分散，无统一门禁确认页 |
+
+## 三、企业客户端
+
+| 页面 ID | 页面/入口 | 主要能力 | 对应大任务 | 原型状态 | 依赖确认项 | 备注 |
+|---|---|---|---|---|---|---|
+| P3-CLI-01 | 出仓进度列表 | 查看本企业出仓单、柜次和当前节点 | T11 客户端出仓协同 | 待原型 | P3-Q11、P3-Q13 | 现有客户端未覆盖三期专用页面 |
+| 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-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/悦` 中暂无对应页面，属于明确原型缺口 |
+
+## 五、下一步拆分顺序
+
+1. 先补 P3-ADM-01、P3-ADM-02，确定三期后台信息架构。
+2. 根据 P3-Q1 结论补 P3-ADM-03 智能排柜原型。
+3. 根据 P3-Q5 复核现有 PDA 拣货原型并补真实状态。
+4. 根据 P3-Q6 优先补 P3-PDA-05 柜封拍照上传原型。
+5. 报关和港务规则确认后，再补客户端及对应后台页面。