天豹云仓的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×tamp=...` - 若配置中有完整 `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`