# shangting-lease

**Repository Path**: phpmylove/shangting-lease

## Basic Information

- **Project Name**: shangting-lease
- **Description**: 尚庭公寓是一个公寓租赁平台项目，包含移动端和后台管理系统，其中移动端面向广大用户，提供找房、看房预约、租约管理等功能，后台管理系统面向管理员，提供公寓（房源）管理、租赁管理、用户管理等功能。
- **Primary Language**: Java
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-07-18
- **Last Updated**: 2025-07-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 添加/完善功能

## 1社区交流
![社区交流](images/社区交流.png)
## 2好友聊天

## 3个人中心
![个人中心](images/个人中心.png)
- 房屋缴费
- 物业报修
- 移动端确认租约bug

## 4管理端
![功能展示](images/功能展示.png)

# 1. 项目概述
尚庭公寓是一个公寓租赁平台项目，包含**移动端**和**后台管理系统**，其中移动端面向广大用户，提供找房、看房预约、租约管理等功能，后台管理系统面向管理员，提供公寓（房源）管理、租赁管理、用户管理等功能。下面分别介绍两端的具体业务功能。

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

- **看房预约管理**

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

- **租约管理**

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

- **房源浏览历史**

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

### 功能展示

![项目展示图](https://typora-1256823886.cos.ap-nanjing.myqcloud.com/2023/image-20240929105610012.png)

由于部署服务器过期，仅作图片展示

## 后台管理系统

### 功能模块

- **公寓信息管理**

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

- **房间信息管理**

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

- **公寓/房间属性管理**

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

- **看房预约管理**

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

- **租约管理**

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

- **后台系统用户管理**

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

- **移动端用户管理**

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

### 功能展示
由于部署服务器过期，仅作图片展示、

- 登陆界面
![登录界面](images/img.png)

- 系统管理
![系统管理](images/img_1.png)

- 公寓管理
![公寓管理](images/img_2.png)

- 租赁管理
![租赁管理](images/img_3.png)


# 您可能遇到的问题

## 功能问题

- 公寓图片和房间图片，无法正常显示

  原因：初始数据库中，apartment_info表、room_info表的图片均需关联到graph_info表，graph_info表的url字段保存的是minio的图片地址，非公网地址。
  
  解决：在后台管理系统web-admin中，按照业务流程添加公寓图片和房间图片即可。

- 新增或修改公寓信息时，无法正常更新公寓的所在地址
  
  原因：前端显示的是地址的省、市、区名称，而新增或修改公寓信息保存的是地址的省、市、区id，名称没有保存。
  
  解决：可以在前端增加保存地址名称的逻辑，也可以在后端根据地址id找到名称，更新vo对象后保存。

## 部署问题

- 部署到腾讯云主机始终无法正确访问服务

  检查云主机端口是否开放，需要开放对应端口，如80、81、8080、8081等；

  检查nginx服务是否正常启动，配置文件是否书写正确；

  检查后端服务是否正确启动，可以使用xxx/doc.html测试接口是否正常工作来确定；
  
  等等
  
- 加载页面非常慢
  
  检查mysql是否正常工作，可以使用本地客户端软件；