Flask租房项目总结

---

该Flask项目历时3天，开发小组6人，目的是开发一个租房web项目，该项目采用前后端分离模式。

Flask租房项目总结

1. 分析需求文档，需要完成的功能模块有：

   • 登陆注册
   • 首页展示，首页搜索
   • 详情展示，订单预定
   • 个人中心的用户信息修改
   • 我的订单展示，客户订单展示
   • 我的房源，上传图片和实名认证

2. 该项目是前后端分离的项目，后端需要根据接口文档的要求，对数据库进行增加，修改，删除，查询的操作

3. 根据需求分析E-R图，为构建模型类做准备：
   

4. 模型类构建完毕，进行数据库迁移和测试数据的添加

5. 小组项目分工，将项目分为6个模块，每个模块相对独立，小组成员独立完成。每过半日，进行临时小组会议，汇报进度和遇到的问题。

6. 项目中犯的错误：

   • 没有严格按照接口文档的url路径写接口。比如接口路径：/api/v1.0/houses/，为了方便在Blueprint中添加了url_preifx=/api/v1.0/，导致前端静态文件路径出错，不得不修改前端路径，犯了大忌。当然也可以创建2个蓝图对象来解决问题，一个用来返回静态资源，一个用来做视图函数，以下采取这种方法。
   • 测试功能时，因为客户订单没有数据，误以为代码有bug，在客户订单接口上花费太长时间。
   • 项目分工不合适，组内成员代码水平差异大，导致工作压力不均衡。
   • 没有写任何单元测试。

7. 项目遇到的bug:

   • avtar_url网址返回给前端时没有加上七牛云地址
   • query抄写为quary
   • 时间单位直接相减
   • 返回数据格式不正确等

   8. 项目逻辑实现：

      1. 创建蓝图对象，为了返回静态资源和视图函数：

          # 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")
         

      2. 注册：

         • 获取前端发送的UUID
         • 借助captcha生成图片验证码，储存在redis中
         • 返回带有图片验证码的响应体对象
         • 前端点击发送短信验证码，获取前端发送的UUID，image_code，mobile
         • 检验数据，使用UUID取出验证码和image_code做对比
         • 借助云通讯发送短信，将短信内容sms_code存储在redis中
         • 前端点击注册按钮，获取前端发送的mobile，sms_code，password
         • 检验数据，对比sms_code和redis中存储短信内容
         • 初始化user模型对象，添加一条新的用户记录
         • 实现状态保持

      3. 登录/退出登录：

         • 获取mobile，password参数，检验参数
         • 查询对应的用户对象，实现状态保持
         • 退出登录即是清除session中存储的状态保持

      4. 我发布的房屋列表：

         • 获取登录的user_id
         • 查询用户所有的房屋对象，返回房屋信息

      5. 发布房源/上传房源图片

         • 获取前端发送的参数，并做参数校检

         • 在房屋-设施多对多关系表添加记录

           house.facilities.append(facility_list)
           

         • 保存house模型对象到数据库

         • 获取前端发送的图片，根据house_id判断房屋是否存在

         • 上传图片在七牛云储存

         • 房屋图片表存储图片相对地址，返回数据

      6. 首页展示内容：

         • 以订单量降序的方式查询房屋

           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]
           

      7. 搜索房屋列表

         • 获取前端参数：aid，start_time，end_time，sort_key，page

         • 参数检验，结束时间要大于开始时间

         • 查询对象和增加过滤条件

         house_query = House.query
         filters = []
         filters.append(House.area_id == area_id)
         

         4. 过滤已预定的房屋

         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))
         

         5. 根据筛选条件进行排序

         house_query = house_query.
         filter(*[filters]).order_by(House.order_count.desc())
         

         6. 进行分页展示，返回数据

         paginate = house_query.
         paginate(int(page),constants.HOUSE_LIST_PAGE_CAPACITY, False)
         houses = paginate.items
         total_page = paginate.pages
         

      8. 下单/预定房间

         • 获取参数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表，返回结果

      9. 获取订单列表

         • 获取当前角色标识，[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()
           

      10. 接单/拒单/评论订单(略)

      11. 用户中心（略）

      12. 项目注意点：

          • 大量的参数检验，不同功能模块，前端、后端内都要进行参数检验，保证参数准确性。
          • 通过将每一次查询后的结果储存在redis中可以提高用户下次查询相同结果的效率，能够提高用户体验。