# 物业管理系统

**Repository Path**: vanboss/epm

## Basic Information

- **Project Name**: 物业管理系统
- **Description**: 社区e家物业管理系统是一个前后端分离的物业管理系统，依托若依(RuoYi)框架开发，包含微信小程序端和后台管理系统。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-03-02
- **Last Updated**: 2026-03-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 社区e家物业管理系统

## 项目简介

社区e家物业管理系统是一个前后端分离的物业管理系统，依托若依(RuoYi)框架开发，包含微信小程序端和后台管理系统。系统涵盖物业缴费、报事报修、邻里互动、社区通知等核心功能，打造便捷、高效的社区服务生态。

![输入图片说明](RuoYi-Vue-master/doc/5fbea2cd-3dac-4012-b855-3a403a2a9ce4.png)
![输入图片说明](RuoYi-Vue-master/doc/967aeaac-9f49-47bc-93ec-3f1b5d8088a8.png)
![输入图片说明](RuoYi-Vue-master/doc/bc20b6ac-d39b-4c5c-8416-45baf9822bac.png)
![输入图片说明](RuoYi-Vue-master/doc/c82d3cf9-63a3-4d81-bd9b-df9774600ef6.png)

![输入图片说明](RuoYi-Vue-master/doc/05c8d1c7-6711-4d75-972d-c709a75f95f2.png)
![输入图片说明](RuoYi-Vue-master/doc/6d746fc2-4682-4586-b67d-bae7691e9550.png)
![输入图片说明](RuoYi-Vue-master/doc/7a2b5fd6-aafd-4e28-aafd-e7508126bde3.png)
![输入图片说明](RuoYi-Vue-master/doc/41a86d6d-5abe-431f-b648-9ce69c5d22cb.png)
![输入图片说明](RuoYi-Vue-master/doc/38112709-2669-4292-b8de-d6265b0cb944.png)

## 项目结构

```
epm/
├── RuoYi-App-master/              # 移动端小程序(业主端)
├── RuoYi-Vue-master/              # 后台管理系统
│   ├── ruoyi-admin/               # Web层 — Controller入口
│   ├── ruoyi-epm/                 # 业务模块 — 物业管理核心代码
│   │   ├── domain/                #   实体类
│   │   ├── mapper/                #   数据访问层
│   │   ├── service/               #   业务逻辑层
│   │   └── resources/mapper/epm/  #   MyBatis XML映射
│   ├── ruoyi-system/              # 若依系统模块
│   ├── ruoyi-framework/           # 若依框架核心
│   ├── ruoyi-common/              # 公共模块
│   ├── ruoyi-quartz/              # 定时任务模块
│   ├── ruoyi-generator/           # 代码生成模块
│   ├── ruoyi-ui/                  # 后台前端Vue代码
│   └── sql/                       # 数据库脚本
├── prototype-html/                # 移动端纯HTML原型
├── prototype-admin/               # 后台纯HTML原型
├── 需求规格说明书.md               # 需求文档
└── README.md
```

## 技术栈

| 层级 | 技术栈 | 说明 |
|------|--------|------|
| 移动端 | UniApp + Vue | 微信小程序端 |
| 后台前端 | Vue2 + ElementUI | 管理后台界面 |
| 后台后端 | SpringBoot + MyBatis | 服务端API |
| 数据库 | MySQL 5.7+ | 数据存储 |
| 缓存 | Redis | 会话与数据缓存 |

## 功能模块

### 后台管理功能（已实现）

| 模块 | 菜单路径 | 功能说明 |
|------|----------|----------|
| 物业缴费 | 物业管理 → 物业缴费 | 账单管理、缴费记录、费用统计 |
| 预存管理 | 物业管理 → 预存管理 | 业主账户预存金额管理 |
| 报事报修 | 物业管理 → 报事报修 | 报修工单管理、状态跟踪、维修分类 |
| 邻里圈 | 社区互动 → 邻里圈 | 话题审核/删除/导出、评论管理、标签筛选（二手/邻里互助/个人活动） |
| 通知公告 | 社区互动 → 通知公告 | 通知新增/编辑/发布/下架、分类（活动消息/系统消息） |
| 系统管理 | 系统管理 | 用户/角色/菜单/部门/字典/参数/日志管理（若依内置） |

### 移动端功能（规划中）

- 首页：天气展示、快捷入口、活动推荐
- 服务：物业缴费、物业预存、报事报修、家政服务
- 邻里圈：话题浏览、话题发布、评论点赞
- 消息：系统消息、活动消息、通知列表
- 我的：个人信息、订单管理

## 数据库表结构

### 业务表

| 表名 | 说明 | 核心字段 |
|------|------|----------|
| `epm_payment` | 物业缴费 | 业主、房号、费用类型、金额、缴费状态 |
| `epm_deposit` | 预存管理 | 业主、预存金额、余额 |
| `epm_repair` | 报事报修 | 报修人、分类、描述、状态、费用 |
| `epm_topic` | 邻里话题 | 用户、内容、图片、标签、点赞/评论数、审核状态 |
| `epm_topic_comment` | 话题评论 | 话题ID、用户、评论内容 |
| `epm_topic_like` | 话题点赞 | 话题ID、用户ID（联合唯一） |
| `epm_notice` | 社区通知 | 标题、类型（活动/系统）、内容、发布状态 |

### 代码分层

```
Controller (ruoyi-admin)          → /epm/payment, /epm/repair, /epm/topic, /epm/notice
Service    (ruoyi-epm/service)    → 业务逻辑封装
Mapper     (ruoyi-epm/mapper)     → 数据访问接口
XML        (ruoyi-epm/resources)  → MyBatis SQL映射
Domain     (ruoyi-epm/domain)     → 实体类
Vue Page   (ruoyi-ui/views/epm)   → 前端页面
API        (ruoyi-ui/api/epm)     → 前端请求封装
```

## 开发环境配置

### 端口配置

| 服务 | 端口 | 说明 |
|------|------|------|
| 后端服务 | 8989 | SpringBoot API |
| 前端开发 | 80 | Vue 开发服务器 |

### 启动步骤

```bash
# 1. 导入数据库
mysql -u root -p < RuoYi-Vue-master/sql/ry_20251217.sql

# 2. 启动后端
cd RuoYi-Vue-master
mvn spring-boot:run -pl ruoyi-admin
# 或使用IDEA运行 RuoYiApplication.java

# 3. 启动前端
cd RuoYi-Vue-master/ruoyi-ui
npm install
npm run dev
```

### 关键配置文件

| 文件 | 用途 |
|------|------|
| `ruoyi-admin/src/main/resources/application.yml` | 服务端口、Redis 配置 |
| `ruoyi-admin/src/main/resources/application-druid.yml` | MySQL 数据库连接 |
| `ruoyi-ui/vue.config.js` | 前端代理 → `http://localhost:8989` |
| `ruoyi-ui/.env.development` | 前端 API 前缀 `/dev-api` |

## 注意事项

1. **端口冲突**：确保 8989 端口未被占用
2. **Redis 连接**：后端需要 Redis 服务，检查 `application.yml` 中的连接配置
3. **数据库初始化**：首次使用需执行 `sql/ry_20251217.sql` 导入完整数据库
4. **前端代理**：前端通过 `/dev-api` 代理到后端 `http://localhost:8989`

## 相关文档

- [需求规格说明书](./需求规格说明书.md) — 详细功能需求