Spring Boot+Vue宠物医院管理系统开发实践

1. 项目概述

作为一名有多年Java开发经验的程序员，我最近完成了一个基于Spring Boot的宠物医院管理系统毕业设计项目。这个系统旨在为宠物医院提供一个高效便捷的信息化管理平台，整合了宠物档案管理、预约挂号、医生信息查询、宠物美容服务等核心功能模块。

在实际开发过程中，我发现宠物医院的信息化管理需求日益增长，但市面上成熟的解决方案并不多。通过这个项目，我不仅巩固了Spring Boot框架的使用技巧，还深入理解了宠物医疗行业的业务流程。系统采用B/S架构，前端使用Vue.js，后端基于Spring Boot，数据库选用MySQL，实现了多角色权限管理，包括普通用户、医生用户、护士用户和管理员四种角色。

2. 技术选型与架构设计

2.1 技术栈选择

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

1. 开发效率：Spring Boot的自动配置和快速启动特性
2. 性能需求：MySQL的关系型数据库特性满足数据一致性要求
3. 用户体验：Vue.js的响应式特性提升前端交互体验
4. 团队熟悉度：选择团队熟悉的Java技术栈

后端技术栈：

• 核心框架：Spring Boot 2.7.x
• 安全框架：Spring Security
• ORM框架：MyBatis-Plus
• 数据库：MySQL 8.0
• 缓存：Redis（用于会话管理和热点数据缓存）

前端技术栈：

• 核心框架：Vue.js 3.x
• UI组件库：Element Plus
• 状态管理：Vuex
• 路由管理：Vue Router

2.2 系统架构设计

系统采用典型的分层架构设计：

code复制┌───────────────────────────────────────┐
│               表现层(View)            │
│   ┌───────────────────────────────┐  │
│   │           Vue.js前端          │  │
└───┴───────────────────────────────┴──┘
                   ↑↓
┌───────────────────────────────────────┐
│             控制层(Controller)        │
│   ┌───────────────────────────────┐  │
│   │      Spring MVC控制器         │  │
└───┴───────────────────────────────┴──┘
                   ↑↓
┌───────────────────────────────────────┐
│             服务层(Service)           │
│   ┌───────────────────────────────┐  │
│   │       业务逻辑处理            │  │
└───┴───────────────────────────────┴──┘
                   ↑↓
┌───────────────────────────────────────┐
│             持久层(DAO)              │
│   ┌───────────────────────────────┐  │
│   │        MyBatis-Plus           │  │
└───┴───────────────────────────────┴──┘
                   ↑↓
┌───────────────────────────────────────┐
│               数据库层               │
│   ┌───────────────────────────────┐  │
│   │            MySQL              │  │
└───┴───────────────────────────────┴──┘

这种分层架构的优势在于：

1. 职责分离：各层专注自己的职责，便于维护和扩展
2. 可测试性：可以单独测试每一层的功能
3. 灵活性：可以替换某一层的实现而不影响其他层

3. 核心功能模块实现

3.1 用户权限管理模块

系统采用RBAC（基于角色的访问控制）模型设计权限系统，包含以下核心表：

• 用户表(user)
• 角色表(user_group)
• 权限表(auth)
• 用户-角色关联表

权限控制实现要点：

1. 使用Spring Security进行认证和授权
2. 自定义UserDetailsService实现用户信息加载
3. 实现JWT令牌进行无状态认证
4. 自定义权限注解控制方法级访问

java复制// 示例：自定义权限注解
@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@PreAuthorize("hasAnyRole('ADMIN', 'DOCTOR')")
public @interface DoctorOrAdminRequired {
}

// 在Controller方法上使用
@DoctorOrAdminRequired
@PostMapping("/appointments")
public ResponseEntity<?> createAppointment(@RequestBody AppointmentDTO dto) {
    // 业务逻辑
}

3.2 宠物档案管理模块

宠物档案是系统的核心数据之一，设计时考虑了以下方面：

数据库表设计：

sql复制CREATE TABLE `pet_profile` (
  `pet_profile_id` int NOT NULL AUTO_INCREMENT,
  `ordinary_users` int DEFAULT NULL COMMENT '普通用户ID',
  `user_name` varchar(64) DEFAULT NULL COMMENT '用户姓名',
  `pet_name` varchar(64) DEFAULT NULL COMMENT '宠物名称',
  `pet_species` varchar(64) DEFAULT NULL COMMENT '宠物种类',
  `pet_age` varchar(64) DEFAULT NULL COMMENT '宠物年龄',
  `pet_weight` varchar(64) DEFAULT NULL COMMENT '宠物体重',
  `pet_gender` varchar(64) DEFAULT NULL COMMENT '宠物性别',
  `pet_fur_color` varchar(64) DEFAULT NULL COMMENT '宠物毛色',
  `vaccination_records` text COMMENT '疫苗接种记录',
  `medical_history` text COMMENT '病史记录',
  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `update_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`pet_profile_id`),
  KEY `idx_user` (`ordinary_users`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;

业务逻辑实现要点：

1. 使用MyBatis-Plus的BaseMapper简化CRUD操作
2. 实现宠物档案的版本控制，记录修改历史
3. 添加数据校验逻辑，确保宠物信息的完整性
4. 实现宠物照片上传功能，使用阿里云OSS存储

3.3 预约挂号模块

预约挂号是系统的核心业务流程，涉及以下关键点：

状态机设计：

code复制[新建] → [待支付] → [已预约] → [就诊中] → [已完成]
            ↓             ↓
        [取消预约]    [缺席]

数据库表设计：

sql复制CREATE TABLE `make_an_appointment_for_registration` (
  `make_an_appointment_for_registration_id` int NOT NULL AUTO_INCREMENT,
  `doctor_users` int DEFAULT NULL COMMENT '医生用户ID',
  `doctors_name` varchar(64) DEFAULT NULL COMMENT '医生姓名',
  `doctors_department` varchar(64) DEFAULT NULL COMMENT '医生科室',
  `ordinary_users` int DEFAULT NULL COMMENT '普通用户ID',
  `pet_name` varchar(64) DEFAULT NULL COMMENT '宠物名称',
  `appointment_time` datetime DEFAULT NULL COMMENT '预约时间',
  `status` varchar(16) NOT NULL DEFAULT 'NEW' COMMENT '状态:NEW,PAID,CONFIRMED,CANCELLED,COMPLETED,ABSENT',
  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `update_time` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`make_an_appointment_for_registration_id`),
  KEY `idx_doctor` (`doctor_users`),
  KEY `idx_user` (`ordinary_users`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;

业务逻辑实现要点：

1. 使用状态模式处理预约状态转换
2. 实现预约冲突检测，防止同一时段重复预约
3. 添加定时任务自动取消超时未支付的预约
4. 实现微信/支付宝支付集成
5. 添加预约提醒功能（短信/站内信）

4. 系统实现中的关键问题与解决方案

4.1 高并发预约问题

在系统测试阶段，我们发现当多个用户同时预约同一位医生的同一时段时，会出现超预约的情况。解决方案是：

1. 使用数据库乐观锁控制并发：

java复制@Transactional
public boolean makeAppointment(AppointmentDTO dto) {
    // 1. 查询医生该时段剩余可预约数量
    DoctorSchedule schedule = doctorScheduleMapper.selectForUpdate(dto.getDoctorId(), dto.getTimeSlot());
    
    if (schedule.getAvailableCount() <= 0) {
        throw new BusinessException("该时段已约满");
    }
    
    // 2. 减少可预约数量
    int updated = doctorScheduleMapper.reduceAvailableCount(schedule.getId(), schedule.getVersion());
    if (updated == 0) {
        throw new ConcurrentBookingException("预约冲突，请重试");
    }
    
    // 3. 创建预约记录
    Appointment appointment = convertToEntity(dto);
    appointmentMapper.insert(appointment);
    
    return true;
}

2. 使用Redis分布式锁控制并发：

java复制public boolean makeAppointmentWithLock(AppointmentDTO dto) {
    String lockKey = "appt_lock:" + dto.getDoctorId() + ":" + dto.getTimeSlot();
    try {
        // 尝试获取分布式锁，有效期10秒
        boolean locked = redisTemplate.opsForValue().setIfAbsent(lockKey, "1", 10, TimeUnit.SECONDS);
        if (!locked) {
            throw new BusinessException("系统繁忙，请稍后再试");
        }
        
        // 执行业务逻辑
        return makeAppointment(dto);
    } finally {
        // 释放锁
        redisTemplate.delete(lockKey);
    }
}

4.2 数据一致性问题

在支付和预约状态更新过程中，需要保证数据的一致性。我们采用以下方案：

1. 使用本地事务+消息队列的最终一致性方案
2. 实现补偿机制处理异常情况
3. 添加对账功能定期检查数据一致性

java复制@Transactional
public PaymentResult processPayment(PaymentRequest request) {
    // 1. 创建支付记录
    PaymentRecord payment = createPaymentRecord(request);
    paymentMapper.insert(payment);
    
    // 2. 更新预约状态
    appointmentMapper.updateStatus(request.getAppointmentId(), "PAID", "NEW");
    
    // 3. 发送支付成功事件
    PaymentSuccessEvent event = new PaymentSuccessEvent();
    event.setPaymentId(payment.getId());
    event.setAppointmentId(request.getAppointmentId());
    rabbitTemplate.convertAndSend("payment.exchange", "payment.success", event);
    
    // 4. 返回支付结果
    return buildPaymentResult(payment);
}

4.3 性能优化

针对系统性能瓶颈，我们实施了以下优化措施：

1. 数据库优化：

   • 添加合适的索引
   • 优化慢查询
   • 使用读写分离

2. 缓存策略：

   • 热点数据缓存（医生信息、服务项目等）
   • 多级缓存（Redis + 本地缓存）
   • 缓存预热

3. 前端优化：

   • 组件懒加载
   • 路由懒加载
   • 图片懒加载
   • 数据分页加载

5. 系统测试与部署

5.1 测试策略

我们采用分层测试策略：

1. 单元测试：使用JUnit + Mockito测试Service层
2. 集成测试：测试Controller层和数据库交互
3. API测试：使用Postman测试REST API
4. UI测试：使用Cypress进行端到端测试
5. 性能测试：使用JMeter模拟高并发场景

5.2 部署方案

系统采用Docker容器化部署，部署架构如下：

code复制┌───────────────────────────────────────┐
│              Nginx负载均衡            │
└─────────────────┬─────────┬───────────┘
                  ↓         ↓
┌───────────────┐ ┌───────┐ ┌───────────┐
│  Web应用节点1 │ │ 节点2 │ │   节点3   │
└───────┬───────┘ └───┬───┘ └─────┬─────┘
        ↓             ↓           ↓
┌───────────────────────────────────────┐
│              Redis集群                │
└───────────────────────────────────────┘
                  ↓
┌───────────────────────────────────────┐
│             MySQL集群                 │
│       (主从复制+读写分离)             │
└───────────────────────────────────────┘

部署步骤：

1. 使用Dockerfile构建应用镜像
2. 使用docker-compose编排服务
3. 配置Nginx负载均衡
4. 设置监控和告警（Prometheus + Grafana）
5. 实现CI/CD流水线（Jenkins）

6. 项目总结与经验分享

在开发这个宠物医院管理系统的过程中，我积累了一些宝贵的经验：

1. 领域建模的重要性：在项目初期，我花了大量时间与宠物医院的工作人员沟通，了解他们的业务流程和痛点。这帮助我建立了准确的领域模型，避免了后期大量的返工。

2. 技术选型的权衡：在技术选型时，我最初考虑使用Spring Cloud微服务架构，但考虑到项目规模和团队经验，最终选择了单体架构。这个决定大大简化了开发和部署的复杂度。

3. 异常处理的经验：在支付模块开发中，我最初没有充分考虑各种异常情况，导致线上出现了一些问题。后来我完善了异常处理机制，添加了足够的日志和监控，大大提高了系统的稳定性。

4. 性能优化的教训：在第一次压力测试时，系统在高并发下表现不佳。通过分析，我发现问题出在数据库查询上。添加适当的索引和优化查询语句后，性能提升了5倍以上。

5. 文档的重要性：良好的文档不仅帮助团队成员理解系统，也为后续维护提供了便利。我坚持在代码中添加详细的注释，并维护了API文档和系统设计文档。

这个项目让我深刻理解了从需求分析到系统上线的完整软件开发流程。虽然过程中遇到了各种挑战，但解决问题的过程也让我收获了很多。未来，我计划继续完善这个系统，考虑添加AI辅助诊断、移动端应用等功能，进一步提升系统的实用性和用户体验。