Spring Boot 3 + Vue 3 宜宾特产销售平台源码前后端分离实战项目-开发者社区

一、项目简介

宜宾市特产销售平台是一个基于 Spring Boot 3 + Vue 3 前后端分离架构的电商系统，主要面向宜宾本地特产的线上销售与推广。系统支持普通用户、商家、管理员三种角色，涵盖商品浏览购买、订单管理、商家店铺运营、特产故事征集展示、系统公告与反馈等完整功能。整体采用 RESTful API 设计，前端通过 JWT Token 进行身份认证与权限控制。

二、技术栈

技术	说明
后端框架	Spring Boot 3.2
ORM	MyBatis-Plus
权限认证	JWT (jjwt) + 自定义拦截器 + BCryptPasswordEncoder
前端框架	Vue 3 + Element Plus
状态管理	Pinia
构建工具	Vite
数据库	MySQL 8
文件上传	MultipartFile 本地存储
报表导出	Apache POI (XSSFWorkbook)

三、功能模块

普通用户端

用户注册：填写用户名、密码、昵称、手机号，可选择偏好分类，支持普通用户和商家两种注册入口
用户登录：支持用户名+密码登录，返回 JWT Token 及用户信息（含角色、头像、昵称）
浏览商品列表：查看所有在售商品，支持按分类、关键词搜索筛选
查看商品详情：浏览商品完整信息（描述、价格、库存、销量、背景故事、媒体图片/视频列表）
下单购买：选择商品数量，填写收货地址，提交订单并生成唯一订单号
查看订单列表：按状态（待付款/已付款/已发货/已完成/已取消/退款中）筛选查看自己的订单
申请退款：对已付款/已发货的订单提交退款申请，填写退款原因
评价商品：对已完成的订单商品进行评价，填写评分、文字内容并上传图片
评价点赞：对其他用户的评价进行点赞操作
收藏商品：将心仪商品加入收藏夹，方便后续快速查找
消息聊天：与商家进行站内消息沟通，支持发送文字消息并查看历史对话
提交反馈：向平台管理员提交意见反馈（标题+内容）
浏览公告：查看管理员发布的系统公告列表
浏览特产故事：查看管理员审核通过的特产故事文章
参与故事征集：查看商家发起的征集活动，提交故事回复参与互动
使用优惠券：在结算时选择可用的优惠券，享受金额减免
查看优惠券列表：查看自己已领取的优惠券及其使用状态

商家端

商家注册：填写用户名、密码、店铺名称、店铺描述，同时创建用户账号和商家信息
工作台概览：查看待处理订单数、未读消息数、活跃故事征集数、今日销售额、商品总数
商品管理：发布新商品（填写名称、描述、价格、库存、分类、封面图、媒体文件），编辑商品信息，上下架商品
订单管理：查看本店订单列表（按状态筛选），对已付款订单进行发货，取消未发货订单
退款处理：查看退款申请列表，同意退款（恢复库存+恢复优惠券）或拒绝退款
评价管理：查看本店商品收到的评价，回复用户评价
消息管理：查看与用户的会话列表，发送站内消息给用户，标记消息已读
反馈管理：向管理员提交反馈，查看自己的反馈列表及回复状态
销售数据概览：查看总销量、总订单数、总收入、今日收入、今日订单数
销售趋势图表：查看最近7天或30天的每日销售额和订单数曲线
热销商品排行：查看本店销量前10的商品排名及对应收入
分类销售占比：按商品分类统计销量占比，辅助经营决策
导出销售数据：将销售订单数据导出为 Excel 报表（含序号、订单号、金额、状态、创建时间）
故事征集管理：发起特产故事征集活动（设置标题、内容、封面、截止时间、奖励优惠券），查看征集列表
查看系统公告：浏览管理员发布的启用状态的公告

管理员端

账号管理：查看普通用户列表和商家列表（分页+关键词搜索），禁用/解禁用户账号，删除用户账号（商家账号同时删除商家信息）
商品管理：查看所有商品列表（按分类/状态/关键词筛选），查看商品完整详情（含媒体文件），强制上下架商品，删除商品
订单管理：查看全平台订单列表（按状态/订单号/用户筛选），查看订单详情（含买家、商家、订单项），删除订单
分类管理：创建商品分类（名称+排序），编辑分类信息，删除分类（需分类下无商品）
公告管理：创建系统公告（标题+内容），编辑公告，启用/禁用公告，删除公告
评价管理：查看全平台评价列表（按商品筛选），删除违规评价（同时删除点赞记录）
反馈管理：查看用户反馈列表（按状态筛选），回复反馈内容，标记已回复状态
故事管理：查看所有故事征集活动，删除征集（同时删除回复），查看特产故事列表（按状态筛选），审核特产故事（通过/拒绝），删除特产故事
系统日志：查看操作日志列表（分页+按操作/用户名/方法关键词搜索），记录管理员关键操作

四、项目总结

本项目技术亮点在于基于最新 Spring Boot 3 + Vue 3 构建完整前后端分离电商系统，采用 JWT 实现无状态认证，MyBatis-Plus 简化数据访问层开发，Pinia 管理前端状态，并集成 Apache POI 实现销售数据导出。系统功能覆盖电商核心流程（商品、订单、支付、评价、优惠券）以及特产文化特色功能（故事征集与展示），适用于中小型特产电商平台的二次开发、课程设计或毕业设计。