Spring Boot 3 + Vue 3 + MySQL 水果超市进销存管理系统源码实战前后端分离
一、项目简介
鲜果园水果超市管理系统是一套基于 Spring Boot 3 + Vue 3 前后端分离架构的超市进销存管理平台，覆盖水果采购入库、销售收银、库存盘点、供应商管理、品类管理及经营数据分析等核心业务环节。系统采用 RESTful API 接口通信，后端负责业务逻辑与数据持久化，前端负责界面交互与状态管理。系统内置管理员、收银员、库管员三种角色，各角色拥有独立操作权限与功能视图，适用于中小型水果超市的日常运营管理。
二、技术栈
| 技术 | 说明 |
|---|---|
| 后端框架 | Spring Boot 3.x |
| ORM | MyBatis-Plus 3.x |
| 权限认证 | JWT（jjwt） |
| 前端框架 | Vue 3.x |
| 状态管理 | Pinia |
| 构建工具 | Vite |
| 数据库 | MySQL 8.x |
| 数据库连接池 | Druid |
| 工具库 | Hutool、Lombok |
三、功能模块
管理员端
- 仪表盘概览：查看今日销售单数/总金额、库存预警数量、水果总数、用户总数等关键指标
- 经营数据分析：展示月度销售趋势图表（按月统计已完成销售单总金额）、月度采购趋势图表、品类销售占比图表、品类库存分布图表、销售排行榜图表（Top 10 水果按销售额降序）
- 水果管理：分页查询水果列表（支持按名称、品类ID、状态筛选）；新增水果时填写名称、选择品类、上传图片、设置产地/单位/进价/售价/库存/预警阈值/供应商；支持编辑与逻辑删除
- 库存盘点：输入水果ID和实际库存数量，系统自动计算差异并记录库存流水
- 库存预警：自动筛选库存量小于等于预警阈值的水果，生成预警列表
- 品类管理：分页查询水果品类（支持按名称模糊搜索）；新增品类时填写名称、上传图片、设置排序号和状态；支持编辑与逻辑删除
- 供应商管理：分页查询供应商（支持按名称/联系人模糊搜索）；新增供应商时填写名称、联系人、电话、地址、描述、状态；支持编辑与逻辑删除
- 采购单管理：分页查询采购单（支持按单号、供应商ID、状态筛选）；新增采购单时选择供应商、添加采购明细（水果/数量/单价），系统自动生成单号和计算总金额；支持确认入库（将待入库采购单状态改为已入库，自动增加库存并记录入库流水）与采购退货（将已入库采购单状态改为已退货，自动扣减库存并记录出库流水）；可查看采购单明细（每项水果的名称、数量、单价、小计）
- 销售单管理：分页查询销售单（支持按单号、收银员ID、状态、日期范围筛选）；开单销售时选择商品、填写数量，系统自动计算总金额并扣减库存，支持设置支付方式和实收金额；支持销售退货（将已完成销售单状态改为已退货，自动恢复库存并记录入库流水）；可查看销售单明细（每项水果的名称、图片、数量、单价、小计）
- 库存流水管理：分页查询库存流水（支持按水果ID、流水类型、日期范围筛选）；查看每笔流水的变动前/后库存、变动数量、关联单号、操作人
- 操作日志管理：分页查询操作日志（支持按操作人、操作类型、日期范围筛选）
- 用户管理：分页查询用户列表（支持按用户名/真实姓名、角色筛选，排除超级管理员）；新增用户时填写用户名、真实姓名、手机号、邮箱、角色（收银员/库管员），默认密码 123456；支持编辑、逻辑删除、重置密码为 123456
收银员端
- 用户登录：输入用户名和密码，系统验证后返回 JWT Token
- 修改个人密码：输入原密码和新密码完成修改
- 开单销售：选择水果、填写数量，系统自动计算总金额，支持现金/微信/支付宝支付
- 查看个人创建的销售单列表：支持按单号、状态、日期筛选
- 查看销售单明细：展示每项水果的名称、数量、单价、小计
- 销售退货：对本人经手的已完成销售单发起退货，恢复库存
库管员端
- 用户登录：输入用户名和密码，系统验证后返回 JWT Token
- 修改个人密码：输入原密码和新密码完成修改
- 水果管理：分页查询水果列表（支持按名称、品类、状态筛选）；支持新增水果（填写基本信息并保存）与编辑水果信息
- 库存盘点：输入水果ID和实际库存，系统自动调整并记录流水
- 库存预警：查看所有库存不足的水果
- 采购单管理：分页查询采购单（支持按单号、供应商、状态筛选）；支持新增采购单（选择供应商和采购明细）、确认入库（将待入库采购单入库，增加库存）、采购退货（对已入库采购单退货，扣减库存）
- 库存流水管理：分页查询库存流水，查看所有库存变动记录
四、项目总结
本项目技术亮点包括：采用 Spring Boot 3 + Vue 3 前后端分离架构，实现清晰的分层与解耦；使用 JWT 进行无状态认证，适配多角色权限控制；集成 MyBatis-Plus 简化数据访问层开发；前端使用 Pinia 管理全局状态，Vite 提升构建效率；内置完整的进销存业务闭环，覆盖采购、销售、库存、预警、数据分析等核心场景。适合作为 Java 全栈课程设计、毕业设计或中小型超市管理系统二次开发的基础项目。
界面展示
交付内容
本项目为完整交付，包含：
- 完整后端源码
- 完整前端源码
- 数据库初始化脚本（SQL）
- 万字项目文档（设计文档 / 论文，可作课程设计、毕业设计参考）
获取完整源码
完整前后端源码 + 数据库脚本 + 万字项目文档见 Gitee 仓库：https://gitee.com/kangxihuang/src-K108