基于Python的房屋租赁管理系统（附源码）

完整项目源码下载链接在文章结尾处，大家自行下载即可~

一、项目背景

传统的线下租房不便、途径少、信息更新慢，导致房屋租赁效率低。为了有效的提升租赁效率和房源信息管理和提供更优质的租赁服务。f房东好租、用户满意。本系统用户分为租客、房东、管家、管理员四种角色。

租客：浏览房源、收藏房源、预定房源、发布租房需求、查看电子合同。
房东：发布房源、订单管理、查看电子合同。
管家：查看房源信息、回复咨询、线下带看房源。
管理员：用户管理、房源管理、订单管理、租房需求、实名认证、系统公告管理。

二、项目体验

项目体验地址 http://43.138.220.206/static/index.html 由于注册需要发送短信验证码，而手机验证码服务现在只能给我的测试手机号发送验证码，因此不能使用注册服务。大家可以使用已有账号去登录体验。

账号类别	用户名	密码	备注
用户账号	hui	123456	租客账号
用户账号	wang	123456	房东账号

三、项目启动

准备好MySQL 与 Redis数据库服务，修改相关数据库配置信息
申请第三方服务：七牛云的OSS服务、容联云的短信服务、阿里的支付服务、百度地图服务
依赖于 Python 3.7.9 编程环境
安装 requirements.txt 项目依赖 pip install -r requirements.txt
启动项目 python run.py
如果成功在本地启动项目，访问 http://127.0.0.1:8080/docs 地址查看接口文档

四、项目部署

确保Mysql、Redis服务正常
在存在Dockerfile文件的项目目录下构建镜像 docker build -t house_rental_image . （最后.不要忘记）
运行镜像产生容器 docker run -d --name house_rental_container -p 80:80 house_rental_image
docker ps 查看容器是否启动

五、系统整体功能图

六、项目结构

项目开发整体采用的是Python的FastAPI框架来搭建系统的接口服务，接口设计遵循 Restful API接口规范。接口前后端交互都采用json格式进行数据交互，项目整体的结构如下：

─house_rental
    ├─commons ------------------------- 项目公共模块
    │  ├─exceptions ------------------- 项目全局异常模块
    │  ├─libs ------------------------- 第三方服务模块
    │  ├─responses -------------------- 项目全局响应模块
    │  ├─settings --------------------- 项目配置
    │  └─utils ------------------------ 项目工具类
    ├─constants ----------------------- 项目常量模块
    ├─logic --------------------------- 项目逻辑模块
    ├─managers ------------------------ 项目数据库模型管理器模块
    ├─middlewares --------------------- 项目中间件模块
    ├─models -------------------------- 项目数据库模型模块
    ├─routers ------------------------- 项目路由模块
    │  ├─admin ------------------------ 后台管理路由
    │  │  ├─apis ---------------------- 后台管理路由接口
    │  │  ├─request_models ------------ 后台路由请求模型
    │  │  └─response_models ----------- 后台路由响应模型
    │  ├─common ----------- 公共路由模块
    │  │  ├─apis
    │  │  ├─request_models
    │  │  └─response_models
    │  ├─house ------------ 房源路由模块
    │  │  ├─apis
    │  │  ├─request_models
    │  │  └─response_models
    │  ├─order ------------ 订单路由模块
    │  │  ├─apis
    │  │  ├─request_models
    │  │  └─response_models
    │  ├─payment ---------- 支付路由模块
    │  │  ├─apis
    │  │  ├─request_models
    │  │  └─response_models
    │  ├─user ------------- 用户路由模块
    │  │  ├─apis
    │  │  ├─request_models
    │  │  ├─response_models
    └─__init__.py --------- 项目初始化文件
└─Dockerfile ----------------- 项目docker部署文件
└─requirements.txt ----------- 项目依赖库文件
└─README.md ------------------ 项目说明文档
└─run.py --------------------- 项目启动入口

七、项目Redis缓存设计

Redis key 规范：

project : module : business : unique key
 项目名 :  模块名 :  业务    : 唯一区别key 

例如：用户手机短信验证码缓存
house_rental:user:sms_code:13022331752

用户模块缓存

Key	类型	过期时间	说明
house_rental:user:sms_code:{mobile}	string	5分钟	存储用户手机短信验证码

| | | | |

房源模块缓存

Key	类型	过期时间	说明
house_rental {user_id}	set	不过期	存储用户收藏的房源id
house_rental:house:home_houses:{city}	string	15天	首页房源信息缓存，存储json
house_rental facilities	string	3个月	房源设施缓存，存储json
house_rental:house:detail:{house_id}	string	15天	房源详情缓存，存储json