初始化柏悦物流海外版 PDA

2026-08-20 20:10:20 +08:00
commit 02a187377d
377 changed files with 49737 additions and 0 deletions
@@ -0,0 +1,40 @@
+# 柏悦物流海外版 PDA
+
+独立的 uni-app Vue 3 工程，面向海外仓现场人员。工程不依赖国内 PDA 源码或仓库外共享目录，可独立安装依赖、运行、编译和发布。
+
+首版工作台按四期边界提供入仓作业、库内作业、换标作业和现场查询原型。登录使用国内 Auth 统一签发的账号与 Token；真实海外业务请求应统一经 `gateway-overseas`，不得请求国内 Firstleg/Warehouse 业务接口。
+
+## 本地运行与检查
+
+Node.js 22 环境：
+
+```powershell
+npm install
+npm test
+npm run dev:h5
+```
+
+生产编译：
+
+```powershell
+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、国内任务状态和国内本地草稿。
+- 当前业务页面是可运行的静态原型，明确提示“业务接口待接入”，不会模拟海外服务提交成功。