README.md 22.8 KB
Newer Older
shuzheng5201314's avatar
shuzheng5201314 已提交
1
# zheng
shuzheng5201314's avatar
shuzheng5201314 已提交
2
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
shuzheng5201314's avatar
shuzheng5201314 已提交
3
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/shuzheng/zheng/pulls)
shuzheng5201314's avatar
shuzheng5201314 已提交
4
[![GitHub stars](https://img.shields.io/github/stars/shuzheng/zheng.svg?style=social&label=Stars)](https://github.com/shuzheng/zheng)
shuzheng5201314's avatar
update  
shuzheng5201314 已提交
5
[![GitHub forks](https://img.shields.io/github/forks/shuzheng/zheng.svg?style=social&label=Fork)](https://github.com/shuzheng/zheng)
shuzheng5201314's avatar
shuzheng5201314 已提交
6

shuzheng5201314's avatar
shuzheng5201314 已提交
7
交流QQ群:133107819🈵、284280411🈵、528049386🈵、305155242♨️(群内含各种工具和文档下载)
shuzheng5201314's avatar
update  
shuzheng5201314 已提交
8

shuzheng5201314's avatar
shuzheng5201314 已提交
9 10
## 前言

shuzheng5201314's avatar
shuzheng5201314 已提交
11
  `zheng`项目创建于2016年10月4日,正在慢慢成长中,目的不仅仅是一个开发架构,而是努力打造一套从 **前端模板** - **基础框架** - **分布式架构** - **开源项目** - **持续集成** - **自动化部署** - **系统监测** - **无缝升级** 的全方位J2EE企业级开发解决方案。
shuzheng5201314's avatar
shuzheng5201314 已提交
12

shuzheng5201314's avatar
shuzheng5201314 已提交
13
## 项目介绍
shuzheng5201314's avatar
shuzheng5201314 已提交
14

shuzheng5201314's avatar
shuzheng5201314 已提交
15
  基于Spring+SpringMVC+Mybatis分布式敏捷开发系统架构,提供整套公共微服务服务模块:内容管理、支付中心、用户管理(包括第三方)、微信平台、存储系统、配置中心、日志分析、任务和通知等,支持服务治理、监控和追踪,努力为中小型企业打造全方位J2EE企业级开发解决方案。
shuzheng5201314's avatar
shuzheng5201314 已提交
16 17 18

### 组织结构

shuzheng5201314's avatar
update  
shuzheng5201314 已提交
19
``` lua
shuzheng5201314's avatar
shuzheng5201314 已提交
20
zheng
shuzheng5201314's avatar
update  
shuzheng5201314 已提交
21
├── zheng-common -- SSM框架公共模块
22 23
├── zheng-admin -- 后台管理模板
├── zheng-ui -- 前台thymeleaf模板[端口:1000]
shuzheng5201314's avatar
shuzheng5201314 已提交
24
├── zheng-upms -- 用户权限管理系统
25
|    ├── zheng-upms-common -- upms系统公共模块
shuzheng5201314's avatar
shuzheng5201314 已提交
26
|    ├── zheng-upms-dao -- 代码生成模块,无需开发
shuzheng5201314's avatar
shuzheng5201314 已提交
27
|    ├── zheng-upms-client -- 集成upms依赖包,提供单点认证、授权、统一会话管理
shuzheng5201314's avatar
shuzheng5201314 已提交
28
|    ├── zheng-upms-rpc-api -- rpc接口包
29
|    ├── zheng-upms-rpc-service -- rpc服务提供者
shuzheng5201314's avatar
shuzheng5201314 已提交
30
|    └── zheng-upms-server -- 用户权限系统及SSO服务端[端口:1111]
shuzheng5201314's avatar
update  
shuzheng5201314 已提交
31
├── zheng-cms -- 内容管理系统
shuzheng5201314's avatar
shuzheng5201314 已提交
32
|    ├── zheng-cms-common -- cms系统公共模块
shuzheng5201314's avatar
shuzheng5201314 已提交
33
|    ├── zheng-cms-dao -- 代码生成模块,无需开发
shuzheng5201314's avatar
shuzheng5201314 已提交
34
|    ├── zheng-cms-rpc-api -- rpc接口包
35
|    ├── zheng-cms-rpc-service -- rpc服务提供者
shuzheng5201314's avatar
shuzheng5201314 已提交
36 37 38 39
|    ├── zheng-cms-search -- 搜索服务[端口:2221]
|    ├── zheng-cms-admin -- 后台管理[端口:2222]
|    ├── zheng-cms-job -- 消息队列、任务调度等[端口:2223]
|    └── zheng-cms-web -- 网站前台[端口:2224]
shuzheng5201314's avatar
update  
shuzheng5201314 已提交
40
├── zheng-pay -- 支付系统
shuzheng5201314's avatar
shuzheng5201314 已提交
41
|    ├── zheng-pay-common -- pay系统公共模块
shuzheng5201314's avatar
shuzheng5201314 已提交
42
|    ├── zheng-pay-dao -- 代码生成模块,无需开发
shuzheng5201314's avatar
shuzheng5201314 已提交
43 44
|    ├── zheng-pay-rpc-api -- rpc接口包
|    ├── zheng-pay-rpc-service -- rpc服务提供者
shuzheng5201314's avatar
update  
shuzheng5201314 已提交
45
|    ├── zheng-pay-sdk -- 开发工具包
shuzheng5201314's avatar
shuzheng5201314 已提交
46 47
|    ├── zheng-pay-admin -- 后台管理[端口:3331]
|    └── zheng-pay-web -- 演示示例[端口:3332]
shuzheng5201314's avatar
update  
shuzheng5201314 已提交
48
├── zheng-ucenter -- 用户系统(包括第三方登录)
shuzheng5201314's avatar
shuzheng5201314 已提交
49
|    ├── zheng-ucenter-dao -- 代码生成模块,无需开发
shuzheng5201314's avatar
update  
shuzheng5201314 已提交
50
|    ├── zheng-ucenter-service -- 业务逻辑
shuzheng5201314's avatar
shuzheng5201314 已提交
51
|    └── zheng-ucenter-home -- 网站前台[端口:4441]
shuzheng5201314's avatar
shuzheng5201314 已提交
52 53
├── zheng-wechat -- 微信系统
|    ├── zheng-wechat-mp -- 微信公众号管理系统
shuzheng5201314's avatar
shuzheng5201314 已提交
54
|    |    ├── zheng-wechat-mp-dao -- 代码生成模块,无需开发
shuzheng5201314's avatar
shuzheng5201314 已提交
55 56 57
|    |    ├── zheng-wechat-mp-service -- 业务逻辑
|    |    └── zheng-wechat-mp-admin -- 后台管理[端口:5551]
|    └── zheng-ucenter-app -- 微信小程序后台
shuzheng5201314's avatar
shuzheng5201314 已提交
58
├── zheng-api -- API接口总线系统
shuzheng5201314's avatar
shuzheng5201314 已提交
59 60 61 62
|    ├── zheng-api-common -- api系统公共模块
|    ├── zheng-api-rpc-api -- rpc接口包
|    ├── zheng-api-rpc-service -- rpc服务提供者
|    └── zheng-api-server -- api系统服务端[端口:6666]
shuzheng5201314's avatar
shuzheng5201314 已提交
63 64 65
├── zheng-oss -- 对象存储系统
|    ├── zheng-oss-sdk -- 开发工具包
|    └── zheng-oss-web -- 管理界面[端口:7771]
shuzheng5201314's avatar
shuzheng5201314 已提交
66 67 68 69
├── zheng-shop -- 电子商务系统
├── zheng-im -- 即时通讯系统
├── zheng-oa -- 办公自动化系统
├── zheng-eoms -- 运维系统
shuzheng5201314's avatar
shuzheng5201314 已提交
70
└── zheng-demo -- 示例模块(包含一些示例代码等)
shuzheng5201314's avatar
shuzheng5201314 已提交
71 72 73
     ├── zheng-demo-rpc-api -- rpc接口包
     ├── zheng-demo-rpc-service -- rpc服务提供者
     └── zheng-demo-web -- 演示示例[端口:8888]
shuzheng5201314's avatar
update  
shuzheng5201314 已提交
74
```
shuzheng5201314's avatar
shuzheng5201314 已提交
75

shuzheng5201314's avatar
shuzheng5201314 已提交
76
### 技术选型
shuzheng5201314's avatar
shuzheng5201314 已提交
77

shuzheng5201314's avatar
shuzheng5201314 已提交
78
#### 后端技术:
shuzheng5201314's avatar
shuzheng5201314 已提交
79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106
- Spring Framework [http://projects.spring.io/spring-framework/](http://projects.spring.io/spring-framework/)
- SpringMVC: MVC框架 [http://docs.spring.io/spring/docs/current/spring-framework-reference/htmlsingle/#mvc](http://docs.spring.io/spring/docs/current/spring-framework-reference/htmlsingle/#mvc)
- Spring secutity: 安全框架 [http://projects.spring.io/spring-security/](http://projects.spring.io/spring-security/)
- Apache Shiro: 安全框架 [http://shiro.apache.org/](http://shiro.apache.org/)
- Spring session: 分布式Session管理 [http://projects.spring.io/spring-session/](http://projects.spring.io/spring-session/)
- MyBatis: ORM框架 [http://www.mybatis.org/mybatis-3/zh/index.html](http://www.mybatis.org/mybatis-3/zh/index.html)
- MyBatis Generator: 代码生成 [http://www.mybatis.org/generator/index.html](http://www.mybatis.org/generator/index.html)
- Druid: 数据库连接池 [https://github.com/alibaba/druid](https://github.com/alibaba/druid)
- FluentValidator: 校验框架 [https://github.com/neoremind/fluent-validator](https://github.com/neoremind/fluent-validator)
- Jsp|Thymeleaf: 模板引擎 [http://www.thymeleaf.org/](http://www.thymeleaf.org/)
- Velocity [http://velocity.apache.org/](http://velocity.apache.org/)
- ZooKeeper: 分布式协调服务 [http://zookeeper.apache.org/](http://zookeeper.apache.org/)
- Dubbo: 分布式服务框架 [http://dubbo.io/](http://dubbo.io/)
- TBSchedule|elastic-job: 分布式调度框架 [https://github.com/dangdangdotcom/elastic-job](https://github.com/dangdangdotcom/elastic-job)
- Redis: 分布式缓存数据库 [https://redis.io/](https://redis.io/)
- Solr|Elasticsearch: 分布式全文搜索引擎 [http://lucene.apache.org/solr/](http://lucene.apache.org/solr/) [https://www.elastic.co/](https://www.elastic.co/)
- Quartz: 作业调度框架 [http://www.quartz-scheduler.org/](http://www.quartz-scheduler.org/)
- Ehcache: 进程内缓存框架 [http://www.ehcache.org/](http://www.ehcache.org/)
- ActiveMQ: 消息队列 [http://activemq.apache.org/](http://activemq.apache.org/)
- JStorm: 实时流式计算框架 [http://jstorm.io/](http://jstorm.io/)
- FastDFS: 分布式文件系统 [https://github.com/happyfish100/fastdfs](https://github.com/happyfish100/fastdfs)
- Log4J: 日志管理 [http://logging.apache.org/log4j/1.2/](http://logging.apache.org/log4j/1.2/)
- Swagger2: 接口测试框架 [http://swagger.io/](http://swagger.io/)
- sequence: 分布式高效ID生产 [http://git.oschina.net/yu120/sequence](http://git.oschina.net/yu120/sequence)
- AliOSS|Qiniu|QcloudCOS: 云存储 [https://www.aliyun.com/product/oss/](https://www.aliyun.com/product/oss/) [http://www.qiniu.com/](http://www.qiniu.com/) [https://www.qcloud.com/product/cos](https://www.qcloud.com/product/cos)
- Protobuf|json: 数据传输 [https://github.com/google/protobuf](https://github.com/google/protobuf)
- Jenkins: 持续集成工具 [https://jenkins.io/index.html](https://jenkins.io/index.html)
- Maven: 项目构建管理 [http://maven.apache.org/](http://maven.apache.org/)
shuzheng5201314's avatar
shuzheng5201314 已提交
107

shuzheng5201314's avatar
shuzheng5201314 已提交
108
#### 前端技术:
shuzheng5201314's avatar
shuzheng5201314 已提交
109 110 111 112 113 114 115 116 117 118 119
- jQuery: 代码库 [http://jquery.com/](http://jquery.com/)
- Bootstrap: 前端框架 [http://getbootstrap.com/](http://getbootstrap.com/)
- Bootstrap-table Bootstrap数据表格 [http://bootstrap-table.wenzhixin.net.cn/](http://bootstrap-table.wenzhixin.net.cn/)
- Font-awesome: 字体图标 [http://fontawesome.io/](http://fontawesome.io/)
- Waves: 点击效果插件 [https://github.com/fians/Waves](https://github.com/fians/Waves)
- zTree: 树插件 [http://www.treejs.cn/v3/](http://www.treejs.cn/v3/)
- Select2: 选择框插件 [https://github.com/select2/select2](https://github.com/select2/select2)
- jquery-confirm: 对话框 [https://github.com/craftpip/jquery-confirm](https://github.com/craftpip/jquery-confirm)
- jQuery EasyUI: 基于jQuery的UI插件集合体 [http://www.jeasyui.com](http://www.jeasyui.com)
- React: 界面构建框架 [https://github.com/facebook/react])(https://github.com/facebook/react)
- Editor.md [Markdown编辑器](https://github.com/pandao/editor.md)
shuzheng5201314's avatar
shuzheng5201314 已提交
120 121 122 123
- zhengAdmin [基于bootstrap实现的响应式Material Design风格的通用后台管理系统](https://github.com/shuzheng/zhengAdmin "zhengAdmin")
- autoMail [邮箱地址自动补全插件](https://github.com/shuzheng/autoMail "autoMail")
- zheng.jprogress.js [一款模仿youtube加载进度条插件](https://github.com/shuzheng/zheng.jprogress.js "zheng.jprogress.js")
- zheng.jtotop.js [返回顶部插件(可以任意速度滑动到指定任意位置)](https://github.com/shuzheng/zheng.jtotop.js "zheng.jtotop.js")
shuzheng5201314's avatar
shuzheng5201314 已提交
124

shuzheng5201314's avatar
shuzheng5201314 已提交
125 126 127 128
#### 架构图

![架构图](project-bootstrap/architect.png)

shuzheng5201314's avatar
shuzheng5201314 已提交
129 130 131 132
#### 模块依赖

![模块依赖](project-bootstrap/project.png)

shuzheng5201314's avatar
shuzheng5201314 已提交
133 134
#### 模块介绍

shuzheng5201314's avatar
shuzheng5201314 已提交
135
> zheng-common
shuzheng5201314's avatar
shuzheng5201314 已提交
136

shuzheng5201314's avatar
shuzheng5201314 已提交
137
Spring+SpringMVC+Mybatis框架集成公共模块,包括公共配置、MybatisGenerator扩展插件、通用BaseService、工具类等。
shuzheng5201314's avatar
shuzheng5201314 已提交
138

139
> zheng-admin
shuzheng5201314's avatar
shuzheng5201314 已提交
140

141
基于bootstrap实现的响应式Material Design风格的通用后台管理系统,`zheng`项目所有后台系统都是使用该模块界面作为前端展示。
shuzheng5201314's avatar
shuzheng5201314 已提交
142

shuzheng5201314's avatar
shuzheng5201314 已提交
143 144 145 146
> zheng-ui

各个子系统前台thymeleaf模板,前端资源模块,使用nginx代理,实现动静分离。

shuzheng5201314's avatar
shuzheng5201314 已提交
147
> zheng-upms
shuzheng5201314's avatar
shuzheng5201314 已提交
148 149 150

本系统是基于RBAC授权和基于用户授权的细粒度权限控制通用平台,并提供单点登录、会话管理和日志管理。接入的系统可自由定义组织、角色、权限、资源等。

shuzheng5201314's avatar
shuzheng5201314 已提交
151
> zheng-oss
shuzheng5201314's avatar
shuzheng5201314 已提交
152

shuzheng5201314's avatar
shuzheng5201314 已提交
153
文件存储系统,提供四种方案:
shuzheng5201314's avatar
shuzheng5201314 已提交
154

shuzheng5201314's avatar
shuzheng5201314 已提交
155 156 157 158
- **阿里云** OSS
- **腾讯云** COS
- **七牛云**
- 本地分布式存储
shuzheng5201314's avatar
update  
shuzheng5201314 已提交
159

shuzheng5201314's avatar
shuzheng5201314 已提交
160
> zheng-api
shuzheng5201314's avatar
shuzheng5201314 已提交
161

shuzheng5201314's avatar
shuzheng5201314 已提交
162
接口总线系统,对外暴露统一规范的接口,包括各个子系统的交互接口、对外开放接口、开发加密接口、接口文档等服务,示例图:
shuzheng5201314's avatar
shuzheng5201314 已提交
163 164 165

![API网关](project-bootstrap/zheng-api.png)

shuzheng5201314's avatar
shuzheng5201314 已提交
166

shuzheng5201314's avatar
shuzheng5201314 已提交
167
> zheng-cms
shuzheng5201314's avatar
shuzheng5201314 已提交
168

shuzheng5201314's avatar
shuzheng5201314 已提交
169
内容管理系统:支持多标签、多类目、强大评论的内容管理,有基本单页展示,菜单管理,系统设置等功能。
shuzheng5201314's avatar
shuzheng5201314 已提交
170

shuzheng5201314's avatar
shuzheng5201314 已提交
171
> zheng-pay
shuzheng5201314's avatar
shuzheng5201314 已提交
172

shuzheng5201314's avatar
shuzheng5201314 已提交
173
- 一站式支付解决方案,统一下单接口,支持支付宝、微信、网银等多种支付方式。不涉及业务的纯粹的支付平台。
shuzheng5201314's avatar
shuzheng5201314 已提交
174

shuzheng5201314's avatar
shuzheng5201314 已提交
175
- 统一下单(统一下单接口、统一扫码)、订单管理、数据分析、财务报表、商户管理、渠道管理、对账系统、系统监控。
shuzheng5201314's avatar
update  
shuzheng5201314 已提交
176

shuzheng5201314's avatar
shuzheng5201314 已提交
177
> zheng-ucenter
shuzheng5201314's avatar
shuzheng5201314 已提交
178

shuzheng5201314's avatar
shuzheng5201314 已提交
179
通用用户管理系统, 实现最常用的用户注册、登录、资料管理、个人中心、第三方登录等基本需求,支持扩展二次开发。
shuzheng5201314's avatar
shuzheng5201314 已提交
180

shuzheng5201314's avatar
shuzheng5201314 已提交
181
> zheng-wechat-mp
shuzheng5201314's avatar
shuzheng5201314 已提交
182

shuzheng5201314's avatar
shuzheng5201314 已提交
183
微信公众号管理平台,除实现官网后台自动回复、菜单管理、素材管理、用户管理、消息群发等基础功能外,还有二维码推广、营销活动、微网站、会员卡、优惠券等。
shuzheng5201314's avatar
shuzheng5201314 已提交
184

shuzheng5201314's avatar
shuzheng5201314 已提交
185 186
> zheng-ucenter-app 

shuzheng5201314's avatar
shuzheng5201314 已提交
187
微信小程序后台
shuzheng5201314's avatar
shuzheng5201314 已提交
188 189 190

> zheng-shop

shuzheng5201314's avatar
shuzheng5201314 已提交
191
电子商务系统
shuzheng5201314's avatar
shuzheng5201314 已提交
192 193 194

> zheng-im

shuzheng5201314's avatar
shuzheng5201314 已提交
195
即时通讯系统
shuzheng5201314's avatar
shuzheng5201314 已提交
196 197 198

> zheng-oa

shuzheng5201314's avatar
shuzheng5201314 已提交
199
办公自动化系统
shuzheng5201314's avatar
shuzheng5201314 已提交
200 201 202

> zheng-eoms

shuzheng5201314's avatar
shuzheng5201314 已提交
203
运维系统
shuzheng5201314's avatar
shuzheng5201314 已提交
204

shuzheng5201314's avatar
shuzheng5201314 已提交
205 206 207
## 环境搭建

#### 开发工具:
shuzheng5201314's avatar
shuzheng5201314 已提交
208 209 210 211 212 213 214 215 216
- MySql: 数据库
- jetty: 开发服务器
- Tomcat: 应用服务器
- SVN|Git: 版本管理
- Nginx: 反向代理服务器
- Varnish: HTTP加速器
- IntelliJ IDEA: 开发IDE
- PowerDesigner: 建模工具
- Navicat for MySQL: 数据库客户端
shuzheng5201314's avatar
shuzheng5201314 已提交
217

shuzheng5201314's avatar
shuzheng5201314 已提交
218 219 220 221 222 223 224
#### 开发环境:
- Jdk7
- Mysql5.5
- Redis
- Zookeeper
- ActiveMQ
- Dubbo-admin
shuzheng5201314's avatar
shuzheng5201314 已提交
225

shuzheng5201314's avatar
shuzheng5201314 已提交
226
### 工具安装
227

228
[环境搭建和系统部署文档(作者:小兵)](http://git.oschina.net/shuzheng/zheng/attach_files "环境搭建和系统部署文档(作者:小兵)")
shuzheng5201314's avatar
shuzheng5201314 已提交
229

shuzheng5201314's avatar
shuzheng5201314 已提交
230
### 资源下载
shuzheng5201314's avatar
shuzheng5201314 已提交
231

shuzheng5201314's avatar
shuzheng5201314 已提交
232
- JDK7 [http://www.oracle.com/technetwork/java/javase/downloads/java-archive-downloads-javase7-521261.html](http://www.oracle.com/technetwork/java/javase/downloads/java-archive-downloads-javase7-521261.html "JDK7")
shuzheng5201314's avatar
shuzheng5201314 已提交
233 234 235 236 237 238
- Maven [http://maven.apache.org/download.cgi](http://maven.apache.org/download.cgi "Maven")
- Redis [https://redis.io/download](https://redis.io/download "Redis")
- ActiveMQ [http://activemq.apache.org/download-archives.html](http://activemq.apache.org/download-archives.html "ActiveMQ")
- ZooKeeper [http://www.apache.org/dyn/closer.cgi/zookeeper/](http://www.apache.org/dyn/closer.cgi/zookeeper/ "ZooKeeper")
- Dubbo [http://dubbo.io/Download-zh.htm](http://dubbo.io/Download-zh.htm "Dubbo")
- Elastic Stack [https://www.elastic.co/downloads](https://www.elastic.co/downloads "Elastic Stack")
shuzheng5201314's avatar
shuzheng5201314 已提交
239
- Nginx [http://nginx.org/en/download.html](http://nginx.org/en/download.html "Nginx")
shuzheng5201314's avatar
shuzheng5201314 已提交
240 241 242
- Jenkins [http://updates.jenkins-ci.org/download/war/](http://updates.jenkins-ci.org/download/war/ "Jenkins")
- dubbo-admin-2.5.3 [http://download.csdn.net/detail/shuzheng5201314/9733652](http://download.csdn.net/detail/shuzheng5201314/9733652 "dubbo-admin-2.5.3")
- dubbo-admin-2.5.4-SNAPSHOT-jdk8 [http://download.csdn.net/detail/shuzheng5201314/9733657](http://download.csdn.net/detail/shuzheng5201314/9733657 "dubbo-admin-2.5.4-SNAPSHOT-jdk8")
shuzheng5201314's avatar
shuzheng5201314 已提交
243
- 更多资源请加QQ群
shuzheng5201314's avatar
shuzheng5201314 已提交
244

shuzheng5201314's avatar
shuzheng5201314 已提交
245 246
## 开发指南:

shuzheng5201314's avatar
shuzheng5201314 已提交
247
- 1、本机安装Jdk7、Mysql、Redis、Zookeeper、ActiveMQ并**启动相关服务**,使用默认配置默认端口即可
shuzheng5201314's avatar
shuzheng5201314 已提交
248
- 2、克隆源代码到本地并打开,**推荐使用IntelliJ IDEA**,本地编译并安装到本地maven仓库
shuzheng5201314's avatar
shuzheng5201314 已提交
249

shuzheng5201314's avatar
shuzheng5201314 已提交
250
### 修改本地Host
shuzheng5201314's avatar
shuzheng5201314 已提交
251

shuzheng5201314's avatar
shuzheng5201314 已提交
252
- 127.0.0.1	ui.zhangshuzheng.cn
shuzheng5201314's avatar
shuzheng5201314 已提交
253 254 255 256 257 258 259
- 127.0.0.1	upms.zhangshuzheng.cn
- 127.0.0.1	cms.zhangshuzheng.cn
- 127.0.0.1	pay.zhangshuzheng.cn
- 127.0.0.1	ucenter.zhangshuzheng.cn
- 127.0.0.1	wechat.zhangshuzheng.cn
- 127.0.0.1	api.zhangshuzheng.cn
- 127.0.0.1	oss.zhangshuzheng.cn
shuzheng5201314's avatar
shuzheng5201314 已提交
260

shuzheng5201314's avatar
shuzheng5201314 已提交
261 262
### 编译流程

263
zheng-admin、zheng-common => zheng-upms => 其他
shuzheng5201314's avatar
shuzheng5201314 已提交
264

shuzheng5201314's avatar
shuzheng5201314 已提交
265
### 启动顺序(后台)
shuzheng5201314's avatar
shuzheng5201314 已提交
266
```
shuzheng5201314's avatar
shuzheng5201314 已提交
267
- 新建zheng数据库,导入project-bootstrap文件夹下的zheng-xxx.sql(使用最新版)
shuzheng5201314's avatar
shuzheng5201314 已提交
268

shuzheng5201314's avatar
shuzheng5201314 已提交
269
- 修改各dao模块和rpc-service模块的redis.properties、jdbc.properties、generator.properties数据库连接等配置信息,其中master.redis.password、master.jdbc.password、slave.jdbc.password、generator.jdbc.password密码值使用了AES加密,请使用com.zheng.common.util.AESUtil工具类修改这些值
270

shuzheng5201314's avatar
shuzheng5201314 已提交
271
- 首先启动 zheng-upms-rpc-service(直接运行src目录下的ZhengUpmsRpcServiceApplication#main方法启动) => zheng-upms-server(jetty),然后按需启动对应子系统xxx的zheng-xxx-rpc-service(main方法) => zheng-xxx-webapp(jetty)
shuzheng5201314's avatar
shuzheng5201314 已提交
272 273 274
```
![rpc-service启动演示](project-bootstrap/start_rpc.png) ![web启动演示](project-bootstrap/start_web.png)
```
shuzheng5201314's avatar
shuzheng5201314 已提交
275
- 访问 [统一后台地址 http://upms.zhangshuzheng.cn:1111/],子系统菜单已经配置到zheng-upms权限中,不用直接访问子系统,默认帐号密码:admin/123456
shuzheng5201314's avatar
shuzheng5201314 已提交
276

shuzheng5201314's avatar
shuzheng5201314 已提交
277
- 登录成功后,可在右上角切换已注册系统访问
shuzheng5201314's avatar
shuzheng5201314 已提交
278
```
shuzheng5201314's avatar
shuzheng5201314 已提交
279

shuzheng5201314's avatar
shuzheng5201314 已提交
280 281
### 启动顺序(前台)

shuzheng5201314's avatar
shuzheng5201314 已提交
282
```
shuzheng5201314's avatar
shuzheng5201314 已提交
283 284 285
- 启动nginx代理zheng-ui静态资源,配置文件可参考 [nginx.conf](http://git.oschina.net/shuzheng/zheng/attach_files)

- 启动前台系统应用服务器
shuzheng5201314's avatar
shuzheng5201314 已提交
286
```
shuzheng5201314's avatar
shuzheng5201314 已提交
287

shuzheng5201314's avatar
shuzheng5201314 已提交
288 289
### 开发演示

shuzheng5201314's avatar
shuzheng5201314 已提交
290
```
shuzheng5201314's avatar
shuzheng5201314 已提交
291 292 293 294 295
- 创建数据表(建议使用PowerDesigner)

- 直接运行对应项目dao模块中的generator.main(),可自动生成单表的CRUD功能和对应的model、example、mapper、service代码

    - 生成的model和example均已实现Serializable接口,支持分布式
shuzheng5201314's avatar
shuzheng5201314 已提交
296
    
shuzheng5201314's avatar
shuzheng5201314 已提交
297
    - 生成的mapper.xml的selectByExample方法自动包含分页参数offset和limit
shuzheng5201314's avatar
shuzheng5201314 已提交
298

shuzheng5201314's avatar
shuzheng5201314 已提交
299
    - 已包含抽象类BaseServiceImpl,只需要继承抽象类并传入泛型参数,即可默认实现mapper接口所有方法,特殊需求直接扩展即可
shuzheng5201314's avatar
shuzheng5201314 已提交
300

shuzheng5201314's avatar
shuzheng5201314 已提交
301
    - BaseServiceImpl方法根据读写操作自动切换主从数据源,继承的扩展接口,可手动通过`DynamicDataSource.setDataSource(DataSourceEnum.XXX.getName())`指定数据源
shuzheng5201314's avatar
shuzheng5201314 已提交
302 303 304 305

- 启动流程:优先rcp-service服务提供者,再启动其他webapp

- 扩展流程:可扩展和拆分rpc-api和rpc-service模块,可按微服务拆分或场景拆分
shuzheng5201314's avatar
shuzheng5201314 已提交
306
```
shuzheng5201314's avatar
shuzheng5201314 已提交
307

shuzheng5201314's avatar
shuzheng5201314 已提交
308 309
### 框架规范约定

shuzheng5201314's avatar
shuzheng5201314 已提交
310
约定优于配置(convention over configuration),此框架约定了很多编程规范,下面一一列举:
shuzheng5201314's avatar
shuzheng5201314 已提交
311

shuzheng5201314's avatar
shuzheng5201314 已提交
312 313
```

shuzheng5201314's avatar
shuzheng5201314 已提交
314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345
- service类,需要在叫名`service`的包下,并以`Service`结尾,如`CmsArticleServiceImpl`

- controller类,需要在以`controller`结尾的包下,类名以Controller结尾,如`CmsArticleController.java`,并继承`BaseController`

- spring task类,需要在叫名`task`的包下,并以`Task`结尾,如`TestTask.java`

- mapper.xml,需要在名叫`mapper`的包下,并以`Mapper.xml`结尾,如`CmsArticleMapper.xml`

- mapper接口,需要在名叫`mapper`的包下,并以`Mapper`结尾,如`CmsArticleMapper.java`

- model实体类,需要在名叫`model`的包下,命名规则为数据表转驼峰规则,如`CmsArticle.java`

- spring配置文件,命名规则为`applicationContext-*.xml`

- 类名:首字母大写驼峰规则;方法名:首字母小写驼峰规则;常量:全大写;变量:首字母小写驼峰规则,尽量非缩写

- springmvc配置加到对应模块的`springMVC-servlet.xml`文件里

- 配置文件放到`src/main/resources`目录下

- 静态资源文件放到`src/main/webapp/resources`目录下

- jsp文件,需要在`/WEB-INF/jsp`目录下

- `RequestMapping`和返回物理试图路径的url尽量写全路径,如:`@RequestMapping("/manage")`、`return "/manage/index"`

- `RequestMapping`指定method

- 模块命名为`项目`-`子项目`-`业务`,如`zheng-cms-admin`

- 数据表命名为:`子系统`_`表`,如`cms_article`

shuzheng5201314's avatar
update  
shuzheng5201314 已提交
346
- 更多规范,参考[[阿里巴巴Java开发手册](http://git.oschina.net/shuzheng/zheng/attach_files "Alibaba Java Development Manual.pdf")]
347

shuzheng5201314's avatar
shuzheng5201314 已提交
348
```
shuzheng5201314's avatar
shuzheng5201314 已提交
349

shuzheng5201314's avatar
shuzheng5201314 已提交
350 351
## 演示地址

shuzheng5201314's avatar
shuzheng5201314 已提交
352
演示地址: [http://www.zhangshuzheng.cn/zhengAdmin](http://www.zhangshuzheng.cn/zhengAdmin "演示地址")
shuzheng5201314's avatar
shuzheng5201314 已提交
353 354

### 预览图
shuzheng5201314's avatar
shuzheng5201314 已提交
355
![idea](project-bootstrap/idea.png)
shuzheng5201314's avatar
shuzheng5201314 已提交
356 357
![login](project-bootstrap/zheng-login.png)
![upms](project-bootstrap/zheng-upms.png)
shuzheng5201314's avatar
update  
shuzheng5201314 已提交
358
![cms](project-bootstrap/zheng-cms.png)
shuzheng5201314's avatar
shuzheng5201314 已提交
359
![swagger](project-bootstrap/api.png)
shuzheng5201314's avatar
shuzheng5201314 已提交
360

shuzheng5201314's avatar
shuzheng5201314 已提交
361
### 数据模型
shuzheng5201314's avatar
shuzheng5201314 已提交
362
![数据库模型](project-datamodel/zheng.png)
shuzheng5201314's avatar
shuzheng5201314 已提交
363 364

### 拓扑图
shuzheng5201314's avatar
shuzheng5201314 已提交
365
![拓扑图](project-bootstrap/distributedSystem.png)
shuzheng5201314's avatar
shuzheng5201314 已提交
366

shuzheng5201314's avatar
shuzheng5201314 已提交
367 368 369
### 开发进度
![开发进度](project-bootstrap/progress.png)

shuzheng5201314's avatar
shuzheng5201314 已提交
370 371 372 373
### 参与开发

首先谢谢大家支持,如果你希望参与开发,欢迎通过[Github](https://github.com/shuzheng/zheng "Github")上fork本项目,并Pull Request您的commit。

shuzheng5201314's avatar
shuzheng5201314 已提交
374 375 376 377 378 379
### 常见问题

- Eclipse下,dubbo找不到dubbo.xsd报错,不影响使用,如果要解决,可参考 [http://blog.csdn.net/gjldwz/article/details/50555922](http://blog.csdn.net/gjldwz/article/details/50555922)

- 报zheng-xxx.jar包找不到,请按照文档编译顺序,将源代码编译并安装到本地maven仓库

shuzheng5201314's avatar
shuzheng5201314 已提交
380 381 382 383 384 385
- zheng-cms-admin启动卡住:因为没有启动activemq

- zheng-upms-server访问报session不存在:因为没有启动redis服务

- 界面没有样式:因为zheng-admin没有编译安装到本地仓库

shuzheng5201314's avatar
shuzheng5201314 已提交
386 387 388 389 390 391
## 附件

### 优秀文章和博客

- [创业互联网公司如何搭建自己的技术框架](http://shuzheng5201314.iteye.com/blog/2330151 "创业互联网公司如何搭建自己的技术框架")

shuzheng5201314's avatar
shuzheng5201314 已提交
392 393
- [微服务实战](https://segmentfault.com/a/1190000004634172 "微服务实战")

shuzheng5201314's avatar
shuzheng5201314 已提交
394 395 396 397 398 399
- [单点登录原理与简单实现](http://shuzheng5201314.iteye.com/blog/2343910 "单点登录原理与简单实现")

- [ITeye论坛关于权限控制的讨论](http://www.iteye.com/magazines/82 "ITeye论坛关于权限控制的讨论")

- [RBAC新解:基于资源的权限管理(Resource-Based Access Control)](http://globeeip.iteye.com/blog/1236167 "RBAC新解:基于资源的权限管理(Resource-Based Access Control)")

shuzheng5201314's avatar
shuzheng5201314 已提交
400 401
- [网站架构经验随笔](http://jinnianshilongnian.iteye.com/blog/2289904 "网站架构经验随笔")

shuzheng5201314's avatar
shuzheng5201314 已提交
402 403
- [支付系统架构](http://shuzheng5201314.iteye.com/blog/2355431 "支付系统架构")

shuzheng5201314's avatar
shuzheng5201314 已提交
404 405
- [Spring整合JMS](http://elim.iteye.com/blog/1893038 "Spring整合JMS")

shuzheng5201314's avatar
shuzheng5201314 已提交
406 407
- [跟我学Shiro目录贴](http://jinnianshilongnian.iteye.com/blog/2018398 "跟我学Shiro目录贴")

shuzheng5201314's avatar
shuzheng5201314 已提交
408 409 410 411 412 413
- [跟我学SpringMVC目录汇总贴](http://jinnianshilongnian.iteye.com/blog/1752171 "跟我学SpringMVC目录汇总贴")

- [跟我学spring3 目录贴](http://jinnianshilongnian.iteye.com/blog/1482071 "跟我学spring3 目录贴")

- [跟我学OpenResty(Nginx+Lua)开发目录贴](http://jinnianshilongnian.iteye.com/blog/2190344 "跟我学OpenResty(Nginx+Lua)开发目录贴")

shuzheng5201314's avatar
shuzheng5201314 已提交
414 415 416 417
- [Redis中文网](http://www.redis.net.cn/ "Redis中文网")

- [读懂Redis并配置主从集群及高可用部署](http://mp.weixin.qq.com/s?__biz=MzIxNTYzOTQ0Ng==&mid=2247483668&idx=1&sn=cd31574877d38cf7ff9c047b86c9bf23&chksm=979475eda0e3fcfb6b5006bcd19c5a838eca9e369252847dbdf97820bf418201dd75c1dadda3&mpshare=1&scene=23&srcid=0117KUiiITwi2ETRan16xRVg#rd "读懂Redis并配置主从集群及高可用部署")

shuzheng5201314's avatar
shuzheng5201314 已提交
418 419
- [Redis哨兵-实现Redis高可用](http://redis.majunwei.com/topics/sentinel.html "Redis哨兵-实现Redis高可用")

shuzheng5201314's avatar
shuzheng5201314 已提交
420 421
- [ELK(ElasticSearch, Logstash, Kibana)搭建实时日志分析平台](http://www.open-open.com/lib/view/open1451801542042.html "ELK(ElasticSearch, Logstash, Kibana)搭建实时日志分析平台")

shuzheng5201314's avatar
shuzheng5201314 已提交
422 423 424 425 426 427 428 429
- [Nginx基本功能极速入门](http://xxgblog.com/2015/05/17/nginx-start/ "Nginx基本功能极速入门")

- [mybatis-genarator 自定义插件](https://my.oschina.net/alexgaoyh/blog/702791 "mybatis-genarator 自定义插件")

- [Elasticsearch权威指南(中文版)](https://es.xiaoleilu.com/510_Deployment/20_hardware.html "Elasticsearch权威指南(中文版)")

- [springMVC对简单对象、Set、List、Map的数据绑定和常见问题.](http://blog.csdn.net/z_dendy/article/details/12648641 "springMVC对简单对象、Set、List、Map的数据绑定和常见问题.")

shuzheng5201314's avatar
shuzheng5201314 已提交
430 431
- [如何细粒度地控制你的MyBatis二级缓存](http://blog.csdn.net/luanlouis/article/details/41800511 "如何细粒度地控制你的MyBatis二级缓存")

shuzheng5201314's avatar
shuzheng5201314 已提交
432 433 434
- [做个男人,做个成熟的男人,做个有城府的男人](http://shuzheng5201314.iteye.com/blog/1387820 "做个男人,做个成熟的男人,做个有城府的男人")


shuzheng5201314's avatar
shuzheng5201314 已提交
435
### 在线小工具
shuzheng5201314's avatar
shuzheng5201314 已提交
436 437 438 439

- [在线Cron表达式生成器](http://cron.qqe2.com/ "在线Cron表达式生成器")

- [在线工具 - 程序员的工具箱](http://tool.lu/ "在线工具 - 程序员的工具箱")
shuzheng5201314's avatar
update  
shuzheng5201314 已提交
440

shuzheng5201314's avatar
shuzheng5201314 已提交
441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458
### 在线文档

- [JDK7英文文档](http://tool.oschina.net/apidocs/apidoc?api=jdk_7u4 "JDK7英文文档")

- [Spring4.x文档](http://spring.oschina.mopaas.com/ "Spring4.x文档")

- [Mybatis3官网](http://www.mybatis.org/mybatis-3/zh/index.html "Mybatis3官网")

- [Dubbo官网](http://dubbo.io/ "Dubbo官网")

- [Nginx中文文档](http://tool.oschina.net/apidocs/apidoc?api=nginx-zh "Nginx中文文档")

- [Freemarker在线手册](http://freemarker.foofun.cn/ "Freemarker在线中文手册")

- [Velocity在线手册](http://velocity.apache.org/engine/devel/developer-guide.html "Velocity在线手册")

- [Bootstrap在线手册](http://www.bootcss.com/ "Bootstrap在线手册")

shuzheng5201314's avatar
shuzheng5201314 已提交
459 460
- [Git官网中文文档](https://git-scm.com/book/zh/v2 "Git官网中文文档")

shuzheng5201314's avatar
shuzheng5201314 已提交
461 462
- [Thymeleaf](http://www.thymeleaf.org/doc/tutorials/3.0/thymeleafspring.html "Thymeleaf")

shuzheng5201314's avatar
update  
shuzheng5201314 已提交
463 464
## 许可证

shuzheng5201314's avatar
shuzheng5201314 已提交
465
[MIT](http://opensource.org/licenses/MIT "MIT")