Appearance
核心概念
研几 IoT 云平台使用四层结构管理设备和数据：
组织（Organization）
└── 项目（Project） — 按站点或场景划分
└── 设备（Device） — 每台网关或控制器对应一个设备
└── 点位（Point） — 每个采集或控制通道对应一个点位组织
组织是公司、团队或客户的工作空间。一个用户可以属于多个组织。组织之间的数据、用户和配置相互隔离。
项目
项目用于归组同一现场、业务场景或客户空间下的设备。比如一个养殖基地、一个冷库中心等。
- 如果设备属于不同现场或不同客户，建议使用不同的项目来管理。
设备
设备代表一台向云端发送数据的物理终端，例如 DTU、网关、控制器或采集节点。
比如：
- 一个大气环境监测站
- 温室大棚中的一个温湿度采集点
- 一个水泵控制器
- 一台智能配电箱
点位
点位表示设备上的一个数据通道或控制通道。
一台设备通常包含多个点位。例如一台 DTU 接入温湿度传感器后，可能包含：
| 点位 | 含义 |
|---|---|
| 空气温度 | 温度读数 |
| 空气湿度 | 湿度读数 |
| 设备状态 | 运行状态 |
点位配置决定平台如何读取、解析、展示和控制这些数据。
点位类型
点位类型用于告诉平台该点位表示什么，例如温度、湿度、GPS、开关、电机等。
点位类型会影响：
- 默认名称和单位
- 图标
- 展示方式
- 控制按钮
- API 中的类型字段
详见 点位类型。
数据流向
典型数据流向如下：
现场层 云平台 外部系统
├─ 传感器/执行器 → ├─ 设备接入、数据解析 → ├─ 实时数据查看
│ ├─ 点位匹配、数据存储 → ├─ 历史数据查询
│ ├─ 数据导出 → ├─ 数据导出下载
│ └─ 数据转发 → └─ 第三方系统
└─ 设备采集与上报 ───────→API 与数据转发
需要实时同步时优先使用数据转发，按需查询时使用 API。