43 lines
2.1 KiB
Markdown
43 lines
2.1 KiB
Markdown
# 柏悦物流海外版 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、国内任务状态和国内本地草稿。
|
|
- 入仓页面已接任务、推送、托盘分配、清点、拣货、箱码扫描/移除、卸柜照片和完成入库的真实 API；错误会保留业务码、requestId 与 traceId。
|
|
- 库内、换标和现场查询仍是可运行的静态原型，不会模拟海外服务提交成功。
|
|
- 本地契约测试与 H5/App 资源编译不等于真实开发环境 HTTP 或 PDA 真机验收。
|