【尚庭公寓 | day01】项目介绍+数据库设计

尚庭公寓 — day1

1. 项目简介

• 基于SSM+SpringBoot

• 用户端	广大用户	找房、看房预约、租约管理
  后台管理系统	管理员	公寓管理、租赁管理、用户管理

• 所需知识

  • Java基础
  • Java Web
  • SSM + Spring Boot
  • MySQL
  • Maven

1.1 移动端

• 房源检索

  用户可以使用这个功能来搜索和检索符合其需求的房源。他们可以根据不同的条件，如地理位置、租金范围、支付方式等，快速找到适合的房源。

• 看房预约管理

  用户可以通过这个功能预约看房。他们可以选择合适的时间，预约在特定的公寓进行实地看房，以便更好地了解房源的情况和环境。

• 租约管理

  这个功能允许用户查看和管理他们的租约信息。他们可以在移动端查看租约合同，以及提交租约终止或延长的请求。

• 房源浏览历史

  用户可以在这里查看他们曾经浏览过的房源历史记录。这个功能可以帮助用户追踪之前感兴趣的房源，方便他们重新查看或做出决策。

1.2 后台管理系统

• 公寓信息管理

  这个模块负责管理所有公寓的基本信息，包括公寓名称、地址、联系方式等。管理员可以在这里添加、编辑、删除公寓信息。

• 房间信息管理

  该模块负责管理每个公寓内各个房间的详细信息，包括房间号、户型、面积、租金等。管理员可以在这里进行房间信息的添加、编辑和删除。

• 公寓/房间属性管理

  这个模块允许管理员定义公寓和房间的各种属性，比如公寓和房间的配套设施，方便管理员在维护公寓信息和房间信息时进行选择。

• 看房预约管理

  该模块用于管理用户的看房预约请求。用户可以在移动端提交看房预约，管理员可以在后台管理系统中查看和处理这些请求，以方便安排人员接待用户。

• 租约管理

  这个模块用于管理租约的创建、修改和终止。管理员可以在这里生成租约合同，并发送给用户签约。

• 后台系统用户管理

  该模块用于管理后台系统的用户账户信息，管理员可以创建、编辑、删除、禁用账户信息。

• 移动端用户管理

  这个模块负责管理移动端用户的信息。管理员可以查看用户信息，处理账户相关问题。

1.3 核心业务流程

• 核心业务流程：签约、续约、退租

  

• 在上述的业务流程中，会涉及到租约状态的多次变化。租约共有7个状态，分别是签约待确认、已签约、已取消、已到期、退租待确认、已退租、续约待确认

  

1.4 项目技术

• 前端

  • 框架：VUE3

• 后端

  • 框架：Spring Boot

  • 数据库访问：MyBatis、MyBatis Plus

    MyBatis-Plus（简称 MP）是一个MyBatis的增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。

  • Web：Spring MVC

• 数据存储

  • 关系型数据库：MySQL

  • 缓存：Redis

  • 对象存储：MinIO

    对象存储是用于存储非结构化数据的数据存储架构，它将一个数据单元称为一个对象，每个对象都包含数据本身、元数据（描述数据的信息）和一个唯一标识符（通常是一个URL地址）。

    在2001年，亚马逊推出了Simple Storage Service（简称S3），这是第一个商业化的、面向互联网的对象存储服务。随后国内众多云服务厂商也都推出了自己的对象存储服务，例如阿里云的OSS，华为云的OBS，百度云的BOS等等。

    MinIO是一个开源的对象存储方案，兼容亚马逊S3协议。

    对于对象存储，我们可以选择直接购买各大云厂商提供的服务，也可以选择使用开源的服务，自行安装和维护。本项目采用开源的对象存储Minio来存储图片信息。

• 部署

  • 前端服务器：Nginx

2. 项目开发流程

第一步

由产品经理负责分析市场、用户需求，并将其转化为详细的产品需求。然后创建初步的产品原型，以便更好地理解和传达产品的设计和功能。

原型通常指的是产品、系统或概念的初步版本或样品，旨在展示设计概念、功能、外观或其他关键特征。

第二步

由UI设计师基于产品需求和初步原型，设计用户界面的外观和交互，得到高保真的原型。高保真原型可能包含更具体的设计元素，如颜色、字体、布局等。

第三步

由架构师根据高保真原型，规划软件系统的整体结构和组件。他们会设计数据库架构和定义接口，输出API文档，以便开发团队进行后续工作。

API文档是关于接口的详细说明文档，其会包含接口所提供的功能，所需参数、返回值、错误处理等细节。接口文档的目的是为开发人员、集成人员以及其他利益相关者提供清晰的指导，以便他们能够正确地使用和集成接口。

第四步

前后端开发工程师根据API文档，分别开发前端和后端的业务逻辑和功能。前端工程师负责构建用户交互界面，而后端工程师负责数据处理逻辑和数据存储。

第五步

测试工程师进行各种测试，以确保软件的质量和稳定性。

第六步

运维工程师负责配置、部署和维护应用程序的生产环境，确保应用程序能够正常运行并具备良好的性能和可用性。

3. 项目原型

常用的原型设计工具有墨刀，Figma等，这些工具设计出的原型美观且具备交互逻辑。本项目的原型：

移动端地址：点击访问

后台管理系统地址：点击访问

4. 数据库设计

4.1 数据库设计流程

4.1.1 概念模型设计

• 只关注实体和关系，不体现最终建表所需的各种细节信息（例如实体的属性）。

4.1.2 逻辑模型设计

• 相较于概念模型，逻辑模型会包含更多的细节信息，例如实体的属性、用于关联两个实体的字段等等。需要注意的是，逻辑模型并不关注具体的数据库实现（例如MySQL或者Oracle）。

4.1.3 物理模型设计

• 相较于逻辑模型，物理模型会包含更多的与所选数据库相关的具体信息，例如存储引擎、字段类型、索引等信息。一般而言，物理模型会包含最终建表所需的所有信息。

4.2 该项目数据库设计

4.2.1 概念模型设计

• 本项目包含的实体有公寓、房间、用户(租客)、租约(合同)、看房预约、浏览历史和后台管理系统用户

  

4.2.2 逻辑模型设计

• 公寓信息

• 房间信息

• 用户信息

• 看房预约信息

• 租约信息

• 浏览历史信息

• 后台管理用户信息

4.2.3 物理模型设计

• 本项目采用MySQL数据库，所有表均使用InnoDB存储引擎
• 注意：
  • 所有表均省略了create_time、update_time、is_deleted三个字段。
  • 所有的状态或类型字段（例如租约状态），均使用数字表示。