1.7 KiB
1.7 KiB
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/、环境文件、签名证书或打包产物。