该Flask项目历时3天，开发小组6人，目的是开发一个租房web项目，该项目采用前后端分离模式。
Flask租房项目总结
-
分析需求文档，需要完成的功能模块有：
-
登陆注册
-
首页展示，首页搜索
-
详情展示，订单预定
-
个人中心的用户信息修改
-
我的订单展示，客户订单展示
-
我的房源，上传图片和实名认证
-
-
该项目是前后端分离的项目，后端需要根据接口文档的要求，对数据库进行增加，修改，删除，查询的操作
-
根据需求分析E-R图，为构建模型类做准备：
-
模型类构建完毕，进行数据库迁移和测试数据的添加
-
小组项目分工，将项目分为6个模块，每个模块相对独立，小组成员独立完成。每过半日，进行临时小组会议，汇报进度和遇到的问题。
-
项目中犯的错误：
-
没有严格按照接口文档的url路径写接口。比如接口路径：/api/v1.0/houses/<int:house_id>，为了方便在Blueprint中添加了url_preifx=/api/v1.0/，导致前端静态文件路径出错，不得不修改前端路径，犯了大忌。当然也可以创建2个蓝图对象来解决问题，一个用来返回静态资源，一个用来做视图函数，以下采取这种方法。
-
测试功能时，因为客户订单没有数据，误以为代码有bug，在客户订单接口上花费太长时间。
-
项目分工不合适，组内成员代码水平差异大，导致工作压力不均衡。
-
没有写任何单元测试。
-
-
项目遇到的bug:
-
avtar_url网址返回给前端时没有加上七牛云地址
-
query抄写为quary
-
时间单位直接相减
-
返回数据格式不正确等
-
-
项目逻辑实现：
-
创建蓝图对象，为了返回静态资源和视图函数：
-
# 1. 创建蓝图
html_blu = Blueprint("html", __name__)
# 访问静态文件
@html_blu.route('/<path:file_name>')
def get_html_file(file_name):
# 判断是否是网站的Logo，如果不是，添加前缀
if file_name != "favicon.ico":
file_name = "html/" + file_name
return current_app.send_static_file(file_name) -
# 创建 /api/v1.0 接口的蓝图
api_blu = Blueprint("api", __name__, url_prefix="/api/v1.0")
-
-
注册：
-
获取前端发送的UUID
-
借助captcha生成图片验证码，储存在redis中
-
返回带有图片验证码的响应体对象
-
前端点击发送短信验证码，获取前端发送的UUID，image_code，mobile
-
检验数据，使用UUID取出验证码和image_code做对比
-
借助云通讯发送短信，将短信内容sms_code存储在redis中
-
前端点击注册按钮，获取前端发送的mobile，sms_code，password
-
检验数据，对比sms_code和redis中存储短信内容
-
初始化user模型对象，添加一条新的用户记录
-
实现状态保持
-
-
登录/退出登录：
-
获取mobile，password参数，检验参数
-
查询对应的用户对象，实现状态保持
-
退出登录即是清除session中存储的状态保持
-
-
我发布的房屋列表：
-
获取登录的user_id
-
查询用户所有的房屋对象，返回房屋信息
-
-
发布房源/上传房源图片
-
获取前端发送的参数，并做参数校检
-
在房屋-设施多对多关系表添加记录
house.facilities.append(facility_list) -
保存house模型对象到数据库
-
获取前端发送的图片，根据house_id判断房屋是否存在
-
上传图片在七牛云储存
-
房屋图片表存储图片相对地址，返回数据
-
-
首页展示内容：
-
以订单量降序的方式查询房屋
houses = House.query.order_by(House.order_count.desc()).limit(constants.HOME_PAGE_MAX_HOUSES).all()
houses_list = [house.to_basic_dict() for house in houses]
-
-
搜索房屋列表
-
获取前端参数：aid，start_time，end_time，sort_key，page
-
参数检验，结束时间要大于开始时间
-
查询对象和增加过滤条件
house_query = House.query
filters = []
filters.append(House.area_id == area_id) -
过滤已预定的房屋
conflict_order = Order.query.filter(Order.begin_date<=end_date, Order.end_date>=start_date).all()
conflict_house_id = [order.house_id for order in conflict_order]
filters.append(House.id.notin_(conflict_house_id)) -
根据筛选条件进行排序
house_query = house_query.
filter(*[filters]).order_by(House.order_count.desc()) -
进行分页展示，返回数据
paginate = house_query.
paginate(int(page),constants.HOUSE_LIST_PAGE_CAPACITY, False)
houses = paginate.items
total_page = paginate.pages
-
-
下单/预定房间
-
获取参数user_id，house_id，start_date，end_date，检验参数
-
查询房屋对象是否存在，判断用户是否是房东，判断房屋是否有冲突订单
filters = [Order.house_id == house_id,
Order.begin_date < end_date, Order.end_date > begin_date]
count = Order.query.filter(*filters).count() -
生成订单模型，存储在order表，返回结果
-
-
获取订单列表
-
获取当前角色标识，[custom，landlord]
-
房客订单查询
orders = Order.query.filter(Order.user_id
== user_id).order_by(Order.create_time.desc()).all() -
房东订单查询
houses = House.query.filter(House.user_id == user_id).all()
houses_id = [house.id for house in houses]
orders = Order.query.filter(Order.house_id in_(houses_id)).filter_by(Order.create_time.desc()).all()
-
-
接单/拒单/评论订单(略)
-
用户中心（略）
-
项目注意点：
-
大量的参数检验，不同功能模块，前端、后端内都要进行参数检验，保证参数准确性。
-
通过将每一次查询后的结果储存在redis中可以提高用户下次查询相同结果的效率，能够提高用户体验。
-
-
-
-