# 基于Flask的房屋租赁系统

**Repository Path**: futureforge/Flask

## Basic Information

- **Project Name**: 基于Flask的房屋租赁系统
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-03
- **Last Updated**: 2025-05-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智能房屋租赁系统

基于Flask框架开发的现代化房屋租赁管理系统，提供完整的房源管理、用户认证、在线预约等功能。

## 功能特性

- **用户认证系统**
  - 用户注册和登录
  - JWT token认证
  - 密码加密存储

- **房源管理**
  - 房源信息发布
  - 房源图片上传
  - 房源搜索和筛选

- **预约系统**
  - 在线预约看房
  - 预约状态跟踪
  - 预约历史记录

- **支付功能**
  - 在线支付接口
  - 交易记录管理

## 技术栈

- **后端框架**：Flask 2.3.3
- **数据库**：MySQL (通过SQLAlchemy ORM)
- **用户认证**：Flask-Login, PyJWT
- **表单处理**：Flask-WTF, WTForms
- **数据库迁移**：Flask-Migrate
- **跨域支持**：Flask-CORS
- **图片处理**：Pillow
- **环境配置**：python-dotenv

## 项目结构

```
/Flask
├── app/                    # 应用主目录
│   ├── auth/              # 用户认证模块
│   ├── booking/           # 预约管理模块
│   ├── house/             # 房源管理模块
│   ├── payment/           # 支付功能模块
│   ├── models/            # 数据模型
│   ├── static/            # 静态资源
│   └── templates/         # HTML模板
├── config.py              # 配置文件
├── app.py                 # 应用入口
└── requirements.txt       # 项目依赖
```

## 环境要求

- Python 3.11+
- MySQL 8.0+

## 安装部署

1. 克隆项目到本地

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

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

4. 配置环境变量
创建 `.env` 文件并设置以下变量：
```
SECRET_KEY=your_secret_key
DATABASE_URL=mysql+mysqlconnector://username:password@localhost/dbname
```

5. 初始化数据库
```bash
flask db upgrade
```

## 运行项目

```bash
python app.py
```
访问 http://localhost:5000 即可使用系统

## 开发说明

- 所有API遵循RESTful设计规范
- 使用Blueprint模块化组织代码
- 统一的错误处理和响应格式
- 完整的用户认证和授权机制

## 贡献指南

1. Fork 项目
2. 创建功能分支
3. 提交变更
4. 发起 Pull Request

## 许可证

[MIT License](LICENSE)