# animal-rescue

**Repository Path**: ydjjava/animal-rescue

## Basic Information

- **Project Name**: animal-rescue
- **Description**: 流浪动物救助
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-07
- **Last Updated**: 2026-03-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PawAid 流浪动物救助管理系统

## 项目简介

PawAid 是一个基于若依框架开发的流浪动物救助管理系统，旨在为流浪动物救助机构提供全方位的管理解决方案。系统包含后台管理、动物管理、救助记录、领养申请、物资捐赠等功能模块，帮助救助机构更高效地开展工作。

## 技术栈

### 后端技术
- Java
- Spring Boot
- MyBatis
- MySQL
- Redis

### 前端技术
- Vue 2.6
- Element UI
- Axios
- ECharts
- Vuex
- Vue Router

## 项目结构

```
PawAid/
├── .github/              # GitHub 相关配置
├── bin/                  # 脚本文件
├── doc/                  # 文档
├── pawaid-admin/         # 后台管理模块
├── pawaid-animal/        # 动物管理模块
├── pawaid-common/        # 通用模块
├── pawaid-framework/     # 框架模块
├── pawaid-generator/     # 代码生成器
├── pawaid-quartz/        # 定时任务模块
├── pawaid-system/        # 系统管理模块
├── pawaid-ui/            # 前端项目
├── .gitignore            # Git 忽略文件
├── LICENSE               # 许可证
└── enable_register.sql   # 启用注册功能的SQL脚本
```

### 核心模块说明

#### 后端模块
- **pawaid-admin**: 后台管理核心模块，包含登录、权限管理等功能
- **pawaid-animal**: 动物管理核心模块，包含流浪动物、救助记录、领养申请等功能
- **pawaid-common**: 通用工具类和常量定义
- **pawaid-framework**: 框架核心配置，包含安全、数据源等配置
- **pawaid-system**: 系统管理模块，包含用户、角色、菜单等功能

#### 前端模块
- **pawaid-ui/src/api**: API接口定义
- **pawaid-ui/src/views**: 页面视图
- **pawaid-ui/src/components**: 通用组件
- **pawaid-ui/src/assets**: 静态资源

## 快速开始

### 环境要求

- JDK 1.8+
- MySQL 5.7+
- Redis 3.0+
- Node.js 12.0+
- npm 6.0+

### 后端部署

1. **克隆项目**

```bash
git clone https://github.com/yourusername/PawAid.git
cd PawAid
```

2. **创建数据库**

- 新建数据库 `pawaid`
- 执行 `doc` 目录下的 SQL 脚本初始化数据库
- 执行 `enable_register.sql` 启用注册功能

3. **配置数据库连接**

修改 `pawaid-admin/src/main/resources/application.yml` 文件中的数据库连接信息：

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/pawaid?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
    username: root
    password: 123456
```

4. **启动后端服务**

- 运行 `pawaid-admin/src/main/java/com/pawaid/RuoYiApplication.java` 主类
- 或执行 `bin/run.bat` 脚本

### 前端部署

1. **安装依赖**

```bash
cd pawaid-ui
npm install
```

2. **启动开发服务器**

```bash
npm run dev
```

3. **构建生产版本**

```bash
npm run build:prod
```

## 功能模块

### 系统管理
- 用户管理：用户信息的增删改查
- 角色管理：角色权限的配置
- 菜单管理：系统菜单的配置
- 部门管理：组织机构的管理
- 字典管理：系统字典的配置
- 参数管理：系统参数的配置
- 通知公告：系统通知的管理

### 动物管理
- 流浪动物：动物信息的管理
- 救助记录：救助过程的记录
- 领养申请：领养流程的管理
- 物资捐赠：捐赠物资的管理
- 救助站管理：救助站信息的管理
- 志愿者任务：志愿者任务的管理

### 监控管理
- 在线用户：在线用户的监控
- 登录日志：用户登录记录
- 操作日志：用户操作记录
- 服务器监控：服务器状态监控

## 系统特点

1. **模块化设计**：采用模块化架构，便于扩展和维护
2. **权限管理**：基于角色的权限控制，确保系统安全
3. **响应式布局**：前端采用响应式设计，适配不同设备
4. **数据可视化**：使用 ECharts 实现数据图表展示
5. **流程化管理**：领养、捐赠等流程的规范化管理
6. **多语言支持**：内置国际化支持

## 登录注册

### 登录页面
- 支持账号密码登录
- 支持验证码验证
- 支持记住密码功能

### 注册页面
- 支持新用户注册
- 支持密码强度验证
- 支持验证码验证

## 如何贡献

1. Fork 本项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件


---

**PawAid - 用科技守护每一个生命** 🐾