# 物流供应链 **Repository Path**: xxf_0921/logistics-supply-chain ## Basic Information - **Project Name**: 物流供应链 - **Description**: 采用云端多租户架构,面向物流企业、供应链贸易商、仓储服务商、承运商及上下游合作方等全链条主体,打造一体化供应链数字化管理体系,打通采购、仓储、订单、运输、配送、财务结算、数据分析等全业务流程,彻底解决传统模式下信息分散、流程杂乱、货品溯源难、对账效率低、业务管控薄弱等痛点。 - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 1 - **Created**: 2026-06-13 - **Last Updated**: 2026-09-09 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 物流供应链 SAAS 管理平台 — 管理端技术栈文档 ## 1. 项目概述 | 项目 | 说明 | |------|------| | 项目名称 | 物流供应链 SAAS 管理端 | | 工程目录 | `vue3-element-plus-admin` | | 项目类型 | 单页应用(SPA) | | 默认端口 | `8080`(`vue-cli-service serve`) | | 后端联调地址 | `public/config.js` → `BASE_URL: http://127.0.0.1:5058` | --- ## 2. 核心技术栈 | 分类 | 技术 | 版本 | 用途 | |------|------|------|------| | 框架 | Vue 3 | ^3.2.13 | 前端核心框架(Composition API) | | 路由 | Vue Router | ^4.0.3 | 页面路由、登录守卫 | | 状态管理 | Pinia | ^3.0.2 | 用户状态、菜单状态 | | 持久化 | pinia-plugin-persistedstate | ^4.2.0 | Store 本地持久化 | | UI 组件库 | Element Plus | ^2.9.9 | 表格、表单、弹窗等 | | 图标 | @element-plus/icons-vue | ^2.3.2 | 界面图标 | | HTTP | Axios | ^1.12.2 | 接口请求封装 | | 图表 | ECharts | ^5.6.0 | 数据看板图表 | | 进度条 | NProgress | ^0.2.0 | 路由切换进度 | | 样式 | Less | ^4.0.0 | CSS 预处理 | | 构建工具 | Vue CLI | ~5.0.0 | 开发/打包 | | 兼容性 | core-js | ^3.8.3 | 浏览器 Polyfill | ### 可选/辅助依赖 | 技术 | 用途 | |------|------| | @vue-office/docx / excel / pdf / pptx | 文档预览(预留能力) | | resize-observer-polyfill | 布局自适应兼容 | | unplugin-auto-import / unplugin-vue-components | 自动导入(开发辅助) | --- ## 3. 后端技术栈(联调参考) | 分类 | 技术 | 版本 | |------|------|------| | 框架 | Spring Boot | 2.6.2 | | ORM | MyBatis | 2.2.0 | | 数据库 | MySQL | 8.x | | JSON | Fastjson | 1.2.41 | | 认证 | JWT(java-jwt / jjwt) | — | | 连接池 | Druid + HikariCP | — | | JDK | Java | 1.8 | --- ## 4. 目录结构 ``` vue3-element-plus-admin/ ├── public/ │ ├── config.js # API 基础地址配置 │ └── index.html ├── src/ │ ├── api/ # 接口封装(26 个模块) │ ├── assets/ # 静态资源、全局样式 │ ├── components/ # 公共组件 │ │ ├── hc-table/ # 通用表格 + 分页 │ │ ├── hc-search/ # 通用搜索栏 │ │ └── hc-select-dialog/ # 通用选择弹窗 │ ├── layout/ # 布局框架 │ │ ├── index.vue # 主布局 │ │ └── components/ │ │ ├── sideBar.vue # 一级菜单 │ │ ├── routing.vue # 二级菜单 │ │ └── heade.vue # 顶部栏(用户信息/改密/退出) │ ├── router/ │ │ ├── index.js # 路由实例 + 登录/权限守卫 │ │ └── modules/ │ │ ├── routing.js # 路由与页面组件映射 │ │ └── routeMeta.js # 菜单权限元数据 │ ├── stores/ │ │ └── modules/ │ │ ├── user.js # 用户登录态(token、roleKey) │ │ └── router.js # 菜单展开状态 │ ├── utils/ │ │ ├── request.js # Axios 封装、Token 注入 │ │ └── permission.js # 角色菜单过滤、路由权限 │ ├── views/ # 业务页面 │ │ ├── login/ # 登录 / 注册 │ │ ├── dashboard/ # 数据看板 │ │ ├── system/ # 系统管理(7 页) │ │ ├── partner/ # 伙伴管理(3 页) │ │ ├── wms/ # 仓储管理(7 页) │ │ ├── pms/ # 采购管理 │ │ ├── oms/ # 订单管理 │ │ ├── tms/ # 运输管理(3 页) │ │ └── fms/ # 财务管理(4 页) │ ├── App.vue │ └── main.js └── package.json ``` --- ## 5. 架构设计 ### 5.1 应用启动流程 ``` main.js ├── 创建 Pinia(含持久化插件) ├── 注册 Vue Router ├── 注册 Element Plus + 全局图标 └── 挂载 App.vue └── router-view ├── /login → 登录页 └── / → Layout ├── sideBar(一级菜单) ├── routing(二级菜单) ├── heade(顶栏) └── router-view(业务页面) ``` ### 5.2 路由模式 - **Hash 模式**:`createWebHashHistory` - 登录页 `/login` 独立路由 - 业务页面作为 Layout 子路由挂载 ### 5.3 权限控制 | 层级 | 实现 | 文件 | |------|------|------| | 菜单过滤 | 按 `role_key` 过滤 `routeMeta` | `utils/permission.js` | | 路由守卫 | 无 Token 跳转登录;无权限拦截 | `router/index.js` | | 用户状态 | Pinia `useUserStore` + localStorage | `stores/modules/user.js` | **角色标识(role_key)** | 值 | 说明 | |----|------| | `super_admin` | 平台超级管理员 | | `tenant_admin` | 租户管理员 | | `wms_admin` | 仓储管理员 | | `oms_operator` | 订单专员 | | `tms_dispatcher` | 运输调度 | | `fms_accountant` | 财务专员 | ### 5.4 接口请求 ``` 页面组件 → api/*.js → utils/request.js → 后端 API ``` - 请求自动携带 `Authorization: {token}` - Token 来源:`localStorage.user.user.token` - `code === 401` 自动跳转登录页 - 基础地址读取 `window.configs.BASE_URL` --- ## 6. 页面模块清单 | 模块 | 路由 | 页面文件 | 对应 API | |------|------|----------|----------| | 数据看板 | `/dashboard` | `views/dashboard/index.vue` | `api/dashboard.js` | | 租户管理 | `/system/tenant` | `views/system/tenant.vue` | `api/sysTenant.js` | | 用户管理 | `/system/user` | `views/system/user.vue` | `api/sysUser.js` | | 角色管理 | `/system/role` | `views/system/role.vue` | `api/sysRole.js` | | 系统配置 | `/system/config` | `views/system/config.vue` | `api/sysConfig.js` | | 操作日志 | `/system/operLog` | `views/system/operLog.vue` | `api/sysOperLog.js` | | 预警管理 | `/system/warning` | `views/system/warning.vue` | `api/sysWarning.js` | | 数据字典 | `/system/dict` | `views/system/dict.vue` | `api/sysDict.js` | | 客户管理 | `/partner/customer` | `views/partner/customer.vue` | `api/partner.js` | | 供应商管理 | `/partner/supplier` | `views/partner/supplier.vue` | `api/partner.js` | | 承运商管理 | `/partner/carrier` | `views/partner/carrier.vue` | `api/partner.js` | | 仓库管理 | `/wms/warehouse` | `views/wms/warehouse.vue` | `api/warehouse.js` | | 库位管理 | `/wms/location` | `views/wms/location.vue` | `api/location.js` | | 商品管理 | `/wms/goods` | `views/wms/goods.vue` | `api/goods.js` | | 库存查询 | `/wms/stock` | `views/wms/stock.vue` | `api/stock.js` | | 入库管理 | `/wms/inbound` | `views/wms/inbound.vue` | `api/inbound.js` | | 出库管理 | `/wms/outbound` | `views/wms/outbound.vue` | `api/outbound.js` | | 调拨管理 | `/wms/transfer` | `views/wms/transfer.vue` | `api/transfer.js` | | 采购申请 | `/pms/requisition` | `views/pms/requisition.vue` | `api/requisition.js` | | 销售订单 | `/oms/order` | `views/oms/order.vue` | `api/order.js` | | 运单管理 | `/tms/waybill` | `views/tms/waybill.vue` | `api/waybill.js` | | 车辆管理 | `/tms/vehicle` | `views/tms/vehicle.vue` | `api/vehicle.js` | | 司机管理 | `/tms/driver` | `views/tms/driver.vue` | `api/driver.js` | | 费用项目 | `/fms/feeItem` | `views/fms/feeItem.vue` | `api/feeItem.js` | | 对账单 | `/fms/statement` | `views/fms/statement.vue` | `api/statement.js` | | 收付款 | `/fms/payment` | `views/fms/payment.vue` | `api/payment.js` | | 应收应付 | `/fms/receivable` | `views/fms/receivable.vue` | `api/receivable.js` | --- ## 7. 公共组件与页面模式 ### 7.1 标准 CRUD 页面结构 管理端业务页普遍采用统一模式: ``` hc-search(搜索栏) └── hc-table(数据表格 + 分页) └── el-dialog(新增/编辑弹窗) ``` ### 7.2 公共组件 | 组件 | 路径 | 功能 | |------|------|------| | `hc-table` | `components/hc-table` | 表格渲染、分页、列插槽 | | `hc-search` | `components/hc-search` | 搜索表单、查询/重置按钮 | | `hc-select-dialog` | `components/hc-select-dialog` | 弹窗式数据选择 | ### 7.3 接口调用约定 ```javascript // 列表 const res = await xxxList({ page: 1, limit: 20, ...filters }); // res.data → 列表数组 // res.maxPage → 总条数 // 增删改 const res = await xxxAdd(payload); if (res.code === 200) { /* 成功 */ } ``` --- ## 8. 本地开发 ### 8.1 环境要求 - Node.js 16+ - npm 或 yarn ### 8.2 启动步骤 ```bash # 1. 安装依赖 cd vue3-element-plus-admin npm install # 2. 配置后端地址(如需修改) # 编辑 public/config.js 中的 BASE_URL # 3. 启动开发服务 npm run dev # 4. 浏览器访问 http://localhost:8080 ``` ### 8.3 生产构建 ```bash npm run build # 产物输出至 dist/ 目录 ``` ### 8.4 初始化演示数据 演示账号见 [accounts.md](./accounts.md)。 --- ## 9. 状态存储说明 | 存储 Key | 内容 | 用途 | |----------|------|------| | `user` | `{ user: { token, users } }` | 登录 Token 与用户信息 | | `loginUser` | Pinia 用户 Store 持久化 | `roleKey`、`userInfo` | | `getRouter` | 菜单展开状态 | 二级菜单记忆 | 退出登录或修改密码后会清除上述缓存。 --- ## 10. 功能特性 - 多租户 SAAS 管理端 - 基于角色的菜单权限控制 - 用户自助注册(创建企业及管理员) - 个人密码修改(顶栏入口) - 数据看板(ECharts 图表) - 系统管理 + WMS/OMS/TMS/FMS 全业务模块 - 统一请求拦截与 Token 过期处理 --- ## 11. 相关文档 | 文档 | 说明 | |------|------| | [api-docs.md](./api-docs.md) | 后端接口文档 | | [accounts.md](./accounts.md) | 演示账号与角色权限 | ## 12. 获取源码 | 优化反馈 ![输入图片说明](c34a9b9e6902be30903f41a166351d55.jpg) ## 13. 效果展示 ![输入图片说明](ScreenShot_2026-06-13_193942_882.png) ![输入图片说明](ScreenShot_2026-06-13_193631_103.png) ![输入图片说明](ScreenShot_2026-06-13_193605_599.png) ![输入图片说明](ScreenShot_2026-06-13_193545_360.png) ![输入图片说明](ScreenShot_2026-06-13_193511_132.png)