将首台设备数据呈现至画面
从空白 Platform 开始，我们将完整体验一次从设备值可见到画面显示的流程。
无需安装 — 您可以使用公开 Demo 直接跟随操作。在熟悉整个流程之后，再考虑部署到自有服务器。 操作顺序为：注册 Site → 连接 Edge → 配置模型。一旦打通此路径，后续操作均为重复。
提供公开 Demo — https://demo-platform.plantpulse.io (admin / admin123!)。
以下所有画面截图均截取自该 Demo。Edge 端请同步使用 **https://demo-edge.plantpulse.io**。
每个步骤都附有简短的无声视频。在阅读文字前先浏览一遍，有助于熟悉画面。
Demo 采用默认 Locale (en) 显示。如需使用韩语，请按 PP_LANG=ko 进行安装。
下文中，画面显示的英文名称将以粗体标出，并附带中文含义。
第 1 步 — 注册 Site
进入左侧菜单 Factory > Model(/model/index)。在没有任何数据时，画面如下所示。
引导框明确告知了操作顺序 — “注册工厂(Site) → 连接 OPC 或其他协议以完成物理模型 → 将物理模型映射至逻辑模型。”
点击右侧 Add Site(添加 Site) 打开注册表单。
| 输入项 | 必填 | 内容 |
|---|---|---|
| Enterprise Name | ✱ | 选择企业（安装时已创建） |
| Site ID | ✱ | 以 SITE_ 开头。仅限英文、数字、_ |
| Site Name | ✱ | 习惯称呼名称 (例如: DAEJEON PLANT 1) |
| Location | ✱ | 通过 Pick on Map 选择坐标 |
| Description | ✱ | 说明 |
Location 和 Description 同样是必填项(✱)。如果不指定地图坐标直接保存，将无法通过。
此 ID 将直接嵌入到标签、API 和报表中。请在注册前确定命名规则 → Domain ID 规则。
第 2 步 — 连接 Edge
数据由 Edge 网关推送至平台。并非在 Platform 中手动创建标签，而是将 Edge 采集到的数据上传。因此，连接优先于模型。
网关侧配置请参考 Edge 教程。在网关中配置 Platform 地址和 Token 后，该设备将出现在 Platform 的 Connectivity > Edge(/edge/index) 中。
顶部的六个卡片是第一个关键检查点。
| 卡片 | 含义 |
|---|---|
| Total | 监控中的 Edge 总数 |
| Connected | Platform 可触达的 Edge |
| Disconnected | 无法触达或从未观测到的 Edge |
| PLC Normal | 已连接并正常采集中的 PLC |
| PLC Not Collecting | 已连接但无法采集的 PLC |
| PLC Disconnected | 断开连接的 PLC |
当状态变为 Total 1 · Connected 1 · PLC Normal 1 时，即表示通过。
画面下方的 Edge Help 框会提供提示 — 断开连接的 Edge 应检查物理环境、网络或 Edge OS；警告则指软件采集错误；CPU、内存或磁盘占用率超过 80% 时应检查资源情况。
列表列项为 CONNECTION · EDGE_ID · EDGE · RESOURCES · NETWORK · PLC
THROUGHPUT。详细阅读方法请参阅 连接管理。
第 3 步 — 配置模型
当数值开始上传后，需将其绑定至设备结构。否则，即使有数据也无法获知「属于哪个设备的什么属性」。
进入 Factory > Asset(/asset/tree/index)。
资产树结构为 Site › Area › Line › Equipment (数据层级最顶端的企业不显示在树中)。请自上而下逐层创建。
| 层级 | 含义 | ID 示例 |
|---|---|---|
| Site | 工厂 · 事业场 | 第 1 步创建的项目 |
| Area | 区域 | AREA_000001 |
| Line | 线体 | LINE_000001 |
| Equipment | 实际设备 | EQUIPMENT_000001 |
选中 Asset 后，右侧 Asset Info 将显示详情及 Timeline(连接与健康状态趋势)。
最后必须执行 — Confirm Factory Model
点击右上角的 Confirm Factory Model(确定工厂模型)。
此步骤是将注册的 Site、资产、标签反映到事件规则引擎 (Event Rule Engine) 中。如果不点击，将无法创建状态与统计事件规则，导致仪表板和报警为空。
⚠️ 相对地，请勿频繁点击 — 规则重新注册存在计算开销。建议在所有变更操作完成后点击一次即可。
点击后，若在 CEP > Statement 中看到新规则，则表示正常。
第 4 步 — 确认数值输入
这是第二个关键检查点。如果在 Equipment > 数据查询(/asset/data/index) 或 Data > Trend(/storage/index) 中看到标签值更新，则表示成功。
若未看到数值，请按以下顺序排查。
| 检查项 | 若非如此 |
|---|---|
| 1. Edge 端是否能看到数值 | 前往 Edge 教程第 5 步 |
| 2. Connectivity > Edge 中是否为 PLC Normal | 检查网关与 PLC 之间的连接 |
| 3. 设备是否绑定了标签 | 在 Factory > Tag(/tag/index) 中确认 |
| 4. 是否点击了 Confirm Factory Model | 返回第 3 步执行点击 |
绝大多数「已完成注册但画面为空」的情况均是因为未执行此操作。
第 5 步 — 设置报警尝试
数值输入后，为其设置条件。在 Alarm > Alarm(/alarm/index) 中配置阈值 → 报警管理。
至此，采集 → 存储 → 监视 的全流程已打通。
流程结束
| 后续步骤 | 相关文档 |
|---|---|
| 在组织中运行 | 业务流程 |
| 增加设备数量 | 工厂管理 |
| 数据加工与联动 | Flow |
| 与外部系统对接 | API 使用手册 |
| 移交前巡检 | 修改初始密码 |