2026-03-16 14:42:06 +08:00
2026-08-12 14:55:47 +08:00
2026-03-16 14:42:06 +08:00
2026-03-16 14:42:06 +08:00
2026-08-13 17:58:43 +08:00
2026-03-16 14:42:06 +08:00
2026-03-16 14:42:06 +08:00
2026-03-16 14:42:06 +08:00
2026-03-16 14:42:06 +08:00
2026-03-16 14:42:06 +08:00
2026-03-16 14:42:06 +08:00
2026-03-16 14:42:06 +08:00

天豹云仓的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.login
    • path: "user.login"
    • 用于账号密码登录
  • user.loginByUuid
    • url: "https://ye4s.wms.gztbyc.com/index/wms/wms/loginByUuid"
    • 用于扫码/工牌 UUID 登录
  • user.info
    • path: "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&timestamp=...
  • 若配置中有完整 url:直接请求该 URL(如 loginByUuid)

3.3 公共请求头

  • 文件:core/request/request.js
  • 默认头包含:
    • platform: pda
    • project: warehouse

注意:若后端提示 project 不支持,优先检查这里的 project 与业务参数中的 project 是否一致。

4)登录调用链(账号密码)

  1. 页面发起:pages/login/index.vue -> this.$store.dispatch('login', loginForm)
  2. 状态层处理:core/store/modules/user.js -> actions.login
  3. 接口调用:http('user.login', { username, password, device, project })
  4. 返回处理:从响应拿 token,调用 setToken(token) 写入本地
  5. 页面跳转:登录页切换到 /pages/index/index

5)登录调用链(扫码/工牌)

  1. 页面监听广播:pages/login/index.vue(broadcast/setCallbacks + onResult)
  2. 获取扫码结果:result.data(通常是 UUID 或包含 UUID 的编码串)
  3. 点击确认登录:调用 loginByUuid(uuid)
  4. 接口调用:http('user.loginByUuid', { uuid })
  5. 返回处理:提取 token 后 setToken(token)
  6. 页面跳转:切换到 /pages/index/index

6)常见错误与关系定位

  • 报错:project 不支持
    • 关联:core/request/request.js 默认请求头 + core/store/modules/user.js 的 state.app.project
  • 报错:登录成功但未返回token
    • 关联:后端返回结构与前端 token 提取逻辑不一致
  • 报错:用户信息加载失败
    • 关联:user.info 接口失败、token 无效或参数不匹配

7)建议的排查顺序

  1. 先看 apis.js 映射是否正确(path/url)
  2. 再看请求头和业务参数中的 project/device 是否与后端一致
  3. 再看接口返回结构是否包含 token
  4. 最后看登录后是否成功调用 user.info
Description
No description provided
Readme MIT 42 MiB
Languages
Vue 72.1%
JavaScript 24.5%
TypeScript 2.4%
SCSS 0.4%
PowerShell 0.4%
Other 0.2%