优化代码

1098226878@qq.com

2021-12-28 ce8e087fedd5e6949ab98b0859b824236f042841

 Readme.md

old mode 100644
new mode 100755
@@ -1,141 +1,104 @@
微小区平台
[english](Readme_en.md)
# HC小区管理系统是前后端完全开源并免费商用的小区物业管理系统，包含小区后端项目，小区前段项目，物业版uni-app和业主版uni-app,最新SQL文件加群获取 857791253、1038870655、770542020、274026637

开发工具：
### 作者微信 17797173942

java1.8 + idea/eclipse + mysql 
## 开源代码说明

技术架构：
### HC小区后端代码
 [https://gitee.com/wuxw7/MicroCommunity](https://gitee.com/wuxw7/MicroCommunity)
### HC小区前端代码
[https://gitee.com/java110/MicroCommunityWeb](https://gitee.com/java110/MicroCommunityWeb)
### HC智慧家庭（业主版）
[https://gitee.com/java110/WechatOwnerService](https://gitee.com/java110/WechatOwnerService)
### HC掌上物业（物业版uni-app）
[https://gitee.com/java110/PropertyApp](https://gitee.com/java110/PropertyApp)

Java + spring cloud + mybatis + mysql + activemq + redis
### HC社区商城（免费安装使用）
[http://bbs.homecommunity.cn/topic/84-shang-cheng-bu-shu-bao-xia-zai](http://bbs.homecommunity.cn/topic/84-shang-cheng-bu-shu-bao-xia-zai)

### 分支说明（branch）

分支管理说明，master 为主分支，0.8-stable 为最新稳定分支（推荐使用）


### 如何开始（how to start）

1.0 小区商家 1
美食
外卖
生鲜
超市
家政
其他
2.0 小区物业 2
小区公告
物业缴费（先不实现，只是用于通知作用，如电费，水费，气费）
房屋登记（先不实现）
停车位登记（先不实现）
意见保修
3.0 小区论坛 5
4.0 小区二手交易服务（后期实现）
5.0 小区拼车服务（附近小区显示5公里之内） 4
6.0 小区运动排名 6
[http://www.homecommunity.cn/](http://www.homecommunity.cn/)

目前提供服务：
### 如何安装（how to install）

1、上下班顺风车服务，用户发布服务，车主联系提供服务。
方案一、centos7.6一键式自动安装

2、超市，便利店，饭馆外卖，家政商家入驻，提供送货上门服务，主要优势为，商家可以不需要花昂贵的钱租店铺，只需在家提供服务，为小区内无工作者提供就业机会。
> yum install -y wget && wget http://cdn.homecommunity.cn/hcInstall.sh && sh hcInstall.sh 您的私网IP

3、为物业管理者提供免费的小区公告发布服务，方便及时查看公告，如 停电，停水 公告。
注意：您的私网IP为服务器内网ip 如果服务器只有一个私网ip时可以省略不填写，如果有多个时需要指定

4、免费意见报修服务，用户可以向客户反馈自己的意见，和需要维修的东西，以至于物业管理者及时处理
[参考视频](https://www.bilibili.com/video/BV1Dk4y19728/)

5、小区论坛，方便小区内交流（正在规划中，欢迎合作）。
方案二、根据需求自助部署

订单调度流程：
[参考视频](https://www.bilibili.com/video/BV1N7411E7rf/)

这里以wechat 服务 order 服务 user服务 为例说明
方案三、宝塔方式安装

![image](https://github.com/java110/MicroCommunity/blob/master/OrderService/orderDispatch.png)
[宝塔方式安装](http://bbs.homecommunity.cn/topic/80-linuxbao-ta-huan-jing-xia-kuai-su-bu-shu-mian-bian-yi-hui-yong-bao-ta-jiu-hui-yong-hc)

### 操作文档

1>、受理过程 调用方发起订单受理，订单服务根据订单中每个（busiOrder节点下的actionTypeCd）业务动作，将订单信息预处理后转发相应模块受理数据。
[操作文档](http://www.homecommunity.cn/operateDoc)

2>、撤单过程 通用方发起撤单，订单服务根据撤单的boId 从数据库中查询信息，分别调相应服务撤单处理。
### 技术文档

3>、事物补偿 如果以上有失败的情况下，作废当前订单信息，订单服务发起消息广播（activemq 消息广播方式），让各模块监听广播监听相应数据，恢复以前数据。
[技术文档](http://www.homecommunity.cn/devDoc)

重要说明：

订单调度 外围系统 如用户服务系统，商户服务系统，支付服务系统，必须要实现以下接口：

1、受理接口

2、作废订单接口

请求协议为：

{ 
    'data':
[
    
    {
        'olId':'123456',
        'newBoId': '123456',
        'boId': '222222',
        'actionTypeCd': 'C1'
    },
    {
    'olId':'123456',
        'newBoId': '123456',
        'boId': '222222',
        'actionTypeCd': 'C1'
    },
    {
    'olId':'123456',
        'newBoId': '123456',
        'boId': '222222',
        'actionTypeCd': 'C1'
    }
]
}
### 产品

   ![image](docs/img/hc.png)

3、补偿事物（目前是activemq）

请求报文 这里data下为所有要作废的订单boId 

{ 
    'data':
[
    
    {
        'boId': '222222',
        'actionTypeCd': 'C1'
    },
    {
        'boId': '222222',
        'actionTypeCd': 'M1'
    },
    {
        'boId': '222222',
        'actionTypeCd': 'C1'
    }
]
}
### 系统功能（function） 

统一返回报文模板为：
   ![image](docs/img/func.png)
   
   主要系统功能请查看
     
   [http://www.homecommunity.cn/devDoc/#/func/funcation](http://www.homecommunity.cn/devDoc/#/func/funcation)
  

{
### 演示地址（demo）

[http://www.homecommunity.cn/](http://www.homecommunity.cn/)

物业 账号/密码：wuxw/admin

运维团队 账号/密码：admin/admin

开发团队 账号/密码：dev/(由于开发者权限较大，删除数据会影响稳定性，查看具体功能，可以单独部署在u_user 表中修改)

### 运行效果（view）
1.在浏览器输入 http://localhost:3000/ 如下图

![image](docs/img/login.png)

    用户名为 wuxw 密码为 admin  如下图

    点击登录，进入如下图：

![image](docs/img/0004.png)

![image](docs/img/index.png)

![image](docs/img/owner.png)


 "RESULT_CODE": "0000",
 
 "RESULT_MSG": "成功",
 
 "RESULT_INFO":{}
}
### 加入我们（join）

RESULT_CODE 结果编码

0000 表示成功
加入微小区交流群随时了解项目进度，和java110开发者零距离沟通 qq群号 857791253、1038870655、770542020、274026637 邮箱：928255095@qq.com

1999 表示失败
![image](docs/img/qq.png)

RESULT_MSG 描述信息

RESULT_INFO 需要附带信息时，可以添加在这里

加入钉钉java110 工作群随时了解项目进度，和java110开发者零距离沟通

![image](https://github.com/java110/MicroCommunity/blob/test/dingding_java110.jpg)