Warehouse Management System

一个基于前后端分离架构的仓库管理系统，覆盖认证授权、系统管理、基础资料、进销退存业务与销售统计分析。

项目亮点

• 前后端分离：Vue 3 + Spring Boot + MySQL
• 角色权限：superadmin / admin / employee
• 核心业务：进货、进货退货、销售、销售退货
• 退货闭环能力：进货退货/销售退货均支持来源单关联与可退数量校验
• 单据处理机制：支持“仅作废”与“作废并红冲”双路径，业务更可控
• 权限体验完善：独立 403 无权限页 + 路由拦截提示，访问反馈更清晰
• 数据可视化：销售概览、Top5、品牌占比、趋势图
• 管理可观测性：首页提供关键异常摘要，便于管理员快速发现问题
• 接口文档：内置 OpenAPI + Knife4j

在线演示

• 演示网站：https://wmsfront.pages.dev/
• 演示网站体验可能不够完整，建议本地部署后体验完整功能。

默认账号（可按需修改）

• superadmin：超级管理员，具备管理员全部能力
• admin：管理员，负责系统与业务管理
• employee：普通用户，以查看权限为主

默认密码:123456

技术栈

• 前端：Vue 3、Vite、Element Plus、Pinia、Vue Router、Axios、ECharts
• 后端：Spring Boot 3.3.5、MyBatis-Plus 3.5.5、Sa-Token 1.37.0
• 数据库：MySQL 8.0
• 运行环境：JDK 17、Node.js 16+

环境准备

• JDK 17：后端基于 Spring Boot 3，必须有 Java 17 环境。
• Maven（MVN）：用于编译和启动后端。项目自带 Maven Wrapper（mvnw / mvnw.cmd）(即使未全局安装 Maven 也通常可以直接运行)。
• Node.js（建议 18+）和 npm：前端基于 Vue 3 + Vite，需要用 npm 安装依赖并启动前端。
• MySQL 8.0：项目数据存储在 MySQL，需先执行初始化 SQL 脚本。

注意事项

必须更改：

• back/src/main/resources/application.properties 中数据库密码请按本机环境修改。

可选更改：

• db.sql 中的默认用户账号（superadmin/admin/employee）和密码（123456）可按需调整。（应用于登录系统时的默认账号密码）
• back/src/main/java/org/example/back/service/UserManageService.java 中的默认密码为 123456。（应用于新建用户时的默认密码）
• • 这两个是不一样的，前者是数据库初始化时的默认账号密码，后者是通过用户管理界面新建用户时的默认密码。

目录结构

.
├─front/                 # Vue 前端
├─back/                  # Spring Boot 后端
└─db.sql                 # 数据库初始化脚本

快速开始

1. 拉取项目

git clone <你的仓库地址>
cd "Warehouse Management System"

2. 初始化数据库

1. 创建数据库（建议字符集 utf8mb4）。
2. 执行根目录数据库脚本：db.sql。

3. 启动后端

cd back
.\mvnw.cmd -DskipTests compile
.\mvnw.cmd spring-boot:run

后端默认地址：http://localhost:8080

4. 启动前端

cd front
npm install
npm run dev

前端默认地址：http://localhost:5173

接口文档

• Knife4j：http://localhost:8080/api/doc.html
• OpenAPI JSON：http://localhost:8080/api/v3/api-docs

---

如果这个项目对你有帮助，欢迎 Star。