diff --git a/三期/README.md b/三期/README.md index 54bc436..64156a1 100644 --- a/三期/README.md +++ b/三期/README.md @@ -17,6 +17,7 @@ - [三期开发进度表](三期开发进度表.md)：参考一期采用“大任务 → 详细任务 → 里程碑 → 未确认事项 → 开工准入 → 验收”结构维护。 - [虫虫出海三期开发进度表（Excel）](虫虫出海三期开发进度表.xlsx)：可筛选、可下拉维护并使用公式汇总的项目进度工作簿。 - [三期需求确认表](三期需求确认表.md)：集中跟踪 P3-Q1～P3-Q13、负责人和最终结论。 +- [三期开工门禁](三期开工门禁.md)：维护已确认范围、跨端硬边界和局部阻断项；模块指引引用本文件，不重复维护阶段状态。 - [三期页面与原型清单](三期页面与原型清单.md)：按管理后台、企业客户端和 PDA 维护页面范围及原型状态。 - [三期验收任务拆分与待确认清单](三期验收任务拆分与待确认清单.md)：真实 HTTP/真机验收覆盖、coverageGap 解除条件和并行任务入口。 - `参考资料/出仓流程.png`：本期 9 个核心动作及业务终点的原始参考图。 @@ -27,11 +28,11 @@ 船期首版按船公司官网查询，每 3 天一次、最多 3 次，记录来源、查询/更新时间和过期标识。首批来源为美森、SML、ZIM、COSCO、EMC、合德；外部页面不可用时保留最近结果并标记过期。报关首版不做系统对接，全部由人工整理、线下提交和人工上传回执。仓库初始化角色包括操作员、拣货员、理货员，具体权限矩阵由 IAM 契约任务落表。 -当前仅 P3-Q4 的设备型号、Android 版本、打包发布和真机验收仍需技术澄清；P3-Q5 已确认复用二期实时库存、当前位置和可用量接口，不扩展完整 WMS。设备问题只阻断真机验收，不影响已确认模块进入契约设计和并行开发。 +P3-Q1～P3-Q13 均已确认；P3-Q4 采用 uni-app 开发并支持在线更新，Android 广播扫描已接入。P3-Q5 复用二期实时库存、当前位置和可用量接口，不扩展完整 WMS。 ### PDA 当前确认口径（2026-08-10） -- Android 扫描广播方式已接入；具体设备型号、系统版本、打包发布和真机验收仍待确认。 +- Android 扫描广播方式已接入；PDA 采用 uni-app 开发并支持在线更新，按既定发布安排完成真机验收。 - 正式作业仅支持在线：进入任务即标记“拣货中”，扫描保存在绑定作业员+任务+柜次的设备持久化草稿，点击提交时批量写后端。 - 允许部分拣货或跳拣，但每个未完成项必须填写异常原因；存在未解决异常时不能完成或进入 `LOADED`。 - 重复提交返回原结果，版本冲突提示员工刷新重试。 diff --git a/三期/三期开发进度表.md b/三期/三期开发进度表.md index 7a84f25..42eb775 100644 --- a/三期/三期开发进度表.md +++ b/三期/三期开发进度表.md @@ -16,7 +16,7 @@ | 大任务 ID | 大任务 | 范围 | 状态 | 进度 | 计划开始 | 计划完成 | 负责人 | 关键依赖/备注 | |---|---|---|---|---:|---|---|---|---| -| T01 | 需求确认与原型 | 锁定阶段边界、流程依赖、排柜规则、设备、文件、报关和港务信息；完成页面原型 | 已完成 | 100% | 2026-07-28 | 2026-08-10 | 总控 | 产品确认版已同步；仅保留设备与真机技术澄清 | +| T01 | 需求确认与原型 | 锁定阶段边界、流程依赖、排柜规则、设备、文件、报关和港务信息；完成页面原型 | 已完成 | 100% | 2026-07-28 | 2026-08-10 | 总控 | 产品确认版已同步；PDA 采用 uni-app、在线更新和 Android 广播扫描 | | T02 | 公共契约与数据模型 | 主/子状态、权限、事件、错误码、订单三期投影、柜次、任务、证据、报关和审计模型 | 进行中 | 10% | 2026-08-10 | 待排期 | 待分配 | 已确认父子订单、硬门禁和仓库角色；依赖二期输出契约 | | T03 | 订单三期编排与柜次 | 增强现有订单列表/详情，建立父子订单-柜次关系、拆分/拼柜和时间线 | 待开始 | 0% | 待排期 | 待排期 | 待分配 | 不新建出仓单；一单多柜、拼柜和未装数量自动生成子订单 | | T04 | 智能排柜 | 排柜规则、系统建议、冲突、人工确认和追溯 | 待开始 | 0% | 待排期 | 待排期 | 待分配 | 装载率上限 110%；税率排序可配置 | @@ -35,13 +35,13 @@ | ID | 大任务 | 端 | 模块 | 功能/交付内容 | 优先级 | 状态 | 进度 | 依赖 | 负责人 | 备注 | |---|---|---|---|---|---|---|---:|---|---|---| -| P3-T01-00 | T01 | 公共 | 需求确认与原型 | 完成需求确认表、页面清单和原型评审，锁定开工阻断项 | P0 | 已完成 | 100% | - | 总控 | 已同步产品确认版；只剩设备和真机技术澄清 | +| P3-T01-00 | T01 | 公共 | 需求确认与原型 | 完成需求确认表、页面清单和原型评审，锁定开工阻断项 | P0 | 已完成 | 100% | - | 总控 | 已同步产品确认版；PDA 技术路线已确认 | | P3-T02-00 | T02 | 公共 | 公共契约与数据模型 | 拆状态、权限、数据模型、接口和审计；初始化操作员/拣货员/理货员角色 | P0 | 进行中 | 10% | P3-T01-00 | 待分配 | 统一固化父子订单、柜次、硬门禁和人工报关 | | P3-T03-00 | T03 | 后台/服务端 | 订单三期编排与柜次 | 实现父订单→子订单→柜次、一单多柜、拼柜、未装数量自动子订单和时间线 | P0 | 待开始 | 0% | P3-T02-00 | 待分配 | 复用现有订单，不创建独立出仓单 | | P3-T04-00 | T04 | 后台/服务端 | 智能排柜 | 实现 110% 装载率上限、可配置税率排序、人工确认和版本追溯 | P0 | 待开始 | 0% | P3-T03-00 | 待分配 | - | | P3-T05-00 | T05 | 后台/服务端 | 订舱与港务信息 | 订舱状态及六家船公司查询、三日周期、三次上限、过期标识 | P0 | 待开始 | 0% | P3-T03-00 | 待分配 | - | | P3-T06-00 | T06 | 后台/服务端 | 拖车预约 | 服务商、车辆司机、时间窗、到离仓和异常；完成状态供门禁校验 | P0 | 待开始 | 0% | P3-T03-00 | 待分配 | - | -| P3-T07-00 | T07 | PDA/后台/服务端 | PDA 拣货与复核 | 按单柜次单作业员实现在线草稿、批量提交、异常、幂等和实时库存校验 | P0 | 待开始 | 0% | P3-T04-00 | 待分配 | 设备型号和真机发布口径单独澄清 | +| P3-T07-00 | T07 | PDA/后台/服务端 | PDA 拣货与复核 | 按单柜次单作业员实现在线草稿、批量提交、异常、幂等和实时库存校验 | P0 | 待开始 | 0% | P3-T04-00 | 待分配 | 采用 uni-app 开发、在线更新和 Android 广播扫描 | | P3-T08-00 | T08 | PDA/后台/服务端 | 装柜及柜封证据 | 实现五类多图追加、角色上传、作废和无限期留存，客户不可见 | P0 | 待开始 | 0% | P3-T07-00 | 待分配 | - | | P3-T09-00 | T09 | 客户端/后台/服务端 | 报关资料与回执 | 实现人工清单、补件、线下提交记录、人工放行回执上传 | P0 | 待开始 | 0% | P3-T02-00 | 待分配 | - | | P3-T10-00 | T10 | 后台/服务端 | 装柜完成门禁 | 实现订舱/拖车/放行/PDA/证据硬门禁并推进 `LOADED` | P0 | 待开始 | 0% | P3-T07-00、P3-T08-00、P3-T09-00 | 待分配 | `LOADED` 后只线下人工处理 | @@ -54,7 +54,7 @@ | 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 | 待分配 | 已确认在线作业、进入即开始、持久化草稿和批量提交；真实任务、鉴权与契约仍需完成 | | P3-T08-PROTO-01 | T08 | 后台 | 装柜证据原型核验 | 映射货柜列表、预装清单、装柜清单、柜号、单证、船期和装柜明细 | P0 | 已完成 | 100% | P3-T01-PROTO-01 | 待分配 | 后台参考较完整，但现场拍照上传原型缺失 | -| P3-T08-PROTO-02 | T08 | PDA | 装柜拍照原型 | 新增柜次确认、五类证据多图追加、锁码文本、预览、重试、作废和提交页面原型 | P0 | 待开始 | 0% | P3-Q4、P3-Q6 | 待分配 | PDA 仅拍照、Admin 可上传、每类至少一张和错图作废已确认 | +| P3-T08-PROTO-02 | T08 | PDA | 装柜拍照原型 | 新增柜次确认、五类证据多图追加、锁码文本、预览、重试、作废和提交页面原型 | P0 | 待开始 | 0% | 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-Q12 | 待分配 | 不提供在线冲正，不需要独立门禁页面 | | P3-T11-PROTO-01 | T11 | 客户端 | 客户端三期原型 | 新增装柜进度、报关资料上传/补件、回执下载和港务/船期页面原型 | P0 | 待开始 | 0% | P3-Q7～P3-Q9、P3-Q12 | 待分配 | 现有客户端原型未覆盖三期专用页面 | @@ -102,7 +102,7 @@ ## 七、未确认事项（需求确认进度） -当前 13 项主确认事项中，P3-Q1～P3-Q3、P3-Q5～P3-Q13 已有产品最终结论；P3-Q4 仅剩设备型号、Android 版本、打包发布和真机验收技术澄清。完整结论统一维护在 [三期需求确认表](三期需求确认表.md)。 +当前 13 项主确认事项均已有产品最终结论；P3-Q4 已确认采用 uni-app、在线更新与 Android 广播扫描。完整结论统一维护在 [三期需求确认表](三期需求确认表.md)。 验收拆分已建立：PDA 进入任务、拣货幂等/版本冲突、五类证据真实上传、多图追加和锁码门禁进入自动化；真机在线、设备草稿批量提交、证据作废、设备与权限留存等仍保留 coverageGap，详见[三期验收任务拆分与待确认清单](三期验收任务拆分与待确认清单.md)。 @@ -111,7 +111,7 @@ | P3-Q1 | 开工阻断 | 智能排柜的硬约束和软偏好 | 已确认 | T04 智能排柜、T07 拣货任务 | | P3-Q2 | 开工阻断 | 是否支持拼柜、一单多柜和拆批装柜 | 已确认 | T03 订单三期编排与柜次、T04 智能排柜 | | P3-Q3 | 非阻断 | “预约托车”是否统一为“预约拖车” | 已确认 | T06 拖车预约、页面与接口文案 | -| P3-Q4 | 模块阻断 | PDA 型号、系统和扫描头接入方式 | 确认中 | 广播模式已接入；设备型号、Android 版本、发布和真机验收待确认 | +| P3-Q4 | 非阻断 | PDA 开发、扫描与发布方式 | 已确认 | 采用 uni-app 开发并支持在线更新；Android 广播模式已接入，设备型号不构成门禁 | | P3-Q5 | 开工阻断 | 拣货是否依赖实时库存和库位可用量 | 已确认 | 复用二期实时库存、当前位置和可用量接口；不扩展完整 WMS | | P3-Q6 | 模块阻断 | 装柜照片和锁码规则 | 已确认 | 五类多图、角色上传、无限期保留、客户不可见 | | P3-Q7 | 模块阻断 | 报关资料清单是否按国家、渠道和货物类型变化 | 已确认 | T09 报关资料、文件版本 | @@ -128,7 +128,7 @@ | 准入编号 | 准入条件 | 当前状态 | 责任方 | 完成证据 | |---|---|---|---|---| -| P3-GO-01 | P3-Q1～P3-Q3、P3-Q5～P3-Q13 均形成产品结论；P3-Q4 仅剩设备技术澄清 | 已完成 | 产品、业务 | `三期需求确认表.md` 已同步最终结论 | +| P3-GO-01 | P3-Q1～P3-Q13 均形成产品结论 | 已完成 | 产品、业务 | `三期需求确认表.md` 已同步最终结论 | | P3-GO-02 | 确认结论已同步开发规划、进度表、页面清单和验收范围 | 进行中 | 产品、项目负责人 | 本轮已同步四份文档，后续随契约实现更新 | | P3-GO-03 | 关键缺失原型已补齐并评审，包括订单装柜完成门禁、客户端三期页面和 PDA 五类多图拍照 | 进行中 | 产品、设计、业务 | 页面清单中的关键页面达到已确认状态 | | P3-GO-04 | T02 公共契约完成，二期输入、状态机、权限、数据模型、接口、错误码和审计口径稳定 | 待开始 | 前后端、架构/技术负责人 | 契约评审记录及稳定的数据/API 定义 | diff --git a/三期/三期开工门禁.md b/三期/三期开工门禁.md new file mode 100644 index 0000000..d227a9f --- /dev/null +++ b/三期/三期开工门禁.md @@ -0,0 +1,29 @@ +# 三期开工门禁 + +> 本文维护三期跨端开发的稳定门禁。实时任务进度见 `三期开发进度表.md`；产品决策以 `三期需求确认表.md` 为准。 + +## 可直接开展的范围 + +- 已确认规则可进入契约、数据、接口、页面和测试拆分，不需要等待整期所有模块完成。 +- 订单继续承载三期主状态，不新建独立出仓单；支持父订单、子订单与柜次关系，以及一单多柜和多订单拼柜。 +- 智能排柜、订舱与船期、拖车预约、PDA 在线拣货、五类装柜证据、人工报关回执和 `LOADED` 服务端门禁按需求确认表执行。 +- 三期国内终点为 `LOADED`；`DELIVERED` 只由海外仓可信回传推进。 + +## 跨端硬边界 + +- `LOADED` 前必须由服务端校验订舱完成、拖车完成、有效报关放行回执、PDA 拣货完成和五类有效证据完整；国内 Admin/PDA 不提供在线冲正或手工推进 `DELIVERED`。 +- PDA 正式作业仅在线；单柜次只允许一名作业员，不支持多人并行、任务接管或换班释放。进入任务即由服务端标记拣货中，扫描草稿按作业员、任务和柜次隔离，提交时批量写入。 +- 每类证据至少一张有效照片，允许同类型追加；错误照片只能作废并保留审计。客户不可见照片与锁码。 +- 前端页面、菜单和路由只能在对应服务端契约、权限和数据模型稳定后发布；原型中的完整 WMS、海外仓及未确认能力不属于三期默认范围。 + +## 局部阻断项 + +- PDA 采用 uni-app 开发并支持在线更新；Android 广播扫描已接入。设备型号不构成开发、发布或验收门禁；扫描适配保持厂商无关，按既定发布安排完成常规真机验收。 +- 未冻结的字段、权限码、错误码、迁移方案或跨服务调用，只阻断依赖它们的模块；不得以模拟成功或前端猜测替代服务端契约。 +- 修改任一跨服务契约时，必须同步检查生产者、调用方、OpenAPI、权限、迁移脚本和实际前端消费者。 + +## 使用方式 + +1. 先读 `README.md`、`三期需求确认表.md` 和本文件，确认任务属于已确认范围。 +2. 再进入目标应用或服务的 `AGENTS.md`，按本地模块入口实现。 +3. 发现新的产品决策或门禁变化时，先更新确认表与本文，再更新受影响模块指引；不要将短期进度、联调故障或环境地址写回模块规则。 diff --git a/三期/三期需求确认表.md b/三期/三期需求确认表.md index 4d65667..c2488ce 100644 --- a/三期/三期需求确认表.md +++ b/三期/三期需求确认表.md @@ -18,7 +18,7 @@ | P3-Q1 | 智能排柜需考虑哪些硬约束和软偏好？ | 业务提供可执行规则表，建议可解释并由人工确认 | 开工阻断 | 已确认 | 产品/业务 | 2026-08-10 | 装载率上限 110%；税率高排前暂作为可配置排序，不作为不可变硬编码；系统给出可解释建议，人工确认后生成任务 | 智能排柜、拣货任务 | | P3-Q2 | 是否存在拼柜、一单多柜和拆批出仓？ | 通过订单-柜次关系预留能力，页面按高频场景逐步开放 | 开工阻断 | 已确认 | 产品/业务 | 2026-08-10 | 支持一单多柜、一个柜拼多个订单；采用“父订单→子订单→柜次”关系。已装载数量形成子订单，未装载数量自动生成待后续处理的子订单；不新建独立出仓单 | 订单、柜次、排柜、拣货 | | P3-Q3 | 原型“预约托车”是否统一为“预约拖车”？ | 建议使用行业常用的“拖车”，同时确认业务实际含义 | 非阻断 | 已确认 | 产品/业务 | 2026-08-10 | 页面、接口和文档统一使用“预约拖车” | 页面文案、接口字段说明 | -| P3-Q4 | 目标 PDA 型号、系统和扫描头接入方式是什么？ | 保持设备适配层，不绑定厂商 SDK | 模块阻断 | 确认中 | 用户当前对话确认 | 2026-08-10 | 采用 uni-app 开发并支持在线更新；Android 广播方式已确认并已接入：Action=`android.intent.action.SCANRESULT`、字符串 Extra=`value`。具体 PDA 型号、Android 版本、打包发布流程和目标设备真机验收仍待技术确认 | PDA 拣货、真机验收 | +| P3-Q4 | PDA 开发、扫描与发布方式是什么？ | 保持设备适配层，不绑定厂商 SDK | 非阻断 | 已确认 | 用户当前对话确认 | 2026-08-10 | 采用 uni-app 开发并支持在线更新；Android 广播方式已接入：Action=`android.intent.action.SCANRESULT`、字符串 Extra=`value`。设备型号不构成开发、发布或验收门禁，扫描适配保持厂商无关 | PDA 拣货、在线更新、真机验收 | | P3-Q5 | 拣货是否依赖实时库存和库位可用量？ | 默认使用二期处理单元和当前位置；如需完整库存，单独评估 WMS 范围 | 开工阻断 | 已确认 | 产品/业务 | 2026-08-10 | PDA 拣货必须依赖实时库存和库位可用量；首版复用二期处理单元、当前位置和可用量接口，超量、库存不足和库位不可用由服务端拒绝；不扩展完整 WMS | 二三期契约、拣货、库存边界 | | P3-Q6 | 柜封照片有哪些必传类型、数量、采集方式、处理规则和留存期限？ | 五类证据、角色和留存按确认版直接进入契约 | 模块阻断 | 已确认 | 产品/业务 | 2026-08-10 | 空仓、半仓、满仓、锁仓、带锁码照五类各至少 1 张有效照片，同类型可无限追加；PDA 只能现场拍照；后台操作员和理货员可人工上传；拣货员只负责 PDA 现场采集，不开放后台人工上传；错图不硬删除，按原因、操作人、时间作废；带锁码照必须填写锁码文本；照片无限期保留，客户不可见照片和锁码 | 装柜、PDA 拍照、Admin 上传、文件存储、订单后程门禁 | | P3-Q7 | 报关资料清单是否按国家、渠道和货物类型变化？ | 清单配置化，并保存业务使用的清单版本 | 模块阻断 | 已确认 | 产品/业务 | 2026-08-10 | 首版不对接海关或代理系统；按人工维护资料清单、收集/补件并保存版本，具体清单可配置 | 客户资料、报关审核、文件版本 | @@ -58,7 +58,7 @@ ## 四、建议确认顺序 1. 已完成 P3-Q1～P3-Q3、P3-Q5～P3-Q13 的产品确认，可直接进入契约和实现拆分。 -2. P3-Q4 仅保留设备型号、Android 版本、打包发布和真机验收的技术确认。 +2. P3-Q4 已确认采用 uni-app、在线更新与 Android 广播扫描；后续按既定发布安排完成常规真机验收。 3. P3-Q5 已确认复用二期实时库存、当前位置和可用量接口，完整 WMS 不纳入三期。 ## 五、产品与业务确认会议 @@ -87,7 +87,7 @@ ### 5.4 会议输出（确认版） -- 13 项确认事项的状态和最终结论已同步；仅 P3-Q4 保留设备/真机技术澄清，不再阻断已确认模块的契约设计。 +- 13 项确认事项的状态和最终结论已同步；P3-Q4 已确认采用 uni-app、在线更新与 Android 广播扫描。 - 需要新增或调整的原型清单。 - 三期范围内/范围外清单及跨期依赖。 - 仍有风险的事项、责任人和完成日期。