Spring Boot+Vue构建宠物健康管理平台实践

倔强的猫

1. 项目概述

作为一名有十年开发经验的Java全栈工程师，我最近完成了一个基于Spring Boot的宠物成长记录平台的设计与实现。这个项目源于我观察到现代宠物主对科学养宠的需求日益增长，但市面上缺乏系统化的宠物健康管理工具。通过这个平台，宠物主可以记录宠物的日常饮食、健康数据、疫苗接种等信息，形成完整的宠物成长档案。

这个项目采用了当前主流的Spring Boot+Vue前后端分离架构，后端使用MyBatis Plus作为ORM框架，数据库选用MySQL。系统实现了用户管理、宠物档案管理、健康记录、提醒服务等核心功能模块。整个开发周期约两个月，期间我遇到了不少技术挑战，也积累了一些值得分享的经验。

2. 技术架构设计

2.1 整体架构设计

系统采用标准的B/S架构，前后端完全分离。这种架构选择主要基于以下几点考虑：

前后端分离的优势：前端专注于页面展示和用户交互，后端专注于业务逻辑和数据处理，开发人员可以并行工作，提高开发效率。
技术栈选择：
- 后端：Spring Boot 2.7 + MyBatis Plus 3.5
- 前端：Vue 3 + Element Plus
- 数据库：MySQL 8.0
- 缓存：Redis 6.2（用于会话管理和热点数据缓存）
部署架构：
- 前端部署在Nginx服务器
- 后端使用内嵌Tomcat容器
- 数据库采用主从复制架构保证数据安全

2.2 后端架构详解

后端采用经典的三层架构设计：

Controller层：处理HTTP请求，参数校验，返回统一格式的JSON响应。我特别设计了全局异常处理机制，确保所有异常都能被捕获并返回友好的错误信息。
Service层：实现核心业务逻辑。这里我使用了策略模式来处理不同类型的宠物健康指标计算，方便后续扩展。
DAO层：基于MyBatis Plus实现，大大简化了CRUD操作。我自定义了通用Mapper和Service，减少了重复代码。

java复制// 示例：宠物健康记录服务接口
public interface PetHealthService {
    /**
     * 记录宠物健康数据
     * @param petId 宠物ID
     * @param healthData 健康数据DTO
     * @return 记录结果
     */
    Result recordHealthData(Long petId, HealthDataDTO healthData);
    
    /**
     * 获取宠物健康趋势
     * @param petId 宠物ID
     * @param days 最近天数
     * @return 健康趋势数据
     */
    HealthTrendVO getHealthTrend(Long petId, int days);
}

2.3 前端架构设计

前端采用Vue3组合式API开发，主要特点：

组件化开发：将UI拆分为可复用的组件，如宠物卡片、健康图表等。
状态管理：使用Pinia管理全局状态，如用户登录信息、宠物列表等。
路由设计：基于Vue Router实现动态路由，根据用户权限加载不同菜单。
UI库选择：Element Plus提供了丰富的组件，加速了开发进程。

3. 核心功能实现

3.1 用户系统

用户系统采用了RBAC权限模型，主要包含以下功能：

注册登录：
- 支持手机号+验证码和账号密码两种登录方式
- 密码采用BCrypt加密存储
- 使用JWT进行身份认证
权限控制：
- 基于注解的权限校验
- 动态菜单生成
- 接口级别权限控制

java复制// 权限校验示例
@PreAuthorize("hasRole('PET_OWNER')")
@PostMapping("/pets/{petId}/records")
public Result addHealthRecord(@PathVariable Long petId, @Valid @RequestBody HealthRecordDTO dto) {
    // 业务逻辑
}

3.2 宠物档案管理

这是系统的核心模块，实现了：

宠物基本信息管理：
- 添加/编辑宠物档案（品种、生日、性别等）
- 上传宠物照片（使用阿里云OSS存储）
- 宠物健康状态评估
数据结构设计：

sql复制CREATE TABLE `pet_info` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `user_id` bigint NOT NULL COMMENT '主人ID',
  `name` varchar(50) NOT NULL COMMENT '宠物名称',
  `type` tinyint NOT NULL COMMENT '宠物类型(1-猫,2-狗,3-其他)',
  `breed` varchar(50) DEFAULT NULL COMMENT '品种',
  `birthday` date DEFAULT NULL COMMENT '生日',
  `gender` tinyint DEFAULT NULL COMMENT '性别(1-公,2-母)',
  `weight` decimal(5,2) DEFAULT NULL COMMENT '体重(kg)',
  `avatar` varchar(255) DEFAULT NULL COMMENT '头像URL',
  `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  KEY `idx_user_id` (`user_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='宠物基本信息表';

3.3 健康记录系统

这个模块实现了宠物健康数据的记录和分析：

健康指标记录：
- 体重变化曲线
- 饮食记录（每日摄入量、食物类型）
- 运动量记录
- 疫苗接种记录
健康提醒：
- 驱虫提醒
- 疫苗到期提醒
- 体检提醒
- 使用Quartz实现定时任务调度
健康报告：
- 周报/月报自动生成
- 健康指标异常预警
- 基于ECharts实现数据可视化

4. 关键技术实现

4.1 文件上传与存储

考虑到宠物照片等文件存储需求，系统实现了：

阿里云OSS集成：
- 使用SDK实现文件上传
- 实现了断点续传功能
- 图片自动压缩和缩略图生成
防重复上传：
- 基于文件MD5校验
- 数据库记录已上传文件

java复制public class FileUploadService {
    private final OSS ossClient;
    private final String bucketName;
    
    public String uploadFile(MultipartFile file, String filePath) {
        // 生成唯一文件名
        String fileName = generateFileName(file.getOriginalFilename());
        // 上传到OSS
        ossClient.putObject(bucketName, filePath + fileName, 
                           file.getInputStream());
        // 返回访问URL
        return generateFileUrl(filePath + fileName);
    }
    
    // 其他工具方法...
}