WMS_PDA/README.md

91 lines
3.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

天豹云仓的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`