简单改改文档

2026-06-01 10:21:26 +08:00 · 2016-10-23 11:19:14 +08:00
parent 1d97e4f343
commit 74a27e283f
2 changed files with 102 additions and 21 deletions
--- a/README.md
+++ b/README.md
@@ -3,7 +3,31 @@
 [![Build Status](https://travis-ci.org/hs-web/hsweb-framework.svg?branch=master)](https://travis-ci.org/hs-web/hsweb-framework)
 [![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg?style=flat-square)](https://www.apache.org/licenses/LICENSE-2.0.html)

-### 主要功能
+### 业务功能
+现在:
+
+1. 权限管理: 权限资源-角色-用户.
+2. 配置管理: kv结构,自定义配置.可通过此功能配置数据字典.
+3. 脚本管理: 动态脚本,支持javascript,groovy,java动态编译执行.
+4. 表单管理: 动态表单,可视化设计表单,自动生成数据库以及系统权限.无需重启直接生效.
+5. 模块设置: 配合动态表达没实现表格页,查询条件自定义.
+6. 数据库维护: 在线维护数据库,修改表结构,执行sql.
+7. 数据源管理: 配置多数据源.
+8. 代码生成器: 在线生成代码,打包下载.可自定义模板.
+9. 定时任务: 配置定时任务,使用动态脚本编写任务内容.
+10. 系统监控: 监控系统资源使用情况.
+11. 缓存监控: 监控缓存情况.
+12. 访问日志: 记录用户每次操作情况
+
+未来
+
+1. 组织架构管理: 地区-机构-部门-职务-人员.
+2. 工作流管理: activiti工作流,在线配置流程,配合动态表单实现自定义流程.
+3. 邮件代收: 代收指定邮箱的邮件
+
+
+### 框架功能
+0. 全局restful+json,前后分离.
 1. 通用dao,service,controller类，增删改查直接继承即可.
 2. 通用mybatis配置文件,支持多种条件查询自动生成,支持自动生成insert,update,delete语句,支持和查询相同的各种条件.
 3. 实现用户,权限管理;基于aop,注解,精确到按钮的权限控制.
@@ -14,7 +38,34 @@
 8. websocket支持.
 9. 定时调度支持,可在页面配置定时任务,编写任务脚本执行。

-### 其他组件
+### 文档
+1. [安装使用](doc/1.安装使用.md)
+2. [API](doc/2.API.md)
+
+### 此版本待完善功能
+1. 单元测试编写
+2. 项目文档编写
+3. ~~增加定时调度,支持集群,任务采用脚本方式编写.~~
+4. 完善数据库持续集成,版本更新时自动更新数据库结构.
+5. 完善动态表单发布,表单发生变化后,自动重新发布(解决集群下,表单配置不一致).
+
+### 演示
+1. 示例:[demo.hsweb.me](http://demo.hsweb.me)
+2. 测试用户:test (test2,test3,test4....) 密码:123456 
+3. 演示项目源码:[hsweb-platform](https://github.com/hs-web/hsweb-platform)
+
+### 技术选型
+第三方:
+
+1. MVC:[spring-boot](https://github.com/spring-projects/spring-boot). 开箱即用,学习成本低,部署方便(main方法运行).
+2. ORM:[mybatis](https://github.com/mybatis/mybatis-3). 配置灵活,简单方便.
+3. JTA:[atomikos](https://www.atomikos.com/). 分布式事务,多数据源事务全靠他.
+4. Cache:[spring-cache](https://github.com/spring-projects/spring-framework/tree/master/spring-context/src/main/java/org/springframework/cache). 统一接口,注解使用,simple,redis... 自动切换.
+5. Scheduler:[quartz](https://github.com/quartz-scheduler/quartz). 开源稳定,支持集群.
+
+自家:
+
+0. [hsweb-commons](https://github.com/hs-web/hsweb-commons) :通用工具类
 1. [hsweb-easy-orm](https://github.com/hs-web/hsweb-easy-orm) :为动态表单设计的orm框架
 2. [hsweb-expands-compress](https://github.com/hs-web/hsweb-expands/tree/master/hsweb-expands-compress) :文件压缩，解压操作
 3. [hsweb-expands-office](https://github.com/hs-web/hsweb-expands/tree/master/hsweb-expands-office) :office文档操作( excel读写，模板导出，word模板导出)
@@ -22,22 +73,3 @@
 5. [hsweb-expands-script](https://github.com/hs-web/hsweb-expands/tree/master/hsweb-expands-script):动态脚本,动态编译执行java,groovy,javascript,spel,ognl....
 6. [hsweb-expands-shell](https://github.com/hs-web/hsweb-expands/tree/master/hsweb-expands-shell):shell执行
 7. [hsweb-expands-template](https://github.com/hs-web/hsweb-expands/tree/master/hsweb-expands-template):各种模板引擎
-
-# 安装
-```bash
-    $ git clone https://github.com/hs-web/hsweb-framework.git
-    $ cd hsweb-framework
-    $ mvn install -DskiptTests
-```
-
-# 此版本待完善功能
-1. 单元测试编写
-2. 项目文档编写
-3. 增加定时调度,支持集群,任务采用脚本方式编写.
-4. 完善数据库持续集成,版本更新时自动更新数据库结构.
-5. 完善动态表单发布,表单发生变化后,自动重新发布(解决集群下,表单配置不一致).
-
-# 演示
-1. 示例:[demo.hsweb.me](http://demo.hsweb.me)
-2. 测试用户:test (test2,test3,test4....) 密码:123456 
-3. 演示项目源码:[hsweb-platform](https://github.com/hs-web/hsweb-platform)
--- a/doc/1.安装使用.md
+++ b/doc/1.安装使用.md
@@ -0,0 +1,49 @@
+# 使用hsweb
+项目java8开发,使用maven进行管理.
+
+## 使用
+配置pom.xml
+```xml
+ <!--统一依赖管理-->
+ <dependencyManagement>
+        <dependencies>
+            <dependency>
+                <groupId>org.hsweb</groupId>
+                <artifactId>hsweb-framework</artifactId>
+                <version>${hsweb.version}</version>
+                <type>pom</type>
+                <scope>import</scope>
+            </dependency>
+        </dependencies>
+    </dependencyManagement>
+  <!--引入私服-->
+  <repositories>
+        <repository>
+            <id>hsweb-nexus</id>
+            <name>Nexus Release Repository</name>
+            <url>http://nexus.hsweb.me/content/groups/public/</url>
+            <snapshots>
+                <enabled>true</enabled>
+            </snapshots>
+        </repository>
+    </repositories>
+```
+
+引入依赖
+```xml
+<!--设置了dependencyManagement,可以不指定版本号-->
+<dependency>
+        <groupId>org.hsweb</groupId>
+        <artifactId>hsweb-web-controller</artifactId>
+</dependency>
+
+<dependency>
+    <groupId>org.hsweb</groupId>
+    <artifactId>hsweb-web-service-simple</artifactId>
+</dependency>
+
+<dependency>
+    <groupId>org.hsweb</groupId>
+    <artifactId>hsweb-web-dao-mybatis</artifactId>
+</dependency>
+```