柏悦物流海外版 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、国内任务状态和国内本地草稿。
• 当前业务页面是可运行的静态原型，明确提示“业务接口待接入”，不会模拟海外服务提交成功。