# WowHelper

**Repository Path**: StanL/WowHelper

## Basic Information

- **Project Name**: WowHelper
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2019-12-30
- **Last Updated**: 2020-12-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# data-cloud-jss 项目说明:
## 一 项目模块说明：
    1. data-cloud-jss 三方数据通道系统，三方数据的缓存和落地以及数据的监控推送等；
    5. 未完待续

## 二、项目开发建议：
    1. 一切基于接口开发
    2. 服务类基于业务领域模块划分，划分原则可以与业务表对应。
    3. 尽量减少表连接，杜绝两个业务领域的表连接，读取数据尽量使用pk主键。
    4. Service不能夸领域调用另一个业务表的dao层。
    5. Module内部服务接口类名以Service结尾，接口方法细粒度;对外提供接口类名以Facade结尾，接口方法定义粗粒度。
    6. 实体类与数据库表对应，建议跟接口参数类不一致，防止修改内部实体类影响接口稳定性。
    7. 尽量使用缓存：配置类的使用内存缓存；业务类数据使用redis缓存。
    8. 外部调用不能放在事务中，避免嵌套事务，大事务，分布式事务。
    
### 三、项目框架流程

![三方数据通道系统](http://on-img.com/chart_image/5a509568e4b01acda58d4f0f.png)    
    
### 四、项目技术

- 技术栈：spring boot/mybatis/spring cloud/redis/hbase...等

- 注册中心

    - 开发环境：http://10.0.4.125:8081/
    
    - 测试环境：http://10.0.4.149:8081/
    
### 五、项目部署
    
- 测试和开发环境
    
    1. #### 部署目录说明 ####
     
        项目部署在/home/appuser/data-cloud-service/data-cloud-jss/目录下，在此目录下创建如下目录：
        
        - bin目录：存放启动脚本,如start.sh,stop.sh,restart.sh,jvm.properties，具体脚本参考项目的bin目录
        
        - config目录：存放配置文件，如log4j2.xml,application.properties,disconf.properties,以及其它配置文件；
        
        - libs目录：存放第三方依赖包，risk-xxx.jar的排除；
        
        - logs目录：存放日志，日志分为gc日志，存放在gc目录，已经系统日志，系统日志分为：
        
            - biz-xxxx.log：为业务日志；
            
            - err-xxxx.log:为错误日志；
            
            - disconf-xxxx.log:为配置中心disconf日志
            
            - io-xxxx.log：入参和出参日志，可以不用配置
            
            - monitor-xxxx.log:监控日志，可以不用配置
            
            - all-xxxx.log:启动日志
        
        - project-xxxx.jar:自身应用程序包，包含自身代码和risk-xxx.jar等依赖包
        
        
    2.  #### 打包方式 ####
        
        - jar包排除在pom.xml的配置
        
        ```
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>1.5.3.RELEASE</version>
            <configuration>
                <fork>true</fork><!-- 如果没有该项配置，devtools不会起作用，即应用不会restart -->
                <!-- 指定该Main Class为全局的唯一入口 -->
                <mainClass>${start-class}</mainClass>
                <layout>ZIP</layout>
                <executable>true</executable>
                <!-- 打包包含的依赖jar包 一般包含risk-xxx.jar的包-->
                <includes>
                    <include>
                        <groupId>nothing</groupId>
                        <artifactId>nothing</artifactId>
                    </include>
                    <include>
                        <groupId>cn.touna.risk</groupId>
                        <artifactId>risk-api</artifactId>
                    </include>

                    <include>
                        <groupId>cn.touna.risk</groupId>
                        <artifactId>risk-cache</artifactId>
                    </include>

                </includes>
                
                <!-- 首次打包排除的第三方依赖jar包 排除risk-xxx.jar的包，其余第三方都不排除-->
                <!--<excludes>
                    <include>
                        <groupId>cn.touna.risk</groupId>
                        <artifactId>risk-api</artifactId>
                    </include>
                    <include>
                        <groupId>cn.touna.risk</groupId>
                        <artifactId>risk-cache</artifactId>
                    </include>
                </excludes>-->
                
            </configuration>
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
        ```
        
        - 配置文件排除在pom.xml的配置
        
        ```
            <!-- 打包需要排除log4j2.xml,application.properties,disconf.properties,generatorConfig.xml-->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>2.6</version>
                <configuration>
                    <excludes>
                        <exclude>generatorConfig.xml</exclude>
                        <exclude>log4j2.xml</exclude>
                        <exclude>application.properties</exclude>
                        <exclude>disconf.properties</exclude>
                    </excludes>
                </configuration>
            </plugin>
        ```
        
        
       3.  #### 集成与启动方式 ####

        
            - 项目构建用[jenkins](http://10.0.4.124:9090/manage)自动打包发布，构建的配置如下：
            
            ![image](https://note.youdao.com/yws/api/personal/file/48798962EE5C4918BE480E86C29859C7?method=download&shareKey=36a1b8fb056c923cd9403428ad4cba08)

            ![image](https://note.youdao.com/yws/api/personal/file/A3473CEDC9B4475B8398B374D29EEBFC?method=download&shareKey=84a11ea958b88a82575acd9378dd7ae6)
            
            ![image](https://note.youdao.com/yws/api/personal/file/3B7AB2A712424091A928A7E757F40A11?method=download&shareKey=7e375fe5bbfaf372d417e1fe6c80a8e6)
            
            
            ![image](http://note.youdao.com/noteshare?id=0ed2da6a7504ee6aff3473a624ede0c2&sub=E969674980CE451280A26CE0E174858B)
            
            
            - 验证是否启动成功
                         
                1. 检查注册中心，是否已有改服务
                                         
                2. 检查进程是否存在                                         
         



- 生产环境

    1. #### 部署目录说明 ####
    
        - 与测试环境和开发分类相同，只有部署目录不同，生产的部署目录为：/data/apps/应用名目录/
    
    2.  #### 打包方式 ####
    
        - 打包方式与测试环境和开发相同；
        
    3.  #### 集成与启动方式 ####
            
        - 生产环境在easyops发布,发布有项目负责人发布。