|
|
# 宠物领养系统
|
|
|
|
|
|
## 项目简介
|
|
|
宠物领养系统是一个前后端分离的Web应用，旨在搭建一个连接宠物与领养者的平台，帮助流浪动物找到温暖的家。系统提供宠物信息展示、领养申请、用户互动、内容管理等功能，为宠物救助和领养提供便捷的数字化解决方案。
|
|
|
|
|
|
## 系统架构
|
|
|
系统采用前后端分离的开发架构：
|
|
|
|
|
|
- **前端**：负责页面开发和用户交互
|
|
|
- **后端**：负责业务逻辑处理和数据管理
|
|
|
- **数据库**：专注于数据存储
|
|
|
|
|
|
## 技术栈
|
|
|
|
|
|
### 后端技术
|
|
|
- **框架**：Spring Boot 2.2.4.RELEASE
|
|
|
- **ORM框架**：MyBatis Plus 3.5.3.1
|
|
|
- **数据库**：MySQL 5.7.43
|
|
|
- **开发语言**：Java 8
|
|
|
- **构建工具**：Maven 3.9.9
|
|
|
- **其他依赖**：Lombok、FastJSON、EasyExcel等
|
|
|
|
|
|
### 前端技术
|
|
|
- **框架**：Vue 2.6.11
|
|
|
- **UI组件库**：Element UI 2.15.14
|
|
|
- **路由**：Vue Router 3.2.0
|
|
|
- **HTTP客户端**：Axios 0.21.1
|
|
|
- **编辑器**：WangEditor、Toast UI Editor
|
|
|
- **其他库**：ECharts、CryptoJS、Lodash等
|
|
|
|
|
|
## 功能模块
|
|
|
|
|
|
### 1. 用户模块
|
|
|
- 用户注册、登录
|
|
|
- 用户信息管理（个人资料、头像等）
|
|
|
- 角色管理（普通用户、管理员）
|
|
|
|
|
|
### 2. 宠物信息模块
|
|
|
- 宠物类别管理
|
|
|
- 宠物信息发布和管理
|
|
|
- 宠物详情展示
|
|
|
- 宠物推荐（基于协同过滤算法）
|
|
|
|
|
|
### 3. 领养订单模块
|
|
|
- 领养申请提交
|
|
|
- 订单状态管理（申请中、已审核、审核未通过、已完成）
|
|
|
- 收货地址管理
|
|
|
- 订单查询和管理
|
|
|
|
|
|
### 4. 互动行为模块
|
|
|
- 宠物点赞和收藏
|
|
|
- 宠物评论和回复
|
|
|
- 评论点赞功能
|
|
|
|
|
|
### 5. 内容管理模块
|
|
|
- 宠物经验帖子发布和管理
|
|
|
- 帖子审核功能
|
|
|
- 帖子推荐（基于协同过滤算法）
|
|
|
- 帖子流量数据统计
|
|
|
|
|
|
### 6. 通知反馈模块
|
|
|
- 系统公告管理
|
|
|
- 建议与反馈提交
|
|
|
- 反馈管理（管理员）
|
|
|
|
|
|
## 开发环境要求
|
|
|
|
|
|
### 开发工具
|
|
|
- **前端**：Visual Studio Code
|
|
|
- **后端**：IntelliJ IDEA 旗舰版（推荐2024.3.5或更高版本）
|
|
|
|
|
|
### 运行环境
|
|
|
- **JDK**：1.8
|
|
|
- **MySQL**：5.7.43（或8.x系列）
|
|
|
- **Maven**：3.9.9（高版本Maven需配合高版本IDEA）
|
|
|
- **Node.js**：推荐16.14.0（20以下版本）
|
|
|
|
|
|
## 项目目录结构
|
|
|
|
|
|
```
|
|
|
pet-adopt-system/
|
|
|
├── source code/ # 源代码目录
|
|
|
│ ├── api/ # 后端API代码
|
|
|
│ │ ├── src/ # 源代码
|
|
|
│ │ ├── pom.xml # Maven配置文件
|
|
|
│ │ └── target/ # 编译输出目录
|
|
|
│ ├── view/ # 前端代码
|
|
|
│ │ ├── src/ # 源代码
|
|
|
│ │ ├── public/ # 静态资源
|
|
|
│ │ ├── package.json # NPM配置文件
|
|
|
│ │ └── dist/ # 构建输出目录
|
|
|
│ └── sql/ # 数据库脚本
|
|
|
│ └── pet_adopt_system.sql # 数据库初始化脚本
|
|
|
├── scaffold/ # 脚手架代码
|
|
|
├── notes/ # 项目文档和开发笔记
|
|
|
└── README.md # 项目说明文档
|
|
|
```
|
|
|
|
|
|
## 安装部署
|
|
|
|
|
|
### 1. 环境准备
|
|
|
确保已安装以下软件：
|
|
|
- JDK 1.8
|
|
|
- MySQL 5.7.43
|
|
|
- Maven 3.9.9
|
|
|
- Node.js 16.14.0
|
|
|
- IDE（IntelliJ IDEA和Visual Studio Code）
|
|
|
|
|
|
### 2. 数据库初始化
|
|
|
- 创建数据库：`pet_adopt_system`
|
|
|
- 导入数据库脚本：`source code/sql/pet_adopt_system.sql`
|
|
|
|
|
|
### 3. 后端配置
|
|
|
- 修改后端配置文件中的数据库连接信息
|
|
|
- 使用Maven构建项目：`mvn clean install`
|
|
|
- 运行Spring Boot应用
|
|
|
|
|
|
### 4. 前端配置
|
|
|
- 安装依赖：`npm install`
|
|
|
- 开发环境运行：`npm run dev`
|
|
|
- 生产环境构建：`npm run build`
|
|
|
|
|
|
## 系统特点
|
|
|
|
|
|
1. **前后端分离架构**：便于团队协作和系统维护
|
|
|
2. **智能推荐**：基于协同过滤算法推荐宠物和经验帖子
|
|
|
3. **完整的领养流程**：从申请到审核的全流程管理
|
|
|
4. **丰富的互动功能**：点赞、收藏、评论等社交元素
|
|
|
5. **完善的权限管理**：区分普通用户和管理员权限
|
|
|
6. **实时定位**：基于高德地图的实时定位
|
|
|
|
|
|
## 注意事项
|
|
|
|
|
|
- 数据库版本建议使用MySQL 5.7.43，避免版本兼容性问题
|
|
|
- Node.js版本建议使用20以下，以确保依赖包正常安装
|
|
|
- 高版本Maven需配合高版本IDEA使用
|
|
|
- 项目运行前请确保数据库服务已启动
|
|
|
|
|
|
## 许可证
|
|
|
|
|
|
本项目仅供学习使用。 |
