# h_m_s

**Repository Path**: jack202367/h_m_s

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-07
- **Last Updated**: 2025-09-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 栖居通 - 城镇保障性住房管理系统

## 项目简介

“栖居通”是一个综合性的**城镇保障性住房**管理系统，旨在为管理员和普通用户提供便捷、高效的房屋信息管理、申请审批、报修处理、缴费记录以及消息反馈等功能。本系统采用前后端分离的架构，后端基于 Spring Boot 3.x 框架，前端使用 Vue.js 2.x 和 Element UI 构建，致力于提供直观友好的用户界面和稳定的系统性能。

## 主要功能

### 管理员端

*   **数据总览**: 直观展示用户总数、房屋总数、空置房屋数、待处理申请、待处理维修请求、未回复留言等关键数据。通过 ECharts 提供房屋状态的饼图，并实时显示最新公告。
*   **用户管理**: 管理系统用户，包括用户信息查看、修改、删除等操作。
*   **房屋信息管理**: 对房屋的详细信息进行增删改查，包括房屋编号、类型、面积、租金、状态等。
*   **房屋类型管理**: 定义和管理不同类型的房屋，方便房屋的分类和筛选。
*   **申请管理**: 审核用户提交的房屋申请，支持批准、拒绝等操作。
*   **分配管理**: 为用户分配或解除房屋，管理房屋的分配状态。
*   **报修管理**: 接收、查看和处理用户的报修请求，跟踪维修进度。
*   **缴费记录管理**: 记录和管理用户的缴费情况，支持缴费类型、状态等筛选。
*   **公告通知管理**: 发布、修改和删除系统公告，向所有用户发布重要信息。
*   **消息反馈管理**: 查看和回复用户的留言与反馈。

### 普通用户端

*   **公告通知**: 查看系统发布的最新公告和通知，支持标题和内容搜索。
*   **我的房屋信息**: 查看自己已分配房屋的详细信息，包括房屋照片、基本信息等，并支持发起报修和查看缴费记录。
*   **申请管理**: 提交房屋申请，查看申请状态，并支持撤销（删除待审核）申请。
*   **报修管理**: 提交房屋维修请求，查看维修进度和历史记录。
*   **缴费记录**: 查看自己的缴费历史记录，支持按缴费类型和状态筛选，并支持新增缴费记录。
*   **消息/反馈**: 提交留言和反馈，查看管理员的回复，支持删除未回复的留言。
*   **个人信息管理**: 查看和修改个人基本信息（如用户名），身份证号码不可修改。

## 技术栈

### 开发环境

| 技术                       | 版本             |
| :------------------------- | :--------------- |
| Java Development Kit       | 17.0.16          |
| Apache Maven               | 3.6.1            |
| Node.js                    | 16.20.2          |
| npm (Node Package Manager) | 8.19.4           |
| Vue CLI                    | 5.0.9            |
| Git                        | 2.50.1.windows.1 |

### 后端

| 技术              | 版本   | 说明                                    |
| :---------------- | :----- | :-------------------------------------- |
| Java              | 17     | 与 JDK 版本一致                         |
| Spring Boot       | 3.1.5  | 用于构建 Web 应用程序和 RESTful API     |
| MyBatis-Plus      | 3.5.5  | 简化 MyBatis 使用，提供强大 CRUD 及分页 |
| MySQL Connector/J | 8.0.33 | MySQL 数据库 JDBC 驱动                  |
| Lombok            | (N/A)  | 通过注解简化 Java Bean 的编写           |

### 前端

| 技术       | 版本    | 说明                                     |
| :--------- | :------ | :--------------------------------------- |
| Vue.js     | 2.6.14  | 渐进式 JavaScript 框架，用于构建用户界面 |
| Vue Router | 3.5.4   | Vue.js 官方的路由管理器                  |
| Element UI | 2.15.14 | 基于 Vue 2.0 的桌面端组件库              |
| Axios      | 0.21.1  | 基于 Promise 的 HTTP 客户端              |
| ECharts    | 6.0.0   | 基于 JavaScript 的开源可视化库           |

## 参考文章

*   [vue安装、环境配置、脚手架安装以及项目的创建运行](https://www.cnblogs.com/idlelife/articles/18690701) - 提供了 Vue 环境搭建、脚手架安装及项目创建的详细指南。

## 快速启动

### 1. 克隆项目

```bash
git clone https://gitee.com/jack202367/h_m_s.git
cd house_manage_system
```

### 2. 后端设置

进入 `back` 目录：

```bash
cd back
```

* **配置数据库**: 修改 `src/main/resources/application.yml` 文件，配置您的 MySQL 数据库连接信息。

  ```yaml
  spring:
    datasource:
      url: jdbc:mysql://localhost:3306/house_manage_system?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai
      username: root
      password: your_password
      driver-class-name: com.mysql.cj.jdbc.Driver
  ```

* **运行 SQL 脚本**: 在您的 MySQL 数据库中执行项目根目录下的 `house_manage_system.sql` 文件，初始化数据库结构和基础数据。

* **构建并运行**:

  ```bash
  ./mvnw clean install
  ./mvnw spring-boot:run
  # 或者使用 IDE (如 IntelliJ IDEA) 运行 BackApplication.java
  ```

  后端服务默认运行在 `http://localhost:8081`。

### 3. 前端设置

进入 `house_front` 目录：

```bash
cd ../house_front
```

* **安装依赖**:

  ```bash
  npm install
  # 或者 yarn install
  ```

* **启动前端应用**:

  ```bash
  npm run serve
  # 或者 yarn serve
  ```

  前端应用默认运行在 `http://localhost:8080`。

现在，您可以在浏览器中访问 `http://localhost:8080` 来使用系统。

---

感谢您使用“栖居通”城镇保障性住房管理系统！如果您有任何问题或建议，欢迎提交 Issue。