版本号：V1.0.0
版权所有：GeoTwin
更新日期：2026-03-16
本软件的所有权和相关知识产权均属于 GeoTwin 单独所有。
用户应通过合法途径获得软件使用权，并按相关约定合法使用。
用户使用本软件过程中，非因 GeoTwin 原因发生的侵权或违法行为，由用户自行承担法律责任，GeoTwin 不承担任何责任。
未经 GeoTwin 书面同意或授权，任何主体不得对本软件进行改编、翻译、注释、整理、汇编、再许可、再授权等任何形式的修改或衍生操作。
本手册的更新或变更信息恕不另行通知，GeoTwin 对此不承担相关义务。
"GeoTwin"、"GEOTWIN" 等均为 GeoTwin 的注册商标，受法律保护。未经 GeoTwin 书面同意或授权，不得以任何方式侵犯注册商标专用权，侵权必究。
功能优化：
新增功能：
其他变更：
| 版本号 | 更新日期 | 核心更新内容 |
|---|---|---|
| V1.0.0 | 2026-03-16 | 首个正式发布版本，涵盖调查创建、表单设计、数据管理、地图联动等核心功能 |
| V0.9.x | 2025-12-09 | 内测版本，基础调查问卷管理及表单设计功能 |
| 组件 | 推荐配置 |
|---|---|
| CPU | Intel Core i5 及以上 或 Apple M1 及以上 |
| 内存 | 16 GB 及以上 |
| 显卡 | 支持 WebGL 2.0 的独立或集成显卡 |
| 存储 | SSD 256 GB 及以上 |
| 网络 | 10 Mbps 及以上宽带 |
| 浏览器 | Google Chrome 最新版本（推荐） |
GeoTwin Survey 为 Web 应用，无需本地安装客户端：
GeoTwin Survey 是一款面向地理信息与数字孪生场景的在线调查问卷管理平台，支持可视化表单设计、地理空间数据采集与三维地图联动展示。平台适用于城市管理、公共健康调查、地产普查、工程核查等需要将问卷数据与地理位置信息相结合的应用场景。
软件主要包含以下核心模块：
| 数据类型 | 支持格式 | 备注说明 |
|---|---|---|
| 表单字段配置 | JSON | 表单设计器内部存储格式，支持导入/导出 |
| 图片上传 | JPG、JPEG、PNG、GIF、WebP | 用于表单 Upload 字段，支持图片采集 |
| 文件上传 | PDF、DOC、DOCX、XLS、XLSX 等 | 通用文件上传字段 |
| 坐标定位 | 经纬度坐标（WGS84、EPSG:2326 等） | 地图字段自动捕获，支持香港1980坐标系 |
| GIS 要素图层 | 平台内置图层服务 | Feature Layer 模式下与调查直接关联 |
| 成果类型 | 支持格式 | 备注说明 |
|---|---|---|
| 调查提交数据 | JSON | 系统内部存储与 API 交互格式 |
| 数据导出 | 待补充 | 导出功能规格待确认 |
| 表单配置导出 | JSON | 支持表单设计器配置的导入导出 |
| 地图可视化 | 三维场景（WebGL） | 通过 @gt-viewer/sdk 渲染，不可直接导出 |
系统顶部导航栏贯穿所有页面，提供全局入口：
| 菜单项 | 核心功能 | 说明 |
|---|---|---|
| My Surveys | 调查问卷管理主页 | 查看、新建、管理所有调查问卷 |
| Scene | 场景管理 | 管理三维 GIS 场景及图层配置 |
| HomePage | 主页配置 | 平台主页内容配置 |
| Group | 分组管理 | 调查问卷分组与权限管理 |
| Content | 内容管理 | 富文本内容与资讯发布 |
| Organization | 组织管理 | 用户、角色、权限配置 |
| Resource | 资源管理 | 平台资源文件管理 |
右上角功能区包含：消息通知（铃铛）、语言切换（Aa）、九宫格应用切换、用户头像与账户菜单。
图5-1-1：GeoTwin Survey 调查问卷列表主页面（宫格视图）
调查列表页（My Surveys）提供以下操作功能：
每个调查卡片底部提供快捷操作：编辑（铅笔图标）、查看详情（文档图标）、更多操作（三点菜单）。
表单设计器采用三栏布局：
| 类别 | 组件 |
|---|---|
| Basic（基础组件） | Input、Textarea、Password、InputNumber、Radio、Checkbox、Select、Switch、Rate、Time、TimeRange、Slider、Date、DateRange、ColorPicker、Cascader、Upload、Transfer、Tree、TreeSelect、Editor、Signature、Map |
| Subform（子表单） | Subform、Group、TableForm |
| Auxiliary（辅助组件） | 待补充 |
顶部工具栏提供：设备尺寸预览（桌面/平板/手机）、撤销/重做、保存、预览、清空操作。
图5-1-3：表单设计器（Design）页面 — 左侧组件面板、中间画布、右侧属性配置
数据管理页面采用上下分栏布局：
上方三维地图区： 基于 @gt-viewer/sdk 渲染的三维 GIS 场景，展示调查数据的地理分布；支持地图缩放、旋转、图层切换
下方数据表格： 以属性表形式显示所有提交的调查数据，字段列与表单设计一致（如 Name、Health Status、Community name、Community Location、Submit time、Action 等）
图5-1-4：数据管理（Data）页面 — 上方三维地图（香港地区）与下方属性数据表格联动
在调查列表页（My Surveys）点击左上角 New Survey 按钮；
系统跳转至调查类型选择页面，提供两种创建方式：
根据需求点击对应类型下的 Create 按钮；
填写调查名称及基础信息后，进入表单设计器开始设计问卷。
图5-2-1：新建调查 — 选择 Blank Survey（空白调查）或 Feature Layer（要素图层）
进入调查详情页，点击顶部 Design 标签进入表单设计器；
从左侧组件面板选择所需字段组件，拖拽至中间设计画布的目标位置；
点击画布中的组件，在右侧属性面板配置该组件的详细参数：
如需地理定位采集，拖入 Map 组件，填写方可在填写时点击地图选取位置坐标；
如需手写签名，拖入 Signature 组件；
设计完成后点击顶部 Save 按钮保存表单；点击 Preview 可预览最终填写效果；
确认无误后，通过分享功能将填写链接发布给受访者。
图5-2-2：表单设计器 — 正在设计"公共健康调查"表单，包含 Name、Health Status、Community name、Community Location 字段
表单设计完成后，在调查列表或详情页获取公开填写链接（Share URL）；
将链接发送给受访者；受访者通过链接访问填写页面，无需登录账号；
受访者填写完毕后点击提交，数据自动同步至系统后台；
管理员进入对应调查的 Overview 标签，查看已提交数量、字段分布等统计概览；
进入 Data 标签，在三维地图上可视化数据分布，同时在下方属性表中逐条查看提交记录；
点击属性表中的 Action 操作列可对单条数据进行查看详情、编辑或删除操作。
在调查列表中找到目标调查，点击卡片进入调查详情；
默认展示 Overview（概览） 标签页；
概览页左侧显示调查导航结构，右侧为三维场景数据概览；
如显示"自动登录成功，请刷新一下"提示，按提示刷新页面即可正常加载数据。
图5-2-4：调查详情 Overview 页面 — 左侧导航面板，右侧地图场景（加载中）
问题1：进入调查详情后页面一直显示加载中
问题2：表单设计器中拖拽组件后无响应
问题3：公开填写链接（Share）访问报错
问题4：数据管理页面三维地图不显示
chrome://gpu/ 查看）；检查 @gt-viewer/sdk 服务端依赖是否正常；尝试缩放页面或切换到其他标签后再切换回来问题5：语言切换后部分文字未更新
| 术语名称 | 定义说明 |
|---|---|
| 调查问卷（Survey） | 由一组字段组成的数据采集表单，可关联地理位置信息，用于收集受访者的结构化数据 |
| 空白调查（Blank Survey） | 从零开始自定义设计的调查表单，不依赖任何已有 GIS 图层 |
| 要素图层调查（Feature Layer Survey） | 基于 GIS 要素图层创建的调查，表单字段与图层属性字段自动映射，填写数据与空间要素直接关联 |
| 表单设计器（Form Designer） | 提供可视化拖拽界面的表单构建工具，支持 20+ 种字段类型的可视化编排 |
| 数字孪生（Digital Twin） | 物理世界的数字化镜像，通过三维 GIS 场景实时映射真实地理空间的状态与数据 |
| GIS（地理信息系统） | 用于采集、存储、分析和展示地理空间数据的信息系统 |
| 要素图层（Feature Layer） | GIS 中存储矢量要素（点、线、面）的数据图层，每个要素拥有空间坐标和属性字段 |
| WebGL | 基于 OpenGL ES 的 Web 标准图形接口，用于在浏览器中渲染二维和三维图形 |
| 坐标系（CRS） | 定义空间坐标含义的参考框架，系统默认支持 WGS84（EPSG:4326）及香港1980坐标系（EPSG:2326） |
| 租户（Tenant） | 系统多租户模式下的独立组织单元，各租户数据隔离 |
| 概览（Overview） | 调查详情中展示数据统计和地图可视化的汇总页面 |
| 宫格视图 / 列表视图 | 调查列表的两种布局显示方式，宫格视图以卡片形式展示，列表视图以行表方式展示 |
如在使用过程中遇到问题，请优先参考本手册的"常见问题处理"章节（第 5.3 节），或联系系统管理员。
以下信息在本手册编写时暂无法确认，需与产品/研发团队核实后补充：
| 编号 | 待确认项 | 所在章节 |
|---|---|---|
| 1 | 公司全称、官方网站地址 | 封面、第7章 |
| 2 | 品牌商标正式名称及注册状态 | 商标声明 |
| 3 | 当前正式版本号（建议与 package.json 同步） | 封面、第1章 |
| 4 | 支持的数据导出格式（CSV/Excel/GeoJSON 等） | 第4章4.2节 |
| 5 | Overview 概览页面字段统计图表的具体功能（截图时数据加载未完成） | 第5.2.4节 |
| 6 | Share（公开填写）页面的完整界面样式 | 第5.2.3节 |
| 7 | 技术支持联系方式（邮箱、电话、官网） | 第7章 |
| 8 | 是否支持离线部署及相关部署要求 | 第2章 |
| 9 | Feature Layer 模式的详细操作步骤 | 第5.2.1节 |
| 10 | 数据导出功能的完整操作流程 | 第5.2节 |