# Animal room system

**Repository Path**: sirguo/animal-room-system

## Basic Information

- **Project Name**: Animal room system
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-05
- **Last Updated**: 2025-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### # 动物房管理系统

 持续更新中

一个基于 FastAPI 和 Vue3 的现代化动物房管理系统。

## 项目结构

```
special-equipment-system/
├── backend/                # FastAPI 后端
│   ├── app/
│   │   ├── api/           # API 路由
│   │   ├── core/          # 核心配置
│   │   ├── models/        # 数据库模型
│   │   ├── schemas/       # Pydantic 模型
│   │   └── utils/         # 工具函数
│   ├── logs/              # 日志文件
│   └── requirements.txt    # Python 依赖
├── frontend/              # Vue3 前端
│   ├── admin/            # 管理后台
│   └── user/             # 用户前台
└── README.md             # 项目说明
```

## 技术栈

### 后端
- FastAPI
- MySQL
- SQLAlchemy
- Pydantic
- Python 3.8+

### 前端
- Vue 3
- Vite
- Element Plus
- Pinia
- Vue Router

## 快速开始

### 后端启动
1. 进入后端目录
```bash
cd backend
```

2. 创建虚拟环境
```bash
python -m venv venv
source venv/bin/activate  # Linux/Mac
.\venv\Scripts\activate   # Windows
```

3. 安装依赖
```bash
pip install -r requirements.txt
```

4. 启动服务
```bash
uvicorn app.main:app --reload
```

### 前端启动
1. 进入前端目录
```bash
cd frontend/admin  # 或 frontend/user
```

2. 安装依赖
```bash
npm install
```

3. 启动开发服务器
```bash
npm run dev
```

## 数据库配置
- 数据库名：test1
- 用户名：test1
- 密码：test1

## 功能特性
- 首页看板
![输入图片说明](6d2391e224fcb3e8f205499137f8bed4.png)
- 数据大屏
![输入图片说明](81f6a70fd36a5064384803640114af51.png)
- 用户角色管理
- 房间管理
- 响应式设计
- 亮色/暗色主题
- 现代化UI界面
- RESTful API
- 完整的日志记录