概念定义

实体管理

名词	描述
实体管理	数字孪生服务中的产品、实体、网关的管理。
产品	一组具有相同功能的实体的集合，产品定义了实体的标准属性、事件、服务，可以理解为某类实体的本体描述。DTS为每个产品颁发全局唯一的productId。每个产品下最多可以包含50万个实体。
实体	产品的实例化对象，是某个产品下的具体实体，可以来源于物联网或虚拟世界应用。DTS为实体颁发、自定义或导入唯一标识deviceId，一般由字母、数字和特殊字符组成，具有配套密钥deviceSecret，由DTS配套生成，一般为8-32个16进制字符。实体需要通过网关连接DTS。
组合实体	一种特殊的虚拟实体，是由多个实体根据应用需要组合的一种实体，其下的每个实体都是一个原实体的镜像，也就是组合实体无需为每一个实体新建产品Profile。
所属品类	创建产品时选择的功能模板分类。包括标准品类（使用系统预先配置好常用功能模板的产品，可一键导入）与自定义品类（不带任何预设模板，需用户完全自主定义属性、事件与服务）。
接入协议	物理或虚拟设备与网关通信所使用的通信网络协议类型。包括通用网关自带的 HTTP 协议（提供设备接入、属性/事件上报），以及对于非标设备接入需专门定制开发对应的定制协议接入服务。
数据格式	设备与平台交互的数据序列化结构形式。包括平台标准的 BV JSON（采用预定义 JSON 结构直接通信）与设备自定义的透传/自定义格式（后者需要消息解析脚本在平台中进行上行与下行格式转换）。
网关	网关是 DTS 进行设备数据接入与协议解析的核心通道。每一个创建的网关都必须对应底层服务器上实际运行的协议接收服务（如 HTTP、MQTT 监听程序或容器服务等），不能随意空置。网关负责聚合/代理下属子实体的数据流，执行接入鉴权，并处理非标协议解析。
Dumb网关	系统内置的逻辑虚拟网关。它不需要任何底层的物理网络通道或协议接收服务。专门用于管理不具备物理通信实体（即无需网络连接）的“组合实体”虚拟映射，以维持数字孪生模型层次结构的完整性。
物联网网关	依托底层特定的数据通信协议（如 HTTP、MQTT 等）接收服务运行的网关通道。专门用于代理挂载在该协议下的多个物理子实体接入 DTS，完成数据的集中上报与指令下发。
视频网关	依托底层的视讯/流媒体处理服务（如系统内置的视频流媒体中间件，如内置的 BVMedia 服务）运行的网关通道。专门用于视频实体设备流数据源与状态监控的接入和关联管理。
实体证书	实体证书指`productId`、`deviceId`、`deviceSecret`。 productId：是DTS为产品颁发的全局唯一标识。该参数很重要，在实体认证以及通信中都会用到。 deviceId：在注册实体时，自定义的、系统生成的或从数字孪生服务导入的实体名称，具备产品维度内的唯一性。该参数很重要，在实体认证以及通信中都会用到。 deviceSecret：DTS为实体颁发的实体密钥，和deviceId成对出现。该参数很重要，在实体认证时会用到。
Topic	Topic是UTF-8字符串，是发布（Pub）/订阅（Sub）消息的传输中介。可以向Topic发布或者订阅消息。
Topic类	同一产品下不同实体的Topic集合，用${productId}和${deviceId}通配一个唯一的实体，一个Topic类对一个productId下所有实体通用。
发布	操作Topic的权限类型，对应的英文名称为Pub。可以往此类Topic中发布消息。
订阅	操作Topic的权限类型，对应的英文名称为Sub。可以从此类Topic中订阅消息。
标签	标签用于对平台资源进行分类检索与授权隔离。标签采用二级格式：一级为“标签分组”（如“业务线”、“部署区域”），二级为具体“标签”（如“制造部”、“北京中心”）。标签编辑与筛选全面支持“可选择 + 可输入”的组合模式（既能快速选择已有标签，也允许直接输入新建）。在进行标签筛选检索时，默认匹配该标签分组下的全部二级标签。目前支持标签的模块包括：产品、网关、实体、组合实体、资源、资源组、任务、数据推送函数、时序数据记录（数据推送函数的特殊子类）以及订阅关系。
产品Profile	对实体的功能描述，包括实体的属性、服务和事件。BV数字孪生模块通过定义一种物的描述语言来描述产品模型，称之为Profile，采用JSON格式，可以根据Profile组装上报实体的数据。
属性	对一个具体状态量、参数量或可配置量的定义，例如温度、速度、位置、模式。例如对于独立的温度和湿度测量时序数据，可以用一个“温湿度传感器”实体的“温度”、“湿度”两个属性分别进行定义，实现实体属性的正向映射。属性有两种更新类型：遥测指标（默认）：动态或快变数据的更新方式，对数据消费者来说，这些传感器的测量值仅实时有意义，过时的数据就没用了，同时它们的更新频率往往很高，所以默认不存入数据库，仅每个心跳周期内存储第一条数据。对于历史数据流的诊断分析应用，可以选择将其进行时序数据记录，存入专门的时序数据库；实体属性：静态或慢变属性的更新方式，如设备的固件版本、设备名称，它们一般很少变化，每次属性更新都会存储到数据库。
事件	实体主动发出的、具有时间点意义的事实，例如告警、碰撞、进入区域、任务完成、状态异常。事件是包含事实描述的通知信息，可包含多个输出参数。事件可以被订阅和推送。
服务	外部可对实体发起的操作，实体以服务的方式提供，例如启动设备、切换模式、打开舱门、执行仿真动作。实体的服务是对反向控制接口调用或能力的封装。
消息解析脚本	针对采用透传格式/自定义数据格式的实体，需要在DTS编写数据解析脚本，将实体上报的二进制数据或自定义的JSON数据，转换为DTS支持的JSON数据格式；将平台下发的JSON格式数据，转换为实体支持的格式。

分组管理

名词	描述
资源	资源指数字孪生服务资源，即数字孪生服务上的产品、实体、网关等内容。
资源组	资源组是数字孪生服务资源的分组。通过资源分组管理，可以授予不同账号查看和操作具体数字孪生服务资源（产品、实体和任务）的权限，从而实现不同账号之间的资源隔离

组织结构

名词	描述
数字孪生模型	物理世界的人员、环境、实体及虚拟世界在数字空间中的全面呈现。在 DTS 中，主要基于物理实体与孪生节点构建，表现为一棵支持层级管理的组织结构树；而涉及三维渲染、业务应用和高级渲染层的虚拟世界模型，则在 DTC 中进行托管与应用。
数字孪生图	呈现项目空间、实体、人员之间多维关联关系的网状拓扑图。在 DTS 侧，尽管配置上表现为树状菜单，但由于孪生体和实体节点支持复用（即一个节点可以同时挂载到多个上级节点），其底层逻辑构成了一张多对多关联的网状图，为 DTC 进行跨维度数据聚合和联动提供支持。
组织结构	数字孪生系统中对孪生体、实体（设备）及关联人员等要素之间层级与关联关系的逻辑框架管理。用户可借此描述空间划分（如厂区-车间-产线-设备）、行政隶属关系或业务逻辑分类，是平台实现数据聚合呈现、策略下发和权限隔离的基础。
根节点Root	系统内置的最顶层逻辑节点，是整个组织结构树的起始原点。所有的项目孪生体、DTS 内部结构以及自定义孪生体都作为根节点的子树向下延伸。该节点在系统中不可删除或重命名。
DTS内部结构	系统内置的独立组织结构根节点。与绑定到特定 DTC 项目的“项目孪生体”不同，DTS 内部结构是平台全局独立的虚拟孪生空间，用户在此处构建的树状结构不依赖于具体 DTC 业务项目，仅供 DTS 进行全局资产管理、跨项目共享或通用调试。
项目孪生体	来自于综合应用管理平台 DTC，以项目为最上层（根节点）的孪生体结构，作为该项目下所有物理和虚拟资源的顶层容器。在 DTS 中，用户可以编辑和修改其子级节点结构及实体的挂载关系，但不支持在 DTS 中创建或删除项目孪生体本身（生命周期由 DTC 侧统一管理）。
自定义孪生体	自由度最高的逻辑孪生体类型。完全由用户在 DTS 中根据业务需求（如空间逻辑划分）自主创建。用户可以自由构建多级树状结构、重命名节点，并随时添加、移动或删除关联的实体和下级节点。
结构孪生体	基于 DTC “结构孪生体模板” 实例化的孪生体。在 DTS 中其功能完全受限，不仅不可编辑其节点树结构，也无法在 DTS 中绑定或解绑具体的实体（所有结构与实体关联关系的修改均必须在 DTC 侧通过其模板统一进行）。DTS 不支持该类型孪生体的创建。
单孪生体	基于 DTC “单孪生体模板” 创建的实例化孪生体（支持嵌套及拥有子孪生体，例如“标准楼层”模板）。该类型孪生体可通过模板对树状层级结构进行重复利用与统一修改；同时，各个实例化的单孪生体下所绑定的具体实体是可以不同且独立配置的。DTS 不支持该类型孪生体的创建。

任务管理

名词	描述
任务	自动化业务逻辑，在满足条件下后，数字孪生服务会自动执行预设的任务列表。
触发条件	用以触发任务开始执行的条件。包含定时触发、属性触发、事件触发；定时触发：到达设定的时间点时触发执行，可以设定重复的周期；属性触发：指定实体发生属性上报且满足设定的属性状态时触发；事件触发：指定实体发生指定事件时触发；
生效条件	在任务满足触发条件后需要满足的附加生效条件。需全部满足生效条件，任务才会被执行
执行任务	任务执行时需要执行的任务列表。属性修改：直接修改实体的属性值。服务调用：调用实体的服务以达到某个功能。执行任务：触发执行任务。启动/停止任务：修改任务的运行状态。数据推送函数：执行数据推送函数。延时：延时一定时间后继续执行下一个任务。注意：以触发事件输出参数作为参数值输入到服务调用或上报告警内容时，需触发条件含有事件触发，否则参数赋值会出现异常。
数据推送函数	提供灵活便捷的数据交互转发模式，可在任务中作为任务被执行，支持RedisMQ、Http请求以及时序数据记录。
时序数据记录	将DTS接收的属性上报、事件上报根据需求选取所需字段内容一条条记录到数据库中，作为后续使用的数据记录
时序数据查询接口	将存储的属性和事件信息数据对外提供访问的途径。

订阅管理

名词	描述
订阅	订阅产品发生变更的业务信息（如实体数据上报、事件数据上报、属性数据上报、实体状态变化等）。订阅一个或多个事件并指定操作类型、订阅者以及消息质量。数字孪生服务根据设置的订阅，将产品下所选择实体的该事件消息流转至目标订阅者。
订阅者	向数字孪生服务发起订阅的第三方服务端或应用平台。
消费者	消费者指在BV数字孪生服务为订阅应用端创建的扩展体系。在消费者扩展体系内可以创建组织架构、用户组、用户并为用户指定角色。订阅者可以根据服务端或应用平台内部的用户体系创建消费者，配置订阅关系后，DTS会将资源下所有实体或POI的已订阅类型的消息转发⾄指定的消费者。