产品与物模型

系统设置概览 | 上一章：系统设置概览 | 下一章：企业与全局配置

1. 产品型号管理

菜单路径：系统设置/产品型号

权限要求：需要 product:info:view 权限

1.1 产品列表

产品列表显示所有产品型号，包含以下信息：

• 产品名称
• 产品编码
• 产品类型
• 产品状态：启用/禁用
• 关联设备数
• 操作：查看详情、编辑、删除

1.2 产品操作

新增产品

权限要求：需要 product:info:create 权限

1. 点击"新增"按钮
2. 填写产品信息：
   • 产品名称（必填）
   • 产品编码（必填，需唯一）
   • 产品类型
   • 产品描述
   • 产品图片（可选）
3. 保存产品

编辑产品

权限要求：需要 product:info:edit 权限

在产品列表中点击"编辑"按钮修改产品信息。

查看产品详情

点击产品进入详情页面，可以：

• 查看产品信息：产品的基本信息
• 查看物模型：产品关联的物模型配置
• 编辑物模型：配置产品的物模型（需要权限）
• 配置设备面板：为该产品选择可视化面板模板（见 1.3 设备面板配置）

删除产品

权限要求：需要 product:info:delete 权限

警告：删除产品前，请确保没有设备使用该产品型号。

提示：建立统一的产品编码规范；产品或物模型变更后及时更新，并做好版本管理。

1.3 设备面板配置

菜单路径：系统设置/产品型号 → 产品详情 → 设备面板配置

权限要求：查看需 product:info:view；选择模板、保存映射需 product:info:edit

设备面板是 单台设备 的可视化控制界面（如空调遥控器、温湿度卡片、热泵控制面板），内嵌在 Web 设备详情 的「设备面板」Tab 中，供用户查看实时数据并远程控制。

与数据可视化的区别：设备面板面向 单设备 交互；数据可视化（go-view Dashboard）面向 项目级或全局大屏 组态，二者能力独立，勿混淆。

能力概览

维度	说明
配置粒度	按 产品型号 配置，同产品下所有设备共用同一面板模板
Web 展示	设备管理 → 设备详情 → 设备面板 Tab（需 device:panel:view）
APP 展示	设备列表 → 设备面板入口（需全局配置 app.device-panel 开启，见 企业与全局配置 · 常用租户配置项）
贴牌图片	设备白标可覆盖面板品牌图，见 3.4 设备白标

配置页面说明

产品详情页的「设备面板配置」区域展示：

• 当前面板：已选模板名称
• 面板 ID：模板标识（templateId），如 heat_pump_v2
• 状态：已启用 / 未启用
• 必需 / 可选数据点：当前模板依赖的物模型字段提示
• 面板预览：右侧实时预览效果，可点击「查看大图」

配置步骤

第一步：选择面板模板

1. 进入目标产品的详情页，找到 设备面板配置
2. 点击 「配置面板」
3. 在弹窗 「选择面板」 下拉框中选择模板（仅展示本租户已授权的模板）
4. 可选填写 备注
5. 点击 「确定」 保存

第二步：配置数据点映射（热泵类产品）

选择 空气源热泵（heat_pump）或 空气源热泵（精美版）（heat_pump_v2）后，页面左侧出现 数据点映射 区域：

1. 将面板逻辑字段绑定到本产品 物模型属性 code（下拉可选，也可手动输入）
2. 必填项（出水温度、回水温度、环境温度、运行模式、开关机）须全部映射后面板才能正常工作
3. 按需配置 制热/热水设定、制冷设定 等设定温度字段
4. 展开 高级选项 可设置滑条范围（℃）、是否显示温度单位、heat_pump_v2 的 Hero 产品主图开关等
5. 点击 「保存映射配置」

其他模板（空调、净化器、温湿度等）通常按模板内置字段名与物模型 code 自动匹配，页面会提示「当前面板模板无需在此配置数据点映射」。

第三步：验证

1. 在右侧 面板预览 确认 UI 效果
2. 打开任意关联该产品的 设备详情 → 设备面板 Tab，确认实时数据与控制正常
3. 若需 APP 端入口，另在 全局配置 中开启 app.device-panel（与 Web 面板模板配置相互独立）

可用面板模板

以下为平台内置模板（实际可见列表以租户授权为准）：

面板 ID	名称	适用场景
default	默认列表	通用数据点列表，无专用 UI 时的兜底方案
air_conditioner	空调遥控器	温度、模式、风速、开关控制
air_purifier	净化器房间	PM2.5、CO₂ 等空气质量展示
temperature_humidity	温湿度传感器	温湿度读数与舒适度
heat_pump	空气源热泵	进出水/环境温度、模式与设定温度
heat_pump_v2	空气源热泵（精美版）	同上，精美 Hero + 仪表带 UI

热泵数据点映射参考

将下列 逻辑字段 映射到物模型中对应的 属性 code（下表「示例 code」仅作参考，以你的产品物模型为准）：

逻辑字段	说明	示例 code
出水温度（inletTemp）	仪表「出水」侧温度	owt1
回水温度（returnTemp）	仪表「回水」侧温度	ewt1
环境温度（ambientTemp）	环境温度	at1
运行模式（mode）	当前运行模式	mode
开关机（power）	电源状态	power
制热/热水设定（setTempHeat）	制热或热水模式设定温度	hotTempSet
制冷设定（setTempCool）	制冷模式设定温度	coolTempSet
单一设定温度（setTemp）	未区分冷暖时可选	—
模式下发（modeSet）	读写分离时的模式下发表项	可选
开关下发（powerSet）	读写分离时的开关下发表项	可选

配置页提供 「填入示例映射」 可快速填入常见字段名，保存前请按实际物模型核对。

前置条件与生效范围

设备详情页能正常展示设备面板，须同时满足：

1. 设备已 关联产品型号
2. 该产品已在详情页 配置并启用 面板模板
3. 用户具备 device:panel:view（或兼容旧码 device:visualization:view）及相应设备角色
4. 物模型属性与映射配置一致，设备已上报对应数据点

从设备详情页也可点击 「前往配置」 跳转到产品详情进行面板配置（需产品编辑权限）。

常见问题

Q：设备详情看不到「设备面板」Tab？

1. 检查是否有 device:panel:view 权限及该设备的设备角色
2. 确认设备已关联产品；未关联时 Tab 内会提示无法展示
3. 确认产品详情中已选择非默认模板或已启用面板配置

Q：面板打开了但数据为空或控制无效？

1. 热泵类产品：检查 数据点映射 是否保存，必填项是否齐全
2. 对照物模型 code 与南向/实际上报字段是否一致
3. 确认设备在线且有 device:datapoint:realtime、device:control:command 等权限

Q：Web 有面板，APP 没有入口？

Web 产品面板与 APP 入口独立配置。APP 需在 全局配置 中启用 app.device-panel，详见 APP 常见问题 · 设备面板。

2. 物模型管理

菜单路径：系统设置/产品型号 → 产品详情 → 编辑物模型

权限要求：需要相应权限

物模型定义了设备的数据结构，包括属性、事件、服务等。

2.1 物模型结构

物模型包含以下部分：

• 属性（Properties）：设备的状态数据，可读可写
• 事件（Events）：设备的事件数据，只读
• 服务（Services）：设备的服务能力，可调用

2.2 物模型配置

属性配置

1. 在物模型编辑页面，找到"属性"部分
2. 点击"新增属性"
3. 填写属性信息：
   • 属性标识（必填，需唯一）
   • 属性名称（必填）
   • 数据类型（int、float、string、bool 等）
   • 取值范围（可选）
   • 单位（可选）
   • 读写类型（只读/只写/读写）
   • 描述（可选）
4. 保存属性

事件配置

1. 在物模型编辑页面，找到"事件"部分
2. 点击"新增事件"
3. 填写事件信息：
   • 事件标识（必填，需唯一）
   • 事件名称（必填）
   • 事件类型（信息/告警/故障）
   • 输出参数（可选）
   • 描述（可选）
4. 保存事件

服务配置

1. 在物模型编辑页面，找到"服务"部分
2. 点击"新增服务"
3. 填写服务信息：
   • 服务标识（必填，需唯一）
   • 服务名称（必填）
   • 输入参数（可选）
   • 输出参数（可选）
   • 描述（可选）
4. 保存服务

提示：使用规范的标识符与名称，为属性、事件、服务补充完整描述，并按实际业务合理设计结构。

2.3 物模型导入导出

• 导入物模型：支持从 JSON 文件导入物模型配置
• 导出物模型：支持将物模型配置导出为 JSON 文件

3. 常见问题

Q: 无法新增产品型号？

A: 检查是否有 product:info:create 权限；产品编码是否已存在（需唯一）。

Q: 物模型配置不生效？

A: 检查物模型是否正确保存；设备是否使用了该产品型号；物模型配置是否符合规范。

---

相关：系统设置概览 · 企业与全局配置 · 设备管理 · 设备面板