# property

**Repository Path**: gitc_1_0/property

## Basic Information

- **Project Name**: property
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-26
- **Last Updated**: 2026-02-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智慧社区物业管理系统 (Smart Community Property Management System)

本项目旨在构建一套信息化、系统化的小区物业管理平台，解决传统物业管理中数据分散、流程不透明、效率低下等问题。系统服务于**物业管理员**、**业主**和**租客**三类用户，涵盖房产管理、财务收费、报修投诉、公告通知等核心业务。

## 1. 系统架构

本系统采用主流的 **B/S 架构** 与 **前后端分离** 的开发模式。

### 技术栈

**前端 (Frontend)**
- **框架**: Vue.js 3 (Composition API)
- **构建工具**: Vite 5
- **UI 组件库**: Element Plus
- **状态管理**: Pinia
- **路由管理**: Vue Router 4
- **HTTP 客户端**: Axios
- **样式**: SCSS

**后端 (Backend)**
- **框架**: Spring Boot 3.2.1
- **ORM**: MyBatis Plus 3.5.5
- **数据库**: MySQL 8.0
- **认证/授权**: JWT (JSON Web Tokens)
- **构建工具**: Maven
- **开发语言**: Java 17

## 2. 设计逻辑

系统设计遵循 **RBAC (Role-Based Access Control)** 权限控制模型，根据不同用户角色（管理员、业主、租客）动态展示菜单和功能。

### 核心设计理念
1.  **角色隔离**: 
    - **管理员**: 拥有全权控制，负责数据录入、审核、配置和调度。
    - **业主**: 关注自有资产（产权房）、账单支付和报修。
    - **租客**: 关注居住权益（租赁房）、日常缴费和报修。
2.  **数据关联**:
    - 通过 `OwnerRoom` 关联表灵活处理房屋与人的关系（所有权 vs 租赁权）。
    - 账单与房屋绑定，而非直接绑定到人，确保费用流转清晰。
3.  **流程闭环**:
    - **报修流程**: 提交 -> 待处理 -> 处理中 -> 已完成 -> 评价（预留）。
    - **缴费流程**: 账单生成 -> 待缴费 -> 支付模拟 -> 已缴费 -> 历史记录。

## 3. 功能模块

### 3.1 管理员端 (Web 管理后台)
*   **控制台 (Dashboard)**: 查看社区核心数据（住户数、楼栋数、营收、待处理报修）。
*   **用户管理**:
    *   **住户列表**: 管理业主和租客信息，重置密码。
    *   **注册审核**: 审核新注册用户的身份信息。
*   **房产管理**:
    *   **楼栋管理**: 维护小区楼栋信息。
    *   **房屋管理**: 批量生成房屋，管理房屋状态（入住/空置）。
*   **财务管理**:
    *   **收费标准**: 自定义物业费、停车费等收费项目和单价。
    *   **账单管理**: 批量生成账单，查看缴费状态。
*   **服务管理**:
    *   **报修管理**: 处理住户提交的报修申请，更新维修进度。
    *   **公告管理**: 发布社区通知和公告。
    *   **投诉建议**: 查看和回复住户的建议反馈。

### 3.2 业主/租客端 (用户前台)
*   **个人中心**: 
    *   修改个人资料、头像。
    *   修改登录密码。
*   **我的房产/住房**: 
    *   **业主**: 查看名下产权房屋详情。
    *   **租客**: 查看当前租赁房屋详情。
*   **物业缴费**: 
    *   查看未缴账单，支持在线模拟支付。
    *   查询历史缴费记录。
*   **在线报修**: 
    *   提交房屋报修申请（支持上传图片）。
    *   查看报修处理进度。
*   **社区公告**: 查看物业发布的最新通知。

## 4. 目录结构

```
PropertyManagementSys/
├── backend/                # 后端工程 (Spring Boot)
│   ├── src/main/java/com/property/
│   │   ├── common/         # 通用工具类 (Result, Constants)
│   │   ├── config/         # 配置类 (WebMvc, CORS)
│   │   ├── controller/     # 控制器层 (API 接口)
│   │   ├── entity/         # 实体类 (数据库映射)
│   │   ├── mapper/         # DAO 层 (MyBatis Mapper 接口)
│   │   ├── service/        # 业务逻辑层
│   │   └── PropertyApplication.java
│   └── src/main/resources/
│       ├── mapper/         # MyBatis XML 映射文件
│       └── application.yml # 全局配置文件
│
├── frontend/               # 前端工程 (Vue 3)
│   ├── src/
│   │   ├── api/            # API 接口封装
│   │   ├── assets/         # 静态资源 (图片, 图标)
│   │   ├── components/     # 公共组件
│   │   ├── router/         # 路由配置
│   │   ├── store/          # Pinia 状态管理
│   │   ├── styles/         # 全局样式
│   │   ├── utils/          # 工具函数 (Request, Format)
│   │   ├── views/          # 页面视图
│   │   └── App.vue         # 根组件
│   └── package.json        # 依赖配置
└── README.md               # 项目说明文档
```

## 5. 快速开始

### 后端启动
1.  确保已安装 JDK 17+ 和 MySQL 8.0+。
2.  创建数据库 `property_management` 并导入初始 SQL（如适用）。
3.  修改 `backend/src/main/resources/application.yml` 中的数据库连接信息。
4.  在 `backend` 目录下运行: `mvn spring-boot:run`。

### 前端启动
1.  确保已安装 Node.js 18+。
2.  进入 `frontend` 目录: `cd frontend`。
3.  安装依赖: `npm install`。
4.  启动开发服务器: `npm run dev`。
5.  访问: `http://localhost:5173`。

---