优化

2026-08-10 12:46:16 +08:00
parent 3d5452d267
commit 60f1959bba
4 changed files with 12 additions and 13 deletions
@@ -226,7 +226,7 @@ PDA 拣货 → 装柜并上传货柜/铅封照片
 - 扫描保存在设备持久化草稿，点击提交时批量写后端；草稿绑定作业员、任务和柜次。
 - PDA 仅现场拍摄五类装柜照片，同类型可多张追加；确认关联信息后上传，并处理进度、失败重试和作废。
 - 在线作业、前后台切换、重复提交、版本冲突和异常退出清理；不支持换班接管，断网不允许正式作业或提交。
- Android 广播扫描已按 Action=`android.intent.action.SCANRESULT`、Extra=`value` 接入；真实设备型号、Android 版本、打包发布方式和真机验收仍待确认。
+- PDA 采用 uni-app 开发并支持在线更新；Android 广播扫描已按 Action=`android.intent.action.SCANRESULT`、Extra=`value` 接入，扫描适配保持厂商无关。

 ### 服务端 `baiyue-firstleg`

@@ -242,7 +242,7 @@ PDA 拣货 → 装柜并上传货柜/铅封照片
 | P3-M0 规则与设备锁定 | 流程、角色、状态、排柜规则、PDA、文件和验收确认 | 二期到仓契约稳定 |
 | P3-M1 订单与排柜 | 现有订单可进入待分柜，并按确认范围提供柜次建议、人工确认与追溯 | 排柜规则确认 |
 | P3-M2 订舱与拖车 | 订舱、船期、拖车预约和异常处理可用 | 服务商与权限可用 |
-| P3-M3 PDA 拣货 | 在线任务、持久化草稿、批量提交、差异、复核和幂等可用 | 目标设备和真机验收口径确认 |
+| P3-M3 PDA 拣货 | 在线任务、持久化草稿、批量提交、差异、复核和幂等可用 | 服务端任务与库存契约可用 |
 | P3-M4 装柜封柜 | 柜号、铅封和照片证据完整，门禁生效 | 文件能力与必传清单确认 |
 | P3-M5 报关协同 | 客户上传、平台审核、补件、提交和回执下载闭环 | 报关资料清单确认 |
 | P3-M6 装柜完成 | 订舱、拖车、放行回执、PDA 拣货、五类证据和锁码文本满足门禁后进入 `LOADED`/装柜完成 | 装柜完成硬门禁已确认 |
@@ -272,7 +272,7 @@ PDA 拣货 → 装柜并上传货柜/铅封照片
 | P3-OVERSEAS-01 | 服务端 | 海外仓派送完成回传 | 只接受海外仓可信回传，校验身份、签名、时间窗、防重放和幂等，推进 `DELIVERED` | P1/后续阶段 | 海外仓契约 |
 | P3-NOTIFY-01 | 公共 | 通知异常 | 站内通知、阻塞、责任人、时限和失败补偿 | P1 | 核心流程完成 |
 | P3-TEST-01 | 公共 | 自动化测试 | 权限、排柜、幂等、并发、文件、门禁和状态测试 | P0 | 所有 P0 模块 |
-| P3-DEVICE-01 | PDA | 真机验收 | 扫描头、弱网、性能、电量、前后台和发布验证 | P0 | 目标设备确认 |
+| P3-DEVICE-01 | PDA | 发布与真机验收 | 扫描头、弱网、性能、电量、前后台和在线更新验证 | P0 | 已确定的 uni-app 发布安排 |
 | P3-REL-01 | 公共 | 发布验收 | 初始化规则、迁移、联调、演练、灰度和生产发布 | P0 | P3-TEST-01、P3-DEVICE-01 |

 ## 十、测试与验收重点
@@ -299,7 +299,7 @@ PDA 拣货 → 装柜并上传货柜/铅封照片
 | P3-Q1 | 智能排柜需考虑哪些硬约束和软偏好？ | 已确认：装载率上限 110%；税率高排前做可配置排序，规则版本化 |
 | P3-Q2 | 是否存在拼柜、一单多柜和拆批出仓？ | 已确认：父订单→子订单→柜次；已装载/未装载数量自动形成子订单 |
 | P3-Q3 | “预约托车”是否统一为“预约拖车”？ | 已确认统一使用“预约拖车” |
-| P3-Q4 | 目标 PDA 型号、系统和扫描头接入方式是什么？ | 广播接入已确认并完成；设备型号、Android 版本、打包发布和真机验收仍待确认 |
+| P3-Q4 | PDA 开发、扫描与发布方式是什么？ | 已确认采用 uni-app 开发并支持在线更新；Android 广播接入已完成，设备型号不构成门禁 |
 | P3-Q5 | 拣货是否依赖实时库存和库位可用量？ | 已确认依赖二期实时库存、当前位置和可用量接口；不扩展完整 WMS |
 | P3-Q6 | 柜封照片有哪些必传角度和留存期限？ | 已确认：五类各至少 1 张、同类型可多张追加、后台操作员/理货员可上传、拣货员仅 PDA 现场采集、错图作废、无限期保留、客户不可见 |
 | P3-Q7 | 报关资料清单是否按国家、渠道和货物类型变化？ | 已确认首版人工维护清单和版本，不接自动报关 |
@@ -312,7 +312,7 @@ PDA 拣货 → 装柜并上传货柜/铅封照片

 ## 十二、建议实施顺序

-1. 固化已确认业务规则，仅对目标设备型号、Android 版本、打包发布和真机验收做技术澄清。
+1. 固化已确认业务规则，按 uni-app 在线更新安排推进 PDA 开发、发布和真机验收。
 2. 统一订单、柜次、订舱、拖车、拣货、报关和港务/船期信息的稳定编码与关联契约。
 3. 先实现服务端权限、状态、门禁、幂等、并发和审计，再接各端页面。
 4. 完成管理后台的出仓编排，再接 PDA 现场执行和客户资料协同。
@@ -42,7 +42,7 @@
 | 18 | 客户是否可以查看五类装柜照片和锁码？ | 建议客户可查看照片和锁码；如存在内部证据，应明确哪些照片仅平台可见 | 待确认 |
 | 19 | 同一柜次是否允许多人并行拣货？ | 待产品确认任务拆分、数量合并、重复扫描和责任归属；未确认前按单任务单作业员设计，但不固化为不可扩展模型 | 待确认 |
 | 20 | 退出任务或换班时是否释放任务？ | 明确任务占用、草稿保留、接管人和超时释放规则 | 待确认 |
-| 21 | 目标 PDA 型号、Android 版本和发布方式是什么？ | 广播协议已接入，仅补设备清单、真机验收和打包发布口径 | 待确认 |
+| 21 | PDA 开发、扫描与发布方式是什么？ | 已确认采用 uni-app 开发并支持在线更新；Android 广播协议已接入，设备型号不构成门禁 | 已确认 |
 | 22 | 批量提交超时或失败时如何提示和重试？ | 建议保留草稿，展示可理解错误；员工刷新后重试，重复提交由幂等键返回原结果 | 待确认 |

 ## 三、页面处理确认
@@ -22,7 +22,7 @@
 | 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-07 | 拣货任务与复核 | 分配、进度、差异、复核和异常 | T07 PDA 拣货与复核 | 部分参考原型 | P3-Q5 | 可参考通用 WMS 出库和 PDA 原型，缺三期真实任务页 |
 | 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 | 置于现有订单详情，不新增独立门禁页；不提供确认派送完成 |
@@ -41,11 +41,11 @@

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

 ## 五、下一步拆分顺序

@@ -22,15 +22,14 @@

 | 编号 | 待确认/待环境能力 | 保留原因 | 解除条件 |
 |---|---|---|---|
-| P3-PDA-D01 | PDA 断网、恢复网络和真机在线限制 | HTTP 验收器无法模拟设备网络与现场相机 | 目标 PDA 型号、Android 版本、网络策略和真机环境确定后执行真机脚本 |
+| P3-PDA-D01 | PDA 断网、恢复网络和真机在线限制 | HTTP 验收器无法模拟设备网络与现场相机 | 按既定 uni-app 发布安排在目标设备执行真机脚本 |
 | P3-PDA-D03/D04 | 设备持久化草稿、批量提交、跨账号隔离 | 当前公开服务未提供稳定的设备草稿/批量提交 HTTP 契约 | 固定草稿 DTO、提交端点、幂等键、版本字段和清理语义 |
-| P3-Q4 | 真机型号、系统、扫描头、打包发布 | 广播协议已接入，但具体设备和真机发布口径未提供 | 产品/技术补齐设备清单并完成真机验收 |

 ## 并行任务拆分

 1. `P3-ACCEPT-PDA-ONLINE`：PDA 真机在线/断网/前后台验收。
 2. `P3-ACCEPT-PDA-DRAFT`：草稿持久化、批量提交、幂等、版本冲突和跨账号隔离验收。
 3. `P3-ACCEPT-EVIDENCE-VOID`：五类证据多图追加、作废、锁码文本和 `LOADED` 门禁验收。
-4. `P3-CONFIRM-Q4`：技术补齐设备型号、Android 版本、打包发布和真机验收口径。
+4. `P3-ACCEPT-PDA-RELEASE`：按既定 uni-app 在线更新安排完成发布与真机验收。

 每个任务完成后，必须把真实请求、响应状态、业务码、`requestId/traceId` 写入报告，并删除对应 coverageGap；不得以 mock 或数据库直写替代接口验收。