# rent

**Repository Path**: Wreckloud/rent

## Basic Information

- **Project Name**: rent
- **Description**: 租房系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-11-08
- **Last Updated**: 2026-02-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 租房系统项目

## 项目简介

基于SpringBoot + Redis + 消息队列的租房系统，支持用户租房、房东发布房源、管理员审核等功能。

前后端分离架构，包含Web管理后台和微信小程序。

## 技术栈

### 后端
- **SpringBoot 2.7.x** - 基础框架
- **MyBatis-Plus** - ORM框架
- **MySQL 8.0** - 数据库
- **Redis 6.x** - 缓存、分布式锁
- **RabbitMQ** - 消息队列
- **JWT** - 认证授权
- **Swagger** - API文档

### 前端
- **Vue 2.x + Element UI** - Web管理后台
- **微信小程序** - 用户端

## 项目结构

```
rent-system/
├── backend/                  # 后端Maven多模块项目
│   ├── rent-common/         # 公共模块（配置、工具类）
│   ├── rent-user/           # 用户模块
│   ├── rent-house/          # 房源模块
│   ├── rent-appointment/    # 预约申请模块
│   ├── rent-message/        # 消息模块
│   └── rent-api/            # 启动模块
├── frontend/                # 前端项目
│   ├── web/                 # Vue管理后台
│   └── miniprogram/         # 微信小程序
├── database/                # 数据库脚本
│   ├── schema.sql          # 表结构
│   ├── init-data.sql       # 初始化数据
│   └── README.md
├── docs/                    # 项目文档
│   ├── 项目计划-租房系统.md
│   ├── 技术实现指南.md
│   ├── API接口文档.md
│   └── ...
└── README.md               # 本文件
```

## 快速开始

### 1. 环境准备

请确保已安装以下软件：

- JDK 1.8+
- Maven 3.6+
- MySQL 8.0+
- Redis 6.0+
- RabbitMQ 3.9+
- Node.js 14+ （前端开发）

### 2. 数据库初始化

```bash
# 创建数据库
mysql -u root -p
CREATE DATABASE house_rent CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

# 导入表结构
mysql -u root -p house_rent < database/schema.sql

# 导入初始化数据
mysql -u root -p house_rent < database/init-data.sql
```

### 3. 启动Redis和RabbitMQ

```bash
# 启动Redis
redis-server

# 启动RabbitMQ（Windows）
rabbitmq-server.bat
```

### 4. 后端启动

```bash
# 进入后端目录
cd backend

# 编译打包
mvn clean package

# 启动项目
cd rent-api
mvn spring-boot:run
```

访问地址：http://localhost:8888/rent

Swagger文档：http://localhost:8888/rent/swagger-ui/

### 5. 前端启动（需要先复制代码）

#### Web管理后台

```bash
cd frontend/web
npm install
npm run dev
```



## 任务

| 成员      | 负责模块         | 主要职责                             |
| --------- | ---------------- | ------------------------------------ |
| **成员1**    | rent-common      | 公共模块、配置类、工具类以及前端代码 |
| **成员2** | rent-user        | 用户管理、认证授权                   |
| **成员3** | rent-house       | 房源管理、Redis缓存优化              |
| **成员4** | rent-appointment | 预约申请、分布式锁                   |
| **成员5** | rent-message     | 消息通知、消息队列                   |
| **成员6** | rent-api + 服务器环境 | 启动模块、前端对接以及服务器环境配置|

## 核心功能

### 用户端
- 用户注册登录
- 房源浏览搜索
- 看房预约
- 租房申请
- 收藏房源
- 消息通知

### 房东端
- 发布房源
- 房源管理
- 预约处理
- 申请处理
- 数据统计

### 管理员
- 房源审核
- 用户管理
- 系统配置

## 技术亮点

1. **Redis缓存优化**
   - 热点房源详情缓存
   - 搜索关键词缓存
   - 浏览量统计

2. **消息队列异步处理**
   - 预约通知
   - 审核通知
   - 申请通知

3. **分布式锁**
   - Redisson防重复预约
   - 并发控制

4. **JWT认证**
   - 无状态认证
   - Token缓存

## 初始账号

- **管理员**：admin / 123456
- **房东**：landlord / 123456
- **租客**：user / 123456

## 开发规范

1. 代码提交前先pull最新代码
2. 提交信息遵循规范（feat/fix/docs等）
3. 遇到问题及时沟通

## License

本项目仅用于学习交流，请勿用于商业用途。