511 lines
14 KiB
Markdown
511 lines
14 KiB
Markdown
# 柏悦物流管理系统（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. [系统概述](#1-系统概述)
|
||
2. [技术架构](#2-技术架构)
|
||
3. [首页仪表盘](#3-首页仪表盘)
|
||
4. [客户管理模块](#4-客户管理模块)
|
||
5. [入库管理模块](#5-入库管理模块)
|
||
6. [出库管理模块](#6-出库管理模块)
|
||
7. [货柜管理模块](#7-货柜管理模块)
|
||
8. [库存管理模块](#8-库存管理模块)
|
||
9. [财务结算模块](#9-财务结算模块)
|
||
10. [托盘管理模块](#10-托盘管理模块)
|
||
11. [通用配置模块](#11-通用配置模块)
|
||
12. [常见案例模块](#12-常见案例模块)
|
||
13. [在线开发模块](#13-在线开发模块)
|
||
14. [报表设计模块](#14-报表设计模块)
|
||
15. [消息中心模块](#15-消息中心模块)
|
||
16. [系统管理模块](#16-系统管理模块)
|
||
17. [系统监控模块](#17-系统监控模块)
|
||
18. [API接口清单](#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路由限制未能获取完整表头信息，已根据菜单结构推断标注。如需补充具体页面详情，请登录系统确认后更新。
|