柏悦物流海外版 PDA

独立的 uni-app Vue 3 工程，面向海外仓现场人员。工程不依赖国内 PDA 源码或仓库外共享目录，可独立安装依赖、运行、编译和发布。

首版工作台按四期边界提供真实入仓作业，以及库内作业、换标作业和现场查询原型。登录使用国内 Auth 统一签发的双 Token；海外入仓请求统一经 gateway-overseas，不得请求国内 Firstleg/Warehouse 业务接口。

本地运行与检查

Node.js 22 环境：

npm install
npm test
npm run dev:h5

生产编译：

npm run build:h5
npm run build:app

• build:h5 生成 H5 发布文件；
• build:app 生成 App 离线打包资源；
• 生成可安装 APK/IPA 需使用 HBuilderX App 开发版执行云打包或配置原生离线打包环境。

正式 App 打包前必填

1. 使用海外版所属的 DCloud 账号为本应用获取独立 AppID，写入 src/manifest.json 的 appid；不得复用国内版 AppID。
2. 确认 Android 包名 com.baiyuelogistics.pda.overseas，如公司已有正式命名规范，在首次正式签名前修改。
3. 配置海外版独立 Android 签名证书；证书、密码和账号信息不得提交仓库。
4. 复制 .env.example 为本机 .env.local，配置 Auth 与海外网关地址；环境文件不提交仓库。
5. 在目标海外 PDA 上验证扫描广播 Action=android.intent.action.SCANRESULT、Extra=value。

当前实现边界

• 已复用并内置：登录壳、PDA 样式、扫码广播、声音反馈、导航、网络检测、图标及 uni_modules。
• 已隔离：国内集装箱拣货、装柜证据、国内 Firstleg API、国内任务状态和国内本地草稿。
• 入仓页面已接任务、推送、托盘分配、清点、拣货、箱码扫描/移除、卸柜照片和完成入库的真实 API；错误会保留业务码、requestId 与 traceId。
• 库内、换标和现场查询仍是可运行的静态原型，不会模拟海外服务提交成功。
• 本地契约测试与 H5/App 资源编译不等于真实开发环境 HTTP 或 PDA 真机验收。