An open API service indexing awesome lists of open source software.

https://github.com/zhuruili/easyhouse

A Flask based intelligent rental web application.
https://github.com/zhuruili/easyhouse

flask html-css-javascript python-web

Last synced: 24 days ago
JSON representation

A Flask based intelligent rental web application.

Awesome Lists containing this project

README

          

# Easy House

![Language](https://img.shields.io/badge/Language-Python-blue)
![flask](https://img.shields.io/badge/package-Flask-black)
![database](https://img.shields.io/badge/database-MySQL-green)
![license](https://img.shields.io/badge/License-MIT-red)

一个基于Flask的智能租房Web应用,这是我学习Flask的入门项目,或许也能帮你入门

A Flask based intelligent rental web application

---

## 效果展示

- **标题页**


标题页

- **搜索功能**


搜索功能

- **推荐房源**


推荐房源

- **详情页**


详情页


详情页


详情页

---

## 如何使用

### 环境搭建

你可以使用`pip`安装项目所需要的依赖:

```bash
pip install -r requirements.txt
```

### 数据准备

既然是“智能租房”项目,那么显然需要房源数据,而为了方便,本项目使用的示例数据来源于网络。数据内容可以查看`database`文件夹下的`house.sql`文件,其中包含建库语句与许多的插入语句

首先在`MySQL`建立一个新的数据库,然后导入`house.sql`脚本,注意在执行脚本之前修改脚本中第一行的数据库名称为你自己建立的数据库名称,我这里的名字叫`easyhouse`

当脚本中的内容全部执行完毕之后,查看数据表中的内容,如果数据无误则数据准备完成

### 隐私保护

在连接数据库的代码中你会看到其中的URI中包含了你的数据库的用户名和密码,这显然不应该直接写在代码里,因此这里我借助`dotenv`以加载环境变量的方式对其进行保护,你可以在项目的根目录下新建`.env`文件并在其中写入你自己的数据库账户信息:

```python
DB_USERNAME=YOUR_USERNAME
DB_PASSWORD=YOUR_PASSWORD
DB_DATABASE=YOUR_DATABASE
```

### 运行文件

运行根目录下的`app.py`文件,然后打开终端输出的网址`http://127.0.0.1:5000`即可看到项目的运行效果

---

## 参考资料

- 《Python Web开发项目教程(Flask版)》,黑马程序员,人民邮电出版社,2023/1

## BUG

>[!note]
>我根据书上的教程一步步走时发现`登陆`功能存在点击会让界面卡死的BUG,我并没有系统性的学过JS,暂时不知道是什么原因,如果你也遇到了相同的问题并且知道解决方案那么恳请赐教