# MicroCommunityWeb

**Repository Path**: guangdong-xingyao/MicroCommunityWeb

## Basic Information

- **Project Name**: MicroCommunityWeb
- **Description**: MicroCommunityWeb是完全开源免费的HC小区管理系统web端前端项目，主要采用比较主流的vue2+elementui框架开发的项目，主要包含功能为资产管理（楼栋 单元 房屋），业主管理，费用管理，投诉建议，维修派单，智慧门禁和智慧停车等,详细请访问官网 加群 770542020
- **Primary Language**: NodeJS
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: http://demo.homecommunity.cn
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1195
- **Created**: 2025-11-17
- **Last Updated**: 2025-11-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HC物业管理系统 - 开发文档

欢迎来到物业管理系统开发文档！这里包含了小白开发者快速上手所需的所有信息。

## 📚 文档目录

### 🚀 快速上手
- **[开发者快速上手指南](./开发者快速上手指南.md)** - 项目概述、技术栈、开发规范
- **[项目架构图](./项目架构图.md)** - 整体架构、目录结构、技术架构详解
- **[开发环境配置指南](./开发环境配置指南.md)** - 环境搭建、配置详解、常见问题解决

## 🎯 适合人群

- **前端新手** - 刚接触 Vue 的开发者
- **项目新人** - 刚加入团队需要了解项目的开发者
- **技术调研** - 需要了解项目技术架构的人员

## 🏗️ 项目简介

**物业管理系统** 是一个基于 Vue 2 的企业级 Web 应用，提供完整的物业管理功能：

- 🏠 **社区管理** - 小区、楼栋、房屋管理
- 👥 **业主管理** - 业主信息、家庭成员、车辆管理
- 💰 **费用管理** - 物业费、水电费、停车费管理
- 🔧 **工单管理** - 维修、投诉、巡检工单
- 📱 **设备管理** - 门禁、监控、充电桩管理
- 📊 **报表统计** - 各类数据统计和报表

## 🛠️ 技术栈

- **前端框架**: Vue 2.6.14
- **UI 组件库**: Element UI 2.15.6
- **路由管理**: Vue Router 3.5.1
- **HTTP 客户端**: Axios 0.21.1
- **国际化**: Vue I18n 8.26.7
- **图表库**: ECharts 5.6.0
- **构建工具**: Vue CLI 4.5.0

## 🚀 快速开始

### 1. 环境要求
- Node.js >= 12.0.0
- npm >= 6.0.0
- Vue CLI >= 4.5.0

### 2. 安装启动
```bash
# 克隆项目
git clone [项目地址]
cd MicroCommunityWeb

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

### 3. 访问应用
- 开发地址: http://localhost:3000
- 自动打开浏览器: 是

## 📖 学习路径

### 第一阶段：环境搭建
1. 阅读 [开发环境配置指南](./开发环境配置指南.md)
2. 安装必要的开发工具
3. 配置开发环境
4. 成功启动项目

### 第二阶段：项目了解
1. 阅读 [项目架构图](./项目架构图.md)
2. 了解项目目录结构
3. 理解技术架构
4. 熟悉开发规范

### 第三阶段：开始开发
1. 阅读 [开发者快速上手指南](./开发者快速上手指南.md)
2. 学习 Vue 2 基础语法
3. 熟悉 Element UI 组件
4. 开始编写代码

## 🔍 常见问题

### 新手常见问题
- **Q: 如何修改页面标题？**
  A: 参考 [开发者快速上手指南](./开发者快速上手指南.md) 中的页面标题设置部分

- **Q: 下拉框不显示内容怎么办？**
  A: 参考 [开发者快速上手指南](./开发者快速上手指南.md) 中的常见问题部分

- **Q: 如何添加新的页面？**
  A: 参考 [开发者快速上手指南](./开发者快速上手指南.md) 中的开发流程部分

### 环境配置问题
- **Q: npm install 失败怎么办？**
  A: 参考 [开发环境配置指南](./开发环境配置指南.md) 中的依赖安装问题部分

- **Q: 开发服务器启动失败？**
  A: 参考 [开发环境配置指南](./开发环境配置指南.md) 中的开发服务器问题部分

## 📞 获取帮助

### 文档资源
- 项目 README: [../README.md](../README.md)
- 安装说明: [../install.md](../install.md)
- 官方文档: [Vue 2 官方文档](https://v2.vuejs.org/)

### 团队支持
- 遇到问题先查看本文档
- 搜索现有 issue 避免重复
- 联系团队成员获取帮助

## 🎉 开始你的开发之旅

现在你已经了解了项目的基本情况，建议按照以下顺序阅读文档：

1. **[开发环境配置指南](./开发环境配置指南.md)** - 先搭建好开发环境
2. **[项目架构图](./项目架构图.md)** - 了解项目整体结构
3. **[开发者快速上手指南](./开发者快速上手指南.md)** - 学习开发规范和流程

**祝您开发愉快！** 🚀

---

*最后更新时间: 2024年*
*文档维护: 开发团队*