版本号：V1.0.0
版权所有：深圳市英特吉欧创新科技有限公司
更新日期：2026.03.16
“深圳市英特吉欧创新科技有限公司”“GeoTwin”等均为深圳市英特吉欧创新科技有限公司的商标或产品标识，受法律保护。未经深圳市英特吉欧创新科技有限公司书面同意或授权，不得以任何方式使用或侵犯相关权利，侵权必究。
| 版本号 | 更新日期 | 核心更新内容 |
|---|---|---|
| V1.0.0 | 2026.03.16 | 初版发布：覆盖资产总览、产品/设备管理、告警中心、规则中心与数据接入 API |
/api），以及实时消息通道（SSE，待补充）| 组件 | 推荐配置 |
|---|---|
| CPU | 4 核及以上 |
| 内存 | 16GB 及以上 |
| 存储 | 256GB SSD 及以上 |
| 网络 | 千兆以太网或等效带宽 |
apps/geotwin 目录安装依赖并启动（npm run dev），通过开发服务器访问；npm run build:prod），并将静态资源部署到 Web 服务器（Nginx/网关，待补充）。适用场景： 通过统一门户登录后访问系统，系统使用 Token 对接口调用与消息订阅进行鉴权。
操作步骤：
常见问题：
/api，待补充），并在浏览器开发者工具中查看请求错误信息（待补充：以交付环境为准）。当前版本暂不提供离线授权（待补充：如后续支持，将在版本更新中说明）。
GeoTwin（IoT）是一款面向物联网资产的管理与可视化应用，支持产品与设备的基础管理、设备数据接入（API 推送）、告警查看与处理、规则中心配置等能力，适用于园区/城市/企业资产的物联设备统一管理场景。
软件主要包含以下核心模块：
| 数据类型 | 支持格式 | 备注说明 |
|---|---|---|
| 设备数据推送（HTTP） | JSON | 通过 POST /gtportal/iot/api/{seriesNumber}/device/data 推送；字段由产品动态字段决定 |
| 设备坐标推送（HTTP） | JSON | 通过 POST /gtportal/iot/api/{seriesNumber}/device/location 推送；包含 x/y/z |
| 产品图标上传 | 图片文件（待补充） | 支持通过上传自定义图标或选择系统图标 |
| 成果类型 | 支持格式 | 备注说明 |
|---|---|---|
| 统计报表 | 页面可视化 | 资产总览中的趋势图、占比图等（不导出文件，待补充） |
| 设备曲线 | 页面可视化 | 设备数值字段的时间序列曲线展示（不导出文件，待补充） |
| 链接/接口地址 | URL | 支持复制数据推送服务 API 链接 |
工作原理： 将产品、设备、告警等关键指标以统计卡片与趋势图方式聚合展示，便于快速了解整体运行状态。
核心功能：
操作步骤：
在左侧菜单进入“资产总览”；
切换时间范围，观察告警趋势与分布；
根据图表或入口跳转到告警列表/设备详情进行进一步处理（待补充：以页面实际为准）。
图5-1-1-1：资产总览（待补充）
工作原理： 以“产品”作为设备类型抽象，统一管理接入协议、字段模型、图标与告警规则等配置，为设备接入与告警计算提供基础。
核心功能：
操作步骤：
进入“产品管理”，查看产品列表；
点击“新增产品”，填写产品名称/标识等信息（待补充：以页面字段为准）并保存；
进入产品编辑或设置抽屉，完成协议与连接信息配置；
配置图标（系统图标/上传自定义图标）；
按需配置字段模型与告警规则，保存后对关联设备生效（待补充：生效策略以页面为准）。
图5-1-2-1：产品管理（待补充）
工作原理： 以“设备”作为具体资产实例，关联所属产品，并在设备详情中集中呈现属性、记录、告警、Topic 与数据接入 API，支撑日常运维与对接。
核心功能：
操作步骤：
进入“设备管理”，按产品或关键字检索目标设备（待补充：筛选项以页面为准）；
点击“新增设备”，选择所属产品并填写设备名称、坐标等信息后保存；
进入设备详情，按页签完成属性维护、查看记录/告警、复制 Topic 或 API 信息；
若为摄像头设备，按页面入口打开监控弹窗并验证播放（待补充：播放依赖流地址与网络环境）。
图5-1-3-1：设备管理（待补充）
工作原理： 将系统产生的告警统一汇总到列表，支持按时间与产品维度筛选，便于快速定位异常与追溯。
核心功能：
操作步骤：
进入“告警中心”，设置时间范围与产品筛选条件；
查看告警列表，按需进入关联设备或详情（待补充：入口以页面为准）；
在具备权限的情况下，选择单条或批量删除告警并确认操作。
图5-1-4-1：告警中心（待补充）
工作原理： 以规则为单位管理告警/策略配置，并通过“应用设备”将规则与设备关联，控制规则生效范围。
核心功能：
操作步骤：
进入“规则中心”，查看规则列表与规则说明；
打开目标规则的“应用设备”页面；
勾选需要生效的设备并保存，使规则对选中设备生效（待补充：生效时机以页面为准）。
图5-1-5-1：规则中心（待补充）
在“产品管理”中创建产品，并完成协议/字段配置（若需要 MQTT 或动态字段，请先配置，待补充）；
在“设备管理”中新建设备，选择所属产品并填写设备名称与坐标；
打开设备详情的“API”页签，获取数据推送服务 API：
POST /gtportal/iot/api/{seriesNumber}/device/dataPOST /gtportal/iot/api/{seriesNumber}/device/location（仅在产品启用“推送实时坐标”时展示）在外部系统按接口文档发送 JSON 数据，系统将用于设备记录/告警计算/展示（以后端规则为准）。
图5-2-1-1：设备详情-API（待补充）
在“产品管理”的产品设置中配置告警规则（阈值/等级/消息等，待补充：以页面为准）；
在“规则中心”中进入某条规则的“应用设备”，勾选需要生效的设备并保存；
当数据接入后满足告警触发条件时，告警会在“告警中心”与“设备详情-告警”中展示。
图5-2-2-1：规则中心-应用设备（待补充）
在“告警中心”使用时间范围与产品筛选，定位目标告警；
在“设备管理”进入设备详情：
如需将页面数据导出为文件，请联系交付方提供导出能力（待补充）。
图5-2-3-1：告警中心-筛选与列表（待补充）
问题 1：页面提示无权限/接口返回 401 或 403
解决方案：重新登录统一门户；检查 Token 是否过期；联系管理员配置账号权限。
问题 2：设备详情中“坐标推送 API”不显示
解决方案：确认所属产品启用了“推送实时坐标”（realtimeCoord），并刷新页面。
问题 3：摄像头监控无法播放
解决方案：检查设备监控地址是否可访问；若为 m3u8 流，确认网络允许访问并支持 HLS；必要时联系管理员检查后端转流配置（待补充）。
问题 4：告警未产生或数量异常
解决方案：检查数据推送字段与产品动态字段一致；检查规则阈值/等级配置；核对规则是否已应用到设备。
| 术语名称 | 定义说明 |
|---|---|
| 产品（Product） | 设备的类型抽象，包含接入协议、字段模型、图标等配置 |
| 设备（Device） | 具体资产实例，关联某个产品，并具有名称、坐标、序列号等信息 |
| 序列号（Series Number） | 设备的唯一标识之一，用于拼装数据推送 API 路径 |
| 动态字段（Dynamic Field） | 产品定义的可上报字段集合，决定数据推送 JSON 的字段集合 |
| 告警（Alert） | 满足规则条件后生成的异常/预警信息，支持列表查看与处理 |
| 规则（Rule） | 告警/推送策略等规则配置，支持将规则应用到设备 |
| Token / clientid | 请求后端 API 所需的鉴权参数，通常由统一登录后下发 |
| SSE | 服务器推送事件通道，用于通知与实时消息（如消息中心） |
docs/images/zh-cn/5-1-1-1-asset-overview.png、docs/images/zh-cn/5-1-2-1-product-list.png、docs/images/zh-cn/5-1-3-1-device-list.png、docs/images/zh-cn/5-1-4-1-alert-center.png、docs/images/zh-cn/5-1-5-1-rule-center.png、docs/images/zh-cn/5-2-1-1-device-detail.png、docs/images/zh-cn/5-2-2-1-rule-applied-devices.png、docs/images/zh-cn/5-2-3-1-alert-list.png（以及其它关键步骤截图）