项目总览

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）

框架包含了11个一级包，其含义如下：

1.技术栈

前端术点

包括： Angularjs、ES6、Reactjs、webpack

前端技术描述

前端MVC、MVVM框架
前端打包方案
前端包依赖管理
前后端通信方式
单元测试方案

后端技术点

1. 并发模型： Actor模型akka Actor模式理解与使用
2. 集群协作：zookeeper
3. 支持协议：mqtt、coap、http
4. 远程调用: gRPC,thrift
5. 持久化: Postgresql、Cassandra（https://cassandra.apache.org/数据存储），datastax（数据访问）

   2.package包功能描述

   Application应用相关类

   appaction.main.java.org.thingsboard.server ThingsboardServerApplication.java(启动类)

install thingsboard服务开启相关配置、异常和调用
exception thingsboard响应错误及错误逻辑处理
controller thingsboard页面展示必要的 系统数据 接口
service 为controller提供支持
config 为同源策略、swagger、webSocket、消息及安全配置注册spring bean

Common

• Data 用于与不同db之间的中间数据结构。
• Message 定义不同的消息类型。
• Transport 定义一个公共的接口，供与客户端的transport层使用

Dao

• dao抽象了对不同数据库的统一接口。
• dao的接口数据一般都data，根据不同的数据库在不同的接口中转换为对应的实体类与数据库交互.
• 通过@ConditionalOnProperty(prefix = "database"， value = "type"， havingValue = "cassandra")动态注入不同的数据库

Docker

系统发布资源类

Img

系统图片类

Msa

• black-box-tests 黑盒测试

• js-executor javascript执行器

  Netty-mqtt

  数据交互协议

  Rule-engine

• 规则与插件。基于actors执行。

• 规则包含Filters,Processors,Action

  Tools

• extensions(extension-kafka,extension-mqtt,extension-rabbitmq,extension-rest-api-call)：分别调用不同协议的后端服务

• extensions-api：定义aciton，filter，plugin，processor及其他基本对象

• extensions-core：实现一些公用aciton，filter，plugin，processor

  Transport

  包含协议：

• http Thingsboard的http传输协议启动类

• coap Thingsboard的coap传输协议启动类
• mqtt Thingsboard的mqtt传输协议启动类

功能概述：

• mqtt基于netty开发mqtt服务器。
• http提供基于rest的http服务。
• 基于californium搭建coap服务。
• 对不同的客户端设备提供不同类型的接口.同时将消息转换成不同的message，通过DefaultActorService与后端的actor交互

  UI

  使用到的前端技术： Angularjs、ES6、Reactjs、webpack
  前端MVC、MVVM框架
  设计到前端打包配置文件：server.js， webpack.*.js

  3.thingsboard开发主要涉及到的包

  如需在thingsboard添加新的接口
  可参考：Usercontroller.java 类

  application

  1： Controller
  2： dao
  3： sql
  

  4.thingsboard代码类及接口说明

  [相关代码类controller说明 ， 文档使用了swagger
  1： 管理控制器(admin-controller)：管理控制器显示
  2： 报警控制器(alarm-controller)：报警控制器显示
  3： 资产控制器(asset-controller)：资产控制器显示
  4： 审核日志控制器(audit-log-controller)：审核日志控制器显示
  5： 身份验证控制器(auth-controller)：身份验证控制器显示
  6： 组件描述符控制器(component-descriptor-controller)：组件描述符控制器显示
  7： 客户控制器(customer-controller)：客户控制器显示
  8： 仪表板控制器(dashboard-controller)：仪表板控制器显示
  9： 设备API控制器(device-api-controller)：设备API控制器显示
  10： 设备控制器(device-controller)：设备控制器显示
  11： 实体关系控制器(entity-relation-controller)：实体关系控制器显示
  12： 实体视图控制器(entity-view-controller)：实体视图控制器显示
  13： 事件控制器(event-controller)：事件控制器显示
  14： RPC控制器(rpc-controller)：RPC控制器显示
  15： 规则链控制器(rule-chain-controller)：规则链控制器显示
  16： 遥测控制器(telemetry-controller)：遥测控制器显示
  17： 租户控制器(tenant-controller)：租户控制器显示
  18： 用户控制器(user-controller)：用户控制器显示
  19： 控件类型控制器(widget-type-controller)：控件类型控制器显示
  20： 控件束控制器(widgets-bundle-controller)：控件束控制器显示
  详情运行thingsbroads开发环境后：输入地址查阅http：//localhost：8080/swagger-ui.html

5.thingsboard使用的第三方包或插件

6.ThingsBoard数据库

[thingsBoard使用的data-jpa]

关系数据库（使用了2个数据库）

1、PostgreSQL：用于数据存储
2、Cassandra：用于数据存储
3、Datasta：用于数据访问

非关系数据库(redis)

redis在ThingsBoard中的使用场景。使用场景主要存储设备终端信息，临时存储。