- 业务源码统一迁入 src/,H5 模板移到 public/index.html - 新增 @vue/cli 4.5 + @dcloudio 2.0.2-5020620260917001 全套依赖与 scripts - 保留 vue.config.js 的 ROUTES 注入(uni-simple-router 运行时依赖) - 新增 scripts/node-compat.cjs 兼容 Node 23+ 移除的 util.isRegExp 等 API - README 补充构建/运行/回退说明
5.2 KiB
5.2 KiB
天豹云仓的WMS_PDA项目
文件说明
day.log:日报记录文件,用于按天填写工作内容(今日完成、进行中、明日计划、问题与风险、备注)。
API接口文档
http://192.168.11.56:6060/api/docs/system/raw
接口文档与登录接口关系
1)接口文档(后端)
- 接口文档定义了后端可调用的 method、参数和返回结构。
- 前端并不直接写死所有 URL,而是通过本地接口映射表进行统一管理。
2)本地接口映射(前端“接口文档”)
- 文件:
core/request/apis.js - 作用:把业务别名映射为请求配置(
path/url、method、auth)
登录相关映射:
user.loginpath: "user.login"- 用于账号密码登录
user.loginByUuidurl: "https://ye4s.wms.gztbyc.com/index/wms/wms/loginByUuid"- 用于扫码/工牌 UUID 登录
user.infopath: "user.info"- 用于拿登录后的用户信息
3)请求封装与实际调用关系
3.1 请求入口
- 文件:
core/request/index.js - 统一入口:
http('user.login', data)/http('user.loginByUuid', data)
3.2 URL组装规则
- 文件:
core/request/request.js - 若配置中有
path:实际请求变为API_URL?method={path}&v=1.0×tamp=... - 若配置中有完整
url:直接请求该 URL(如loginByUuid)
3.3 公共请求头
- 文件:
core/request/request.js - 默认头包含:
platform: pdaproject: warehouse
注意:若后端提示
project 不支持,优先检查这里的project与业务参数中的project是否一致。
4)登录调用链(账号密码)
- 页面发起:
pages/login/index.vue->this.$store.dispatch('login', loginForm) - 状态层处理:
core/store/modules/user.js->actions.login - 接口调用:
http('user.login', { username, password, device, project }) - 返回处理:从响应拿
token,调用setToken(token)写入本地 - 页面跳转:登录页切换到
/pages/index/index
5)登录调用链(扫码/工牌)
- 页面监听广播:
pages/login/index.vue(broadcast/setCallbacks+onResult) - 获取扫码结果:
result.data(通常是 UUID 或包含 UUID 的编码串) - 点击确认登录:调用
loginByUuid(uuid) - 接口调用:
http('user.loginByUuid', { uuid }) - 返回处理:提取 token 后
setToken(token) - 页面跳转:切换到
/pages/index/index
6)常见错误与关系定位
- 报错:
project 不支持- 关联:
core/request/request.js默认请求头 +core/store/modules/user.js的state.app.project
- 关联:
- 报错:
登录成功但未返回token- 关联:后端返回结构与前端 token 提取逻辑不一致
- 报错:
用户信息加载失败- 关联:
user.info接口失败、token 无效或参数不匹配
- 关联:
7)建议的排查顺序
- 先看
apis.js映射是否正确(path/url) - 再看请求头和业务参数中的
project/device是否与后端一致 - 再看接口返回结构是否包含 token
- 最后看登录后是否成功调用
user.info
构建与运行(uni-app Vue2 CLI 工程)
本项目已从 HBuilderX 工程迁移为
@vue/cli脚手架工程(2026-10-02): 业务源码全部位于src/,H5 模板由public/index.html提供(即原根目录的template.h5.html)。
命令
| 命令 | 作用 | 产物 |
|---|---|---|
npm run dev:h5 |
H5 开发服务器(默认 http://localhost:8080) | 内存编译 |
npm run build:h5 |
H5 生产构建 | dist/build/h5 |
npm run dev:app-plus |
App 资源监听编译 | dist/dev/app-plus |
npm run build:app-plus |
App 生产构建 | dist/build/app-plus |
npm run lint |
ESLint 自动修复 | - |
App 端调试与打包
- CLI 不提供「运行到手机」:
build:app-plus只产出 App 资源,用 HBuilderX 导入dist/build/app-plus运行(或使用自定义基座、离线打包)。 - 正式云打包仍建议走 HBuilderX;
src/manifest.json中的 appid、模块、权限配置均保持原样。
注意事项
- Node 版本:当前在 Node 24 下构建,依赖两个脚本内开关——
--openssl-legacy-provider(webpack 4 需要)与--require=./scripts/node-compat.cjs(补回 Node 23+ 移除的util.isRegExp等历史 API)。若改用 Node 16/18,这两项会自动变成无害的空操作。 ROUTES常量:由根目录vue.config.js(uni-read-pages+ DefinePlugin)注入,uni-simple-router内部依赖它;缺失会在运行时抛ReferenceError: ROUTES is not defined,请勿删除该配置。- @dcloudio 版本必须整体一致:当前锁定
2.0.2-5020620260917001(Vue2 线),升级时需全量同版本替换。 - 依赖镜像:
.npmrc指向registry.npmmirror.com。 src/pages/componentsA|B|C是 uView 官方示例页(含 67 个.nvue文件),未被pages.json注册、不参与编译,可按需删除。
回退方式
原 HBuilderX 工程完整备份在 d:\WMS_PDA_bak_20261002-1936(含 node_modules、.hbuilderx、template.h5.html、vue.config.js、package.json、package-lock.json)。需要回退时,把备份内容覆盖回项目根目录即可。