SpringBoot+Vue医药管理系统架构与优化实践-代码聚汇网

SpringBoot+Vue医药管理系统架构与优化实践

大JoeJoe

1. 企业级医药管理系统架构解析

这套基于SpringBoot+Vue+MyBatis+MySQL的企业级医药管理系统，采用了当前主流的全栈技术架构。前端使用Vue.js构建响应式用户界面，后端采用SpringBoot提供RESTful API服务，数据持久层通过MyBatis与MySQL数据库交互，形成了完整的前后端分离解决方案。

1.1 技术栈选型依据

SpringBoot作为后端框架的选择主要基于其快速开发特性和企业级支持能力。在医药行业场景下，SpringBoot的内置健康检查、指标监控和安全防护功能特别重要。我们实测发现，通过简单的配置就能实现药品批次追踪所需的审计日志功能。

Vue.js的渐进式特性让前端团队可以按需引入状态管理（Vuex）和路由（Vue Router），这对于医药管理系统复杂的表单交互（如处方开具界面）特别有价值。最新使用的Vue 3组合式API大幅提升了代码复用率。

MyBatis+MySQL的组合在医药数据管理方面展现出独特优势：

精确控制SQL语句，优化药品库存查询性能
类型处理器完美处理医药特有的数据格式（如药品有效期）
事务管理确保处方开立与库存扣减的原子性

1.2 系统模块划分

核心业务模块包括：

药品档案管理
- 药品基本信息维护（批准文号、规格、厂商）
- 药品分类体系（ATC编码）
- 药品图片及说明书管理
库存管理子系统
- 批次管理（效期追踪）
- 库存预警（低库存、近效期提醒）
- 出入库流水记录
处方管理模块
- 电子处方开具
- 配伍禁忌检查
- 处方审核流程
统计分析报表
- 药品销量TOP分析
- 效期预警报表
- 医师处方统计

2. 数据库设计与优化实践

2.1 核心表结构设计

药品主表采用符合GSP规范的字段设计：

sql复制CREATE TABLE `medicine` (
  `id` bigint(20) NOT NULL COMMENT '药品ID',
  `code` varchar(20) NOT NULL COMMENT '药品编码',
  `name` varchar(100) NOT NULL COMMENT '通用名称',
  `spec` varchar(50) NOT NULL COMMENT '规格',
  `manufacturer` varchar(200) NOT NULL COMMENT '生产厂家',
  `approval_no` varchar(50) NOT NULL COMMENT '批准文号',
  `category_id` int(11) NOT NULL COMMENT '分类ID',
  `unit` varchar(10) NOT NULL COMMENT '单位',
  `price` decimal(10,2) NOT NULL COMMENT '单价',
  `stock_warning` int(11) DEFAULT NULL COMMENT '库存预警值',
  `status` tinyint(4) NOT NULL DEFAULT '1' COMMENT '状态',
  PRIMARY KEY (`id`),
  UNIQUE KEY `idx_code` (`code`),
  KEY `idx_category` (`category_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='药品信息表';

库存批次表设计要点：

采用双主键（药品ID+批次号）
包含生产日期和有效期字段
使用无符号整型存储库存数量

2.2 查询性能优化方案

针对医药管理系统特有的查询场景，我们实施了以下优化：

药品模糊查询优化：

java复制@Select("<script>" +
        "SELECT * FROM medicine WHERE 1=1 " +
        "<if test='keyword != null'> AND (name LIKE CONCAT('%',#{keyword},'%') OR code LIKE CONCAT('%',#{keyword},'%'))</if>" +
        "<if test='categoryId != null'> AND category_id = #{categoryId}</if>" +
        " ORDER BY id DESC LIMIT #{offset}, #{pageSize}" +
        "</script>")
List<Medicine> searchMedicines(@Param("keyword") String keyword, 
                              @Param("categoryId") Integer categoryId,
                              @Param("offset") int offset,
                              @Param("pageSize") int pageSize);

库存预警视图：

sql复制CREATE VIEW v_stock_alert AS
SELECT m.name, m.spec, b.batch_no, b.quantity, 
       DATEDIFF(b.expire_date, CURDATE()) AS remain_days
FROM medicine m
JOIN medicine_batch b ON m.id = b.medicine_id
WHERE b.quantity < m.stock_warning 
   OR DATEDIFF(b.expire_date, CURDATE()) < 30;

使用MySQL窗口函数优化销售统计：

sql复制SELECT 
    medicine_id,
    SUM(quantity) AS total_sales,
    RANK() OVER (ORDER BY SUM(quantity) DESC) AS sales_rank
FROM prescription_detail
WHERE create_time BETWEEN '2023-01-01' AND '2023-12-31'
GROUP BY medicine_id
LIMIT 10;

3. 关键业务逻辑实现

3.1 处方开具事务处理

处方开立涉及多个数据表的原子性操作，我们采用Spring声明式事务管理：

java复制@Service
@RequiredArgsConstructor
public class PrescriptionServiceImpl implements PrescriptionService {
    private final PrescriptionMapper prescriptionMapper;
    private final PrescriptionDetailMapper detailMapper;
    private final StockMapper stockMapper;

    @Transactional(rollbackFor = Exception.class)
    public void createPrescription(PrescriptionDTO dto) {
        // 1. 保存处方主表
        Prescription prescription = convertToEntity(dto);
        prescriptionMapper.insert(prescription);
        
        // 2. 保存处方明细并扣减库存
        for (PrescriptionDetailDTO item : dto.getDetails()) {
            PrescriptionDetail detail = convertDetailToEntity(item);
            detail.setPrescriptionId(prescription.getId());
            detailMapper.insert(detail);
            
            // 扣减库存
            stockMapper.decreaseStock(item.getMedicineId(), 
                                    item.getBatchNo(), 
                                    item.getQuantity());
        }
        
        // 3. 记录操作日志
        logService.recordOperation(OperationType.CREATE_PRESCRIPTION, 
                                 prescription.getId());
    }
}

3.2 药品配伍禁忌检查

实现基于规则引擎的药品相互作用检查：

java复制public class DrugInteractionChecker {
    private static final Map<String, Set<String>> INTERACTION_RULES = Map.of(
        "抗生素", Set.of("抗凝药", "利尿剂"),
        "降压药", Set.of("抗抑郁药", "NSAIDs")
    );
    
    public List<String> checkInteractions(List<Medicine> medicines) {
        List<String> warnings = new ArrayList<>();
        Set<String> categories = medicines.stream()
            .map(Medicine::getCategoryName)
            .collect(Collectors.toSet());
            
        for (String category : categories) {
            if (INTERACTION_RULES.containsKey(category)) {
                Set<String> conflictCategories = INTERACTION_RULES.get(category);
                for (Medicine med : medicines) {
                    if (conflictCategories.contains(med.getCategoryName())) {
                        warnings.add(String.format(
                            "[警告] %s(%s) 与 %s 类药物存在配伍禁忌", 
                            med.getName(), 
                            med.getCategoryName(),
                            category));
                    }
                }
            }
        }
        return warnings;
    }
}

4. 系统安全与合规设计

4.1 医药数据特殊保护

敏感字段加密存储：

java复制@Column(name = "patient_name")
@Convert(converter = CryptoConverter.class)
private String patientName;

// 加密转换器实现
public class CryptoConverter implements AttributeConverter<String, String> {
    private static final String KEY = "secure-key-123";
    
    @Override
    public String convertToDatabaseColumn(String attribute) {
        return AES.encrypt(attribute, KEY);
    }
    
    @Override
    public String convertToEntityAttribute(String dbData) {
        return AES.decrypt(dbData, KEY);
    }
}

审计日志实现：

java复制@Aspect
@Component
@RequiredArgsConstructor
public class AuditLogAspect {
    private final AuditLogMapper logMapper;
    
    @Pointcut("execution(* com.medical..service..*(..))")
    public void serviceLayer() {}
    
    @AfterReturning(pointcut = "serviceLayer()", returning = "result")
    public void logAfterReturning(JoinPoint joinPoint, Object result) {
        AuditLog log = new AuditLog();
        log.setOperation(joinPoint.getSignature().getName());
        log.setParams(Arrays.toString(joinPoint.getArgs()));
        log.setResult(result != null ? result.toString() : null);
        log.setUserId(SecurityUtils.getCurrentUserId());
        logMapper.insert(log);
    }
}

4.2 基于Spring Security的权限控制

医药管理系统采用RBAC模型，实现细粒度权限控制：

java复制@Configuration
@EnableWebSecurity
@RequiredArgsConstructor
public class SecurityConfig extends WebSecurityConfigurerAdapter {
    private final UserDetailsService userDetailsService;
    
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.csrf().disable()
            .authorizeRequests()
            .antMatchers("/api/auth/**").permitAll()
            .antMatchers("/api/doctor/**").hasRole("DOCTOR")
            .antMatchers("/api/pharmacist/**").hasRole("PHARMACIST")
            .antMatchers("/api/admin/**").hasRole("ADMIN")
            .anyRequest().authenticated()
            .and()
            .addFilter(new JwtAuthenticationFilter(authenticationManager()))
            .addFilter(new JwtAuthorizationFilter(authenticationManager()))
            .sessionManagement()
            .sessionCreationPolicy(SessionCreationPolicy.STATELESS);
    }
    
    @Bean
    public PasswordEncoder passwordEncoder() {
        return new BCryptPasswordEncoder();
    }
}

5. 部署与运维实践

5.1 多环境配置管理

使用SpringBoot Profile实现环境隔离：

yaml复制# application-dev.yml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/medical_dev
    username: dev_user
    password: dev123
    
# application-prod.yml
spring:
  datasource:
    url: jdbc:mysql://prod-db:3306/medical_prod
    username: ${DB_USER}
    password: ${DB_PASSWORD}
  redis:
    host: redis-cluster

5.2 前端部署优化

Vue项目通过以下配置实现生产环境优化：

javascript复制// vue.config.js
module.exports = {
  productionSourceMap: false,
  configureWebpack: {
    optimization: {
      splitChunks: {
        chunks: 'all',
        cacheGroups: {
          vendor: {
            test: /[\\/]node_modules[\\/]/,
            name(module) {
              const packageName = module.context.match(
                /[\\/]node_modules[\\/](.*?)([\\/]|$)/
              )[1];
              return `npm.${packageName.replace('@', '')}`;
            }
          }
        }
      }
    }
  },
  chainWebpack: config => {
    config.plugin('preload').tap(options => {
      options[0].fileBlacklist.push(/\.map$/);
      return options;
    });
  }
};

6. 常见问题排查指南

6.1 MyBatis映射异常处理

问题现象：查询返回的药品实体类中manufacturer字段始终为null

排查步骤：

检查SQL查询结果是否包含该列
确认实体类字段名与数据库列名是否一致
检查是否有TypeHandler配置错误

解决方案：

xml复制<!-- 显式指定列别名 -->
<resultMap id="medicineResultMap" type="Medicine">
  <result column="manufacturer_name" property="manufacturer"/>
</resultMap>

<select id="selectById" resultMap="medicineResultMap">
  SELECT 
    id, name, spec, 
    manufacturer AS manufacturer_name  <!-- 别名匹配 -->
  FROM medicine
  WHERE id = #{id}
</select>

6.2 库存并发问题

问题场景：多个处方同时扣减同一药品库存导致数据不一致