用户甲1. 项目背景与核心需求
流浪动物救助管理一直是社会公益领域的痛点问题。传统的手工登记、纸质档案管理方式效率低下，信息难以共享，志愿者协作困难。我们团队在实地调研了7家流浪动物救助站后发现，超过80%的机构仍在使用Excel表格记录动物信息，导致以下典型问题：
- 动物健康档案更新不及时，医疗记录分散
- 领养申请处理周期长，平均需要5-7个工作日
- 志愿者排班混乱，经常出现重复排班或岗位空缺
- 物资捐赠与消耗无法实时跟踪
基于这些痛点，我们决定开发一套基于SpringBoot的流浪动物救助管理系统。系统需要实现以下核心功能模块：
- 动物信息管理：包括基础信息、健康档案、行为特征等结构化存储
- 医疗记录追踪：疫苗接种、绝育手术、疾病治疗等全生命周期记录
- 领养流程数字化：从申请、审核到后续回访的全流程管理
- 志愿者协同平台：任务发布、排班调度、工时统计等功能
- 物资管理子系统：捐赠接收、库存预警、消耗记录等
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 技术架构设计
2.1 整体技术栈选型
经过技术评估，我们采用以下技术组合：
- 后端框架：SpringBoot 2.7.18（LTS版本）
- 数据库：MySQL 8.0 + Redis 7.0
- 前端：Vue3 + Element Plus
- 部署：Docker Compose
- 辅助工具：
- 消息队列：RabbitMQ（用于异步处理领养申请）
- 文件存储：MinIO（动物照片、医疗影像存储）
- 搜索引擎：Elasticsearch（领养匹配推荐）
选择SpringBoot 2.7而非3.x版本的主要考虑：当前生产环境大多数稳定中间件（如Spring Cloud Alibaba）对3.x的兼容性仍在完善中，且项目不需要Java 17特性。
2.2 核心架构图
系统采用经典的三层架构：
code复制[前端层]
↓ HTTP/WebSocket
[API网关层] → [认证中心]
↓
[业务微服务] → [公共组件]
↓
[数据持久层] → [缓存层]
每个业务模块拆分为独立微服务，通过Spring Cloud OpenFeign进行服务间通信。特别设计了"动物档案服务"作为核心服务，采用CQRS模式分离读写操作。
3. 关键功能实现细节
3.1 动物信息管理模块
3.1.1 数据结构设计
动物信息采用JSON Schema定义动态字段，核心表结构如下：
sql复制CREATE TABLE `animal` (
`id` BIGINT PRIMARY KEY,
`basic_info` JSON NOT NULL COMMENT '基础信息',
`health_status` JSON COMMENT '健康状态',
`behavior_traits` JSON COMMENT '行为特征',
`is_sterilized` TINYINT DEFAULT 0,
`adoption_status` ENUM('待领养','已预约','已领养') DEFAULT '待领养',
`create_time` DATETIME DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
使用JSON类型存储动态属性，既保证了结构化查询能力，又适应不同救助站对字段的个性化需求。
3.1.2 照片管理实现
采用MinIO分布式存储动物照片，前端通过预签名URL实现断点续传：
java复制// SpringBoot文件上传端点
@PostMapping("/upload")
public ResponseEntity<String> generatePresignedUrl(
@RequestParam String fileName,
@RequestParam Long fileSize) {
String objectName = "animal/" + UUID.randomUUID() + getFileExtension(fileName);
Map<String, String> formData = minioClient.getPresignedPostFormData(
bucketName,
objectName,
Duration.ofMinutes(15),
fileSize);
return ResponseEntity.ok(
objectMapper.writeValueAsString(formData));
}
3.2 领养流程引擎
3.2.1 状态机设计
领养流程采用状态机模式管理，核心状态转换如下：
mermaid复制stateDiagram-v2
[*] --> 申请提交
申请提交 --> 初审通过: 志愿者审核
申请提交 --> 初审拒绝
初审通过 --> 家访安排
家访安排 --> 家访通过
家访安排 --> 家访拒绝
家访通过 --> 领养签约
领养签约 --> 领养完成
领养完成 --> 回访中
实际代码使用Spring StateMachine实现：
java复制@Configuration
@EnableStateMachineFactory
public class AdoptionStateMachineConfig
extends EnumStateMachineConfigurerAdapter<AdoptionStates, AdoptionEvents> {
@Override
public void configure(StateMachineStateConfigurer<AdoptionStates, AdoptionEvents> states)
throws Exception {
states.withStates()
.initial(AdoptionStates.SUBMITTED)
.states(EnumSet.allOf(AdoptionStates.class));
}
@Override
public void configure(StateMachineTransitionConfigurer<AdoptionStates, AdoptionEvents> transitions)
throws Exception {
transitions.withExternal()
.source(AdoptionStates.SUBMITTED).target(AdoptionStates.PRELIMINARY_APPROVED)
.event(AdoptionEvents.APPROVE)
.and()
.withExternal()
.source(AdoptionStates.SUBMITTED).target(AdoptionStates.REJECTED)
.event(AdoptionEvents.REJECT);
// 其他转换规则...
}
}
3.2.2 异步处理优化
领养申请高峰期可能出现并发问题，我们采用RabbitMQ实现异步处理：
java复制@RabbitListener(queues = "adoption.apply")
public void processAdoptionApply(AdoptionApplication application) {
// 1. 查重校验
if (duplicateCheckService.isDuplicate(application)) {
log.warn("Duplicate application detected: {}", application);
return;
}
// 2. 自动初审规则
AdoptionStatus status = autoApproveService.evaluate(application);
// 3. 持久化
adoptionRepository.saveWithStatus(application, status);
// 4. 通知申请人
notificationService.sendApplicationResult(application, status);
}
4. 系统安全与性能优化
4.1 安全防护措施
-
认证授权：采用JWT + OAuth2混合模式
- 志愿者：账号密码登录
- 领养人：短信验证码登录
- 管理员：二次验证
-
数据安全：
- 敏感字段加密：使用Java Cryptography Extension (JCE)加密
- 日志脱敏：自定义Logback过滤器
- SQL防护：MyBatis-Plus插件防止注入
-
接口防护：
- Spring Security配置RBAC模型
- 关键接口添加@PreAuthorize注解
- 领养相关接口启用防重放攻击
4.2 性能优化实践
4.2.1 缓存策略
采用多级缓存架构：
-
本地缓存：Caffeine缓存热点数据（如动物品种字典）
java复制@Bean public CacheManager cacheManager() { CaffeineCacheManager cacheManager = new CaffeineCacheManager(); cacheManager.setCaffeine(Caffeine.newBuilder() .expireAfterWrite(10, TimeUnit.MINUTES) .maximumSize(1000)); return cacheManager; } -
分布式缓存：Redis缓存共享数据（如志愿者信息）
-
数据库缓存：MySQL查询缓存
4.2.2 查询优化
针对动物列表查询的典型慢SQL：
sql复制-- 优化前
SELECT * FROM animal WHERE shelter_id = ? AND adoption_status = ?;
-- 优化后
SELECT id, basic_info->>'$.name' as name,
basic_info->>'$.age' as age
FROM animal
WHERE shelter_id = ? AND adoption_status = ?
ORDER BY create_time DESC
LIMIT 20;
优化措施：
- 只查询必要字段
- 使用JSON路径提取代替全量JSON解析
- 添加复合索引：(shelter_id, adoption_status, create_time)
5. 部署与监控方案
5.1 Docker Compose部署
核心服务编排文件示例：
yaml复制version: '3.8'
services:
mysql:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASS}
volumes:
- mysql_data:/var/lib/mysql
ports:
- "3306:3306"
redis:
image: redis:7.0-alpine
ports:
- "6379:6379"
minio:
image: minio/minio
command: server /data --console-address ":9001"
ports:
- "9000:9000"
- "9001:9001"
volumes:
- minio_data:/data
5.2 监控体系搭建
-
基础监控：Prometheus + Grafana
- JVM指标采集
- 接口响应时间监控
- 数据库性能看板
-
业务监控：
- 领养转化率统计
- 志愿者活跃度分析
- 物资库存预警
-
日志分析：ELK Stack
- 错误日志实时报警
- 操作审计追踪
6. 项目演进与经验总结
在实际开发过程中，我们积累了以下关键经验：
-
领域模型设计：初期将"动物"与"医疗记录"强耦合导致后期扩展困难，重构为事件溯源模式后灵活性大幅提升。
-
性能取舍：领养列表页最初追求实时性，后来改为15秒缓存策略，QPS从50提升到1200+。
-
异常处理：医疗记录模块需要特别注意：
- 第三方宠物医院API调用超时处理
- 检验报告图片OCR识别重试机制
- 药品剂量单位自动转换
-
测试策略：
- 动物匹配算法采用属性基测试(Property-based Testing)
- 领养流程使用契约测试确保接口兼容性
- 压力测试模拟春节前后的领养高峰
系统上线后，合作救助站的平均领养处理时间从7天缩短到2.5天，志愿者协作效率提升40%，物资浪费减少25%。未来计划引入AI图像识别来自动分析动物健康状况，并探索区块链技术用于捐赠溯源。