基于SpringBoot的宠物医院日常业务管理系统 - 源码深度解析

随着现代宠物医疗行业的蓬勃发展，传统依赖手工记录和分散管理的运营模式已难以应对日益增长的业务需求。信息孤岛现象普遍、业务流程繁琐、管理效率低下，这些痛点严重制约了宠物医院服务质量的提升。为此，我们设计并实现了一套专业级的宠物医疗运营管理平台。该系统通过数字化手段，深度整合了宠物档案管理、诊疗业务流程、药品库存监控、财务收费结算等核心运营环节，旨在为中小型宠物诊所及连锁医院提供一体化、高效率的运营支持解决方案。

系统架构与技术栈选型

本平台采用业界经典的SpringBoot全栈架构，充分利用了SpringBoot在快速开发、约定优于配置、内嵌服务器及微服务友好部署方面的显著优势。

后端框架：基于SpringBoot 2.x构建，提供稳定的依赖管理和自动配置。
数据持久层：选用轻量级的MyBatis框架，灵活掌控SQL，便于复杂查询优化。
数据库：采用MySQL 8.0，利用其窗口函数、公用表表达式等高级特性提升数据处理能力。
前端技术：结合Thymeleaf模板引擎进行服务端页面渲染，并引入Vue.js实现前后端分离的动态交互体验。

系统采用清晰的三层架构设计，职责分明，便于维护和扩展：

控制层（Controller）：负责接收前端HTTP请求，进行参数绑定、数据验证、权限拦截和结果返回。
业务逻辑层（Service）：封装核心业务规则、复杂业务流程和事务控制，确保业务逻辑的完整性和一致性。
数据持久层（Mapper）：通过MyBatis的映射接口与XML文件，实现对象关系映射（ORM）和数据库CRUD操作。

以下是一个控制层的代码示例，展示了如何接收和管理文章相关的管理员请求：

@RestController
@RequestMapping("/admin/article")
public class ArticleAdminController {
    
    @Value("${articleImageFilePath}")
    private String articleImageFilePath; // 图片存储路径，通过配置文件注入
    
    @Resource
    private ArticleService articleService; // 文章业务逻辑服务
    
    @Resource
    private ArticleTypeService articleTypeService; // 文章分类服务
    
    @Resource
    private LogService logService; // 日志服务，用于记录操作轨迹
}

在安全方面，系统集成Apache Shiro安全框架，实现了细粒度的权限访问控制。通过简洁的注解方式，即可对不同的业务操作进行权限验证，保障系统安全：

@RequestMapping("/list")
@RequiresPermissions(value = "文章管理") // Shiro权限注解，要求用户拥有"文章管理"权限
public Map<String, Object> list(Article searchArticle, 
                               @RequestParam(value = "page", required = false) Integer page,
                               @RequestParam(value = "rows", required = false) Integer rows) {
    // 实现带条件的分页查询逻辑
}

数据库设计亮点剖析

优秀的数据库设计是系统高性能、高可用的基石。以下是几个核心表的设计解析。

1. 信息通知表（t_information）的设计优化

信息通知表是系统内部通讯的核心枢纽，其设计充分考虑了查询性能和数据关联完整性：

CREATE TABLE `t_information` (
  `id` int(11) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `content` varchar(1000) DEFAULT NULL COMMENT '内容',
  `sendDate` datetime DEFAULT NULL COMMENT '发送日期',
  `isRead` int(11) DEFAULT NULL COMMENT '是否已读（0-未读，1-已读）',
  `customerId` int(11) DEFAULT NULL COMMENT '客户ID',
  `userId` int(11) DEFAULT NULL COMMENT '用户ID（发送者或关联用户）',
  PRIMARY KEY (`id`),
  KEY `customerId` (`customerId`),
  KEY `userId` (`userId`),
  CONSTRAINT `t_information_ibfk_1` FOREIGN KEY (`customerId`) 
    REFERENCES `t_customer` (`id`) ON DELETE CASCADE,
  CONSTRAINT `t_information_ibfk_2` FOREIGN KEY (`userId`) 
    REFERENCES `t_user` (`id`) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_general_ci COMMENT='信息表'

设计亮点深度分析：

字段类型优化：content字段采用varchar(1000)而非text类型。对于通知类短文本，此设计在满足存储需求的同时，避免了text类型可能带来的额外磁盘I/O和内存开销，提升了查询效率。
精准的索引策略：为常用的查询条件customerId（按客户查消息）和userId（按用户查消息）分别建立普通索引，显著优化了查询速度，避免了全表扫描。
严谨的参照完整性：通过外键约束（FOREIGN KEY）关联用户表和客户表，并使用ON DELETE CASCADE策略，确保主表记录删除时，关联的从表信息自动清理，杜绝脏数据。
字符集与校对集：采用utf8字符集和utf8_general_ci校对集，确保系统能够正确存储和比较多语言内容（如中英文混排）。

2. 设备使用日志表（t_equipmentuselog）的业务建模

设备管理是宠物医院成本控制和运营效率的关键。此表设计实现了对设备使用全生命周期的精细化管理：

CREATE TABLE `t_equipmentuselog` (
  `id` int(11) NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  `beginDate` datetime DEFAULT NULL COMMENT '开始使用时间',
  `endDate` datetime DEFAULT NULL COMMENT '结束使用时间',
  `userId` int(11) DEFAULT NULL COMMENT '操作员ID',
  `equipmentId` int(11) DEFAULT NULL COMMENT '设备ID',
  PRIMARY KEY (`id`),
  KEY `equipmentId` (`equipmentId`),
  KEY `userId` (`userId`),
  CONSTRAINT `t_equipmentuselog_ibfk_1` FOREIGN KEY (`equipmentId`) 
    REFERENCES `t_equipment` (`id`) ON DELETE CASCADE,
  CONSTRAINT `t_equipmentuselog_ibfk_2` FOREIGN KEY (`userId`) 
    REFERENCES `t_user` (`id`) ON DELETE CASCADE
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_general_ci COMMENT='设备使用日志表'

设备使用记录管理

业务价值体现：

精确的时间维度管理：通过beginDate和endDate字段，可以精确记录设备的每次使用时段。基于此数据，可进行设备使用率、闲置率、高峰时段的统计分析，为设备采购和调度提供决策依据。
完整的责任追溯体系：通过userId关联到具体操作人员，实现了设备使用的责任到人，便于问题追踪和绩效管理。
支撑设备全生命周期管理：详细的日志记录为预测设备维护周期、评估设备损耗、制定报废计划提供了坚实的数据基础。

3. 角色权限表（t_user_role）的安全架构

基于经典的RBAC（Role-Based Access Control，基于角色的访问控制） 模型，本系统构建了灵活且安全的权限管理体系：

CREATE TABLE `t_user_role` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `roleId` int(11) DEFAULT NULL,
  `userId` int(11) DEFAULT NULL,
  PRIMARY KEY (`id`),
  KEY `FKa9c8iiy6ut0gnx491fqx4pxam` (`roleId`),
  KEY `FKq5un6x7ecoef5w1n39cop66kl` (`userId`),
  CONSTRAINT `FKa9c8iiy6ut0gnx491fqx4pxam` FOREIGN KEY (`roleId`) 
    REFERENCES `t_role` (`id`) ON DELETE CASCADE,
  CONSTRAINT `FKq5un6x7ecoef5w1n39cop66kl` FOREIGN KEY (`userId`) 
    REFERENCES `t_user` (`id`) ON DELETE CASCADE
) ENGINE=InnoDB AUTO_INCREMENT=122 DEFAULT CHARSET=utf8 COLLATE=utf8_general_ci

此表是RBAC模型中的核心关联表，实现了用户（t_user）和角色（t_role）的多对多关系。管理员只需为用户分配角色，即可批量授予该角色所包含的所有权限，极大简化了权限管理复杂度。

核心功能模块实现解析

1. 智能文章管理系统

文章管理模块超越基础的增删改查，集成了富文本编辑器（CKEditor） 和异步图片上传功能，旨在构建一个强大的医院知识库和内容发布平台：

/**
 * 处理CKEditor编辑器的图片上传请求
 * @param file 上传的图片文件
 * @param CKEditorFuncNum CKEditor回调函数编号，用于前端回调
 * @return 执行CKEditor回调的JavaScript脚本
 */
@RequestMapping("/ckeditorUpload")
public String ckeditorUpload(@RequestParam("upload") MultipartFile file, 
                           String CKEditorFuncNum) throws Exception {
    // 获取原始文件名
    String fileName = file.getOriginalFilename();
    // 提取文件后缀名（如 .jpg, .png）
    String suffixName = fileName.substring(fileName.lastIndexOf("."));
    // 生成新文件名：使用当前时间戳避免重名
    String newFileName = DateUtil.getCurrentDateStr() + suffixName;
    
    // 将上传的图片流保存到服务器指定目录
    FileUtils.copyInputStreamToFile(file.getInputStream(), 
        new File(articleImageFilePath + newFileName));
    
    // 构造CKEditor要求的回调脚本，告知编辑器图片上传成功的URL
    String script = "<script type=\"text/javascript\">";
    script += "window.parent.CKEDITOR.tools.callFunction(" + CKEditorFuncNum 
            + ",'/image/article/" + newFileName + "','')";
    script += "</script>";
    
    return script; // 返回脚本，由浏览器执行以更新编辑器内容
}

![文章管理界面](https://images.maancode.com/projects/springboot-pet-hospital-management-system-417/管理

基于SpringBoot的宠物医院日常业务管理系统 - 源码深度解析

文章摘要

基于SpringBoot的宠物医院日常业务管理系统 - 源码深度解析

系统架构与技术栈选型

数据库设计亮点剖析

1. 信息通知表（t_information）的设计优化

2. 设备使用日志表（t_equipmentuselog）的业务建模

3. 角色权限表（t_user_role）的安全架构

核心功能模块实现解析

1. 智能文章管理系统

上下篇