# 说明
 
## 环境

### 服务发现

默认采用Consul作为发现服务，见本目录Env/Consul

默认安装Redis作为缓存服务，见本目录Env/Redis

## 模块说明

        <module>obpm-common</module>
        <module>obpm-core</module>
        <module>obpm-authtime</module>
        <module>obpm-runtime</module>
        <module>obpm-gateway</module>
        <module>obpm-designer</module>
        <module>obpm-qms</module>
        <module>obpm-pms</module>
        <module>obpm-kms</module>
### 公共 obpm-common

基础常量，基础类等。

### 核心 obpm-core

核心库，通常是runtime、authtime、gateway通用的类等。

### 授权时 obpm-authtime

实现用户授权等。

### 运行时 obpm-runtime

发布到生产服务器的部分，最终用户使用。集成spring session，用redis实现session共享。

### 网关服务 obpm-gateway

网管服务，采用zuul实现负载均衡和失效转移。

### 设计时 obpm-designer

设计者使用，可以和runtime一起运行，也可以单独运行。

### 示例数据 obpm-demo

示例的模板信息，包含workspace目录，uploads目录等，通常设计及授权（超级用户等）的内容存放在此目录。

### 问卷调查 obpm-qms

未完成

### 任务管理 obpm-pms

未完成

### 知识管理 obpm-kms

未完成

## 编译

### 编译前准备

安装Java环境，建议Java8，并设置JAVA_HOME和PATH

安装maven，并设置PATH

### 安装

windows 环境下运行：install.bat

### 清理并安装

windows 环境下运行：install-clean.bat

## 运行

### 运行前准备

1. 确保Consul、Redis、MySql服务正常运行

2. 修改obpm-runtime 的配置文件application.yml中

   ```
   myapps:
        storage:
          root: D:/Java/trunk2018/obpm-demo
   ```

 ### 运行及调试

1. 启动网关，运行 obpm-gateway目录下 run.bat 或 debuge.bat(调试)

2. 启动运行器，运行 obpm-runtime目录下run.bat 或 debuge.bat(调试)

3. 启动设计器（可选），运行obpm-designer目录下run.bat 或 debuge.bat(调试)

4. 启动知识管理（可选），运行obpm-kms目录下run.bat 或 debuge.bat(调试)

**或**

  直接运行目录下的run-all.bat

**通过浏览器访问：**

运行时
  （通过run.bat运行或debug.bat运行）  http://localhost:8080/obpm/
设计器
  （通过run.bat或debug.bat运行）  http://localhost:8082/designer

知识管理
  http://localhost:8080/kms/

### 默认端口配置

如果不设置默认端口，则Consul可能存在不能自行清理失效节点且引发错误问题，因此默认设置为：

obpm-gateway：8080

obpm-designer：8082

obpm-runtime：8083

obpm-kms：8084

obpm-signon：8085

obpm-agentclient：8086  

### svn分支主干说明  

以后主干的命名格式为xx.xx.nightbuild，示例：4.3.nightbuild，其分支命名格式为XX.XX.stable，示例：4.3.0.stable


### 启动初始化说明

启动时，把初始化超级管理员、初始化权限、初始化软件、初始化索引、初始化MC数据库表结构、初始化工作日历、初始化多语言用一个日志文件记录，初始化过一次就不再初始化。
日志文件为：initTable.log(删掉即可重新初始化)