30 lines
1.7 KiB
Markdown
30 lines
1.7 KiB
Markdown
# Overseas PDA Uni-app Instructions
|
||
|
||
## 项目定位
|
||
|
||
- 本项目是“柏悦物流海外版”独立 uni-app Vue 3 工程，面向海外仓现场人员。
|
||
- 工程必须独立安装、构建和发布，不得依赖 `apps/pda-uniapp/` 或仓库外 `pda-shared` 目录。
|
||
- 当前业务范围按四期收敛为入仓、库内、换标、库存/库位/托盘查询；不包含海外仓出库、派送和国内集装箱拣货/装柜。
|
||
|
||
## 服务与发布边界
|
||
|
||
- 国内 Auth 是唯一账号和 Token 签发方；海外业务请求统一经 `gateway-overseas`。
|
||
- 国内与海外 AppID、Android 包名、签名、版本号、构建产物和在线更新通道必须独立。
|
||
- `src/manifest.json` 中的 AppID 在正式打包前由海外版所属 DCloud 账号创建；不得伪造或复用国内 AppID。
|
||
- 环境地址只通过 `.env.local` 等未提交环境文件配置，不写入源码。
|
||
|
||
## 工程入口
|
||
|
||
- 源码根：`src/`；页面注册：`src/pages.json`；应用配置：`src/manifest.json`。
|
||
- 工作台定义：`src/data/overseas-workbench.js`。
|
||
- 登录与会话：`src/api/auth.js`、`src/stores/session.js`。
|
||
- 扫码设备层：`src/utils/scan-broadcast.js`；广播 Action=`android.intent.action.SCANRESULT`，Extra=`value`。
|
||
- 当前通用作业页是静态原型，不得将原型提示改成模拟远程成功。
|
||
|
||
## 质量门禁
|
||
|
||
- 安装：`npm install`；检查：`npm test`。
|
||
- H5 生产编译：`npm run build:h5`；App 资源编译：`npm run build:app`。
|
||
- APK/IPA 必须在 HBuilderX 或正式原生打包环境中使用独立 AppID 与签名验证；仅通过 App 资源编译不得声称 APK 真机验收完成。
|
||
- 不提交 `node_modules/`、`dist/`、`unpackage/`、环境文件、签名证书或打包产物。
|