Resource Guide
数字孪生项目资料清单填写说明
摘要：数字孪生项目资料清单用于整理空间资料、现场照片、三维模型、设备点位、数据接口、告警规则、视频资源和部署环境。它能帮助项目团队先判断哪些内容适合首期实现，哪些内容需要等数据、点位或系统权限准备好后再扩展。
这份清单什么时候使用
建议在数字孪生方案和报价确认前先完成一次资料盘点，并在建模、接口和点位联调开始前补齐责任人和样例文件。清单的作用不是要求所有资料一开始就齐全，而是标明已有、缺失、待确认和计划提供时间，便于判断首期范围与高风险项。
空间资料决定建模范围
平面图、CAD、楼层图、鸟瞰图、现场照片和已有模型会影响三维场景范围、建模精度和制作周期。填写资料清单时，建议说明哪些区域需要重点还原，哪些区域可以简化示意，避免把展示重点和背景空间混在一起。
设备点位决定能不能联动
设备点位表应包含设备编码、名称、类型、所属区域、坐标或楼层位置、状态字段和数据来源。没有点位表也可以先做展示型场景，但要做实时状态、告警定位和视频联动，就需要尽早补齐点位关系。
接口和告警规则要分开写
接口说明负责回答数据从哪里来、多久更新一次、字段含义是什么；告警规则负责回答什么情况下变红、谁处理、是否需要联动视频或工单。这两类资料建议分开整理，否则联调阶段容易出现“有数据但不知道怎么用”的问题。
建议按什么顺序整理
- 先确定园区、建筑、车间、楼层或设备的空间范围和首期重点区域。
- 建立对象与设备编码，确认模型、台账、点位和业务系统使用同一映射关系。
- 补充接口字段、刷新频率、告警规则、视频资源和异常状态样例。
- 最后确认部署环境、访问终端、账号权限、性能目标和资料责任人。
关键资料怎样判断是否可用
| 资料 | 至少说明 | 可用性判断 |
|---|---|---|
| 空间图纸与模型 | 版本、范围、坐标或楼层、精度 | 能区分重点还原区域与示意区域 |
| 设备与点位 | 编码、名称、位置、状态字段 | 能把设备定位到具体空间对象 |
| 数据接口 | 来源、字段、单位、时间、刷新频率 | 有脱敏样例并能解释异常值 |
| 告警与视频 | 触发、等级、恢复、通道、权限 | 能说明一次完整联动路径 |
| 部署与访问 | 服务器、网络、终端、并发、账号 | 能判断实现方式和验证环境 |
资料不齐可以先做什么
图纸、点位或接口尚未齐全时，可以先用明确标注的样例数据验证空间层级、页面路径和视觉方向，但应同时记录缺口、责任人和补齐时间。样例数据不能替代真实接口、异常状态和性能验收。
下载与相关资料
需要先判断模型、地图、视频、设备协议和业务接口能否在目标环境使用时，可填写数字孪生资产与协议兼容矩阵；需要把空间对象、模型构件、资产、测点和页面组件逐项对应时，可使用数字孪生对象、资产、点位与页面映射表；需要进一步统一告警规则时，可使用数字孪生点位编码与告警分级模板。继续阅读数字孪生项目启动前要准备哪些资料。