# 社区网格化管理系统

**Repository Path**: zhaoyw1/wangge

## Basic Information

- **Project Name**: 社区网格化管理系统
- **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-12-29
- **Last Updated**: 2026-01-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 社区网格管理系统

一个基于 Spring Boot + Vue 3 的现代化社区网格管理系统，提供用户管理、网格管理、设施管理、巡逻管理、事件管理、房屋管理、人员管理和通知管理等完整功能。

## 技术栈

### 后端
- **框架**: Spring Boot 3.1.10
- **ORM**: MyBatis Plus 3.5.9
- **数据库**: MySQL 8.0+
- **Java 版本**: JDK 17
- **构建工具**: Maven

### 前端
- **框架**: Vue 3.5.24
- **语言**: TypeScript
- **UI 组件库**: Element Plus 2.13.0
- **状态管理**: Pinia 3.0.4
- **路由**: Vue Router 4.6.4
- **HTTP 客户端**: Axios 1.13.2
- **图表库**: ECharts 6.0.0
- **构建工具**: Vite 7.2.4

## 项目结构

```
shequwangge/
├── src/                          # 后端源码
│   └── main/
│       ├── java/
│       │   └── com/iwei/shequwangge/
│       │       ├── config/       # 配置类
│       │       ├── controller/   # 控制器
│       │       ├── dto/          # 数据传输对象
│       │       ├── entity/       # 实体类
│       │       ├── mapper/       # Mapper 接口
│       │       ├── service/      # 服务层
│       │       └── utils/        # 工具类
│       └── resources/
│           ├── application.yml   # 应用配置
│           └── init.sql          # 数据库初始化脚本
├── frontend/                     # 前端源码
│   ├── src/
│   │   ├── api/                  # API 接口定义
│   │   ├── assets/               # 静态资源
│   │   ├── components/           # 公共组件
│   │   ├── router/               # 路由配置
│   │   ├── stores/               # Pinia 状态管理
│   │   ├── utils/                # 工具函数
│   │   └── views/                # 页面组件
│   ├── package.json
│   └── vite.config.ts
└── pom.xml                       # Maven 配置

```

## 功能模块

### 1. 用户管理
- 用户列表管理（增删改查）
- 用户角色管理（增删改查）
- 用户状态管理

### 2. 网格管理
- 网格基本信息管理
- 网格区域管理
- 房屋信息管理

### 3. 设施管理
- 设施基本信息管理
- 设施维护记录管理

### 4. 巡逻管理
- 巡逻任务管理
- 巡逻记录管理

### 5. 事件管理
- 事件基本信息管理
- 事件处理记录管理

### 6. 人员管理
- 人员基本信息管理
- 人员流动记录管理

### 7. 通知管理
- 通知发布管理
- 通知阅读记录管理

## 快速开始

### 环境要求

- JDK 17+
- Maven 3.6+
- Node.js 18+
- MySQL 8.0+
- npm 或 yarn

### 数据库配置

1. 创建数据库：
```sql
CREATE DATABASE IF NOT EXISTS pingan_grid CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

2. 执行初始化脚本：
```bash
mysql -u root -p pingan_grid < src/main/resources/init.sql
```

3. 配置数据库连接（修改 `src/main/resources/application.yml`）：
```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/pingan_grid?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai
    username: root
    password: 123456
```

### 后端启动

1. 进入项目根目录
2. 编译项目：
```bash
mvn clean install
```

3. 启动应用：
```bash
# Windows
start-backend.bat

# Linux/Mac
mvn spring-boot:run
```

或者直接运行主类：
```bash
mvn spring-boot:run
```

后端服务默认运行在：http://localhost:8080

### 前端启动

1. 进入前端目录：
```bash
cd frontend
```

2. 安装依赖：
```bash
npm install
```

3. 启动开发服务器：
```bash
npm run dev
```

前端服务默认运行在：http://localhost:5173

### 生产环境构建

**后端构建：**
```bash
mvn clean package
```

生成的 JAR 文件在 `target/shequwangge-0.0.1-SNAPSHOT.jar`

**前端构建：**
```bash
cd frontend
npm run build
```

构建产物在 `frontend/dist/` 目录

## API 接口

所有 API 接口统一前缀：`/api`

### 用户相关
- `POST /api/users/login` - 用户登录
- `GET /api/users` - 获取用户列表
- `GET /api/users/{id}` - 获取用户详情
- `POST /api/users` - 创建用户
- `PUT /api/users/{id}` - 更新用户
- `DELETE /api/users/{id}` - 删除用户
- `PUT /api/users/{id}/status` - 更新用户状态

### 其他模块 API
参考 `module_design.md` 文件了解各模块的 API 接口设计。

## 默认账户

系统初始化后，可以使用以下默认账户登录（具体账户信息请查看 `init.sql` 文件）：

- 管理员账户：admin/admin123（请根据实际 SQL 脚本中的账户信息登录）

## 开发规范

详细的开发规范请参考 [DEVELOPMENT.md](./DEVELOPMENT.md)

### 代码规范
- Java 代码遵循阿里巴巴 Java 开发手册
- Vue 代码遵循 Vue 官方风格指南
- 使用 ESLint 进行前端代码检查

### Git 提交规范
- feat: 新功能
- fix: 修复 bug
- docs: 文档更新
- style: 代码格式调整
- refactor: 代码重构
- test: 测试相关
- chore: 构建/工具相关

## 配置说明

详细的配置说明请参考 [ENV_CONFIG.md](./ENV_CONFIG.md)

## 常见问题

### 1. 数据库连接失败
- 检查 MySQL 服务是否启动
- 检查数据库连接配置是否正确（参考 `ENV_CONFIG.md`）
- 确认数据库已创建并执行初始化脚本

### 2. 前端无法连接后端
- 检查后端服务是否启动（默认端口 8080）
- 检查 `frontend/src/utils/axios.ts` 中的 `baseURL` 配置
- 检查 CORS 配置（后端已配置，如需要可调整）

### 3. 端口被占用
- 修改 `application.yml` 中的 `server.port`（后端）
- 修改 `vite.config.ts` 中的 `server.port`（前端）

更多问题请查看 [DEVELOPMENT.md](./DEVELOPMENT.md) 中的常见问题部分

## 许可证

本项目采用 MIT 许可证。

## 贡献指南

欢迎提交 Issue 和 Pull Request！

## 联系方式

如有问题，请提交 Issue 或联系项目维护者。