Spring Boot+MySQL构建社区医疗系统开发实践

莫姐

1. 项目背景与核心价值

社区医疗服务系统是当前医疗信息化建设的重要方向。随着分级诊疗制度的推进，基层医疗机构需要更高效的信息化管理工具来提升服务质量和运营效率。这个毕业设计项目选择Java+Spring Boot+MySQL的技术栈，既考虑了教学实践需求，又兼顾了实际应用场景。

我在三甲医院信息科工作期间，曾参与过多个类似系统的实施。社区医疗系统相比大型医院HIS系统，更注重以下几个特点：

就诊流程简化
慢性病管理功能
家庭医生签约服务
药品库存管理
居民健康档案

2. 技术选型解析

2.1 Spring Boot框架优势

选择Spring Boot主要基于以下考虑：

快速开发：内嵌Tomcat，约定优于配置
微服务友好：便于后期扩展为多模块架构
丰富生态：Spring Data JPA、Spring Security等子项目可直接集成
教学价值：企业级开发标准框架

典型依赖配置示例：

xml复制<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>

2.2 MySQL数据库设计要点

社区医疗系统的数据库设计需要特别注意：

患者信息表：包含基础信息、过敏史、慢性病史等
医生信息表：职称、专长、排班信息
药品库存表：批次、效期、库存预警
就诊记录表：与电子病历关联

典型建表示例：

sql复制CREATE TABLE patient (
    id BIGINT PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(50) NOT NULL,
    id_card VARCHAR(18) UNIQUE,
    phone VARCHAR(11),
    chronic_diseases TEXT,
    create_time DATETIME DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

3. 核心功能实现

3.1 预约挂号模块

关键技术点：

号源管理：医生排班与号池生成算法
预约冲突检测：同一时段唯一性约束
爽约处理：黑名单机制实现

核心代码片段：

java复制@RestController
@RequestMapping("/api/appointment")
public class AppointmentController {
    
    @Autowired
    private AppointmentService appointmentService;
    
    @PostMapping
    public ResponseEntity<?> createAppointment(@Valid @RequestBody AppointmentDTO dto) {
        if(appointmentService.checkConflict(dto)){
            throw new BusinessException("该时段已有预约");
        }
        return ResponseEntity.ok(appointmentService.create(dto));
    }
}

3.2 电子病历管理

设计要点：

结构化存储：使用JSON字段存储动态表单数据
版本控制：每次修改生成新版本
权限控制：RBAC模型实现

病历实体设计示例：

java复制@Entity
public class MedicalRecord {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    @ManyToOne
    private Patient patient;
    
    @ManyToOne
    private Doctor doctor;
    
    @Column(columnDefinition = "JSON")
    private String content;
    
    @Version
    private Integer version;
}

4. 系统安全设计

4.1 认证与授权

采用Spring Security + JWT方案：

密码加密：BCryptPasswordEncoder
权限控制：@PreAuthorize注解
Token刷新：双Token机制

安全配置示例：

java复制@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {
    
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.csrf().disable()
            .authorizeRequests()
            .antMatchers("/api/auth/**").permitAll()
            .anyRequest().authenticated()
            .and()
            .addFilter(new JwtAuthenticationFilter(authenticationManager()))
            .sessionManagement()
            .sessionCreationPolicy(SessionCreationPolicy.STATELESS);
    }
}

4.2 数据安全

关键措施：

敏感字段加密：身份证号、手机号等
操作日志审计：记录关键数据变更
定期备份策略：xtrabackup物理备份

5. 部署与性能优化

5.1 生产环境部署

推荐方案：

服务器：2核4G云服务器
中间件：Nginx反向代理
数据库：MySQL主从复制
监控：Spring Boot Actuator + Prometheus

Docker部署示例：

dockerfile复制FROM openjdk:11-jre
COPY target/community-medical.jar /app.jar
ENTRYPOINT ["java","-jar","/app.jar"]

5.2 性能调优经验

实战技巧：

JVM参数：-Xmx设置堆内存上限
连接池：HikariCP配置优化
缓存策略：Redis缓存热点数据
SQL优化：慢查询日志分析

6. 常见问题解决方案

6.1 开发环境问题

数据库连接失败：
- 检查MySQL服务是否启动
- 验证application.yml中的连接参数
- 测试网络连通性

跨域问题：

java复制@Configuration
public class CorsConfig implements WebMvcConfigurer {
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**")
                .allowedOrigins("*")
                .allowedMethods("*");
    }
}

6.2 业务逻辑问题

并发预约冲突：
- 数据库唯一索引
- 乐观锁机制
- 分布式锁（Redis实现）

药品库存扣减：

java复制@Transactional
public void reduceStock(Long medicineId, int quantity) {
    Medicine medicine = medicineRepository.findById(medicineId)
            .orElseThrow(() -> new BusinessException("药品不存在"));
    
    if(medicine.getStock() < quantity) {
        throw new BusinessException("库存不足");
    }
    
    medicine.setStock(medicine.getStock() - quantity);
}