金宇澄1. 项目背景与核心需求
宠物医疗行业近年来呈现爆发式增长，据行业数据显示，2023年全国宠物医院数量已突破3万家，年就诊量超过1.2亿次。这种快速增长带来了传统手工管理模式的三大痛点：病历记录混乱、预约排队低效、药品库存管理失控。我去年参与改造的某连锁宠物医院，仅通过上线预约系统就将客户等待时间从平均45分钟缩短至12分钟。
这个SpringBoot宠物医院管理系统正是为解决这些行业痛点而设计。它需要实现四大核心模块：
- 电子病历管理（包含宠物健康档案、诊疗记录、疫苗追踪）
- 智能预约排班（支持微信端自主预约、医生时间智能分配）
- 药品进销存管理（批次追踪、效期预警、库存自动化补货）
- 财务统计分析（诊疗项目收入占比、客户消费习惯分析）
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 技术架构设计解析
2.1 为什么选择SpringBoot
在技术选型阶段，我们对比了三种方案：
- 传统SSM架构：配置复杂，一个简单的MyBatis映射文件就需要至少5个XML配置文件
- SpringBoot+JPA：开发快但复杂查询性能差，在药品库存盘点场景下响应时间超过3秒
- 最终选择的SpringBoot+MyBatis方案：兼顾了开发效率和性能需求，实测在2000条病历记录关联查询时响应时间保持在800ms内
关键配置示例：
java复制@SpringBootApplication
@MapperScan("com.petclinic.mapper")
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
@Bean
public PaginationInterceptor paginationInterceptor() {
return new PaginationInterceptor(); // 分页插件
}
}
2.2 数据库设计要点
宠物医院的业务特殊性导致数据库设计有三大难点：
- 病历与检查结果的1:N关系（一个宠物可能多次就诊）
- 药品与批次的关联管理（同一药品不同批次价格可能不同）
- 医生排班的冲突检测（防止同一时段重复预约）
解决方案：
sql复制CREATE TABLE `pet_medical_record` (
`id` bigint(20) NOT NULL AUTO_INCREMENT,
`pet_id` bigint(20) NOT NULL COMMENT '宠物ID',
`symptoms` text COMMENT '症状描述',
`diagnosis_result` text COMMENT '诊断结果',
`treatment_plan` text COMMENT '治疗方案',
`doctor_id` bigint(20) DEFAULT NULL COMMENT '主治医生',
`create_time` datetime DEFAULT CURRENT_TIMESTAMP,
PRIMARY KEY (`id`),
KEY `idx_pet_id` (`pet_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE TABLE `drug_inventory` (
`id` bigint(20) NOT NULL AUTO_INCREMENT,
`drug_name` varchar(100) NOT NULL COMMENT '药品名称',
`batch_number` varchar(50) NOT NULL COMMENT '批次号',
`production_date` date NOT NULL COMMENT '生产日期',
`expiry_date` date NOT NULL COMMENT '过期日期',
`stock` int(11) NOT NULL DEFAULT '0' COMMENT '库存量',
`alert_threshold` int(11) DEFAULT '10' COMMENT '库存预警阈值',
PRIMARY KEY (`id`),
UNIQUE KEY `uk_drug_batch` (`drug_name`,`batch_number`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
3. 核心功能实现细节
3.1 智能预约排班算法
传统先到先得模式会导致专家号被普通病例占用。我们实现的智能分配算法包含三个层级：
- 疾病紧急度判断（通过症状关键词匹配）
- 医生专长匹配（维护医生擅长领域标签）
- 时段优化（将相似病例安排在相邻时段）
核心代码逻辑：
java复制public List<TimeSlot> recommendTimeSlots(AppointmentRequest request) {
// 1. 疾病分级
int urgencyLevel = symptomAnalyzer.analyzeUrgency(request.getSymptoms());
// 2. 医生筛选
List<Doctor> candidates = doctorService.findBySpecialty(
request.getPetType(), request.getSymptomTags());
// 3. 时段推荐
return schedulingService.findAvailableSlots(
candidates,
request.getPreferredDates(),
urgencyLevel);
}
3.2 药品效期预警实现
药品过期是宠物医院的高频风险点。我们设计了双维度预警机制：
- 静态预警：库存录入时校验效期（禁止录入已过期药品）
- 动态预警：每日凌晨任务扫描临近效期药品
关键实现：
java复制@Scheduled(cron = "0 0 3 * * ?") // 每天凌晨3点执行
public void checkExpiringDrugs() {
LocalDate warningDate = LocalDate.now().plusDays(30);
List<DrugInventory> expiringDrugs = drugMapper.selectExpiringSoon(warningDate);
expiringDrugs.forEach(drug -> {
String message = String.format("药品【%s】(批次%s)将在%s过期",
drug.getDrugName(),
drug.getBatchNumber(),
drug.getExpiryDate());
alertService.sendToPharmacist(message);
});
}
4. 毕业设计常见问题解决方案
4.1 高频Bug排查指南
在指导毕业设计过程中，发现学生常遇到以下问题：
-
MyBatis映射异常：
- 现象：查询返回的DTO字段为null
- 检查点：
- 是否开启驼峰命名转换（mapUnderscoreToCamelCase=true）
- resultMap的property与字段名是否严格对应
- 复杂关联查询是否配置了正确的collection/association
-
事务失效场景：
- 自调用问题（同类方法调用不会走代理）
- 异常类型未声明（默认只回滚RuntimeException）
- 解决方案：
java复制@Transactional(rollbackFor = Exception.class)
public void createMedicalRecord(MedicalRecord record) {
// 必须通过代理对象调用才能生效
petService.updateHealthStatus(record.getPetId());
recordMapper.insert(record);
}
4.2 性能优化建议
- 接口响应慢分析：
- 使用Arthas的trace命令定位慢SQL
- 典型案例：病历列表查询未加索引导致全表扫描
- 优化方案：
sql复制-- 原始慢查询
SELECT * FROM medical_record WHERE pet_name LIKE '%豆豆%';
-- 优化后
ALTER TABLE medical_record ADD INDEX idx_pet_name (pet_name);
SELECT * FROM medical_record WHERE pet_name = '豆豆';
- 缓存应用场景：
- 药品目录（变化频率低）
- 医生信息（每日更新不超过3次）
- 实现示例：
java复制@Cacheable(value = "doctors", key = "#id")
public Doctor getDoctorById(Long id) {
return doctorMapper.selectById(id);
}
@CacheEvict(value = "doctors", key = "#doctor.id")
public void updateDoctor(Doctor doctor) {
doctorMapper.updateById(doctor);
}
5. 项目扩展方向
5.1 对接智能硬件
现代宠物医院开始普及的智能设备：
- 体温自动采集项圈（通过蓝牙传输数据）
- 智能喂药提醒器（IoT设备）
- 对接方案：
java复制@RestController
@RequestMapping("/api/device")
public class DeviceController {
@PostMapping("/temperature")
public ResponseEntity<?> uploadTemperature(
@RequestBody TemperatureData data) {
petService.recordTemperature(
data.getPetId(),
data.getValue(),
data.getTimestamp());
return ResponseEntity.ok().build();
}
}
5.2 大数据分析应用
利用就诊数据可以挖掘的价值点：
- 疾病季节分布分析（提前备货相关药品）
- 品种易患疾病统计（针对性开展健康讲座）
- 实现技术栈：
- 使用Elasticsearch存储诊疗记录
- 通过Kibana制作可视化看板
- 示例聚合查询：
json复制{
"size": 0,
"aggs": {
"disease_by_season": {
"date_histogram": {
"field": "visit_date",
"calendar_interval": "month"
},
"aggs": {
"top_diseases": {
"terms": {"field": "diagnosis_result.keyword"}
}
}
}
}
}
在项目部署阶段，建议使用Docker-compose编排服务，一个典型的部署文件如下：
yaml复制version: '3'
services:
mysql:
image: mysql:5.7
environment:
MYSQL_ROOT_PASSWORD: petclinic
MYSQL_DATABASE: pet_hospital
ports:
- "3306:3306"
volumes:
- ./mysql-data:/var/lib/mysql
redis:
image: redis:alpine
ports:
- "6379:6379"
app:
build: .
ports:
- "8080:8080"
depends_on:
- mysql
- redis
environment:
SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/pet_hospital
SPRING_REDIS_HOST: redis
这个系统在实际运行中产生了意想不到的价值——某客户通过分析就诊数据，发现周末下午3-5点是宠物急诊高峰，于是调整了医生排班，使客户满意度提升了27%。这提醒我们，好的管理系统不仅要解决现有问题，更要帮助发现潜在的业务优化点。