基于SpringBoot的社区团购平台

一、项目简介

社区团购平台是一套面向社区居民的前后端分离拼团购物系统。后端采用 Spring Boot、MyBatis、MySQL 和 Token 鉴权，前端采用 Vue；系统将商品分类、商品展示、团购活动、购物车、收货地址、订单和平台公告整合在一起，并提供后台商品与活动运营能力。

项目实际包含认证、公共内容、用户地址、购物车、用户订单，以及管理员公告、分类、团购活动、订单、商品、上传和用户控制器。前端包含用户首页、地址、购物车、订单和登录页面，以及管理员看板、商品、分类、活动、订单、用户和公告页面。

二、系统功能

1.1 用户端功能

注册登录与身份认证

用户可通过 LoginRegister.vue 完成注册和登录。后端 AuthController 提供认证接口，登录后的 Token 用于保护购物车、地址和订单等个人业务数据。

商品与团购活动浏览

用户可在 UserHome.vue 浏览商品分类、商品详情和正在进行的团购活动。PublicController 向用户端提供公开商品、分类、活动和公告数据，使用户能够了解商品的团购价格、成团条件和活动状态。

购物车管理

用户可在 UserCart.vue 添加、修改或删除购物车商品，并按需要勾选商品提交订单。UserCartController 保存与当前用户关联的购物车记录。

收货地址管理

用户可在 UserAddress.vue 新增、编辑、删除收货地址并设置默认地址。下单时系统读取用户地址信息，避免每次重复填写收货资料。

订单提交与查询

用户从购物车选择商品和收货地址后提交订单。UserOrderController 负责创建订单、查询个人历史订单和展示订单状态，用户可在 UserOrders.vue 查看订单明细与处理进度。

平台公告查看

平台公告在用户首页展示，用户可阅读管理员发布的团购通知、配送提醒或活动说明。

1.2 管理员端功能

运营数据看板

AdminDashboard.vue 汇总用户、商品、订单和活动等核心数据，为管理员了解社区团购业务运行情况提供数据概览。

商品分类与商品管理

管理员可在 AdminCategories.vue 维护商品分类，在 AdminProducts.vue 新增、编辑、删除商品，维护商品封面、价格、库存和上下架状态。AdminUploadController 支持商品素材上传。

团购活动管理

管理员可在 AdminActivities.vue 创建和维护团购活动，为活动绑定商品、设置团购价、开始结束时间和成团人数等规则。活动状态会直接影响用户端活动展示与下单选择。

订单、用户与公告管理

管理员可在 AdminOrders.vue 查询全量订单并手动更新订单状态；在 AdminUsers.vue 查询用户并启用或禁用账号；在 AdminAnnouncements.vue 发布、编辑和删除平台公告。

三、技术栈

层级	技术	说明
后端	Java 8、Spring Boot 2.7.18	业务接口服务
数据访问	MyBatis、MySQL 8.x	商品、活动、订单、地址和用户数据存储
身份认证	Token、拦截器	用户和管理员接口访问控制
前端	Vue 2.7、Vue Router、Axios	用户端与后台管理页面

四、项目结构

c217/
├── backend/src/main/java/com/community/groupbuy/
│   ├── controller/
│   │   ├── AuthController.java
│   │   ├── PublicController.java
│   │   ├── UserAddressController.java
│   │   ├── UserCartController.java
│   │   ├── UserOrderController.java
│   │   └── Admin*Controller.java       # 商品、分类、活动、订单、用户、公告和上传
│   ├── common/                          # Token、拦截器、统一返回与异常处理
│   └── config/                          # Web 配置
├── frontend/src/
│   ├── views/user/                      # 首页、地址、购物车、订单页面
│   └── views/admin/                     # 看板、商品、分类、活动、订单、用户、公告页面
├── sql/
│   ├── community_group_buy.sql          # 基础建表脚本
│   └── community_group_buy_rich_data.sql # 丰富初始化数据
└── README.md

五、环境要求

JDK 8
Maven 3.6+
MySQL 8.x
Node.js 12+
npm

六、数据库初始化

先导入基础建表脚本，再根据需要导入丰富初始化数据。完成后修改后端数据源连接为本机 MySQL 配置。

mysql -u root -p --default-character-set=utf8mb4 < sql/community_group_buy.sql
mysql -u root -p --default-character-set=utf8mb4 < sql/community_group_buy_rich_data.sql

七、后端启动

cd backend
mvn spring-boot:run

八、前端启动

cd frontend
npm install
npm run serve

九、默认账号

项目未提供可确认的默认账号，请以 community_group_buy_rich_data.sql 中的初始化数据为准。

十、业务流程说明

9.1 团购下单流程

用户登录后浏览商品或团购活动，查看活动价格和成团规则，将商品加入购物车。用户选择收货地址后提交订单，系统创建订单及商品明细；用户可在订单页面查看状态。

管理员在订单管理中查看订单并更新处理状态，处理结果同步反馈到用户订单列表。团购活动的商品、价格和状态由后台活动管理统一维护。

9.2 商品与活动运营流程

管理员先维护商品分类和商品资料，上传商品封面并设置上下架状态，再创建团购活动并绑定对应商品。活动满足发布条件后在用户首页展示，用户报名或购买产生的订单数据会汇总到后台看板和订单管理模块。

十一、交付内容

项目完整源码，包含 Spring Boot 后端与 Vue 前端代码。
数据库脚本 community_group_buy.sql 与 community_group_buy_rich_data.sql。
项目说明文档，包含功能说明、环境、初始化和启动步骤。

本项目为个人原创，结构清晰，功能完整，适合课程设计、毕业设计和个人学习使用。如需购买项目成品或定制化需求可以联系作者。