半泽和莉娜1. 项目背景与核心需求
宠物经济近年来呈现爆发式增长，根据行业数据显示，2023年中国宠物市场规模已突破3000亿元。在这样的市场背景下，传统宠物店手工记账、Excel管理的模式已经难以满足业务需求。我去年为本地一家连锁宠物店做技术咨询时，店主就经常抱怨："会员信息分散在三个本子上，库存盘点总要加班到半夜，预约洗澡的客户经常被漏单..."
这正是"宠贝爱家"这类管理系统需要解决的核心痛点。系统主要面向中小型宠物店经营者，需要同时处理以下几个维度的业务：
- 商品管理：包括宠物食品、用品、药品的进销存，需要支持批次管理、保质期预警、库存阈值提醒等
- 宠物档案：记录宠物品种、年龄、疫苗记录、病史等，理想状态下应该能与商品购买记录关联
- 服务管理：洗澡、美容、寄养等服务项目的预约与执行跟踪
- 会员体系：客户消费积分、储值卡、优惠券等营销工具
实际开发中发现，最容易被忽视的是"宠物-商品-服务"三者的关联关系。比如一只患有皮肤病的狗狗，在购买特定处方粮时应该自动提示可用优惠券，洗澡时应该提醒美容师避开患处。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 技术选型与架构设计
2.1 为什么选择Java技术栈
虽然现在Python、Go等语言很火热，但Java在中小型商业系统中仍有不可替代的优势：
- 成熟稳定：Spring Boot生态经过十几年发展，从数据库连接到安全认证都有现成解决方案
- 性能表现：基于JVM的即时编译优化，在处理宠物店典型的高并发场景（如促销秒杀）时更可靠
- 人才储备：Java开发者基数大，后期维护成本低
技术栈的具体组成：
- 后端：Spring Boot 2.7 + MyBatis Plus
- 前端：Vue 3 + Element Plus（考虑店主操作习惯，未采用React）
- 数据库：MySQL 8.0（关系型）+ Redis（缓存）
- 部署：Docker容器化
2.2 系统架构关键决策
采用经典的三层架构，但有几个特殊设计点：
-
商品微服务独立部署：
java复制@Service public class ProductServiceImpl implements ProductService { // 使用Redisson实现分布式锁 public boolean reduceStock(Long productId, int quantity) { RLock lock = redissonClient.getLock("product_" + productId); try { lock.lock(); // 库存扣减逻辑 } finally { lock.unlock(); } } }库存操作单独抽离，避免促销时影响核心交易流程
-
宠物档案的文档型存储：
虽然主库用MySQL，但宠物健康记录采用MongoDB存储，因为：- 每只宠物的医疗记录结构差异大
- 需要支持嵌套文档（如疫苗记录包含批次、接种时间、医生备注等）
-
预约服务的状态机设计：
mermaid复制stateDiagram [*] --> 待确认 待确认 --> 已预约: 客户确认 已预约 --> 服务中: 到店签到 服务中 --> 已完成: 服务结束 已预约 --> 已取消: 超时未到使用Spring State Machine实现，避免状态流转混乱
3. 核心功能实现细节
3.1 商品智能推荐模块
这是区别于普通进销存系统的关键功能，实现逻辑：
-
标签体系构建：
- 商品维度：适用宠物类型（犬/猫/异宠）、年龄段、功能分类（美毛、肠胃调理等）
- 宠物维度：品种、年龄、既往病史
-
推荐算法：
java复制public List<Product> recommendProducts(Pet pet) { // 基础规则匹配 List<Product> baseProducts = productMapper.selectByTags( pet.getType(), pet.getAgeGroup()); // 协同过滤增强 if (pet.getOwner().getPurchaseHistory() != null) { baseProducts.addAll(collaborativeFiltering( pet.getOwner().getId())); } // 健康相关商品加权 return baseProducts.stream() .sorted((p1, p2) -> { if (p1.getTags().contains(pet.getHealthCondition())) { return -1; } return p2.getSales() - p1.getSales(); }) .limit(5) .collect(Collectors.toList()); }
3.2 服务预约的冲突检测
宠物店经常遇到的问题是同一时间段多个服务冲突（如美容师同时被预约），解决方案：
-
资源日历建模：
sql复制CREATE TABLE `schedule_resource` ( `id` BIGINT PRIMARY KEY, `staff_id` BIGINT COMMENT '美容师ID', `date` DATE NOT NULL, `time_slots` JSON NOT NULL COMMENT '时间段占用情况' );使用JSON字段存储15分钟粒度的时段占用状态
-
并发控制：
java复制@Transactional public boolean bookService(BookingRequest request) { // 使用SELECT FOR UPDATE锁定资源记录 ScheduleResource resource = resourceMapper.selectForUpdate( request.getStaffId(), request.getDate()); if (isTimeSlotAvailable(resource, request.getSlot())) { updateTimeSlot(resource, request.getSlot(), true); resourceMapper.update(resource); return true; } return false; }
4. 开发中的典型问题与解决方案
4.1 库存超卖问题
初期采用简单SQL：
sql复制UPDATE product SET stock = stock - #{quantity}
WHERE id = #{productId} AND stock >= #{quantity}
但在秒杀测试中仍出现超卖，最终方案：
-
Redis预减库存：
java复制public boolean preReduceStock(Long productId, int quantity) { String key = "product_stock:" + productId; long value = redisTemplate.opsForValue().decrement(key, quantity); if (value < 0) { // 回滚 redisTemplate.opsForValue().increment(key, quantity); return false; } return true; } -
异步落库：
通过RocketMQ消息队列实现最终一致性
4.2 宠物健康记录导出
店主需要定期将宠物疫苗记录导出给动物卫生监督所，遇到两个问题：
-
PDF中文乱码：
最终采用openhtmltopdf+freemarker方案：xml复制<dependency> <groupId>org.thymeleaf</groupId> <artifactId>thymeleaf</artifactId> <version>3.0.15.RELEASE</version> </dependency> -
大数据量内存溢出：
实现分页流式导出：java复制public void exportPetRecords(HttpServletResponse response) { int pageSize = 100; for (int page = 1; ; page++) { Page<Pet> petPage = petMapper.selectPage( new Page<>(page, pageSize), null); if (petPage.getRecords().isEmpty()) break; // 分批写入输出流 writeToOutputStream(petPage.getRecords(), response.getOutputStream()); } }
5. 部署与性能优化
5.1 Docker化部署要点
编写docker-compose.yml时特别注意：
-
MySQL字符集配置：
yaml复制services: mysql: image: mysql:8.0 command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci -
JVM内存设置：
dockerfile复制FROM openjdk:17-jdk ENV JAVA_OPTS="-Xms512m -Xmx1024m -XX:+UseG1GC"
5.2 高频查询优化
-
商品分类缓存：
java复制@Cacheable(value = "productCategory", key = "#root.methodName") public List<Category> getAllCategories() { return categoryMapper.selectList(null); } -
Elasticsearch接入：
对宠物搜索功能引入ES，解决LIKE查询性能问题：json复制{ "mappings": { "properties": { "petName": {"type": "text", "analyzer": "ik_max_word"}, "chipNumber": {"type": "keyword"} } } }
6. 实际运营中的经验总结
经过三个月的试运行，收集到店主的一些实用反馈：
-
扫码入库比预期更重要：
临时增加功能：用ZXing库实现商品条形码扫描入库，减少人工输入错误 -
移动端适配需求突显：
后期追加开发微信小程序版本，支持客户自主预约和查看宠物档案 -
数据看板的价值：
sql复制SELECT p.type, COUNT(*) as count, SUM(o.amount) as revenue FROM pets p JOIN orders o ON p.owner_id = o.customer_id GROUP BY p.type这类简单分析帮助店主发现"猫用品利润率比狗用品高15%"等商业洞见
这个项目给我的深刻体会是：好的管理系统不是功能的堆砌，而是要像宠物店的"数字孪生"一样，真实反映业务脉络。比如最初设计的独立会员系统，后来改造为"客户-宠物"的双中心模型，这才真正抓住了宠物行业的业务本质。