ThingsBoard 二次开发指南
参考资料
概述
1 整个ThingsBoard的代码中，变量、方法命名规范;
2 变量和方法的标识符，字面意思基本能表达整个方法或变量的功能或目的;
3 TB采用了模块化开发来实现松耦合、高内聚。每个模块之间有一定的依赖;
4 微服务集群的容器使用Docker,容器编排使用k8s;
5 使用了Actors编程模型(AKKA框架)(纯异步)、事件驱动模型;
二开团队知识储备
MQTT协议 & MQTT Broker(重要)
CoAP协议
HTTP协议(除get/post之外的动作)
WebSocket协议
RESTFUL 设计规范
TCP/IP协议簇
IoT Gateway
规则引擎概念与设计
Actors编程模型理论
Google Protocol Buffer 原理与使用
AKKA框架
Netty
kafka
PostgreSQL数据库
Nodejs
Vue SPA套件（UI重制）
目录结构
application: 应用程序主目录，整体项目打包时也是这个Module
src/main/java/org.thingsboard.server: app主目录
actors: actor执行者目录
config: 配置类目录
controller: 控制器
exception: 异常处理
service: 服务目录，app打包后，server要运行的服务的实现都在这里
cluster: 集群服务，包括服务发现、服务实例等
script: 脚本执行服务，主要是规则引擎的执行（JS）
transport: 消息传输服务
rpc: 远程调用服务
utils: 工具类
common: 公共工具集、方法集模块
dao-api: 数据访问对象的服务接口，在这里做定义
data: 用于不同数据库之间的中间数据结构
message: 消息服务的实现集，包括集群消息、TB的基础服务消息、系统类消息
queue: 队列服务的实现集，用的Kafka
transport: 消息传输通道服务的实现，定义公共接口，给客户端的transport层使用
coap: CoAP消息传输的实现，包括适配器和客户端
http: HTTP消息传输的实现
mqtt: MQTT消息传输的实现，包括适配器、会话、SSL工具等
util: 工具集（当前仅有一个异步回调工具）
dao: 数据访问对象集合，整个应用的DAO层，一般只要dao的都要data，以实现不同数据库数据结构兼容。
docker: 集群部署-docker容器解决方案，包含了部署环境和shell脚本
haproxy: HAproxy工具的配置文件存放处
tb-node: 应用程序节点配置存放目录
tb-transports: 消息传输服务的配置文件，包括coap,http,mqtt
img: 应用图标存放处
k8s: 容器编排工具Kubernetes的配置文件和自动化脚本
msa: 微服务半自动构建模块，包含了黑盒测试、js执行引擎等
black-box-tests: 黑盒测试工具
js-excutor: js执行引擎，基于nodejs，用于执行规则引擎中的js代码（沙盒执行）
tb: tb主应用程序配置
tb-node: tb程序节点配置
transport: docker中的消息传输服务的部署配置
web-ui: TB的Web用户界面在docker中部署的配置,自带http server
netty-mqtt: TB的MQTT协议的实现，包括连接、发布、订阅、遗嘱、关闭等
rule-engine: TB的规则引擎，TB没有用开源的Drools等工具，而是自己开发了一套规则引擎，主要包含3个组件和1套服务接口
rule-engine-api: 服务接口的实现
rule-engine-components: 规则引擎组件，包含滤波器、动作、数据、脚本、延迟加载、消息、队列、RPC实现、邮件等
tools: 工具模块，主要实现了MQTT with SSL客户端和REST客户端。可以测试用。
transport: 三种消息传输服务启动器，服务的实现参考common/transport,mqtt协议的实现见netty-mqtt
ui: TB的用户界面，主要使用AngularJS和react组件，单页应用（要替换掉，用Vue）
所需IDE插件
IDEA Plugins
protobuf
lombok
打包
TB将所有模块打包，以application为根模块，打包成多个平台的安装包。
运行
TB以系统服务的方式运行：
CentOS/Redhat-------thingsboard.rpm
Debian--------thingsboard.deb
Windows------thingsboard-windows.zip
常见问题
一、 mvn clean install到Server UI出现npm install无法执行的错误：
结束Java binary进程后，用管理员权限运行Terminal(cmd或powershell或shell等)环境，最好不要更改npm源，
开全局代理，依次用以下方法：
1 更改UI，js-executor，web-ui下的pom.xml，将nodeVersion和npmVersion改成和本机版本一致。
如果上述方法不行
2 删除本机Nodejs，重新执行。
如果还不行
3 跳过无法insall的项目，手动npm install，npm run build。执行逻辑在各自的pom.xml中。
二、IDE打开项目后，出现一大堆Error和Warning提示。
IDE中，安装 protobuf、lombok两个plugins，重启IDE。