一、项目简介鲜汇超市进销存管理系统是一套面向生鲜超市场景的前后端分离管理平台。系统覆盖了商品展示、采购、销售、库存、盘点、报表等超市核心业务链路并内置多角色权限控制。后端基于 Spring Boot 3 与 MyBatis-Plus 构建提供 RESTful API前端采用 Vue 3 Element Plus 开发单页应用通过 Axios 与后端交互。系统包含管理员端与普通用户端两类角色管理员负责商品、供应商、客户、订单、库存、报表等全链路管理普通用户端主要面向商品浏览、分类筛选与详情查看。整体架构清晰适合作为进销存类系统的学习与二次开发底座。二、技术栈技术说明后端框架Spring Boot 3.xORM 框架MyBatis-Plus 3.x分页插件、逻辑删除、字段自动填充权限认证JWTjjwt、拦截器实现接口鉴权密码加密MD5前端框架Vue 3Composition API、Vue Router 4UI 组件库Element Plus状态管理Pinia图表库ECharts 5构建工具Vite数据库MySQL 8.xHTTP 客户端Axios三、功能模块管理员端登录认证通过用户名和密码登录密码采用 MD5 加密存储校验账号是否被禁用登录成功后签发 JWT 令牌。控制台概览展示在售商品总数、今日销售额按当天已完成订单实付金额汇总、库存预警商品数库存 ≤ 最低库存、待审核采购单数。销售趋势图表展示近 30 天每日销售额折线图按日期分组统计已完成订单的订单数、实付金额、优惠金额。分类库存分布按商品分类统计库存数量以饼图展示各分类库存占比。用户管理分页查询系统用户列表支持按用户名/姓名/手机号模糊搜索、新增用户用户名唯一性校验默认密码 123456、编辑、删除、重置密码。商品管理分页查询商品列表支持按名称/条码模糊搜索、按分类筛选、新增、编辑、删除、查看商品详情。库存预警查询库存量 ≤ 最低库存或 ≥ 最高库存的商品按库存量升序排列仅显示启用状态商品。临期预警根据生产日期 保质期天数计算到期日筛选出距到期日 ≤ 预警天数的商品列表。库存查询按关键字名称/条码/库位模糊搜索或按分类筛选查询启用状态商品的库存信息按库位升序排列。库存盘点创建盘点单自动生成单号 IC时间戳记录操作员添加盘点明细自动带出系统库存量计算差异量 实盘数 - 系统数完成盘点后自动更新商品库存为实盘数量。盘点单列表查看全部盘点单含操作员姓名支持查看盘点单详情含商品名称、单位、库位、系统数、实盘数、差异数。分类管理分页查询商品分类支持按名称搜索按排序号升序、新增、编辑、删除、查询全部启用分类。供应商管理分页查询供应商列表支持按名称/联系人模糊搜索、新增、编辑、删除、查询全部启用供应商。客户管理分页查询客户列表支持按姓名/手机号模糊搜索、新增、编辑、删除、按关键字搜索客户姓名/手机号。采购订单管理创建采购单自动生成单号 PO时间戳记录操作员自动计算明细金额和订单总金额支持挂起/直接提交、订单审核待审→已审核、订单完成入库并更新商品库存和成本价、订单取消、订单删除。采购单查询按状态筛选、按单号/供应商名称模糊搜索查看采购单详情含商品明细、供应商名称、操作员姓名。销售开单POS 收银创建销售单自动生成单号 SO时间戳自动带出商品售价和成本价计算订单金额支持折扣金额实付 总额 - 折扣完成状态自动扣减库存。待处理销售单查询状态为待处理的销售单列表支持完成选择支付方式、可修改折扣完成后扣减库存、取消操作。销售记录查询全部销售单按状态筛选、按单号搜索查看销售单详情含客户名称、操作员、商品明细、支付方式、优惠金额。日报表按日期范围查询每日销售汇总日期、订单数、实付金额、优惠金额支持月报表按月份汇总。商品销售排行按日期范围统计已完成订单中各商品的销售数量、销售金额按销量降序排列。利润报表按日期范围统计已完成订单中各商品的销售额、成本、利润销售额 - 成本按利润降序排列。库存报表查询全部商品库存明细含分类名、供应商名统计库存总价值成本价 × 库存量和商品种类数。采购报表按日期范围查询已完成采购单列表统计采购总金额和采购单数。文件上传支持上传图片文件最大 10MB生成 UUID 文件名返回可访问的图片 URL 地址。普通用户端首页展示查看启用状态的商品分类列表、热门商品按 ID 倒序取前 8 条、新品推荐按创建时间倒序取前 8 条。商品分类浏览查看全部启用状态的商品分类按排序号升序排列。商品列表筛选按分类 ID 精确筛选、按商品名称模糊搜索仅显示启用状态商品。商品详情查看查看商品详细信息包括商品名称、分类、条码、单位、成本价、售价、库存量、保质期天数、生产日期、预警天数、图片、供应商、库位等字段。四、项目总结本项目技术栈选型主流且版本较新Spring Boot 3 Vue 3 的组合具备良好的工程实践参考价值。业务模块覆盖了进销存系统的完整闭环从采购入库、销售出库到库存盘点、报表统计均有落地实现且每个模块都包含实际业务中常见的字段与状态流转逻辑。权限控制基于 JWT 拦截器实现简单直接适合理解前后端分离下的认证鉴权流程。项目自带数据库初始化脚本和文档适合作为课程设计、毕业设计或进销存类系统的二次开发基础。对于想学习 Spring Boot 3 与 Vue 3 整合、MyBatis-Plus 使用、ECharts 数据可视化等技术的开发者来说是一份结构清晰、可直接运行的完整参考。界面展示交付内容本项目为完整交付包含完整后端源码完整前端源码数据库初始化脚本SQL万字项目文档设计文档 / 论文可作课程设计、毕业设计参考获取完整源码完整前后端源码 数据库脚本 万字项目文档见 Gitee 仓库https://gitee.com/kangxihuang/src-K332
