- 新增 pages/warehouse/inventoryTransfer.vue:支持按商品条码/名称/操作人搜索、 扫码查询、移入/移出类型筛选、分页列表(展示商品、数量、移出/移入库位、操作人等) - pages.json 注册 pages/warehouse/inventoryTransfer 路由 - core/request/apis.js 新增 warehouse.getSpaceInfo、storage.transaction.list 接口 - pages/index/index.vue、pages/home/edit-quick-actions.vue:工作台「移库记录」 菜单点击跳转到移库记录页 refactor: 重构称重页查询与校验逻辑 - 改用 common.toOrder + order.detail 查询,替代原 scanOrder 分支逻辑 - 按波次号前缀区分散单/团单(B 开头视为团单),新增 isGroupOrder 状态 - 增加称重前置校验:未拣货、未复核禁止称重;散单未打包禁止称重 - 商品净重统一取订单详情 items_weight,运单匹配成功才回填称重重量 - 提取 clearOrderData 复用清空逻辑
天豹云仓的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%