# 宠物之家

**Repository Path**: hung_jun/pethome

## Basic Information

- **Project Name**: 宠物之家
- **Description**: 宠物之家前后端分离 ，springboot+vue 
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 7
- **Forks**: 0
- **Created**: 2020-07-18
- **Last Updated**: 2026-03-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# PetHome (宠物之家)

#### 项目介绍
PetHome（宠物之家）是一个基于 **Spring Boot + Vue.js** 开发的前后端分离的宠物综合服务平台。该项目集成了宠物领养、宠物商品买卖、店铺管理、订单处理以及支付功能（支付宝）等核心业务模块，适用于中小型宠物电商或社区运营场景。

#### 软件架构

**后端 (Spring Boot)**
*   **核心框架**: Spring Boot 2.x
*   **持久层**: MyBatis + MySQL
*   **缓存**: Redis (用于验证码、Session存储)
*   **文件存储**: FastDFS (分布式文件存储)
*   **API文档**: Swagger2
*   **消息通知**: 短信 (SMS) + 邮件 (Email)

**前端 (Vue.js)**
*   **框架**: Vue 2.x
*   **UI库**: Element UI (提供深色/浅色多套主题)
*   **构建工具**: Webpack

#### 功能模块

1.  **用户系统**:
    *   支持多种登录方式：手机号、邮箱、微信小程序。
    *   用户信息管理、收货地址管理。
2.  **宠物中心**:
    *   **领养 (Adopt)**: 发布宠物领养信息，支持审核上架流程。
    *   **出售 (Pet)**: 商铺或个人发布待售宠物信息。
3.  **商城系统 (Product)**:
    *   商品管理（上下架、详情介绍）。
    *   商品分类（PetType）。
4.  **店铺管理 (Shop)**:
    *   商铺注册、申请流程。
    *   商铺信息维护、管理员审核（Audit）机制。
5.  **订单与支付 (Order & Pay)**:
    *   订单生成、地址管理。
    *   集成支付宝支付（`AlipayUtils`），处理支付回调。
6.  **工具服务**:
    *   **LBS服务**: 根据地址计算距离（`DistanceUtil`）。
    *   **验证码**: 短信/邮件验证码发送。

#### 安装教程

1.  **环境准备**:
    *   安装 JDK 1.8+
    *   安装 MySQL 5.7+ 并导入数据库脚本
    *   安装 Redis
    *   搭建 FastDFS 文件服务器集群
2.  **后端配置**:
    *   修改 `PetHome/src/main/resources/application.yml` 或 `application.properties`：
        *   配置数据库连接信息。
        *   配置 Redis 密码和地址。
        *   配置支付宝商户密钥 (`merchant_private_key`, `appid` 等)。
        *   配置邮件服务器和短信平台凭证。
3.  **前端部署**:
    *   进入 `Pethome_web/PetHome_Admin` 目录。
    *   执行 `npm install` 安装依赖。
    *   执行 `npm run dev` 启动开发服务器。
    *   执行 `npm run build` 构建生产版本。

#### 目录结构

```text
pethome
├── PetHome/                          # 后端主项目
│   ├── src/main/java/hong/jun/
│   │   ├── basic/                    # 基础配置（跨域、Swagger、工具类）
│   │   ├── pet_home/                 # 业务模块
│   │   │   ├── controller/           # 控制器层 (API接口)
│   │   │   ├── domain/               # 实体类 (Entity)
│   │   │   ├── mapper/               # MyBatis Mapper接口
│   │   │   ├── service/              # 业务逻辑层
│   │   │   └── query/                # 查询参数封装类
│   │   └── APP.java                  # 启动类
│   └── src/main/resources/            # 配置文件、Mapper XML
│
└── Pethome_web/
    └── PetHome_Admin/                # 后台管理前端 (Vue)
        ├── src/                      # Vue 源码
        ├── build/                    # Webpack 构建配置
        └── config/                   # 项目环境配置
```

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request

#### 特别鸣谢

*   感谢 Gitee 提供的托管平台。
*   基于 Element UI 的优秀前端组件库。
*   Spring Boot 社区。