docs/悦/货代SAAS平台后台/柏悦WMS系统文档.md

柏悦物流管理系统（Baiyue WMS）系统文档

版本: 基于测试系统 2026-06-01 抓取分析
访问地址: http://39.101.149.173
后端API: https://adtest.bylogistic.cn
技术栈: Ant Design Vue + Spring Boot + MySQL + Redis
测试账号: admin / ndui#Emdfj23123

---

目录

1. 系统概述
2. 技术架构
3. 首页仪表盘
4. 客户管理模块
5. 入库管理模块
6. 出库管理模块
7. 货柜管理模块
8. 库存管理模块
9. 财务结算模块
10. 托盘管理模块
11. 通用配置模块
12. 常见案例模块
13. 在线开发模块
14. 报表设计模块
15. 消息中心模块
16. 系统管理模块
17. 系统监控模块
18. API接口清单

---

1. 系统概述

柏悦物流管理系统（Baiyue WMS）是一套面向跨境物流仓储行业的综合管理系统，覆盖从客户管理 → 入库 → 出库 → 货柜管理 → 库存 → 托盘 → 财务结算的全链路业务流程。

1.1 核心业务流程

客户下单 → 入库单 → 入库测量 → 测量审核 → 接收审核 → 库存管理
    ↓
出库单 → BOL/派送 → 托盘管理 → 货柜管理 → 财务结算

1.2 系统模块总览

序号	模块	子页面数	说明
1	首页	1	数据看板/仪表盘
2	客户管理	4	客户公司、用户、阶梯费用、流水
3	入库	4	入库单、测量、审核、接收
4	出库	3	派送单、BOL、自提单
5	货柜管理	2	货柜列表、装柜清单
6	库存	3	海外仓库存查询、理货、报损
7	财务结算	5	应收应付、对账单、仓储成本
8	托盘管理	2	托盘列表、生成托盘
9	通用	8	产品、费用、FBA地址、库位等
10	常见案例	2	自定义组件、对象存储
11	在线开发	1	Online表单开发
12	报表设计	3	积木报表、生产监控、物流监控
13	消息中心	3	模板、消息管理、我的消息
14	系统管理	12	用户、角色、菜单、租户等
15	系统监控	7	在线用户、日志、定时任务等
16	统计报表	-	报表设计入口

---

2. 技术架构

2.1 前端技术

• 框架: Vue.js（SPA 单页应用）
• UI 组件库: Ant Design Vue
• 路由: Vue Router（Hash 模式）
• 状态管理: Vuex
• 图表: 集成数据可视化组件

2.2 后端技术

• 框架: Spring Boot（推测，基于 Spring 生态）
• 数据库: MySQL
• 缓存: Redis
• 认证: Token-based（JWT）
• API 风格: RESTful

2.3 认证流程

用户登录 → POST /sys/login → 返回 Token
后续请求 → Header: Authorization: Bearer {token}
权限验证 → GET /sys/permission/getUserPermissionByToken

---

3. 首页仪表盘

• URL: /wms/Dashboard
• 页面标题: 柏悦物流管理系统

首页提供系统总览数据看板，展示关键业务指标（订单数、库存状态、财务概况等）。

---

4. 客户管理模块

4.1 客户公司管理

管理客户公司的基本信息，包括公司名称、联系方式、合作状态等。

4.2 用户资料

管理客户下的用户账号资料，包括登录账号、角色权限等。

4.3 海外仓阶梯费用

配置客户在海外仓的阶梯式费用规则，按不同量级设置不同单价。

4.4 客户账户流水

查看客户账户的资金流水明细，包括充值、消费、退款等记录。

---

5. 入库管理模块

入库是系统的核心业务流程模块，包含四个阶段：入库单创建 → 测量 → 测量审核 → 接收审核。

5.1 入库单列表

• URL: /wms/ByInstoreList
• 页面标题: 入库单列表 · 柏悦物流管理系统

搜索条件

字段	说明
定位仓库	筛选指定仓库的入库单
交货仓	筛选指定交货仓的入库单
入仓码	按入仓码精确查询
订单状态	按订单状态筛选（如：待处理、处理中、已完成）
费用审核状态	按费用审核状态筛选

表格列头（23列）

列名	说明
仓库	入库目标仓库
交货仓	货物来源交货仓
配载状态	货物配载状态
是否扣货	是否被扣货标记
扣货理由	扣货原因说明
集装箱号	集装箱编号
柜号	货柜编号
公司	客户公司名称
业务类型	业务分类
提货方式	提货方式（自提/送货等）
提货时间	预约提货时间
提货联系人电话	提货联系人电话
提货地址	提货地址详情
提货邮编	提货地邮编
提货联系人邮箱	提货联系人邮箱
渠道	业务渠道来源
买单/退税	贸易方式（买单/退税）
是否整柜	整柜/拼柜标记
商检验	商检检验标记
开船时间	预计开船时间
到港时间	预计到港时间
总箱数	货物总箱数
总毛重(T.K.GW)	总毛重（吨/公斤）

操作按钮

按钮	功能
查询	根据搜索条件查询数据
重置	清空搜索条件
国内仓下单	创建国内仓入库单
海外分仓下单	创建海外分仓入库单
整托下单	以整托方式创建入库单
高级查询	打开高级筛选面板
导出报表	导出当前查询结果为Excel
导出入库清单总表	导出完整的入库清单
导出唛头	导出唛头标签文件
导出FBA流转单ZIP	导出FBA流转单压缩包
下载	下载选中记录的相关文件

5.2 入库单测量

• URL: /wms/ByInstoreList4Measured
• 页面标题: 入库单测量 · 柏悦物流管理系统

对入库货物进行实际测量，记录测量数据。

搜索条件

字段	说明
仓库	筛选仓库
入仓码	按入仓码查询
公司	按客户公司筛选
FBA货件编号	按FBA货件编号查询

表格列头（24列）

列名	说明
入仓码	入仓编码
仓库	目标仓库
订单状态	订单处理状态
配载状态	配载情况
测量数据审核状态	测量审核进度
唛头文件	唛头标签文件
是否扣货	扣货标记
扣货理由	扣货原因
公司	客户公司
业务类型	业务分类
渠道	业务渠道
买单/退税	贸易方式
是否整柜	整柜/拼柜
商检验	商检状态
总箱数	货物总箱数
总毛重(T.K.GW)	总毛重
总体积(m³)	货物总体积
总材积重	材积重量
总净重(T.K.NW)	总净重
目的仓类型	目的仓库类型
目的仓	目的仓库
货件编号	货件编号
测量完成时间	测量完成时间
操作	操作按钮列

操作按钮

按钮	功能
查询	根据条件查询
重置	清空条件
下载	下载数据

5.3 测量数据审核

• URL: /wms/ByInstoreList4MeasuredAudit
• 页面标题: 测量数据审核 · 柏悦物流管理系统

对测量数据进行审核确认。表头和搜索条件与入库单测量一致。

5.4 接收审核

• URL: /wms/ByInstoreList4ReceiveAudit
• 页面标题: 接收审核 · 柏悦物流管理系统

最终接收审核环节，确认货物入库完成。表头和搜索条件与入库单测量一致。

---

6. 出库管理模块

6.1 派送单列表

• URL: /wms/ByDispatchList

管理出库派送订单，包括派送地址、物流方式、派送状态等。

6.2 BOL（提单管理）

• URL: /wms/ByBolList

管理 Bill of Lading（提单），是国际物流中的重要单证。包括提单号、船名航次、发货人、收货人等。

6.3 自提单

管理客户自提订单，记录自提预约、提货人信息等。

---

7. 货柜管理模块

7.1 货柜列表

• URL: /wms/ByContainerList

管理所有货柜信息，包括柜号、类型、尺寸、状态、当前位置等。

7.2 装柜清单

记录每个货柜的装柜明细，展示柜内货物列表和装载方案。

---

8. 库存管理模块

8.1 海外仓库存查询

• URL: /wms/ByInventoryList

查询海外仓当前库存情况，支持按仓库、产品、SKU等维度查询。

8.2 理货管理

对库存货物进行盘点、整理、移位等操作。

8.3 报损单

管理货物损耗/损坏的报损申请和审批流程。

---

9. 财务结算模块

9.1 客户应收应付

• URL: /wms/ByFinanceList

管理每个客户的应收账款和应付账款明细。

9.2 客户对账单

生成和查看客户对账单，用于与客户进行账务核对。

9.3 结算单位应付

按结算单位（如承运商、仓库方）管理应付账款。

9.4 结算单位对账单

生成结算单位的对账单。

9.5 洛杉矶仓储成本

专门针对洛杉矶仓库的仓储成本核算和分析。

---

10. 托盘管理模块

10.1 托盘列表

• URL: /wms/ByTrayList

管理所有托盘信息，包括托盘编号、规格、状态、关联货物等。

10.2 生成托盘

根据入库货物自动/手动生成托盘，分配货物到托盘。

---

11. 通用配置模块

系统基础数据和配置管理。

子模块	说明
产品信息	管理产品/货品基础信息（名称、规格、HS编码等）
费用项目	定义各类费用项目（仓储费、操作费、运输费等）
FBA编码地址	管理Amazon FBA仓库编码和地址信息
托盘管理	托盘基础配置
库位/货架管理	仓库库位和货架的编号和配置
订单流转路径	定义订单在不同节点之间的流转规则
快递公司	合作的快递/物流公司信息
往来单位	管理供应商、承运商等往来单位信息

---

12. 常见案例模块

12.1 自定义组件

展示系统自定义组件的使用示例和开发指南。

12.2 对象存储

文件/对象存储功能的配置和使用说明。

---

13. 在线开发模块

13.1 Online表单开发

低代码表单开发工具，允许管理员在线设计和配置业务表单，无需编写代码。

---

14. 报表设计模块

14.1 积木报表设计

可视化报表设计器，支持拖拽式设计各类业务报表。

14.2 生产销售监控

展示生产和销售的监控数据看板。

14.3 智慧物流监控

物流全链路监控大屏，展示实时物流数据。

---

15. 消息中心模块

15.1 模板管理

管理系统通知的消息模板，支持短信、邮件、站内信等类型。

15.2 消息管理

查看和管理所有已发送的系统消息。

15.3 我的消息

当前登录用户收到的个人消息列表。

---

16. 系统管理模块

系统后台管理功能。

子模块	说明
用户管理	管理系统用户账号（创建、编辑、禁用、重置密码）
角色管理	定义角色并分配权限
菜单管理	配置系统导航菜单结构
租户管理	多租户隔离管理（适用于SaaS模式）
部门管理	组织架构部门管理
我的部门	当前用户所属部门信息
职务管理	定义系统内职务
通讯录	系统用户通讯录
数据字典	系统枚举值和字典数据维护
分类字典	分类树形字典维护
系统通告	发布系统级公告通知
菜单管理2	菜单管理的增强版/备用入口

---

17. 系统监控模块

系统运行状态监控和运维管理。

子模块	说明
在线用户	查看当前在线用户列表，支持强制下线
路由网关	查看系统路由配置和网关状态
定时任务	管理系统的定时任务（Cron Job）
日志管理	查看系统操作日志
数据日志	数据变更日志记录
SQL监控	SQL执行监控（基于Druid连接池）
在线文档	系统API文档（Swagger/Knife4j）

---

18. API接口清单

系统后端API部署在 https://adtest.bylogistic.cn，以下为已发现的API端点：

认证相关

接口	方法	说明
/sys/login	POST	用户登录
/sys/randomImage/{timestamp}	GET	获取验证码图片
/sys/permission/getUserPermissionByToken	GET	获取用户权限

数据字典

接口	方法	说明
/sys/dict/getDictItems/by_company	GET	获取公司字典
/sys/dict/getDictItems/by_order_status	GET	获取订单状态字典
/sys/dict/getDictItems/by_customer	GET	获取客户字典
/sys/dict/getDictItems/by_store	GET	获取仓库字典
/sys/dict/getDictItems/by_order_path	GET	获取订单路径字典
/sys/dict/getDictItems/by_fba	GET	获取FBA编码字典

系统功能

接口	方法	说明
/sys/annountCement/listByUser	GET	获取用户公告列表
/sys/loginfo	GET	系统日志信息
/sys/visitInfo	GET	访问统计信息

---

附录：SKU明细区域列头

在入库单详情页面，SKU明细表格包含以下列：

列名	说明
操作	编辑/删除操作
#	序号
报关HS_CODE	报关用HS海关编码
货品图片	货品图片预览
仓/储/微(快递)码/纱	仓储编码/微信码/快递码
中品名	中文品名
英品名	英文品名
清关HS_CODE	清关用HS海关编码
箱规长(cm)	外箱长度
箱规宽(cm)	外箱宽度

---

文档生成时间: 2026-06-01
数据来源: 测试系统 http://39.101.149.173 实际登录抓取
说明: 部分页面因SPA路由限制未能获取完整表头信息，已根据菜单结构推断标注。如需补充具体页面详情，请登录系统确认后更新。