3. ThingsBoard 核心实体导航：租户、客户、用户、设备、资产、仪表板

在 ThingsBoard 平台中，实体（Entity）是构建物联网应用的基础单元。理解租户、客户、用户、设备、资产和仪表板这六大核心实体及其层级关系，是进行设备接入与数据采集的前提。本章将逐一介绍这些实体的定义、作用及它们在平台中的导航路径。

3.1 实体层级总览

ThingsBoard 采用多租户架构，实体之间存在严格的层级归属关系。下图展示了核心实体之间的逻辑结构：

3.2 核心实体详解

3.2.1 租户 (Tenant)

租户是 ThingsBoard 中的顶级业务隔离单元，代表一个独立的组织或企业。每个租户拥有自己独立的设备、用户、仪表板和规则链。系统管理员可以创建和管理多个租户。

• 导航路径： 系统管理员登录 → 左侧菜单 “租户” → 查看/创建/编辑租户。
• 关键属性： 租户名称、电子邮件、地址、时区、最大设备数限制。
• 典型场景： 一个智慧园区平台下，不同园区（如A园区、B园区）各自作为一个租户。

3.2.2 客户 (Customer)

客户隶属于租户，代表租户下的终端用户或子部门。客户可以拥有自己的用户、设备和仪表板，实现更细粒度的权限和数据隔离。

• 导航路径： 租户管理员登录 → 左侧菜单 “客户” → 管理客户列表。
• 关键属性： 客户名称、标题、联系信息、所属租户。
• 典型场景： 一个智慧楼宇租户下，不同楼层或不同公司作为独立客户。

3.2.3 用户 (User)

用户是平台的操作者，可以是租户管理员、客户管理员或普通用户。用户通过电子邮件和密码登录，并基于角色权限访问对应实体。

• 导航路径： 租户/客户管理员 → 左侧菜单 “用户” → 邀请/管理用户。
• 关键属性： 电子邮件、姓名、角色（租户管理员/客户管理员/普通用户）、所属客户。
• 权限说明： 租户管理员可管理租户下所有实体；客户管理员只能管理所属客户下的实体。

3.2.4 设备 (Device)

设备是 ThingsBoard 中最核心的实体，代表一个物理或虚拟的 IoT 设备。设备通过 MQTT、CoAP 或 HTTP 协议与平台通信，上报遥测数据并接收指令。

• 导航路径： 租户/客户管理员 → 左侧菜单 “设备” → 添加/查看设备。
• 关键属性： 设备名称、设备类型、访问令牌（Access Token）、凭证类型、所属客户。
• 典型场景： 温度传感器、智能电表、GPS 追踪器等。

3.2.5 资产 (Asset)

资产用于建模物理世界中的非设备对象，如建筑、车辆、生产线、仓库等。资产可以与设备建立关联，形成完整的数字孪生模型。

• 导航路径： 租户/客户管理员 → 左侧菜单 “资产” → 创建/管理资产。
• 关键属性： 资产名称、资产类型、所属客户、关联设备列表。
• 典型场景： 将多个温度传感器关联到“冷库A”资产，统一监控冷库环境。

3.2.6 仪表板 (Dashboard)

仪表板是 ThingsBoard 的数据可视化载体，通过拖拽式组件（图表、地图、表格、控件）展示设备遥测数据和状态。仪表板可以分配给租户或客户，实现定制化监控界面。

• 导航路径： 租户/客户管理员 → 左侧菜单 “仪表板” → 创建/编辑/分享仪表板。
• 关键属性： 仪表板标题、所属客户、是否公开、组件配置。
• 典型场景： 设备实时数据大屏、历史趋势分析面板、告警监控中心。

3.3 实体对比表

实体	层级	主要用途	是否可关联设备	典型示例
租户	顶层	业务隔离、资源配额管理	间接（通过客户）	企业A、园区B
客户	租户下	终端用户/子部门管理	是	楼层1、公司X
用户	租户/客户下	平台操作与权限控制	否	管理员、操作员
设备	租户/客户下	数据采集与指令下发	—	温度传感器、电表
资产	租户/客户下	物理对象建模与设备聚合	是	冷库、车辆、产线
仪表板	租户/客户下	数据可视化与监控	间接（展示设备数据）	实时大屏、报表

3.4 实体关联与数据流

下图展示了设备数据从采集到展示的完整流转路径，以及各实体在其中的角色：

3.5 操作建议与最佳实践