智慧社区管理系统

一个基于前后端分离架构的综合性智慧社区管理平台，为社区管理者提供高效的管理工具，为居民提供便捷的社区服务。

📋 项目简介

本项目采用现代化的技术栈，集成了用户管理、房屋管理、车辆管理、事件上报、社区公告等功能模块，并通过AI技术实现智能事件分类和身份认证，为智慧社区建设提供完整的解决方案。

🏗️ 技术架构

前端技术栈

• 框架: Vue 2.6.14
• 状态管理: Vuex 3.6.2
• 路由: Vue Router 3.5.1
• UI组件库: Element UI 2.15.14
• HTTP客户端: Axios 1.10.0
• 其他: XLSX (Excel处理)、Less (样式预处理)

后端技术栈

• 框架: Spring Boot 3.4.7
• 开发语言: Java 17
• ORM框架: MyBatis Plus 3.5.5
• 安全框架: Spring Security
• 数据库: MySQL (生产环境)、H2 (测试环境)
• API文档: SpringDoc OpenAPI 2.5.0
• 工具库:
  • Apache POI 5.2.4 (Excel文件处理)
  • Hutool 5.8.25 (Java工具类库)
  • Lombok (代码简化)

🎯 核心功能

用户管理

• 用户注册、登录、登出
• 实名认证（身份证OCR识别 + 身份信息验证）
• 用户信息管理
• 权限控制

房屋管理

• 房屋信息维护
• 房屋绑定管理
• 楼栋管理

车辆管理

• 车辆信息登记
• 车辆-房屋绑定
• 车辆审批流程
• 停车位管理

社区服务

• 事件上报: 居民可上报各类社区问题，支持上传图片和视频
• 智能分类: 基于AI语义分析自动分类事件（设施维修、环境卫生、安全隐患、噪音投诉、邻里纠纷、物业服务、停车问题等）
• 事件处理: 完整的事件处理流程，包括事件转派、处置反馈等

社区公告

• 新闻发布与管理
• 社区公告推送

AI智能化

• 身份证OCR识别: 自动提取身份证信息
• 身份验证: 对接阿里云API进行实名认证
• 事件智能分类: 使用AI语义模型自动分类事件

📦 项目结构

智慧社区系统/
├── front-main/              # 前端项目
│   ├── public/              # 静态资源
│   ├── src/
│   │   ├── api/            # API接口封装
│   │   ├── assets/         # 静态资源（图片、样式）
│   │   ├── components/     # 公共组件
│   │   ├── router/         # 路由配置
│   │   ├── store/          # Vuex状态管理
│   │   └── views/          # 页面组件
│   │       ├── adminViews/ # 管理员页面
│   │       ├── usersViews/ # 用户页面
│   │       ├── login/      # 登录页面
│   │       └── register/   # 注册页面
│   └── package.json
│
└── springboot_work-master/ # 后端项目
    ├── src/
    │   └── main/
    │       ├── java/com/cy/pms/
    │       │   ├── controller/    # 控制器层
    │       │   ├── service/       # 服务层
    │       │   ├── entity/        # 实体类
    │       │   ├── mapper/        # 数据访问层
    │       │   ├── dto/           # 数据传输对象
    │       │   ├── config/        # 配置类
    │       │   └── util/          # 工具类
    │       └── resources/
    │           ├── mapper/        # MyBatis映射文件
    │           ├── sql/           # SQL脚本
    │           └── application.properties  # 配置文件
    └── pom.xml

🚀 快速开始

前置要求

• Node.js 14+
• Java 17
• MySQL 8.0+
• Maven 3.6+

后端启动

1. 配置数据库

# 创建数据库
CREATE DATABASE pms CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

# 执行SQL脚本
mysql -u root -p pms < springboot_work-master/src/main/resources/schema.sql

2. 修改配置文件 编辑 springboot_work-master/src/main/resources/application.properties:

spring.datasource.url=jdbc:mysql://localhost:3306/pms?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai
spring.datasource.username=root
spring.datasource.password=你的密码

3. 启动后端服务

cd springboot_work-master
mvn clean install
mvn spring-boot:run

后端服务将在 http://localhost:8080 启动

前端启动

1. 安装依赖

cd front-main
npm install

2. 启动开发服务器

npm run serve

前端服务将在 http://localhost:8080 启动

3. 构建生产版本

npm run build

📝 API文档

详细的API文档请查看：springboot_work-master/API_DOCUMENTATION.md

主要API模块：

• 用户认证: /api/user/*
• 身份验证: /api/auth/*
• 事件管理: /api/incident-reports/*
• 房屋管理: /api/houses/*
• 车辆管理: /api/vehicles/*
• 新闻公告: /api/news/*

Swagger UI: http://localhost:8080/swagger-ui.html

🔧 配置说明

OCR配置（百度云）

ocr.api.url=https://aip.baidubce.com/rest/2.0/ocr/v1/idcard
ocr.api.key=your_api_key
ocr.api.secret=your_api_secret

身份验证配置（阿里云）

verification.api.url=https://sinocheck2.market.alicloudapi.com/getapilist/verify_id_name
verification.api.appcode=your_appcode

AI分类配置

ai.classification.enabled=true
ai.classification.api.url=https://api.siliconflow.cn/v1/chat/completions
ai.classification.api.key=your_api_key

🎨 主要页面

管理员端

• 管理员首页
• 居民管理
• 房屋管理
• 车辆管理
• 事件处理
• 事务处理
• 新闻发布

居民端

• 居民首页
• 实名认证
• 家庭成员管理
• 房屋管理
• 车辆管理
• 事件上报
• 事件审批

🔒 认证机制

• 基于Session的认证方式
• 支持角色权限管理（管理员、居民）
• 接口拦截保护

📄 许可证

本项目仅供学习和研究使用。

👥 作者

GUOCHUANG SOFTWARE

📞 联系方式

如有问题或建议，请通过Issue反馈。

---

注: 请妥善保管配置文件中的API密钥，生产环境部署时请修改默认密码和密钥配置。