网关模型
网关模型定义「这一类网关」怎么接入平台：传输协议、认证、Topic、物模型与能力开关。所有网关设备实例都从模型派生。
返回：网关操作说明总览
路径：产品模型 → 网关模型（/gateway/model）
详情：/gateway/model/info?id=…
1、列表页：每个功能干什么
| 功能 | 作用 | 说明 / 举例 |
|---|---|---|
| 刷新 | 重新拉模型列表 | 别人刚授权给你的公开模型，刷新后可见 |
| 新增 | 创建一类网关产品模板 | 例：TH-601-MQTT、透传网关-A |
| 批量删除 | 删除未再使用的模型 | 已有设备实例时谨慎删除 |
| 列自定义 | 显示/隐藏表格列 | 按运维习惯留「型号、启用、可见性」 |
| 搜索 | 按名称/标识等筛选 | 搜 TH-601 |
| 上线引导 | 按步骤检查：模型→配置→调试→创建设备→子设备 | 列表上方流程条，点步骤可跳转对应页 |
| 启用开关 | 模型是否可被选用 | 未启用时无法规范创建网关设备 |
| 可见性 | 平台公开 / 租户公开 / 已授权 / 自有 | 决定哪些租户能看见并使用该模型 |
| 模型名称点击 | 进入模型详情 | 去配物模型、Topic、透传主站 |
| 编辑 / 删除 | 改基本信息或删除 | 仅自有且有权限时可改 |
| 谱系 / 设置范围 | 看上下游链路；限定可用租户/项目范围 | 排查「为何某项目选不到该模型」 |
2、新建 / 编辑：关键字段含义
| 字段 | 作用 | 举例 |
|---|---|---|
| 模型名称 | 列表与选型时显示的名字 | TH-601 空压站网关 |
| 产品标识 / ProductKey | MQTT Topic 第一段、云端产品身份 | 系统生成或按规范填写 |
| 品牌 / 型号 | 产品档案信息 | 品牌凌点、型号 TH-601 |
| 联网方式 | 网关连平台用的网络类型 | 蜂窝、以太网、Wi-Fi |
| 传输协议 | 网关跑的协议包插件：决定如何接入、如何采子设备 | 选已上架的 MQTT 网关协议包 |
| 认证方式 | 设备连云鉴权策略 | 一型一密 / 一机一码 |
| 协议文件 | 可选附件，存厂商协议 PDF 等 | 便于研发/实施查阅，不参与运行时 |
| 串口配置 | 网关侧默认串口能力描述（可随协议包预填） | 波特率、校验位等默认值，实例还可再调 |
说明：
- 传输协议 ≠ 物模型数据格式：物模型上下行 payload 一般为 ICA JSON；传输协议管「网关怎么连、怎么转发」。
- 节点类型在网关入口下固定为 gateway，无需再选「子设备」。
3、详情页签：每个页签的作用
3.1 模型概览
| 能力 | 作用 |
|---|---|
| 接入信息总览 | 看 ProductKey、认证、联网、协议包是否配齐 |
| Topic 列表 | 本产品可用的上下行 Topic 模板（含网关自身与子设备路径约定） |
| 文档 / MQTT 参数 | 查看接入说明、连接参数（主机、端口、ClientId、用户名等） |
| 打开调试 | 不强制先发布也可在调试面板验证 Topic/上报 |
什么时候用：刚建完模型，先核对 Topic 与 MQTT 参数再去创建设备。
3.2 物模型
定义网关自身的 属性 / 事件 / 服务（以及分组、版本）。
| 能力 | 作用 | 举例 |
|---|---|---|
| 属性 | 网关上报的状态量 | 信号强度、固件版本、串口状态 |
| 事件 | 网关主动上报的事件 | 掉线恢复、配置变更 |
| 服务 | 平台可调用的下行能力 | 重启、拉取配置 |
| 导入 | TSL / Excel / AI 识点表等 | 从厂商点表快速生成 |
| 分组 / 版本 | 分模块维护；草稿与已发布版本 | 改点表后发布新版本再下发 |
| 调试联动 | 与底部调试面板联动读写 | 联调时看实时值 |
网关物模型通常比采集终端「轻」——重点在网关自身运维态；现场仪表点表一般在 采集终端模型 上配。
3.3 告警规则
产品级告警画像：基于物模型属性/事件配置规则模板，供该模型下设备继承或引用。
举例：信号强度连续低于阈值 → 产生「弱网」告警策略，再在网关设备告警中心落地。
3.4 透传主站（仅网关模型）
声明本模型是否支持 透传型网关 + 平台 Modbus 主站：
- 网关只转发
raw_hex，不解析点表 - 平台侧按 PollTask 主动轮询子设备
| 开关状态 | 含义 |
|---|---|
| 未声明 | 走常规「网关本地解析/协议包采集」路径 |
| 已声明主站能力 | 可在设备侧启用主站采集策略，与 Modbus RTU 透传场景配套 |
举例：廉价透传盒子只做 RS485↔MQTT 转发时，打开此能力，由平台排程点读。
3.5 关联设备
列出已基于本模型创建的 网关设备实例（状态、编码、名称、型号、创建时间），可跳进设备详情。
作用：从「产品」一眼看到「现场有几台、是否在线」。
3.6 预注册管理
在设备真正激活前，预先登记设备编码/密钥等信息（视认证方式与权限显示）。
作用：产线批量烧录或出厂预置名单，避免现场随意编造编码。
4、推荐配置顺序
- 新增模型并 启用
- 选好 传输协议 + 认证方式
- 在 模型概览 核对 Topic / MQTT
- 配 物模型（至少基础状态）并发布版本
- 需要透传轮询时打开 透传主站
- 用上线引导或直接去 网关管理 创建设备
下一步
- 网关管理
- 采集终端模型
- 接入实操：MQTT 网关设备接入