1. 项目背景与核心价值
宠物经济近年来呈现爆发式增长，根据行业数据显示，2023年国内宠物市场规模已突破3000亿元。传统宠物店使用纸质记录或简单Excel表格管理的方式，已经难以应对日益复杂的业务场景。这个基于SpringBoot的宠物店管理系统，正是为解决以下行业痛点而生：
- 多业务线割裂：洗澡美容、商品销售、医疗服务等业务数据分散
- 人工统计低效：每日营收核算需要手动汇总多个表格
- 库存管理滞后：缺货和临期商品无法及时预警
- 客户维系困难：无法系统化记录宠物健康档案和服务历史
系统采用SpringBoot 2.7 + MyBatis Plus + Vue.js技术栈，包含12个核心模块。我在实际部署中发现，相比市面上的通用零售系统，这套方案有三大独特优势：
- 专门为宠物店设计的服务预约日历，可直观显示美容师排班和宠物服务时长
- 集成宠物电子档案功能，记录疫苗、过敏史等关键信息
- 针对活体销售的特色流程，包含检疫证明上传和售后跟踪
提示：系统默认使用H2内存数据库方便演示，生产环境建议切换MySQL并配置定期备份策略
2. 系统架构与技术选型
2.1 整体架构设计
系统采用经典的三层架构，但针对宠物店业务做了特殊优化：
code复制表现层：Vue.js + Element UI
↑
业务逻辑层：SpringBoot + Spring Security
↑
数据持久层：MyBatis Plus + H2/MySQL
↑
第三方服务：短信API + 支付网关 + 电子秤串口通信
特别值得注意的是商品管理模块的双层设计：
- 常规商品（食品、用品）采用标准SKU管理
- 活体宠物（猫狗等）需要单独建立生物档案体系
2.2 关键技术决策解析
选择SpringBoot而非传统SSM框架的主要考虑：
- 快速集成RabbitMQ实现库存预警（平均延迟<500ms）
- 内置Actuator端点方便监控服务健康状态
- 与Vue.js的前后端分离架构更匹配
数据库选型对比：
| 选项 | 开发环境适用性 | 宠物店业务适配度 | 运维复杂度 |
|---|---|---|---|
| H2 | ★★★★★ | ★★☆☆☆ | ★☆☆☆☆ |
| MySQL | ★★★☆☆ | ★★★★★ | ★★★☆☆ |
| PostgreSQL | ★★☆☆☆ | ★★★★☆ | ★★★★☆ |
注意：活体宠物需要频繁更新状态（在售/预定/已售），建议MySQL配置事务隔离级别为READ_COMMITTED
3. 核心功能实现细节
3.1 宠物服务预约系统
这是最具行业特色的模块，主要技术难点在于：
- 服务资源冲突检测（美容师、洗浴间等）
- 不同品种宠物所需服务时长预测
- 会员折扣与套餐优惠的叠加计算
核心算法实现（部分伪代码）：
java复制// 预约冲突检测逻辑
public boolean checkConflict(Appointment newAppt) {
return existingAppointments.stream()
.anyMatch(existing ->
!existing.getGroomerId().equals(newAppt.getGroomerId())
&& existing.getDateTime().isBefore(newAppt.getEndTime())
&& existing.getEndTime().isAfter(newAppt.getDateTime()));
}
// 品种服务时长映射表
@Embeddable
public class BreedTimeConfig {
private String breed;
private int bathMinutes;
private int haircutMinutes;
// getters/setters...
}
3.2 动态库存预警机制
不同于常规零售系统，宠物店需要特别关注：
- 宠物食品的临期预警（提前30天）
- 易耗品（尿垫、猫砂）的智能补货建议
- 活体库存的特殊处理（不计入常规盘点）
实现的关键配置：
yaml复制# application-inventory.yml
inventory:
warning:
food-expiry-days: 30
consumable-threshold: 20%
live-animal-status: [FOR_SALE, RESERVED, SOLD]
4. 部署与运维实战指南
4.1 宝塔环境部署要点
在CentOS 7.x上的实测经验：
- JDK建议选择Azul Zulu 11（比OpenJDK内存占用低15%）
- Nginx配置需要特别处理WebSocket：
nginx复制location /api/ws {
proxy_pass http://localhost:8080;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
- 定时任务建议用Supervisor管理，配置示例：
ini复制[program:petstore]
command=java -jar /www/petstore.jar
autostart=true
autorestart=true
stderr_logfile=/var/log/petstore.err.log
stdout_logfile=/var/log/petstore.out.log
4.2 常见故障排查
问题1：启动时报Bean创建失败
- 检查MySQL连接池配置（建议Druid）
- 确认MyBatis映射文件位置正确
问题2：预约时间显示错乱
- 确保服务器时区设置为Asia/Shanghai
- 前端moment-timezone需统一配置
问题3：库存同步延迟
- 检查RabbitMQ队列积压情况
- 适当调整消费者线程数
5. 二次开发建议
根据我参与的三个宠物店定制项目经验，最常需要的扩展点：
-
智能推荐模块
- 基于消费历史的宠物食品推荐
- 疫苗到期自动提醒
-
连锁店支持
- 多门店库存调拨
- 总部数据看板
-
硬件集成
- 宠物称重蓝牙设备对接
- 智能猫柜状态监控
关键接口示例：
java复制public interface GroomingRecommendService {
List<ServicePackage> recommendPackages(Pet pet, List<Appointment> history);
@Scheduled(cron = "0 0 9 * * ?")
void sendVaccineReminders();
}
源码中特别值得研究的几个设计：
- 使用策略模式处理不同会员等级的折扣计算
- 宠物状态机实现（State Pattern）
- 基于AOP的营业数据自动快照
这个系统最让我惊喜的是其异常处理设计，比如当尝试删除已有消费记录的宠物时，会触发级联档案转存而非直接删除，这个细节避免了多个项目中的历史数据丢失问题。对于准备学习SpringBoot实战开发的同学，这套源码比很多教学demo更有商业项目质感