Skip to content

Glossary

This page standardizes terminology across the docs: DC3 platform objects, general IoT terms, and the protocol and interface identifiers you'll meet in the docs and code. Technical identifiers (class names, table names, routing keys, HTTP paths, auth headers) are kept verbatim; when a name is ambiguous, this page is the authority.

You are here: you hit a term while reading Core Concepts or the operations docs, and came back to look it up. Every platform term links to its detail page.

DC3 Platform Terms

These are IoT DC3's own object model. Their relationships are fixed: drivers connect devices, profiles describe capabilities, devices bind profiles, points carry data, and the data center stores values and dispatches commands. Each row gives the canonical name and where to read more.

ChineseEnglish · IdentifierDescriptionDomain
驱动Driver · dc3-driver-*A protocol-adapter service instance that talks to devices or data sources. See DriverDevice access
模板ProfileA device capability template aggregating points / commands / events. See ProfileMetadata
设备DeviceA field-device instance bound to one Profile and one Driver. See DeviceMetadata
位号PointA single data item; whether it can be written is decided by the Point's rwFlag. See PointMetadata
位号值PointValueA collected real-time / historical value (always "PointValue", never "point reading / measurement"). See Point ValueData
网关Gateway · dc3-gatewayThe sole external HTTP entry point (8000); aggregates center routes and injects auth context. See ServicesAccess
鉴权中心Auth Center · dc3-center-authAuthentication / tenant / RBAC / OAuth. See Auth · Tenant · RBACCenter service
管理中心Manager Center · dc3-center-managerMetadata management (driver / profile / device / point). See ServicesCenter service
数据中心Data Center · dc3-center-dataPoint-value persistence and command dispatch. See Data PlaneCenter service
智能中心Agentic Center · dc3-center-agenticLLM chat and tool calling. See ServicesCenter service
租户Tenant · tenantIdThe isolation boundary for business data. See TenantCross-cutting
属性AttributeA driver protocol-layer configuration item, registered by the driver from its application.yml at startup. See Attribute & ConfigConfiguration
配置ConfigThe concrete value a device instance supplies for an attribute. See Attribute & ConfigConfiguration

Don't mix "point reading / measurement / point"

Across the docs, use "Point" for the data-item definition and "PointValue" for its runtime value. On first mention, a center service gets its "Chinese name + identifier"; afterwards either form is fine.

General IoT Terms

These are common IoT-domain terms, not specific to DC3. Knowing them helps place DC3's objects in the larger picture — for example, drivers roughly sit between the perception and network layers, while the center services live at the platform layer.

ChineseEnglish · IdentifierDescriptionDomain
感知层Perception LayerThe bottom IoT layer, where sensors and actuators interact directly with the physical world to collect and actLayering
网络层Network LayerThe layer that transports perception-layer data to the platform over wired or wireless networksLayering
平台层Platform LayerThe layer that aggregates, stores, and manages devices and data, exposing capabilities to applicationsLayering
应用层Application LayerThe layer that consumes platform capabilities for concrete business scenarios (monitoring, scheduling, analytics)Layering
传感器SensorA device that converts a physical quantity such as temperature or pressure into a readable electrical or digital signalPerception
执行器ActuatorA device that receives control instructions and acts on the physical world (e.g. open a valve, start a motor)Perception
RFIDRFIDRadio-frequency identification: contactless reading and writing of electronic tags over radio to identify objectsIdentification
NB-IoTNB-IoTNarrowband IoT: a cellular standard for low-power, wide-coverage, massive-connection scenariosNetwork
MQTTMQTTA lightweight publish / subscribe messaging protocol, common for device reporting over constrained or unstable networksApplication protocol
CoAPCoAPThe Constrained Application Protocol: a REST-like protocol over UDP designed for low-power constrained devicesApplication protocol
LwM2MLwM2MLightweight M2M device-management protocol built on CoAP, used for device registration and remote managementDevice management
边缘计算Edge ComputingProcessing data on or near the data source — on devices or gateways — to cut latency and backhaul bandwidthComputing paradigm
雾计算Fog ComputingDistributed processing on network nodes between edge and cloud; an intermediate layer between the twoComputing paradigm
时序数据Time-seriesMeasurement data keyed by timestamp and produced in time order; point values are the canonical exampleData model
数字孪生Digital TwinA real-time digital mirror of a physical entity, used for simulation, monitoring, and predictionModeling
AIoTAIoTThe convergence of AI and IoT, adding intelligent analysis and decision-making on top of collection and connectivityConvergence paradigm

Protocol and Interface Identifiers

These identifiers appear directly in the doc examples and the source: the message-bus exchanges, the driver routing key, the login endpoints, and the auth headers the gateway injects. Treat the source as the authority for exact usage; here we give each one's role in the pipeline.

Name · IdentifierTypeDescriptionDomain
dc3.driver.codeDriver routing identifierA driver's stable routing identifier used for message-bus addressing; it is a stable identifier and must not be changed casuallyDriver
dc3.e.valueRabbitMQ exchangeThe exchange for point-value reporting; a driver wraps a reading as a PointValue and sends it hereData flow
dc3.e.point_commandRabbitMQ exchangeThe exchange for read/write command dispatch; the data center routes commands to the target driver through itCommand flow
X-Auth-TenantHTTP auth headerThe tenant identifier carried on protected endpoints, feeding downstream tenant isolationAuth
X-Auth-LoginHTTP auth headerThe login-identity identifier carried on protected endpointsAuth
X-Auth-TokenHTTP auth headerThe access token carried on protected endpointsAuth
POST /token/saltHTTP endpoint (public)Login step one: send tenant and name to get the salt; use it within 5 minutes (server does not enforce the timeout)Login
POST /token/generateHTTP endpoint (public)Login step two: send tenant, name, salt, and the salt-hashed password to get an access token valid for 12 hoursLogin

Login is a two-step token exchange

First POST /token/salt to get the salt, then hash the password with the salt and POST /token/generate to exchange it for an access token. With the token in hand, protected requests carry X-Auth-Tenant / X-Auth-Login / X-Auth-Token through the gateway. Treat the source as the authority for exact fields.

Further Reading

  • Core Concepts — a one-sentence mental model plus an entity-relationship diagram that ties the platform terms into an object model
  • Domain Model — DO/BO/VO layering and field details

Released under the AGPL-3.0 License