SpringBoot农产品供销系统设计与实现

胖葫芦

1. 项目背景与核心需求

农产品供销一直是农业产业链中的关键环节，但传统模式存在诸多痛点。作为一名长期关注农业信息化的开发者，我在实际调研中发现：农户与采购商之间往往需要经过3-4级中间商，导致农产品流通成本增加30%-50%；同时由于信息不透明，经常出现区域性滞销与价格波动问题。

这个基于SpringBoot的农产品供销系统，正是为了解决这些行业痛点而设计。系统实现了从生产端到消费端的直连通道，具备以下核心价值：

消除信息差：实时展示农产品库存、价格、规格等关键信息
简化交易流程：支持在线议价、电子合同、担保支付等全流程数字化
提升管理效率：自动化订单处理、库存预警、物流跟踪等功能
数据可视化：为农户提供销售数据分析，辅助生产决策

2. 技术架构设计

2.1 整体技术栈选型

经过对比主流技术方案，最终确定以下技术组合：

后端框架：SpringBoot 2.7 + MyBatis-Plus
- 选型理由：快速构建RESTful API，内置Tomcat简化部署
数据库：MySQL 8.0
- 关键配置：启用InnoDB集群，设置事务隔离级别为READ-COMMITTED
前端技术：Thymeleaf + Bootstrap5
- 特别优化：采用懒加载技术提升农产品列表页性能
安全方案：Spring Security + JWT
- 实现细节：密码BCrypt加密，接口权限粒度控制到按钮级

2.2 系统分层架构

采用经典的三层架构，但针对电商场景做了特殊优化：

code复制表现层
  ├── Web控制器(Controller)
  └── 视图渲染(View)
业务层 
  ├── 服务接口(Service)
  └── 领域模型(Domain)
持久层
  ├── 数据访问(DAO)
  └── 缓存处理(Cache)

特别注意：在商品查询服务中引入二级缓存策略，先用Redis缓存热点数据，未命中再查数据库，实测QPS提升8倍。

3. 核心功能实现

3.1 农产品展示模块

3.1.1 分类体系设计

采用三级分类结构（大类-中类-小类），数据库设计如下：

sql复制CREATE TABLE `product_category` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `parent_id` bigint DEFAULT NULL COMMENT '父分类ID',
  `name` varchar(64) NOT NULL,
  `level` int DEFAULT NULL COMMENT '分类层级',
  PRIMARY KEY (`id`),
  KEY `idx_parent_id` (`parent_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

3.1.2 商品详情页优化

实现技术要点：

使用MySQL全文索引加速商品搜索
图片采用CDN分发，格式转换为WebP
价格字段使用DECIMAL(10,2)避免精度丢失

3.2 交易流程实现

3.2.1 购物车设计

java复制// 购物车核心逻辑
public Cart addToCart(Long userId, Long productId, Integer quantity) {
    // 1. 校验库存
    Product product = productService.checkStock(productId, quantity);
    
    // 2. 合并相同商品
    Cart cart = cartRepository.findByUserAndProduct(userId, productId)
        .orElse(new Cart(userId, productId));
    cart.addQuantity(quantity);
    
    // 3. 计算实时价格
    cart.setCurrentPrice(product.getPrice());
    
    return cartRepository.save(cart);
}

3.2.2 订单状态机

设计六种核心状态：

code复制待支付 → 已支付 → 已发货 → 已完成
            ↘  已取消 ← 退款中

使用状态模式实现：

java复制public interface OrderState {
    void pay(Order order);
    void cancel(Order order);
    void refund(Order order);
    // ...其他操作
}

4. 数据库设计与优化

4.1 关键表结构

4.1.1 订单表设计

sql复制CREATE TABLE `order` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `order_no` varchar(32) NOT NULL COMMENT '订单编号',
  `user_id` bigint NOT NULL,
  `total_amount` decimal(10,2) NOT NULL COMMENT '订单总额',
  `payment_type` tinyint DEFAULT NULL COMMENT '1-支付宝 2-微信',
  `status` tinyint NOT NULL DEFAULT '0' COMMENT '订单状态',
  `address_id` bigint NOT NULL COMMENT '收货地址',
  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_order_no` (`order_no`),
  KEY `idx_user_id` (`user_id`),
  KEY `idx_create_time` (`create_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

4.2 性能优化实践

索引优化：
- 为所有外键字段添加普通索引
- 订单表建立组合索引 (user_id, create_time)

SQL优化：

sql复制/* 反例 - 全表扫描 */
SELECT * FROM product WHERE price > 10;

/* 正例 - 使用覆盖索引 */
SELECT id,name FROM product 
WHERE category_id = 5 AND status = 1
ORDER BY sales DESC LIMIT 10;

5. 典型问题解决方案

5.1 并发库存扣减

采用乐观锁实现：

java复制@Transactional
public boolean reduceStock(Long productId, Integer quantity) {
    Product product = productMapper.selectById(productId);
    if (product.getStock() < quantity) {
        throw new BusinessException("库存不足");
    }
    
    int rows = productMapper.updateStock(
        productId, quantity, product.getVersion());
    return rows > 0;
}

对应Mapper：

xml复制<update id="updateStock">
    UPDATE product 
    SET stock = stock - #{quantity},
        version = version + 1
    WHERE id = #{id} AND version = #{version}
</update>

5.2 分布式事务问题

支付成功后需要：

更新订单状态
扣减库存
生成交易记录

使用本地消息表实现最终一致性：

java复制// 1. 创建订单（状态为待支付）
Order order = createOrder();

// 2. 预扣减库存（冻结库存）
freezeStock(order.getItems());

// 3. 支付成功后发送MQ消息
rabbitTemplate.convertAndSend(
    "order.pay.success", 
    new OrderMessage(order.getId()));