Spring Boot药店销售管理系统开发实践

1. 项目概述

作为一名有多年Java开发经验的程序员，我最近完成了一个基于Spring Boot的药店销售管理系统。这个项目源于我观察到传统药店管理中存在的信息滞后、效率低下等问题。通过这个系统，药店可以实现从药品采购、库存管理到销售统计的全流程数字化管理。

系统采用了当前主流的Spring Boot + MySQL技术栈，前端使用Vue.js框架。整个开发周期约3个月，目前已在本地测试环境中稳定运行。系统最大的亮点在于其完善的权限管理和智能预警功能，能够根据不同角色（管理员、药师、收银员、普通用户）提供差异化的操作界面和功能。

2. 技术选型与架构设计

2.1 技术栈选择

在技术选型上，我主要考虑了以下几个因素：

1. 开发效率：Spring Boot的自动配置和起步依赖可以大幅减少样板代码
2. 性能需求：药品数据更新频繁，需要保证系统响应速度
3. 安全性：药品销售涉及敏感数据，需要严格的安全控制
4. 可维护性：药店人员可能不具备专业技术背景，系统需要易于维护

最终确定的技术栈如下：

• 后端：Spring Boot 2.7 + MyBatis Plus
• 数据库：MySQL 8.0
• 缓存：Redis
• 前端：Vue 3 + Element Plus
• 构建工具：Maven

2.2 系统架构

系统采用经典的三层架构：

code复制┌───────────────────────────────────────┐
│               表现层                  │
│  (Controller/API接口/Vue前端)         │
└───────────────────────────────────────┘
                ↓
┌───────────────────────────────────────┐
│               业务逻辑层               │
│  (Service层/业务规则处理)             │
└───────────────────────────────────────┘
                ↓
┌───────────────────────────────────────┐
│               数据访问层               │
│  (DAO层/MyBatis Plus/MySQL)           │
└───────────────────────────────────────┘

这种分层设计使得各层职责明确，便于后期维护和扩展。例如，如果需要更换数据库，只需修改数据访问层的实现，不会影响其他层。

3. 核心功能实现

3.1 权限管理系统

权限管理是系统的核心模块之一。我们实现了基于RBAC（基于角色的访问控制）模型的权限系统：

java复制@Entity
@Table(name = "user")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    private String username;
    private String password;
    
    @ManyToOne
    @JoinColumn(name = "role_id")
    private Role role;
    // 其他字段和方法...
}

@Entity
@Table(name = "role")
public class Role {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    private String name;
    
    @ManyToMany
    @JoinTable(
        name = "role_permission",
        joinColumns = @JoinColumn(name = "role_id"),
        inverseJoinColumns = @JoinColumn(name = "permission_id")
    )
    private Set<Permission> permissions = new HashSet<>();
    // 其他字段和方法...
}

权限验证通过Spring Security实现，关键配置如下：

java复制@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {
    
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.authorizeRequests()
            .antMatchers("/admin/**").hasRole("ADMIN")
            .antMatchers("/pharmacist/**").hasRole("PHARMACIST")
            .antMatchers("/cashier/**").hasRole("CASHIER")
            .anyRequest().authenticated()
            .and()
            .formLogin()
            .loginPage("/login")
            .permitAll()
            .and()
            .logout()
            .permitAll();
    }
    
    // 其他配置...
}

3.2 库存预警功能

库存管理是药店系统的核心功能。我们实现了智能预警机制，当库存低于阈值时自动提醒：

java复制@Service
public class InventoryService {
    
    @Value("${inventory.warning.threshold}")
    private int warningThreshold;
    
    @Scheduled(cron = "0 0 9 * * ?") // 每天上午9点检查
    public void checkInventoryLevels() {
        List<Drug> lowStockDrugs = drugRepository
            .findByQuantityLessThan(warningThreshold);
        
        if (!lowStockDrugs.isEmpty()) {
            String message = "以下药品库存不足:\n";
            for (Drug drug : lowStockDrugs) {
                message += String.format("%s (当前库存: %d)\n", 
                    drug.getName(), drug.getQuantity());
            }
            notificationService.sendAlert(message);
        }
    }
}

这个功能大大减少了因库存不足导致的销售中断问题。在实际测试中，它能提前3-5天预警库存风险，给药店充足的补货时间。

4. 数据库设计

4.1 主要表结构

系统数据库包含20多张表，以下是几个核心表的设计：

药品表(drug_warehouse):

销售订单表(sales_order):

4.2 索引优化

为提高查询性能，我们在以下字段上建立了索引：

1. drug_warehouse表的drug_number和name字段
2. sales_order表的order_number和create_time字段
3. 所有外键字段

索引创建示例：

sql复制CREATE INDEX idx_drug_number ON drug_warehouse(drug_number);
CREATE INDEX idx_order_time ON sales_order(create_time DESC);

5. 关键业务逻辑实现

5.1 销售流程

销售流程是系统的核心业务，主要步骤如下：

1. 药师选择药品和数量
2. 系统检查库存是否充足
3. 计算总金额（考虑优惠券等折扣）
4. 生成销售订单
5. 更新库存
6. 记录财务信息

关键代码实现：

java复制@Transactional
public SalesOrder createSale(SaleRequest request) {
    // 1. 验证库存
    Drug drug = drugRepository.findById(request.getDrugId())
        .orElseThrow(() -> new DrugNotFoundException(request.getDrugId()));
    
    if (drug.getQuantity() < request.getQuantity()) {
        throw new InsufficientStockException(drug.getName(), drug.getQuantity());
    }
    
    // 2. 计算金额
    BigDecimal unitPrice = drug.getPrice();
    BigDecimal total = unitPrice.multiply(BigDecimal.valueOf(request.getQuantity()));
    
    // 应用优惠券折扣
    if (request.getCouponId() != null) {
        Coupon coupon = couponService.validateCoupon(request.getCouponId(), request.getCustomerId());
        total = coupon.applyDiscount(total);
    }
    
    // 3. 创建订单
    SalesOrder order = new SalesOrder();
    order.setOrderNumber(generateOrderNumber());
    order.setDrugId(drug.getId());
    order.setQuantity(request.getQuantity());
    order.setUnitPrice(unitPrice);
    order.setTotalAmount(total);
    order.setCustomerId(request.getCustomerId());
    order.setPharmacistId(request.getPharmacistId());
    order.setStatus("COMPLETED");
    
    salesOrderRepository.save(order);
    
    // 4. 更新库存
    drug.setQuantity(drug.getQuantity() - request.getQuantity());
    drugRepository.save(drug);
    
    // 5. 记录财务
    FinancialRecord record = new FinancialRecord();
    record.setRecordDate(LocalDate.now());
    record.setIncome(total);
    record.setType("SALE");
    record.setReferenceId(order.getId());
    financialRepository.save(record);
    
    return order;
}

5.2 采购审批流程

采购流程采用工作流设计，包含以下状态：

1. 药师创建采购申请（PENDING）
2. 管理员审核（APPROVED/REJECTED）
3. 药品入库（COMPLETED）

状态转换通过状态模式实现：

java复制public interface PurchaseOrderState {
    void approve(PurchaseOrder order);
    void reject(PurchaseOrder order);
    void complete(PurchaseOrder order);
}

@Service
@Scope("prototype")
public class PendingState implements PurchaseOrderState {
    
    @Override
    public void approve(PurchaseOrder order) {
        order.setState(new ApprovedState());
        order.setStatus("APPROVED");
        order.setUpdateTime(LocalDateTime.now());
        // 发送通知...
    }
    
    // 其他方法实现...
}

6. 系统测试与优化

6.1 性能测试

我们使用JMeter对系统进行了压力测试，主要指标如下：

1. 单药品查询API：平均响应时间<200ms (100并发)
2. 销售订单创建API：平均响应时间<500ms (50并发)
3. 库存预警检查：完成时间<3s (5000条药品记录)

6.2 缓存优化

为提高系统性能，我们针对以下数据实施了Redis缓存：

1. 药品基本信息（有效期1小时）
2. 用户权限数据（有效期30分钟）
3. 热门药品销售排行榜（每日更新）

缓存配置示例：

java复制@Configuration
@EnableCaching
public class CacheConfig {
    
    @Bean
    public RedisCacheManager cacheManager(RedisConnectionFactory factory) {
        RedisCacheConfiguration config = RedisCacheConfiguration.defaultCacheConfig()
            .entryTtl(Duration.ofHours(1))
            .disableCachingNullValues()
            .serializeValuesWith(SerializationPair.fromSerializer(new GenericJackson2JsonRedisSerializer()));
        
        return RedisCacheManager.builder(factory)
            .cacheDefaults(config)
            .build();
    }
}

7. 部署方案

系统采用Docker容器化部署，主要包含以下服务：

1. 应用服务（Spring Boot）
2. MySQL数据库
3. Redis缓存
4. Nginx反向代理

docker-compose.yml关键配置：

yaml复制version: '3'

services:
  app:
    image: pharmacy-app:latest
    ports:
      - "8080:8080"
    environment:
      - SPRING_DATASOURCE_URL=jdbc:mysql://db:3306/pharmacy
      - SPRING_REDIS_HOST=redis
    depends_on:
      - db
      - redis
  
  db:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=root
      - MYSQL_DATABASE=pharmacy
    volumes:
      - db_data:/var/lib/mysql
  
  redis:
    image: redis:6.0
    ports:
      - "6379:6379"
  
  nginx:
    image: nginx:1.19
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf

volumes:
  db_data:

8. 开发经验分享

在开发这个系统过程中，我积累了一些有价值的经验：

1. 事务管理：药品销售涉及多个表的更新操作，必须使用@Transactional确保数据一致性。我们遇到过因事务配置不当导致的库存不同步问题。

2. 批量操作优化：初期实现药品导入功能时，采用单条插入方式，性能极差。后改为批量插入，速度提升50倍：

java复制@Transactional
public void importDrugs(List<Drug> drugs) {
    int batchSize = 100;
    for (int i = 0; i < drugs.size(); i += batchSize) {
        List<Drug> batch = drugs.subList(i, Math.min(i + batchSize, drugs.size()));
        drugRepository.saveAll(batch);
    }
}

3. 日志记录：完善的日志系统对排查问题至关重要。我们使用MDC实现请求追踪：

java复制@Slf4j
@Aspect
@Component
public class LoggingAspect {
    
    @Around("execution(* com.pharmacy..*(..))")
    public Object logMethod(ProceedingJoinPoint joinPoint) throws Throwable {
        String methodName = joinPoint.getSignature().getName();
        MDC.put("method", methodName);
        
        log.info("Entering method: {}", methodName);
        try {
            Object result = joinPoint.proceed();
            log.info("Exiting method: {}", methodName);
            return result;
        } catch (Exception e) {
            log.error("Error in method {}: {}", methodName, e.getMessage());
            throw e;
        } finally {
            MDC.remove("method");
        }
    }
}

4. 接口文档：使用Swagger生成API文档，极大方便了前后端协作。配置示例：

java复制@Configuration
@EnableSwagger2
public class SwaggerConfig {
    
    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
            .select()
            .apis(RequestHandlerSelectors.basePackage("com.pharmacy.controller"))
            .paths(PathSelectors.any())
            .build()
            .apiInfo(apiInfo());
    }
    
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
            .title("药店销售系统API")
            .description("药店销售管理系统接口文档")
            .version("1.0")
            .build();
    }
}

9. 系统亮点与创新

1. 智能预警系统：除了基础的库存预警，我们还实现了：

   • 近效期药品预警（有效期3个月内）
   • 滞销药品提醒（6个月无销售）
   • 销售异常波动检测

2. 多维度报表：系统提供丰富的统计分析功能：

   • 药品销售趋势分析
   • 客户购买行为分析
   • 利润贡献度分析

3. 移动端适配：采用响应式设计，完美适配手机和平板设备，方便药师随时随地查看库存和销售情况。

10. 遇到的问题及解决方案

10.1 并发销售导致的库存超卖

初期版本在高并发销售场景下会出现库存超卖问题。我们通过以下方案解决：

1. 数据库乐观锁：

java复制@Entity
public class Drug {
    @Version
    private Integer version;
    // 其他字段...
}

2. Redis分布式锁：

java复制public boolean sellWithLock(Long drugId, int quantity) {
    String lockKey = "drug_lock:" + drugId;
    String requestId = UUID.randomUUID().toString();
    try {
        // 尝试获取锁
        boolean locked = redisTemplate.opsForValue()
            .setIfAbsent(lockKey, requestId, 30, TimeUnit.SECONDS);
        
        if (!locked) {
            return false;
        }
        
        // 执行销售逻辑
        return sellDrug(drugId, quantity);
    } finally {
        // 释放锁
        if (requestId.equals(redisTemplate.opsForValue().get(lockKey))) {
            redisTemplate.delete(lockKey);
        }
    }
}

10.2 大数据量查询性能问题

当药品记录超过10万条时，某些报表查询变得非常缓慢。优化措施包括：

1. 添加适当的数据库索引
2. 使用SQL优化（如避免SELECT *）
3. 实现分页查询
4. 对复杂报表使用定时任务预计算

11. 项目总结

这个药店销售管理系统项目让我深刻体会到业务需求与技术实现的结合之道。系统从设计到实现历时3个月，过程中遇到了各种挑战，但最终都找到了合适的解决方案。

系统的主要优势在于：

1. 完善的权限控制和审计功能，确保数据安全
2. 智能预警机制，帮助药店规避经营风险
3. 友好的用户界面，降低使用门槛
4. 良好的扩展性，方便后续功能添加

未来可能的改进方向包括：

1. 引入机器学习算法进行销售预测
2. 增加供应商协同平台功能
3. 开发微信小程序端
4. 实现与医保系统的对接

整个项目的源码已经整理上传到GitHub，包含了详细的部署文档和使用说明，希望能给有类似需求的开发者提供参考。在实际部署时，建议根据药店的具体业务需求调整系统参数，如库存预警阈值、报表统计周期等。