# communityhub

**Repository Path**: joinux/communityhub

## Basic Information

- **Project Name**: communityhub
- **Description**: 社区居民信息管理系统，包含了居民信息管理、房屋信息管理、车辆信息管理以及车辆、房屋和住户版绑定功能。适用于大学课程设计。
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-23
- **Last Updated**: 2026-03-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CommunityHub

社区管理平台，用于管理房屋、居民、车辆及关联关系。

## 项目简介

CommunityHub 是一个基于 Spring Boot 的社区管理平台，主要功能包括房屋管理、居民管理、车辆管理以及居民与房屋的绑定关系管理。适用于小区物业管理、社区服务等场景。

## 功能特性

- **房屋管理**：添加、编辑、删除、查询房屋信息。
- **居民管理**：添加、编辑、删除、查询居民信息。
- **车辆管理**：管理居民车辆信息。
- **关系绑定**：绑定居民与房屋的归属关系。

## 技术栈

- Spring Boot
- MyBatis Plus
- Thymeleaf（前端模板）
- MySQL

## 安装指南

1. **克隆仓库**：
   ```bash
   git clone https://gitee.com/joinux/communityhub.git
   cd communityhub
   ```

2. **导入数据库**：
   使用 `sql/community_dev.sql` 文件导入数据库结构。

3. **配置数据库连接**：
   修改 `src/main/resources/application.yaml` 文件中的数据库连接信息。

4. **运行项目**：
   ```bash
   mvn spring-boot:run
   ```

5. **访问系统**：
   打开浏览器，访问 http://localhost:8080

## 使用说明

- **房屋管理**：访问 `/house/list` 查看房屋列表。
- **居民管理**：访问 `/resident/list` 查看居民列表。
- **车辆管理**：访问 `/vehicle/list` 查看车辆列表。
- **绑定居民与房屋**：访问 `/residentHouse/bind` 进行绑定。

## 目录结构

```
src/
├── main/
│   ├── java/                      # Java 源代码
│   │   └── com/ccit/communityhub/ # 包结构
│   │       ├── controller/        # 控制器类
│   │       ├── entity/            # 实体类
│   │       ├── mapper/            # MyBatis Mapper 接口
│   │       ├── service/           # 业务接口及实现
│   │       └── config/            # 配置类
│   ├── resources/
│   │   ├── application.yaml       # 配置文件
│   │   └── templates/             # Thymeleaf 模板文件
│   └── test/                      # 测试代码
└── pom.xml                        # Maven 项目配置文件
```

## 参与贡献

欢迎提交 Pull Request 和提出新想法。请遵循项目的代码规范并确保测试通过。

## 许可证

本项目采用 MIT 许可证。详情请查看 [LICENSE](LICENSE) 文件。