1. 项目背景与意义
随着移动互联网和社区电商的快速发展，社区团购已成为连接社区居民与本地供应商的重要零售模式。传统社区团购多依赖微信群接龙、手工记账等方式，存在订单易错、对账繁琐、团长管理困难、配送信息不透明等问题。开发一套基于SpringBoot的社区团购管理系统，能够有效解决上述痛点，实现商品管理、订单流转、团长佣金结算、用户端下单等核心业务的线上化与自动化。
从实际意义来看，该系统一方面降低了社区团购运营方的人力成本，提升了订单处理效率和准确性；另一方面通过数据化的商品与订单管理，为运营决策提供了数据支撑，有助于提升社区团购的整体服务质量与用户满意度。
2. 系统技术栈
本系统采用前后端分离架构，后端基于SpringBoot框架构建，前端采用Vue.js配合Element UI组件库，数据库使用MySQL，缓存层引入Redis。整体技术选型兼顾了开发效率、系统稳定性与后续扩展性。
| 技术分类 | 技术选型 | 主要用途 |
|---|---|---|
| 后端框架 | SpringBoot 2.7 | 业务接口开发、依赖注入、自动配置 |
| 持久层框架 | MyBatis-Plus | 数据库ORM、通用CRUD、分页查询 |
| 数据库 | MySQL 8.0 | 核心业务数据存储 |
| 缓存 | Redis | 热点数据缓存、验证码存储、分布式会话 |
| 安全认证 | Spring Security + JWT | 用户认证与接口权限控制 |
| 前端框架 | Vue.js + Element UI | 管理后台与用户端页面 |
| 构建工具 | Maven | 项目依赖管理与构建 |
3. 系统核心功能模块
社区团购管理系统主要面向三类角色：平台管理员、社区团长和普通用户。围绕这三类角色，系统划分为以下核心功能模块。
- 用户管理模块：支持用户注册、登录、个人信息维护，以及基于JWT的登录态校验。
- 商品管理模块：管理员可对商品进行上架、下架、编辑库存与价格，支持商品分类管理。
- 团购活动模块：团长可发起团购活动，设置活动时间、参团商品与成团人数门槛。
- 订单管理模块：用户下单后生成订单，支持订单状态流转（待付款、已付款、待自提、已完成、已取消）。
- 团长佣金模块：根据订单金额按比例自动计算团长佣金，支持佣金提现申请与审核。
- 数据统计模块：提供商品销量、订单金额、用户增长等维度的统计图表。
4. 数据库设计
系统核心数据表包括用户表、商品表、团购活动表、订单表、订单明细表、团长佣金表等。下面给出订单表和订单明细表的核心字段设计。
-- 订单表 CREATE TABLE `t_order` ( `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '订单ID', `order_no` varchar(32) NOT NULL COMMENT '订单编号', `user_id` bigint(20) NOT NULL COMMENT '下单用户ID', `leader_id` bigint(20) DEFAULT NULL COMMENT '团长ID', `total_amount` decimal(10,2) NOT NULL COMMENT '订单总金额', `status` tinyint(4) NOT NULL DEFAULT '0' COMMENT '订单状态：0待付款 1已付款 2待自提 3已完成 4已取消', `create_time` datetime NOT NULL COMMENT '下单时间', `pay_time` datetime DEFAULT NULL COMMENT '支付时间', PRIMARY KEY (`id`), UNIQUE KEY `uk_order_no` (`order_no`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='团购订单表'; -- 订单明细表 CREATE TABLE t_order_item ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT '明细ID', order_id bigint(20) NOT NULL COMMENT '订单ID', goods_id bigint(20) NOT NULL COMMENT '商品ID', goods_name varchar(100) NOT NULL COMMENT '商品名称', goods_price decimal(10,2) NOT NULL COMMENT '商品单价', buy_num int(11) NOT NULL COMMENT '购买数量', PRIMARY KEY (id), KEY idx_order_id (order_id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='订单明细表';5. 核心代码实现
本节选取订单提交与订单状态流转两个核心业务场景，给出后端关键代码实现。
5.1 订单提交接口
用户提交订单时，后端需要校验商品库存、计算订单金额并生成订单号。核心代码如下：
@Service public class OrderServiceImpl implements OrderService { @Autowired private OrderMapper orderMapper; @Autowired private OrderItemMapper orderItemMapper; @Autowired private GoodsMapper goodsMapper; @Autowired private StringRedisTemplate redisTemplate; @Override @Transactional(rollbackFor = Exception.class) public OrderVO createOrder(OrderCreateDTO dto, Long userId) { // 1. 生成订单号 String orderNo = generateOrderNo(); // 2. 计算订单总金额并校验库存 BigDecimal totalAmount = BigDecimal.ZERO; List<OrderItem> itemList = new ArrayList<>(); for (OrderItemDTO itemDTO : dto.getItems()) { Goods goods = goodsMapper.selectById(itemDTO.getGoodsId()); if (goods == null || goods.getStatus() != 1) { throw new BusinessException("商品不存在或已下架"); } if (goods.getStock() < itemDTO.getBuyNum()) { throw new BusinessException("商品库存不足：" + goods.getGoodsName()); } totalAmount = totalAmount.add(goods.getPrice().multiply(BigDecimal.valueOf(itemDTO.getBuyNum()))); OrderItem item = new OrderItem(); item.setOrderId(null); item.setGoodsId(goods.getId()); item.setGoodsName(goods.getGoodsName()); item.setGoodsPrice(goods.getPrice()); item.setBuyNum(itemDTO.getBuyNum()); itemList.add(item); } // 3. 保存订单主表 Order order = new Order(); order.setOrderNo(orderNo); order.setUserId(userId); order.setLeaderId(dto.getLeaderId()); order.setTotalAmount(totalAmount); order.setStatus(0); order.setCreateTime(LocalDateTime.now()); orderMapper.insert(order); // 4. 保存订单明细 for (OrderItem item : itemList) { item.setOrderId(order.getId()); orderItemMapper.insert(item); } // 5. 扣减库存 for (OrderItemDTO itemDTO : dto.getItems()) { goodsMapper.deductStock(itemDTO.getGoodsId(), itemDTO.getBuyNum()); } // 6. 缓存订单号，用于超时未支付自动取消 redisTemplate.opsForValue().set("order:pay:" + orderNo, "0", 30, TimeUnit.MINUTES); OrderVO vo = new OrderVO(); vo.setOrderNo(orderNo); vo.setTotalAmount(totalAmount); return vo; } private String generateOrderNo() { return "CG" + System.currentTimeMillis() + RandomUtil.randomNumbers(4); } }5.2 订单状态流转
订单支付成功后，系统需要更新订单状态，并同步计算团长佣金。核心代码如下：
@Service public class OrderStatusServiceImpl implements OrderStatusService { @Autowired private OrderMapper orderMapper; @Autowired private CommissionMapper commissionMapper; @Override @Transactional(rollbackFor = Exception.class) public void payOrder(String orderNo) { Order order = orderMapper.selectByOrderNo(orderNo); if (order == null) { throw new BusinessException("订单不存在"); } if (order.getStatus() != 0) { throw new BusinessException("订单状态异常，无法支付"); } // 1. 更新订单状态为已付款 order.setStatus(1); order.setPayTime(LocalDateTime.now()); orderMapper.updateById(order); // 2. 计算团长佣金（按订单金额的5%） if (order.getLeaderId() != null) { BigDecimal commissionAmount = order.getTotalAmount().multiply(new BigDecimal("0.05")); Commission commission = new Commission(); commission.setOrderId(order.getId()); commission.setLeaderId(order.getLeaderId()); commission.setAmount(commissionAmount); commission.setStatus(0); commission.setCreateTime(LocalDateTime.now()); commissionMapper.insert(commission); } // 3. 删除超时支付缓存 redisTemplate.delete("order:pay:" + orderNo); } }6. 系统部署与运行
系统采用前后端分离方式部署。后端SpringBoot项目打包为可执行JAR包，前端Vue项目构建为静态资源后由Nginx托管。数据库初始化脚本随项目源码一并提供，首次启动时执行即可完成建库建表。
# 后端打包 mvn clean package -DskipTests 启动后端服务 java -jar community-groupbuy.jar --spring.profiles.active=prod 前端构建 npm run build7. 总结
本文围绕基于SpringBoot的社区团购管理系统，从项目背景、技术栈、功能模块、数据库设计到核心代码实现进行了系统阐述。该系统通过SpringBoot + MyBatis-Plus + Redis + Vue的技术组合，实现了社区团购业务中商品、订单、佣金等核心环节的数字化管理，具备较好的实用性与扩展性。后续可在此基础上进一步引入消息队列处理高并发下单场景，并结合数据分析模块优化运营决策。
