# rent-house

**Repository Path**: itsdf07/rent-house

## Basic Information

- **Project Name**: rent-house
- **Description**: 一个专注于房东房屋租赁管理的开源项目，（包含前后端源码，全部开源）提供房源发布、租客管理、合同处理等功能，旨在简化租房流程，提升房东与租客的体验。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2026-09-24
- **Last Updated**: 2026-09-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 家庭出租屋管理系统 (Rent House)
 本项目起初是为了解决自家租房管理的繁琐而写，如果你也有类似的困扰，欢迎一起完善。
一个基于 Spring Boot 3 + Vue 3 (Uni-app) 的家庭出租屋管理系统，旨在简化房东对房源、租客、合同及账单的管理流程。

## 💻 核心业务功能

### 1. 🏠 房源管理 (Room Management)
- **房间录入**: 支持批量及单个录入房间信息，包括面积、租金、楼层、房号等。
- **状态管理**: 实时展示房间状态（空置、已租、维修中），支持快速筛选。
- **配套设施**: 管理房间内的配套设施（如空调、热水器、床等）。

### 2. 👥 租客管理 (Tenant Management)
- **租客档案**: 记录租客基本信息（姓名、身份证、联系方式等）及紧急联系人。
- **实名登记**: 支持上传身份证照片，满足租房实名制要求。
- **历史记录**: 关联历史入住记录，方便查询过往租赁情况。

### 3. 📝 合同管理 (Contract Management)
- **电子签约**: 生成标准租赁合同，支持自定义合同条款和租期。
- **合同归档**: 自动关联房源与租客，支持合同到期提醒及续签功能。
- **退租流程**: 标准化退租结算流程，自动计算押金退还及水电扣款。

### 4. 💰 账单管理 (Financial Management)
- **自动算费**: 根据合同周期自动生成租金账单。
- **水电抄表**: 支持手动抄表录入，系统自动计算水电费差额。
- **收支明细**: 清晰记录每一笔收入（租金、押金）和支出，支持导出财务报表。
- **催缴提醒**: 对逾期未缴账单进行标记和提醒。

## 📸 系统预览 (System Preview)

> *此处后续补充系统运行截图*

### 首页概览
<img src="docs/1769667707088.png" width="400px" />
<img src="docs/1769667615988.png" width="400px" />

<img src="docs/1769667637900.png" width="400px" />
<img src="docs/1769667647848.png" width="400px" />

<img src="docs/1769667662103.png" width="400px" />
<img src="docs/1769667694669.png" width="400px" />
<img src="docs/1769667700367.png" width="400px" />


## 🛠 技术栈

### 后端 (Backend)
- **核心框架**: Spring Boot 3.2.1
- **ORM 框架**: MyBatis-Plus 3.5.5
- **数据库**: MySQL 8.0
- **工具库**: Hutool 5.8.25
- **安全/认证**: JWT (jjwt 0.12.3), Spring Security Crypto
- **API 文档**: Knife4j 4.4.0
- **构建工具**: Maven

### 前端 (Frontend)
- **框架**: Uni-app (Vue 3)
- **构建工具**: Vite 5.2.8
- **UI 组件**: uView-Plus
- **样式预处理**: Sass

## 📂 项目结构

```
rent_house/
├── backend/            # 后端项目源码 (Spring Boot)
│   ├── src/main/resources/
│   │   ├── application.yml  # 配置文件
│   │   └── mapper/          # MyBatis Mapper XML
├── frontend/           # 前端项目源码 (Uni-app)
├── docs/               # 项目文档 & SQL 脚本
│   ├── schema.sql           # 数据库初始化脚本
│   └── README.md            # 项目说明文档
```

## 🚀 快速开始

### 1. 环境准备
确保您的开发环境已安装以下软件：
- JDK 17+
- Maven 3.6+
- Node.js 18+ (推荐)
- MySQL 8.0

### 2. 数据库设置
1. 创建数据库 (例如 `rent_house_db`)。
2. 运行 `docs/schema.sql` 脚本初始化表结构。
3. 如果有数据迁移需求，可参考 `docs/multi_landlord_migration.sql`。

### 3. 后端启动
1. 进入 `backend` 目录。
2. 修改 `src/main/resources/application.yml` 中的数据库配置（`url`, `username`, `password`）。
3. 运行 Maven 命令下载依赖：`mvn clean install`。
4. 启动 Spring Boot 应用。
   - 默认端口: `8080`
   - API 文档地址: `http://localhost:8080/doc.html`

### 4. 前端启动
1. 进入 `frontend` 目录。
2. 安装依赖：
   ```bash
   npm install
   ```
3. 启动开发服务器（H5 模式）：
   ```bash
   npm run dev:h5
   ```
4. 微信小程序开发：
   ```bash
   npm run dev:mp-weixin
   ```

## 📄 许可证
[MIT License](LICENSE) (请根据实际情况添加 LICENSE 文件)