From 2cffa9c3962667cd424b9e3b19ec81fa284a65ad Mon Sep 17 00:00:00 2001 From: thinkgem Date: Tue, 1 Sep 2020 09:40:58 +0800 Subject: [PATCH] =?UTF-8?q?=E7=82=B9=E5=87=BB=E5=8F=B3=E4=B8=8A=E8=A7=92?= =?UTF-8?q?=E3=80=90Star=E3=80=91=E6=94=B6=E8=97=8F=E6=9C=AC=E8=BD=AF?= =?UTF-8?q?=E4=BB=B6=20^=5F^?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 113 ++++++++++++++++++++++++++---------------------------- 1 file changed, 55 insertions(+), 58 deletions(-) diff --git a/README.md b/README.md index abf5a56b..a92eb122 100644 --- a/README.md +++ b/README.md @@ -1,45 +1,49 @@ -# 引言 -JeeSite 是一个 Java EE 企业级快速开发平台，基于经典技术组合（Spring Boot、Spring MVC、Apache Shiro、MyBatis、Beetl、Bootstrap、AdminLTE），在线代码生成功能，包括核心模块如：组织机构、角色用户、菜单及按钮授权、数据权限、系统参数、内容管理、工作流等。采用松耦合设计；界面无刷新，一键换肤；众多账号安全设置，密码策略；在线定时任务配置；支持集群，支持SAAS；支持多数据源。 +## 交流方式 + +* 交流 QQ 群（千人大群）：`127515876`、`209330483`、`223507718`、`709534275`、`730390092`、`1373527`、`183903863(外包)` +* 问题反馈： 　[【新手必读】](https://gitee.com/thinkgem/jeesite4/issues/I18ARR) +* 码云Gitee： +* GitHub： +* 作者博客： +* **技术服务：** +* 官方网站： +* 官方论坛： +* 关注微信公众号，了解最新动态： + +![JeeSite4微信公众号](https://images.gitee.com/uploads/images/2020/0727/091951_a3ab258c_6732.jpeg "JeeSite4微信公众号") + +## 平台介绍 + +JeeSite 快速开发平台，不仅仅是一个后台开发框架，它是一个企业级快速开发解决方案，基于经典技术组合（Spring Boot、Spring MVC、Apache Shiro、MyBatis、Beetl、Bootstrap、AdminLTE）采用经典开发模式，让初学者能够更快的入门并投入到团队开发中去。在线代码生成功能，包括模块如：组织机构、角色用户、菜单及按钮授权、数据权限、系统参数、内容管理、工作流等。采用松耦合设计，模块增减便捷；界面无刷新，一键换肤；众多账号安全设置，密码策略；文件在线预览；消息推送；多元化第三方登录；在线定时任务配置；支持集群，支持SAAS；支持多数据源；支持读写分离、分库分表；支持微服务应用。 JeeSite 快速开发平台的主要目的是能够让初级的研发人员快速的开发出复杂的业务功能（经典架构会的人多），让开发者注重专注业务，其余有平台来封装技术细节，降低技术难度，从而节省人力成本，缩短项目周期，提高软件安全质量。 -JeeSite 自开源以来已被广大爱好者用到了企业、政府、医疗、金融、互联网等各个领域中，JeeSite 依架构简单精良、易于扩展、大众思维的设计模式，深入开发者的内心，并得到一致好评，于[2016](http://www.oschina.net/project/top_cn_2016?sort=1)和[2017](http://www.oschina.net/project/top_cn_2017?sort=1)连续两年获得开源中国《最受欢迎中国开源软件》奖杯，期间也帮助了不少刚毕业的大学生作为入门教材，快速的去实践。 +JeeSite 自 2013 年发布以来已被广大爱好者用到了企业、政府、医疗、金融、互联网等各个领域中，JeeSite 架构精良、易于扩展、大众思维的设计模式、工匠精神打磨每一个细节，深入开发者的内心，并荣获开源中国《最受欢迎中国开源软件》奖杯，期间也帮助了不少刚毕业的大学生，教师作为入门教材，快速的去实践。 -4.0的升级，作者结合了多年总结和经验，以及各方面的应用案例，对架构完成了一次全部重构，也纳入很多新的思想。不管是从开发者模式、底层架构、逻辑处理还是到用户界面，用户交互体验上都有很大的进步，在不忘学习成本、提高开发效率的情况下，安全方面也做和很多工作，包括：身份认证、密码策略、安全审计、日志收集。 +JeeSite4 的升级，作者结合了多年总结和经验，以及各方面的应用案例，对架构完成了一次全部重构，也纳入很多新的思想。不管是从开发者模式、底层架构、逻辑处理还是到用户界面，用户交互体验上都有很大的进步，在不忘学习成本、提高开发效率的情况下，安全方面也做和很多工作，包括：身份认证、密码策略、安全审计、日志收集。努力为大中小微企业打造全方位企业级快速开发解决方案。 -**我们的优势：** 架构清晰、技术先进、入门简单、易于维护、易于扩展、安全稳定。 - -### 4.0 新特性 - -* +### 4.x 的新特性及优势： ## 技术选型 -* 主框架：Spring Boot 1.5、Spring Framework 4.3、Apache Shiro 1.4 +* 主框架：Spring Boot 1.5、Spring Framework 4.3、Apache Shiro 1.6 * 持久层：Apache MyBatis 3.4、Hibernate Validation 5.3、Alibaba Druid 1.1 * 视图层：Spring MVC 4.3、Beetl 2.7 替换JSP、Bootstrap 3.3、AdminLTE 2.4 * 前端组件：jQuery 1.12、jqGrid 4.7、layer 3.0、zTree 3.5、jquery-validation * 工具组件：Apache Commons、Logback 1.1、Jackson 2.8、POI 3.14、Quartz 2.2 +* 技术选型详情： + +## 内置功能 + +* + +## 生态系统 + +* 分布式微服务系统（Spring Cloud）： * JFlow工作流引擎： ： -* 技术选型详情： - -## 内置功能菜单 - -* - -## 开发手册 - -* 持久层开发手册 (Dao)： -* 业务层开发手册 (Service)： -* 视图层开发手册 (WebView)： -* 权限管理应用基础 (Shiro)： -* 常用JS类库API (jeesite.js)： -* 数据表格API (DataGrid.js)： -* 修改 (默认) 视图，新增主题： -* 手机 API 接口调用、前后分离： -* 代码生成工具使用手册： -* 常见问题： +* Flowable业务流程模块（BPM）： +* 内容管理模块（CMS）： # 快速体验 @@ -52,56 +56,49 @@ JeeSite 自开源以来已被广大爱好者用到了企业、政府、医疗、 ### 本地运行 1. 环境准备：`JDK 1.8`、`Maven 3.3`、`MySQL 5.7` -2. 下载源码： -3. 打开文件：/web`/src/main/resources/config/jeesite.yml` 配置JDBC连接 -4. 执行脚本：/web`/bin/init-data.bat` 初始化数据库 -5. 执行脚本：/web`/bin/run-tomcat.bat` 启动服务即可 +2. 执行命令：`git clone https://gitee.com/thinkgem/jeesite4.git` 下载源码 +3. 打开文件：`/web/src/main/resources/config/jeesite.yml` 配置JDBC连接 +4. 执行脚本：`/web/bin/init-data.bat` 初始化数据库 +5. 执行脚本：`/web/bin/run-tomcat.bat` 启动服务即可 6. 浏览器访问： 账号 system 密码 admin -7. 常见问题： +7. 部署常见问题： ### 开发环境 -1. 部署运行： -2. 常见问题： +1. 部署运行文档： +2. 部署常见问题： -# 今后如何升级？ +## 在线文档 -尽量不修改web项目以外的源码项目，如 jeesite-common、jeesite-modele-core，如果修改了，请 Pull Requests 上来，否则代码编码将与官方不同步，将对你的日后升级带来困难。 +* 在线文档学习地址： -JeeSite的小版本（4.0.x）升级是非常便捷的，你只需要将 pom.xml 文件中的 parent.version 版本修改到最新版本即可，同版本下你可进行Maven快照强制更新，即可将最新版的依赖jar更新到本地，下面介绍一下在Eclipse里如何操作： +## 技术服务与支持 -在web项目上右键，选择菜单 -> Maven -> Update Project...（或按Alt+F5） -> 点击 Select All 按钮 -> 选择 Force Update of Snapshots/Releases 复选框 -> 点击OK按钮即可。 +* 没有资金的支撑就很难得到发展，特别是一个好的产品，如果 JeeSite 帮助了您，请为我们点赞。支持我们，您可以得到一些回报，有了这些我们会把公益事业做的更好，回报社区和社会，请给我们一些动力吧，在此非常感谢已支持我们的朋友！ +* **联系方式（官方商务）QQ：[1766571055](http://wpa.qq.com/msgrd?v=3&uin=1766571055&site=qq&menu=yes)** +* 技术服务支持网页： -如果进行相对大的版本（4.x.x）升级这里我们会附加一个声明，帮助你进行迁移操作。 - -# 授权协议声明 +## 授权协议声明 1. 已开源的代码，授权协议采用 AGPL v3 + Apache Licence v2 进行发行。 2. 您可以免费使用、修改和衍生代码，但不允许修改后和衍生的代码做为闭源软件发布。 3. 修改后和衍生的代码必须也按照AGPL协议进行流通，对修改后和衍生的代码必须向社会公开。 4. 如果您修改了代码，需要在被修改的文件中进行说明，并遵守代码格式规范，帮助他人更好的理解您的用意。 -5. 在延伸的代码中（修改和有源代码衍生的代码中）需要带有原来代码中的协议、版权声明和其他原作者规定需要包含的说明（请尊重原作者的著作权，不要删除或修改文件中的`@author`信息）。 +5. 在延伸的代码中（修改和有源代码衍生的代码中）需要带有原来代码中的协议、版权声明和其他原作者规定 +需要包含的说明（请尊重原作者的著作权，不要删除或修改文件中的`@author`信息）。 6. 您可以应用于商业软件，但必须遵循以上条款原则（请协助改进本作品）。 -7. 关系平台的发展战略考虑，底层部分代码暂未开源，但这不影响您的二次开发。 -8. 请知悉社区版，用户数不可超过100个，最大允许10个用户同时在线（不含匿名）。 +7. 您若套用本平台的一些代码或功能参考，需要在您的软件介绍明显位置说明出处。 +8. **当前 v4.0.8 版本，没有系统用户数量限制，没有最大在线人数限制。** -### 获得技术服务支持： +## 今后如何升级？ -* 随着JeeSite发展，我们也需要有相应的资金支持才能持续的开发和维护。支持我们，您可以得到一些回报，我们有了这些也会把开源事业做的更好，请给我们一些动力吧，谢谢您的支持！ +尽量不修改 web 项目以外的源码项目，如 jeesite-common、jeesite-modele-core，如果修改了，请 Pull Requests 上来，否则代码与官方不同步，会将对你的日后升级增加难度。 -# 技术交流方式 +如果您修改了依赖模块代码，也没关系，这时你需要利用 Git 版本控制工具，与官方仓库代码进行同步，合并代码即可。 -* QQ 群号： `127515876(已满)` `209330483(已满)` `223507718(已满)` `709534275` `730390092` -* 问题反馈： 　[【新手必读】](http://www.dianbo.org/9238/stone/tiwendezhihui.htm) -* 码云Gitee： -* GitHub： -* 作者博客： -* 官方网站： -* 官方论坛： -* 微信公众号： - -![https://static.oschina.net/uploads/space/2018/0302/145133_OGZf_941661.jpg](https://static.oschina.net/uploads/space/2018/0302/145133_OGZf_941661.jpg "JeeSite4微信公众号") +每个版本升级，我们都会附带详细更新日志：。 +在这里，你可以看到 JeeSite 新增哪些新功能和改进，在每个版本下都有对应升级方法。 # Git 全局设置技巧