1. 项目背景与意义随着居民生活水平的提升和健康意识的增强鲜奶作为日常营养食品的需求持续增长。社区鲜奶订购场景具有高频、周期性强、配送时效要求高等特点传统电话订购、线下登记等方式存在记录易丢失、配送信息不透明、订单统计繁琐等问题。开发一套基于SpringBoot的社区鲜奶订购系统能够将用户下单、订单管理、配送安排、支付记录等环节数字化帮助社区奶站和配送人员提升运营效率降低人工差错同时为居民提供更便捷的订购体验。从技术角度看SpringBoot框架简化了项目搭建与配置流程配合MyBatis-Plus、MySQL等成熟组件可以快速构建稳定可靠的后端服务。本系统的设计与实现既贴合社区零售数字化趋势也具备较强的工程实践价值。2. 系统技术栈本系统采用前后端分离架构后端基于SpringBoot构建RESTful API前端使用Vue.js配合Element UI实现管理界面移动端通过H5页面适配用户订购操作。整体技术选型如下层次技术选型说明后端框架SpringBoot 2.7.x核心业务服务与接口管理持久层框架MyBatis-Plus简化数据库操作与分页查询数据库MySQL 8.0存储用户、商品、订单等业务数据权限认证Spring Security JWT用户登录认证与接口鉴权前端框架Vue.js 3 Element UI后台管理与用户订购界面接口文档Swagger / Knife4j自动生成接口调试文档构建工具Maven项目依赖管理与打包3. 系统功能模块设计系统面向三类角色普通社区居民、配送管理员和系统管理员。核心功能模块划分如下用户模块注册登录、个人信息维护、收货地址管理。商品模块鲜奶商品分类展示、库存管理、上下架操作。订购模块用户选择商品加入购物车、提交订单、查看订单状态。配送模块配送员查看当日配送任务、更新配送状态。订单管理模块管理员查询订单、处理退款、统计销售数据。公告模块发布社区鲜奶供应通知与活动信息。4. 数据库设计系统核心数据表包括用户表、商品表、订单表、订单明细表、配送任务表和地址表。订单表与订单明细表采用一对多关系配送任务表与订单表关联便于按配送员和日期维度查询任务。以下为订单表的核心字段设计CREATE TABLE orders ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 订单ID, order_no varchar(32) NOT NULL COMMENT 订单编号, user_id bigint(20) NOT NULL COMMENT 下单用户ID, total_amount decimal(10,2) NOT NULL COMMENT 订单总金额, status tinyint(4) NOT NULL DEFAULT 0 COMMENT 订单状态0待支付 1已支付 2配送中 3已完成 4已取消, delivery_date date DEFAULT NULL COMMENT 期望配送日期, address_id bigint(20) DEFAULT NULL COMMENT 收货地址ID, create_time datetime DEFAULT CURRENT_TIMESTAMP COMMENT 创建时间, update_time datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 更新时间, PRIMARY KEY (id), KEY idx_user_id (user_id), KEY idx_order_no (order_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT鲜奶订购订单表;5. 核心代码实现本节选取订单提交与订单状态流转两个核心业务场景展示后端关键代码实现。5.1 订单提交接口用户提交订单时后端需要校验商品库存、计算订单金额并生成订单编号。核心代码如下Service public class OrderServiceImpl implements OrderService { Resource private OrderMapper orderMapper; Resource private OrderItemMapper orderItemMapper; Resource private ProductMapper productMapper; Override Transactional(rollbackFor Exception.class) public OrderVO createOrder(OrderCreateDTO dto, Long userId) { // 1. 查询购物车商品信息 ListCartItem cartItems dto.getItems(); if (CollectionUtils.isEmpty(cartItems)) { throw new BusinessException(订购商品不能为空); } // 2. 计算订单总金额并校验库存 BigDecimal totalAmount BigDecimal.ZERO; ListOrderItem orderItems new ArrayList(); for (CartItem item : cartItems) { Product product productMapper.selectById(item.getProductId()); if (product null || product.getStatus() ! 1) { throw new BusinessException(商品不存在或已下架); } if (product.getStock() item.getQuantity()) { throw new BusinessException(商品库存不足 product.getName()); } BigDecimal itemAmount product.getPrice().multiply(BigDecimal.valueOf(item.getQuantity())); totalAmount totalAmount.add(itemAmount); OrderItem orderItem new OrderItem(); orderItem.setProductId(product.getId()); orderItem.setProductName(product.getName()); orderItem.setPrice(product.getPrice()); orderItem.setQuantity(item.getQuantity()); orderItem.setItemAmount(itemAmount); orderItems.add(orderItem); } // 3. 创建订单主记录 Order order new Order(); order.setOrderNo(generateOrderNo()); order.setUserId(userId); order.setTotalAmount(totalAmount); order.setStatus(0); order.setDeliveryDate(dto.getDeliveryDate()); order.setAddressId(dto.getAddressId()); orderMapper.insert(order); // 4. 保存订单明细 for (OrderItem orderItem : orderItems) { orderItem.setOrderId(order.getId()); orderItemMapper.insert(orderItem); } // 5. 扣减库存 for (CartItem item : cartItems) { productMapper.deductStock(item.getProductId(), item.getQuantity()); } return OrderVO.fromEntity(order); } private String generateOrderNo() { return MILK System.currentTimeMillis() RandomUtil.randomNumbers(4); } }5.2 订单状态流转配送员完成配送后更新订单状态系统同时记录操作日志。核心代码如下Override Transactional(rollbackFor Exception.class) public void updateOrderStatus(Long orderId, Integer targetStatus, Long operatorId) { Order order orderMapper.selectById(orderId); if (order null) { throw new BusinessException(订单不存在); } // 校验状态流转合法性 Integer currentStatus order.getStatus(); if (!isValidTransition(currentStatus, targetStatus)) { throw new BusinessException(非法的订单状态流转); } // 更新订单状态 Order update new Order(); update.setId(orderId); update.setStatus(targetStatus); orderMapper.updateById(update); // 记录操作日志 OrderLog log new OrderLog(); log.setOrderId(orderId); log.setOperatorId(operatorId); log.setFromStatus(currentStatus); log.setToStatus(targetStatus); log.setRemark(订单状态更新); orderLogMapper.insert(log); } private boolean isValidTransition(Integer from, Integer to) { // 0待支付 - 1已支付 / 4已取消 // 1已支付 - 2配送中 / 4已取消 // 2配送中 - 3已完成 if (from 0) { return to 1 || to 4; } if (from 1) { return to 2 || to 4; } if (from 2) { return to 3; } return false; }6. 系统测试与总结系统完成开发后针对用户注册登录、商品浏览、下单支付、配送状态更新等核心流程进行了功能测试同时使用JMeter对订单提交接口进行了基础性能验证。测试结果表明系统各模块功能运行稳定接口响应满足日常业务需求。本系统通过SpringBoot与Vue.js的组合实现了社区鲜奶订购业务的线上化闭环有效提升了奶站运营效率和居民订购体验。后续可在支付对接、配送路线优化、用户画像推荐等方面进一步扩展持续完善系统能力。 基于SpringBoot的社区鲜奶订购系统的设计与实现
1. 项目背景与意义随着居民生活水平的提升和健康意识的增强鲜奶作为日常营养食品的需求持续增长。社区鲜奶订购场景具有高频、周期性强、配送时效要求高等特点传统电话订购、线下登记等方式存在记录易丢失、配送信息不透明、订单统计繁琐等问题。开发一套基于SpringBoot的社区鲜奶订购系统能够将用户下单、订单管理、配送安排、支付记录等环节数字化帮助社区奶站和配送人员提升运营效率降低人工差错同时为居民提供更便捷的订购体验。从技术角度看SpringBoot框架简化了项目搭建与配置流程配合MyBatis-Plus、MySQL等成熟组件可以快速构建稳定可靠的后端服务。本系统的设计与实现既贴合社区零售数字化趋势也具备较强的工程实践价值。2. 系统技术栈本系统采用前后端分离架构后端基于SpringBoot构建RESTful API前端使用Vue.js配合Element UI实现管理界面移动端通过H5页面适配用户订购操作。整体技术选型如下层次技术选型说明后端框架SpringBoot 2.7.x核心业务服务与接口管理持久层框架MyBatis-Plus简化数据库操作与分页查询数据库MySQL 8.0存储用户、商品、订单等业务数据权限认证Spring Security JWT用户登录认证与接口鉴权前端框架Vue.js 3 Element UI后台管理与用户订购界面接口文档Swagger / Knife4j自动生成接口调试文档构建工具Maven项目依赖管理与打包3. 系统功能模块设计系统面向三类角色普通社区居民、配送管理员和系统管理员。核心功能模块划分如下用户模块注册登录、个人信息维护、收货地址管理。商品模块鲜奶商品分类展示、库存管理、上下架操作。订购模块用户选择商品加入购物车、提交订单、查看订单状态。配送模块配送员查看当日配送任务、更新配送状态。订单管理模块管理员查询订单、处理退款、统计销售数据。公告模块发布社区鲜奶供应通知与活动信息。4. 数据库设计系统核心数据表包括用户表、商品表、订单表、订单明细表、配送任务表和地址表。订单表与订单明细表采用一对多关系配送任务表与订单表关联便于按配送员和日期维度查询任务。以下为订单表的核心字段设计CREATE TABLE orders ( id bigint(20) NOT NULL AUTO_INCREMENT COMMENT 订单ID, order_no varchar(32) NOT NULL COMMENT 订单编号, user_id bigint(20) NOT NULL COMMENT 下单用户ID, total_amount decimal(10,2) NOT NULL COMMENT 订单总金额, status tinyint(4) NOT NULL DEFAULT 0 COMMENT 订单状态0待支付 1已支付 2配送中 3已完成 4已取消, delivery_date date DEFAULT NULL COMMENT 期望配送日期, address_id bigint(20) DEFAULT NULL COMMENT 收货地址ID, create_time datetime DEFAULT CURRENT_TIMESTAMP COMMENT 创建时间, update_time datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT 更新时间, PRIMARY KEY (id), KEY idx_user_id (user_id), KEY idx_order_no (order_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT鲜奶订购订单表;5. 核心代码实现本节选取订单提交与订单状态流转两个核心业务场景展示后端关键代码实现。5.1 订单提交接口用户提交订单时后端需要校验商品库存、计算订单金额并生成订单编号。核心代码如下Service public class OrderServiceImpl implements OrderService { Resource private OrderMapper orderMapper; Resource private OrderItemMapper orderItemMapper; Resource private ProductMapper productMapper; Override Transactional(rollbackFor Exception.class) public OrderVO createOrder(OrderCreateDTO dto, Long userId) { // 1. 查询购物车商品信息 ListCartItem cartItems dto.getItems(); if (CollectionUtils.isEmpty(cartItems)) { throw new BusinessException(订购商品不能为空); } // 2. 计算订单总金额并校验库存 BigDecimal totalAmount BigDecimal.ZERO; ListOrderItem orderItems new ArrayList(); for (CartItem item : cartItems) { Product product productMapper.selectById(item.getProductId()); if (product null || product.getStatus() ! 1) { throw new BusinessException(商品不存在或已下架); } if (product.getStock() item.getQuantity()) { throw new BusinessException(商品库存不足 product.getName()); } BigDecimal itemAmount product.getPrice().multiply(BigDecimal.valueOf(item.getQuantity())); totalAmount totalAmount.add(itemAmount); OrderItem orderItem new OrderItem(); orderItem.setProductId(product.getId()); orderItem.setProductName(product.getName()); orderItem.setPrice(product.getPrice()); orderItem.setQuantity(item.getQuantity()); orderItem.setItemAmount(itemAmount); orderItems.add(orderItem); } // 3. 创建订单主记录 Order order new Order(); order.setOrderNo(generateOrderNo()); order.setUserId(userId); order.setTotalAmount(totalAmount); order.setStatus(0); order.setDeliveryDate(dto.getDeliveryDate()); order.setAddressId(dto.getAddressId()); orderMapper.insert(order); // 4. 保存订单明细 for (OrderItem orderItem : orderItems) { orderItem.setOrderId(order.getId()); orderItemMapper.insert(orderItem); } // 5. 扣减库存 for (CartItem item : cartItems) { productMapper.deductStock(item.getProductId(), item.getQuantity()); } return OrderVO.fromEntity(order); } private String generateOrderNo() { return MILK System.currentTimeMillis() RandomUtil.randomNumbers(4); } }5.2 订单状态流转配送员完成配送后更新订单状态系统同时记录操作日志。核心代码如下Override Transactional(rollbackFor Exception.class) public void updateOrderStatus(Long orderId, Integer targetStatus, Long operatorId) { Order order orderMapper.selectById(orderId); if (order null) { throw new BusinessException(订单不存在); } // 校验状态流转合法性 Integer currentStatus order.getStatus(); if (!isValidTransition(currentStatus, targetStatus)) { throw new BusinessException(非法的订单状态流转); } // 更新订单状态 Order update new Order(); update.setId(orderId); update.setStatus(targetStatus); orderMapper.updateById(update); // 记录操作日志 OrderLog log new OrderLog(); log.setOrderId(orderId); log.setOperatorId(operatorId); log.setFromStatus(currentStatus); log.setToStatus(targetStatus); log.setRemark(订单状态更新); orderLogMapper.insert(log); } private boolean isValidTransition(Integer from, Integer to) { // 0待支付 - 1已支付 / 4已取消 // 1已支付 - 2配送中 / 4已取消 // 2配送中 - 3已完成 if (from 0) { return to 1 || to 4; } if (from 1) { return to 2 || to 4; } if (from 2) { return to 3; } return false; }6. 系统测试与总结系统完成开发后针对用户注册登录、商品浏览、下单支付、配送状态更新等核心流程进行了功能测试同时使用JMeter对订单提交接口进行了基础性能验证。测试结果表明系统各模块功能运行稳定接口响应满足日常业务需求。本系统通过SpringBoot与Vue.js的组合实现了社区鲜奶订购业务的线上化闭环有效提升了奶站运营效率和居民订购体验。后续可在支付对接、配送路线优化、用户画像推荐等方面进一步扩展持续完善系统能力。