# 宠物社区平台

**Repository Path**: xxf_0921/pet-platform

## Basic Information

- **Project Name**: 宠物社区平台
- **Description**: 本项目是一款面向全域养宠用户、连锁宠物门店、宠物服务机构的全生态数字化SaaS服务平台，依托微信小程序轻量化载体，基于uni-app+图鸟UI前端、Java+Spring Boot企业级后端架构自研开发，是集智能服务履约、同城社交流量、公益生态服务、数字化经营管理于一体的闭环式宠物产业综合解决方案。
- **Primary Language**: Java
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-05-28
- **Last Updated**: 2026-05-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 宠物运营平台 — 项目介绍与技术栈

> 文档版本：1.2  
> 更新日期：2026-05-28  
> 适用工程：`Pet_platform_api` · `Pet_platform_admin` · `Pet_platform_wx` · `Pet_platform_merchant`

---

## 项目介绍

本项目是一款面向全域养宠用户、连锁宠物门店、宠物服务机构的全生态数字化 SaaS 服务平台，依托微信小程序轻量化载体，基于 **uni-app + 图鸟 UI** 前端、**Java + Spring Boot** 企业级后端架构自研开发，是集 **智能服务履约、同城社交流量、公益生态服务、数字化经营管理** 于一体的闭环式宠物产业综合解决方案。

---

## 核心功能板块

### 一、宠物动态社区

1. **动态发布**：支持文字 + 多图组合发布，可自定义添加话题标签，满足宠物日常分享需求  
2. **内容互动**：提供动态点赞、评论、收藏、分享全链路互动能力，提升社区活跃度  
3. **智能分发**：按热门推荐、同城动态、关注好友动态多维度分发内容，精准触达用户  
4. **话题广场**：聚合 #萌宠日常#、#猫咪#、#狗狗#、#宠物成长# 等热门话题，打造内容分类与流量入口  
5. **个人主页**：集中展示用户历史动态，支持绑定宠物基础信息，打造专属宠物社交主页  

### 二、多门店智能预约

1. **门店基础管理**：统一管理多门店信息、营业时间、宠物服务项目配置  
2. **预约规则配置**：支持时段容量、每日预约上限、休息日自定义设置  
3. **订单全流程管理**：覆盖订单创建、取消、确认、完成全状态自动流转  
4. **智能防冲突校验**：自动校验预约时间 / 容量冲突，杜绝超约、超卖问题  

### 三、宠物档案管理

1. **宠物信息建档**：支持录入宠物品种、年龄、性别、毛色、体重、疫苗史、驱虫史、病史等完整信息  
2. **成长记录追踪**：动态记录宠物日常数据、健康变化、成长瞬间，形成可视化成长档案  
3. **多宠物绑定**：单个用户可绑定多只宠物档案，统一管理、便捷查看  
4. **档案联动使用**：可同步至门店预约、社区动态，实现一档案全平台通用  

---

## 1. 项目概览

本项目是一套 **宠物行业 SaaS 运营平台**，采用 **前后端分离 + 多端共用同一后端 API** 的架构。

| 子工程 | 目录名 | 角色 | 产品形态 |
|--------|--------|------|----------|
| 服务端 | `Pet_platform_api` | 统一 REST API | Spring Boot 服务，默认端口 `12092` |
| 管理端 | `Pet_platform_admin` | 平台/运营后台 | Web 管理端 |
| 用户端 | `Pet_platform_wx` | C 端用户 | 微信小程序「宠邻圈 / 汪喵Pro」 |
| 商家端 | `Pet_platform_merchant` | B 端商家 | 原生 App「宠物商家助手」（uni-app 打包） |

**演示地址：** `https://pet.yunchencloud.cn/`  
**API 根地址（开发示例）：** `http://127.0.0.1:12092/`

各端配置需保持根地址一致（管理端 `public/host.js`，小程序 `config/api-base.js`）。

---

## 2. 系统架构

```
┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐
│  Pet_platform   │  │  Pet_platform   │  │  Pet_platform   │
│     _admin      │  │       _wx       │  │   _merchant     │
│  Vue3 Web 后台  │  │  微信小程序 C端  │  │  商家 App B端   │
└────────┬────────┘  └────────┬────────┘  └────────┬────────┘
         │                    │                    │
         └────────────────────┼────────────────────┘
                              │ HTTPS / REST + JWT
                              ▼
                    ┌─────────────────────┐
                    │  Pet_platform_api   │
                    │  Spring Boot 2.6    │
                    │  MyBatis + MySQL    │
                    └──────────┬──────────┘
                               │
         ┌─────────────────────┼─────────────────────┐
         ▼                     ▼                     ▼
   ┌──────────┐          ┌──────────┐          ┌──────────┐
   │  MySQL   │          │ 阿里云OSS │          │ 微信/支付 │
   │pet_platform│        │  文件存储  │          │  第三方通道 │
   └──────────┘          └──────────┘          └──────────┘
```

---

## 3. 业务模块说明

### 3.1 C 端（微信小程序）

- **内容与社区**：美拍/文章、社区帖子（喵星日常）、关注达人、点赞收藏、评论
- **爱宠工具**：物种/宠物档案、日程事件、爱宠日志、记录分类（分包 `clockpage`）
- **本地生活**：附近门店推荐、探店、服务详情、在线预约、订单与核销码
- **商家入驻**：商铺入驻申请（分包 `merchantPkg`）
- **消息**：平台通知与消息详情

### 3.2 B 端（商家 App）

- **门店管理**：门店信息、资质、门店二维码
- **服务管理**：服务分类、服务项目维护
- **订单**：订单列表、订单详情、扫码核销
- **财务**：本店流水记录
- **账户**：登录、个人设置、密码修改

### 3.3 平台管理端（Web）

| 模块 | 主要功能 |
|------|----------|
| 首页 | 运营数据概览 |
| 平台设置 | 轮播图、金刚区、FAQ、消息通知、评论管理 |
| 用户管理 | 小程序用户（Customer） |
| 物种/宠物 | 物种管理、宠物管理、记录功能分类 |
| 社区 | 分类管理、帖子管理 |
| 商家管理 | 商家列表、资质管理、推荐门店 |
| 商家中心 | 店铺资料与资质、订单、支付流水（商家视角） |
| 财务管理 | 全平台支付流水 |
| 系统维护 | 人员、部门、角色、菜单、登录日志 |

### 3.4 服务端核心域（Controller 层）

| 业务域 | 代表 Controller |
|--------|-----------------|
| 权限与用户 | `UsersController`、`RolesController`、`PermissionsController`、`DepartmentsController` |
| C 端用户 | `CustomerController` |
| 商家 | `MerchantsController`、`MerchantCredentialsController`、`MerchantOrdersController` |
| 服务与分类 | `CustomerServiceCategoriesController`、`CustomerMerchantServicesController` |
| 社区 | `PostsController`、`CategoriesController`、`UserPostsController`、`UserFollowsController`、`MommentsController` |
| 宠物 | `PetsController`、`SpeciesController`、`PetDailyLogsController`、`RecordCategoriesController` |
| 运营配置 | `BannerInfoController`、`DiamondZoneController`、`FaqController`、`NotificationMessagesController` |
| 财务 | `FinancePaymentLogsController`、`CustomerFinancePaymentLogsController`、`ApiTradeController` |
| 微信 | `WxController`、`QRCodeController` |
| 文件 | `FileController` |
| 分析 | `AnalysisController` |

---

## 4. 各子项目技术栈

### 4.1 Pet_platform_api（服务端）

| 类别 | 技术选型 |
|------|----------|
| 语言 | Java 8 |
| 框架 | Spring Boot 2.6.2 |
| Web | spring-boot-starter-web |
| 持久层 | MyBatis 2.2.0 + MyBatis Generator |
| 数据库 | MySQL（库名 `pet_platform`） |
| 连接池 | Alibaba Druid |
| 认证 | JWT（java-jwt / jjwt） |
| JSON | FastJSON |
| 工具 | Hutool、Lombok |
| 对象存储 | 阿里云 OSS SDK |
| 微信 | weixin-java-mp |
| 二维码 | Google ZXing |
| 加密 | BouncyCastle |
| 架构形态 | 单体 Spring Boot 应用 |

**主要依赖说明：**

- 使用 `@MapperScan` 扫描 `com.yunchen.server.mapper`
- 支持 `@EnableScheduling` 定时任务
- 令牌配置：`application.properties` 中 `token-secret`、`token-expiration`（默认 7 天）
- 支付：对接第三方收银通道（如扫码富），含支付回调处理

**启动：**

```bash
# 在 Pet_platform_api 目录
mvn spring-boot:run
# 或运行主类 com.yunchen.server.ServerApplication
```

默认端口：`12092`

---

### 4.2 Pet_platform_admin（管理端 Web）

| 类别 | 技术选型 |
|------|----------|
| 框架 | Vue 3 |
| 路由 | Vue Router 4 |
| UI 组件库 | Element Plus 2.x |
| 状态管理 | Pinia + pinia-plugin-persistedstate |
| 构建工具 | Vue CLI 5 |
| HTTP | Axios |
| 样式 | Less |
| 图表 | ECharts + vue-echarts |
| 地图 | 高德地图 @amap/amap-jsapi-loader |
| 文件上传 | 阿里云 OSS（ali-oss） |
| 富文本 | WangEditor 5 |
| 其他 | NProgress、pdfjs-dist、unplugin 自动导入 |

**启动：**

```bash
cd Pet_platform_admin
npm install
npm run dev      # 开发，默认 http://localhost:8080
npm run build    # 生产构建
```

**API 配置：** `public/host.js` 中的 `VITE_APP_BASE_API`

---

### 4.3 Pet_platform_wx（微信小程序 C 端）

| 类别 | 技术选型 |
|------|----------|
| 跨端框架 | uni-app（Vue 2） |
| 主要目标平台 | 微信小程序（mp-weixin） |
| UI 库 | 图鸟 UI（Tuniao UI），easycom 引入 `tn-*` |
| 构建工具 | HBuilderX 3.1+ |
| 样式 | node-sass |
| 可选端 | H5（标题「宠物小舍」，router base `/chongwuxiaoshe/`） |

**应用信息：**

- manifest 应用名：宠邻圈
- 首页导航标题：汪喵Pro
- 微信 appid：见 `manifest.json` → `mp-weixin.appid`

**主要页面结构：**

- 主包：首页、登录、内容详情、社区、关注、订单、消息等
- 分包 `clockpage`：事件分类、爱宠日志、我的爱宠、发帖/收藏/点赞等
- 分包 `merchantPkg`：商铺入驻、提交入驻申请

**端能力：** 地理位置（`getLocation` / `chooseLocation`），用于附近门店推荐

**API 配置：** `config/api-base.js` → `API_BASE`

**运行：**

1. HBuilderX 打开 `Pet_platform_wx`
2. 运行 → 运行到小程序模拟器 → 微信开发者工具
3. 在微信公众平台配置服务器域名

---

### 4.4 Pet_platform_merchant（商家移动端 App）

| 类别 | 技术选型 |
|------|----------|
| 跨端框架 | uni-app（Vue 2） |
| 发布形态 | 5+ App / app-plus（Android + iOS） |
| 应用名称 | 宠物商家助手 |
| UI 库 | Tuniao UI |
| 构建工具 | HBuilderX |
| 硬件能力 | 相机、条码（门店扫码核销） |

**Tab 结构：** 首页 · 订单 · 我的

**扩展页面：** 门店管理、资质、服务分类/项目、订单详情、流水、门店二维码、账户设置等

**运行：**

1. HBuilderX 打开 `Pet_platform_merchant`
2. 运行到手机/模拟器，或使用云打包生成 Android / iOS 安装包

---

## 5. 端间协作关系

| 端 | 主要使用者 | 核心职责 |
|----|------------|----------|
| 小程序 | 宠物主人 | 内容消费、养宠记录、预约下单、轻量核销 |
| 商家 App | 门店经营者 | 接单、维护门店与服务、流水、扫码核销 |
| 管理后台 | 平台运营 | 审核商家、运营位配置、用户/社区/财务管理、RBAC |
| API | — | 统一鉴权、业务逻辑、微信与支付回调、OSS 上传 |

---

## 6. 环境与配置

### 6.1 服务端（application.properties 要点）

| 配置项 | 说明 |
|--------|------|
| `server.port` | 默认 `12092` |
| `spring.datasource.url` | MySQL 连接（库 `pet_platform`） |
| `token-secret` | JWT 密钥 |
| `token-expiration` | 令牌有效期（毫秒，默认 7 天） |
| `spring.servlet.multipart.max-file-size` | 上传限制 500MB |

### 6.2 前端 API 地址

| 端 | 配置文件 |
|----|----------|
| 管理端 | `Pet_platform_admin/public/host.js` |
| 小程序 | `Pet_platform_wx/config/api-base.js` |
| 商家端 | 项目内 API 请求封装（与上述根地址保持一致） |

---

## 7. 目录结构速览

```
宠物运营平台/
├── Pet_platform_api/          # Spring Boot 后端
│   └── src/main/java/com/yunchen/server/
│       ├── controller/        # REST 接口
│       ├── service/           # 业务逻辑
│       ├── mapper/            # MyBatis Mapper
│       └── util/              # 工具类
├── Pet_platform_admin/        # Vue3 管理后台
│   └── src/
│       ├── views/             # 页面
│       ├── router/            # 路由
│       └── api/               # 接口封装
├── Pet_platform_wx/           # uni-app 小程序
│   ├── pages/                 # 主包页面
│   ├── clockpage/             # 爱宠分包
│   ├── merchantPkg/           # 入驻分包
│   └── config/api-base.js
├── Pet_platform_merchant/   # uni-app 商家 App
│   └── pages/                 # 首页/订单/门店/服务等
└── docs/                      # 项目文档（本文件所在目录）
```

---

## 8. 技术选型总结

| 层次 | 技术 |
|------|------|
| 后端 | Java 8 · Spring Boot 2.6 · MyBatis · MySQL · JWT |
| 管理端 | Vue 3 · Element Plus · Pinia · Vue CLI |
| 移动端 | uni-app · Vue 2 · Tuniao UI · HBuilderX |
| 基础设施 | 阿里云 OSS · 微信开放平台 · 第三方支付通道 |

整体为 **国内常见、成熟稳定** 的技术组合，适合宠物本地生活、社区内容与商家 SaaS 的完整业务闭环。

---

## 9. 附录：管理端路由模块

来源：`Pet_platform_admin/src/router/modules/routing.js`

- `/home` — 首页
- `/app/*` — 平台设置（轮播图、金刚区、FAQ、消息、评论）
- `/user/customer` — 小程序用户
- `/species`、`/pets`、`/recordCategories` — 物种/宠物/记录分类
- `/community/*` — 社区分类与帖子
- `/merchants/*` — 商家列表、资质、推荐门店
- `/merchant/*` — 商家中心（资料、订单、流水）
- `/finance/paymentLogs` — 全平台支付流水
- `/system/*` — 人员、部门、角色、菜单、登录日志

---

## 10. 知识星球

扫码加入知识星球，获取项目交流、更新说明与相关资料。

![输入图片说明](6f1fb9346995bf9b51753e6fd9cd0d6b.jpg)