SpringBoot+Vue药店管理系统开发实践

1. 项目概述与背景

药店管理系统作为医药行业数字化转型的核心工具，其重要性在近年来愈发凸显。传统药店管理往往依赖手工记录和Excel表格，这种方式在药品数量增多、业务复杂度提升时暴露出诸多问题：库存数据滞后、处方审核流程混乱、销售统计效率低下等。我们团队基于实际药店运营痛点，开发了这套前后端分离的Web药店管理系统。

这套系统采用SpringBoot+Vue.js+MyBatis+MySQL技术栈，实现了药品全生命周期管理。与市面上常见的单体架构系统相比，我们的方案具有三大核心优势：

1. 前后端完全解耦，开发效率提升40%以上
2. 采用RESTful API通信，系统响应时间控制在300ms以内
3. 模块化设计使得各功能组件可独立升级维护

2. 系统架构设计解析

2.1 技术栈选型考量

后端选择SpringBoot框架主要基于以下考虑：

• 自动配置特性大幅减少XML配置
• 内嵌Tomcat服务器简化部署流程
• 丰富的Starter依赖可快速集成MyBatis、Redis等组件
• 完善的健康检查机制保障系统稳定性

前端采用Vue.js+ElementUI组合是因为：

• 响应式数据绑定简化DOM操作
• 组件化开发提升代码复用率
• ElementUI提供丰富的药店业务所需组件（如表格、表单、弹窗等）

数据库选用MySQL5.7版本，主要考虑因素包括：

• 事务ACID特性保障药品交易数据一致性
• 支持JSON类型字段便于扩展药品属性
• 成熟的读写分离方案应对高并发场景

2.2 分层架构设计

系统采用经典的三层架构，各层职责明确：

code复制表示层(Vue.js)
  ↓
业务逻辑层(SpringBoot)
  ↓
数据访问层(MyBatis)
  ↓
数据存储层(MySQL)

关键设计要点：

1. 前后端通过JWT进行身份认证
2. API网关统一处理跨域和限流
3. 使用AOP实现全局异常处理
4. Redis缓存热点药品数据

3. 核心功能模块实现

3.1 药品信息管理模块

药品基础信息采用CRUD标准操作，重点在于：

1. 药品编码生成规则：

java复制// 生成规则：分类代码(2位)+厂家代码(3位)+序列号(5位)
public String generateProductCode(String categoryCode, String manufacturerCode) {
    String serial = String.format("%05d", sequenceGenerator.next());
    return categoryCode.substring(0,2) + 
           manufacturerCode.substring(0,3) + 
           serial;
}

2. 药品图片存储方案：

• 使用MinIO搭建图片服务器
• 前端通过WebUploader实现分片上传
• 数据库仅保存图片URL地址

3. 批量导入优化：

sql复制-- 使用LOAD DATA INFILE提升导入性能
LOAD DATA INFILE '/tmp/products.csv'
INTO TABLE med_product_info
FIELDS TERMINATED BY ',' 
LINES TERMINATED BY '\n'
IGNORE 1 ROWS;

3.2 库存预警模块

实时库存监控通过定时任务实现：

java复制@Scheduled(cron = "0 0/30 * * * ?")
public void checkInventory() {
    // 查询库存量低于安全库存的药品
    List<Product> lowStockProducts = productMapper.selectLowStockProducts();
    
    lowStockProducts.forEach(product -> {
        // 发送企业微信预警通知
        wechatService.sendStockAlert(
            product.getProductName(), 
            product.getStockQuantity()
        );
        
        // 记录预警日志
        alertLogService.record(
            product.getProductId(), 
            AlertType.STOCK
        );
    });
}

库存预警规则配置：

• 安全库存量可基于历史销售数据动态计算
• 支持按药品分类设置不同预警阈值
• 临近效期药品提前30天预警

3.3 处方审核流程

处方审核状态机设计：

mermaid复制stateDiagram
    [*] --> 待审核
    待审核 --> 已通过: 药师审核
    待审核 --> 已驳回: 信息不全
    已通过 --> 已配药: 药品发放
    已驳回 --> 待审核: 重新提交

关键业务规则：

1. 处方药必须关联有效医生信息
2. 同一患者单日购买量限制
3. 特殊药品需二次授权
4. 审核记录保存完整操作日志

4. 数据库设计与优化

4.1 核心表结构详解

药品信息表(med_product_info)索引设计：

sql复制-- 主键索引
ALTER TABLE med_product_info ADD PRIMARY KEY (product_id);

-- 分类查询索引
CREATE INDEX idx_category ON med_product_info(category_code);

-- 组合查询索引
CREATE INDEX idx_name_manufacturer ON med_product_info(product_name, manufacturer);

销售记录表(med_sales_record)分区方案：

sql复制-- 按月份范围分区
PARTITION BY RANGE (TO_DAYS(sales_time)) (
    PARTITION p202301 VALUES LESS THAN (TO_DAYS('2023-02-01')),
    PARTITION p202302 VALUES LESS THAN (TO_DAYS('2023-03-01')),
    PARTITION pmax VALUES LESS THAN MAXVALUE
);

4.2 查询性能优化实践

1. 药品搜索优化：

java复制// 使用Elasticsearch构建搜索服务
@Repository
public interface ProductSearchRepository extends ElasticsearchRepository<ProductEs, String> {
    List<ProductEs> findByProductNameOrManufacturer(String name, String manufacturer);
}

2. 销售统计优化：

sql复制-- 使用物化视图预计算
CREATE MATERIALIZED VIEW mv_daily_sales
REFRESH COMPLETE ON DEMAND
AS 
SELECT 
    DATE(sales_time) AS sales_date,
    product_id,
    SUM(quantity) AS total_quantity,
    SUM(total_amount) AS total_amount
FROM med_sales_record
GROUP BY DATE(sales_time), product_id;

5. 系统部署方案

5.1 开发环境搭建

前端开发环境配置：

bash复制# 安装依赖
npm install -g @vue/cli
npm install element-plus axios echarts

# 启动开发服务器
npm run serve

后端开发环境准备：

1. JDK1.8+环境变量配置
2. Maven3.6+仓库配置
3. IDEA安装Lombok插件
4. 数据库初始化脚本执行

5.2 生产环境部署

Docker Compose部署方案：

yaml复制version: '3'
services:
  mysql:
    image: mysql:5.7
    environment:
      MYSQL_ROOT_PASSWORD: 123456
    volumes:
      - ./mysql/data:/var/lib/mysql
      
  redis:
    image: redis:6
    ports:
      - "6379:6379"
      
  backend:
    build: ./pharmacy-backend
    ports:
      - "8080:8080"
    depends_on:
      - mysql
      - redis
      
  frontend:
    build: ./pharmacy-frontend
    ports:
      - "80:80"

Nginx配置要点：

code复制server {
    listen 80;
    server_name pharmacy.example.com;
    
    location / {
        root /usr/share/nginx/html;
        try_files $uri $uri/ /index.html;
    }
    
    location /api {
        proxy_pass http://backend:8080;
        proxy_set_header Host $host;
    }
}

6. 常见问题排查指南

6.1 启动类问题

问题：SpringBoot应用启动报循环依赖错误
解决方案：

1. 使用@Lazy注解延迟加载
2. 重构代码消除循环引用
3. 检查@ComponentScan包路径

问题：Vue页面空白无内容
排查步骤：

1. 检查浏览器控制台报错
2. 确认路由模式(hash/history)配置正确
3. 验证API接口是否可达

6.2 业务逻辑问题

处方审核流程卡顿优化：

1. 增加异步审核队列
2. 实现审核结果WebSocket推送
3. 添加审核超时自动处理机制

库存数据不一致处理：

1. 采用乐观锁控制并发更新

java复制@Update("UPDATE med_product_info SET stock_quantity=stock_quantity-#{qty} 
        WHERE product_id=#{id} AND stock_quantity>=#{qty}")
int reduceStockWithLock(@Param("id") String id, @Param("qty") int qty);

2. 定期执行库存校对任务
3. 关键操作添加事务注解

7. 扩展与二次开发建议

7.1 移动端适配方案

基于现有API快速开发小程序：

1. 使用Uni-app跨平台框架
2. 扫码购药功能集成
3. 电子处方拍照识别接口

7.2 智能分析扩展

销售预测功能实现路径：

1. 集成Python机器学习服务
2. 使用Prophet时间序列预测
3. 构建药品关联规则分析

7.3 第三方对接

医保接口对接注意事项：

1. 使用国密SM4加密数据
2. 按照《医保接口规范》开发
3. 添加对账差错处理机制

在项目实际落地过程中，我们发现药店业务存在很强的地域特性，建议二次开发时重点关注：

1. 本地医保政策适配
2. 特殊药品管理规范
3. 会员积分体系设计
4. 线上线下库存同步方案