## 工作目标管理平台

英文简称：TC

上下文路径（必须）：/minto

## 名词解释

| 名词  | 全称                            | 描述                       |
|-----|-------------------------------|--------------------------|
| TC  | MINTO CENTER                  | 工作目标管理平台对外标识             |
| TD  | MINTO DEVICE                  | 工作目标管理平台移动端对外标识          |
| TIP | MINTO Infrastructure Platform | 明途基础平台，主要是工作目标管理平台底层技术平台 |
| TAP | MINTO Application Platform    | 明途应用平台，基于基础平台的上层应用，如任务管理 |
| TGP | 未知                            | 
| TTP | 未知                            |
| TPM | 未知                            |

## 相关仓库

代码仓库：http://39.99.155.97:8888/product/maven/tip_root

Sql仓库：http://39.99.155.97:8888/product/sql

移动端仓库：http://39.99.155.97:8888/product/maven/tmp-app.git

## 项目结构说明
```
tip-root                                         -- 根
  ├── 01-docs                                    -- 相关文档
  ├── 01-style                                   -- 代码样式检查文件
  ├── 01-script                                  -- 相关脚本
  ├── tc-service                                 -- TC服务
  │    ├── tap-goal
  │    └── tap-performance
  ├── td-service                                 -- 移动端服务
  │    ├── td-apps
  │    └── td-common                             -- 移动端公共模块
  ├── tip-api                                    -- api模块，所有服务模块均依赖此模块
  ├── tip-bff                                    -- bff模块，业务模块聚合
  ├── tip-front                                  -- web模块
  └── tip-service                                -- 平台服务层
       ├── tip-auth                              -- 验证模块
       ├── tip-matrix                            -- 矩阵模块
       └── tip-...                               -- 其他平台模块
```


## 构建
本工程使用`Maven`进行依赖管理，开发环境必须安装`Maven`，并在环境变量中增加`MAVEN_HOME`

工具：`eclipse`、`idea`（推荐）

开发插件：`lombok`(必须)、`mapstruct`(必须)


## 打包

可以使用本目录下的:`02-script/mvn-build-xx.bat/sh` 进行打包，windows环境可以通过执行bat文件打包，类unix环境可以使用sh进行打包

打包分为两种，一种是单体模式，一种是微服务模式，使用不同的脚本进行打包，单体服务使用`mvn-build-suite-*.bat/sh`打包，微服务使用
`mvn-build-microApp-*.bat/sh`打包

> dev表示开发环境打包、prod表示生成环境

> 使用前需要在path中配置maven的全局变量

## 发布

使用Tag进行打包发布，Tag名称为：版本号_Release_时间，如：V6.0_Release_20210510。
如果同一个版本需要多次发布，则直接更新时间即可。

发布时需要同步提供数据库空库、运行环境（tomcat、nginx，war包等）、相关文档等

## 附录

### F.A.Q

#### 1. ureport在linux环境下启动报错：```Caused by: java.lang.NullPointerException: null```
一般来说有两种解决方案：

1）使用`report.enabled`配置禁用report模块启动

2）执行以下命令
```shell
yum install fontconfig
```

### ureport 报表学习地址

http://wiki.bsdn.org/display/UR/UREPORT+2+Home