一、系统介绍
Pet360 管理系统，专为宠物服务行业打造的 B 端业务管理平台，采用 SpringBoot 后端 + Vue 前端 + MySQL 数据库 技术栈开发。 目标用户：宠物美容店、宠物医院、宠物寄养馆、宠物用品零售店。 业务定位：整合宠物档案、主人会员、洗护寄养订单、商品库存、收银对账功能，替代手工台账、Excel 表格记账，实现门店数字化管理。
系统角色
1. 管理员：最高权限，账号管理、系统参数配置、查看全部经营报表
2. 门店员工 / 美容师：创建预约、登记宠物信息、开具洗护工单、收银结算
3. 会员（配套小程序端，可选）：线上预约、查看宠物档案、购买服务套餐
二、核心功能模块
1. 会员管理
· 会员档案登记：宠物主人姓名、手机号、地址、会员等级、账户余额、积分管理
· 会员充值、次卡 / 套餐管理（洗护套餐、美容套餐、寄养套餐）
· 会员消费记录、充值记录查询，支持会员标签分类（新客 / 老客 / 宠物过敏高危客户）
· 消息提醒（疫苗到期、洗护周期提醒）
2. 宠物档案（系统核心模块）
· 宠物基础信息：名字、品种、年龄、性别、体重、毛色、生日
· 健康档案：疫苗记录、驱虫记录、病史、过敏备注、手术记录
· 宠物照片上传，每次洗护 / 体检记录自动归档至宠物档案
· 寄养、美容历史记录自动关联对应宠物档案
3. 预约 & 洗护管理
· 前台手工预约 / 客户线上预约，美容师排班管理
· 洗护工单：洗澡、美容、药浴，记录毛发状态、皮肤情况
· 寄养管理：寄养入住登记、寄养天数核算、寄养费用、喂食记录、每日状态记录、到期自动提醒
4. 商品进销存
· 商品档案：宠物粮、零食、玩具、药品，分类管理，支持上传商品图片
· 采购入库、商品出库、库存预警（库存低于阈值触发补货提醒）
· 商品销售绑定收银单据，销售后自动扣减库存
· 供应商信息管理
5. 收银结算
· 订单合并结算：洗护服务 + 商品 + 寄养费用合并一单结算
· 多种支付方式：微信、支付宝、现金、会员余额抵扣
· 小票打印，订单流水查询，退款管理
· 开单自动生成消费记录，同步更新会员档案
6. 数据报表
· 营业报表：按日 / 按月统计营业额、营收构成（洗护 / 商品 / 寄养）
· 会员统计：新增会员数量、充值总金额、客户复购率
· 商品销售排行、库存台账报表
· 美容师业绩统计，自动核算员工提成
7. 系统基础设置
· 员工账号创建、角色权限分配
· 服务项目配置（洗澡、美容项目定价）
· 套餐配置、商品分类维护
· 系统参数、打印机配置、消息通知配置
8. 可选配套（部分版本包含）
微信小程序端：客户自助预约、套餐浏览、线上充值。
三、系统优缺点
✅ 优点
1. 行业针对性强：并非通用进销存软件，专门适配宠物门店业务，内置宠物健康档案、寄养、美容工单，无需大量自定义字段。
2. 轻量化，硬件门槛低：普通电脑即可部署，无需高价专用服务器。
3. 前后端分离架构，页面操作流畅；业务界面贴合宠物店日常工作，员工上手难度低。
4. 业务一体化：会员 + 宠物档案 + 洗护寄养 + 库存 + 收银集成在一套系统，无需切换多套软件。
5. 报表功能完善，自动统计员工业绩，方便门店管理者查看经营情况，自动计算美容师提成。
❌ 缺点
1. 开源版本无官方技术售后，出现程序 bug 需要自行排查修复；商用版本才提供技术支持。
2. 开源版本的小程序端大多为阉割版本，完整小程序功能需要二次开发。
3. 不支持复杂连锁多门店架构，更适合单门店使用；多门店场景需要改造数据库与权限模块。
4. 医疗相关模块功能简单，如果是大型宠物医院，缺少完整病历、处方、检验模块，仅能满足简易诊所登记需求。
5. 数据库自动备份需要手动配置，忘记备份存在门店经营数据丢失风险。
6. 对小票打印机兼容性有限，小众型号打印机可能出现打印乱码问题。
四、保姆级部署教程（本地部署 + Linux 服务器部署两套方案）
环境说明：SpringBoot + Vue + MySQL8.0，JDK1.8 / JDK11 前置资源：Pet360 源码包（后端 jar 包 + Vue 前端源码）
方案 A：Windows 本地部署（门店电脑单机使用，新手优先）
步骤 1：安装运行环境
1. 安装 JDK 1.8
· 下载 JDK1.8 并安装，配置环境变量 JAVA_HOME
· 打开 cmd，输入 java -version，输出版本号即安装成功
2. 安装 MySQL 8.0
· 设置 root 账户密码，妥善保存密码（后续配置使用）
· 新建数据库：pet360，字符集 utf8mb4
CREATE DATABASE pet360 DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
1. 安装 Redis（部分版本依赖，无依赖可跳过）
步骤 2：导入数据库脚本
1. 在源码目录找到 pet360.sql 文件
2. 使用 Navicat/DBeaver 连接本地 MySQL，选中 pet360 数据库，执行 sql 脚本，导入表结构与初始化基础数据
步骤 3：后端项目配置
1. 打开后端配置文件 application.yml
2. 修改数据库连接信息
spring:
datasource:
url: jdbc:mysql://127.0.0.1:3306/pet360?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
username: root
password: 【填写你的mysql密码】
1. 打包后端项目，生成 pet360.jar
2. cmd 切换到 jar 包所在目录，执行启动命令：
java -jar pet360.jar
日志打印启动成功，后端默认占用 8080 端口
步骤 4：Vue 前端部署
1. 安装 node.js（v14/v16 稳定版本）
2. 进入前端项目文件夹，执行依赖安装
npm install
1. 修改前端 .env 环境文件，后端接口地址改为 http://127.0.0.1:8080
2. 本地调试启动：npm run serve
3. 正式打包部署：npm run build，打包完成后 dist 文件夹即为静态页面资源
步骤 5：访问系统
前端启动成功，浏览器访问：http://localhost:8081 默认管理员账号密码（源码初始化数据，一般为 admin / 123456）
单机部署说明：门店电脑必须保持开机才能访问系统；电脑关机，系统无法使用。
方案 B：Linux 服务器部署（外网访问，老板远程查看报表，商用推荐）
服务器推荐：阿里云 / 腾讯云 2 核 2G，CentOS7 / Ubuntu20.04
1. 服务器环境安装
#安装JDK1.8
yum install java-1.8.0-openjdk-devel -y
#安装mysql8
yum install mysql-server -y
systemctl start mysqld
systemctl enable mysqld
#安装redis（按需安装）
yum install redis -y
systemctl start redis
服务器安全组放行端口：80、8080、3306
2. 数据库初始化
登录 mysql，创建 pet360 数据库，上传 pet360.sql 脚本，source 导入数据库
CREATE DATABASE pet360 DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
use pet360;
source /root/pet360.sql;
3. 上传后端 jar 包，启动后台服务
1. 使用 xshell+rz 工具上传 pet360.jar 到服务器 /root 目录
2. 修改 application.yml 数据库连接信息，填写服务器 mysql 账号密码
3. 后台持久运行（关闭 ssh 连接服务不停止）
nohup java -jar pet360.jar > pet360.log 2>&1 &
查看实时日志：tail -f pet360.log
4. Nginx 部署前端 dist 包
1. 安装 nginx
yum install nginx -y
systemctl start nginx
1. 将 dist 文件夹上传到 nginx 网页目录 /usr/share/nginx/html/pet360
2. 修改 nginx 配置，配置反向代理，将 /api 请求转发到后端 8080 端口
server {
listen 80;
server_name 你的服务器IP;
root /usr/share/nginx/html/pet360;
index index.html;
location /api/ {
proxy_pass http://127.0.0.1:8080/;
}
}
1. 重启 nginx 服务 systemctl restart nginx
5. 访问系统
浏览器输入服务器公网 IP，直接打开 Pet360 管理后台。
五、部署后必做配置
1. 修改默认 admin 账号密码！防止非法登录
2. 添加门店员工账号，分配对应权限（美容师仅开放开单权限，禁止修改系统配置）
3. 录入服务项目：洗澡、美容、寄养项目定价
4. 录入商品库存、供应商信息
5. 测试小票打印机，调整打印模板
6. 设置数据库定时自动备份，建议每日备份 pet360 数据库
7. 完整测试预约、收银、会员充值全业务流程，验证业务正常
六、常见问题排查
1. 启动报错：数据库连接失败 → 核对 mysql 账号密码、端口，确认数据库已创建
2. 前端空白页面：检查 nginx 反向代理配置、前端后端接口地址是否填写错误
3. 图片上传失败：检查服务器文件夹读写权限
4. 小票打印乱码：打印机驱动问题，更换 GBK 编码打印模板
七、运维注意事项
1. 定期备份数据库，推荐本地 + 云端双备份方案
2. 服务器不要直接把 3306 数据库端口暴露到公网，限制访问 IP，降低数据库被攻击风险
3. 开源项目禁止直接作为成品对外售卖，严格遵守开源协议