天豹云仓的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
Languages
Vue
72.1%
JavaScript
24.5%
TypeScript
2.4%
SCSS
0.4%
PowerShell
0.4%
Other
0.2%