操作手册

管理端日常使用与超管运维步骤。界面以当前 v3.0 为准。

登录与首页

1. 打开管理端地址（默认本地 http://127.0.0.1:8087）。
2. 使用账号密码登录。
3. 登录后进入工作台；顶部显示当前数据空间。

数据空间

选择 / 切换空间

1. 点击顶部「数据空间」下拉。
2. 选择目标空间；页面会刷新会话并加载该空间业务菜单。
3. 超管可切回「全部空间」（系统控制中也可「切回全部空间」）。

新建空间（超管）

1. 先在「数据源管理」登记业务库连接并测试通过。
2. 在数据空间管理中创建空间，绑定数据源。
3. 为用户授权该空间后，对方即可切换进入。

数据管理

1. 进入「数据」模块（原数据集）。
2. 上传 SHP / GeoJSON / GPKG 等文件，填写目标表与空间信息。
3. 系统将任务交给 data 服务解析入库；在上传列表中查看进度与结果。
4. 入库成功后，可在数据列表预览、编辑元数据；物理表与 vector_info 保持一致。

地图、图层与样式

1. 地图：创建地图信息，作为服务与切片的组织单元。
2. 图层：将数据（矢量等）挂到地图，配置字段与过滤。
3. 样式：配置 MapLibre 风格；可管理字体（Glyphs）与图标（Sprites）。
4. 在预览器中检查渲染效果后再发布服务。

服务发布与测试

1. 在「服务管理」登记/发布服务，关联地图与样式。
2. 使用服务测试页验证切片、要素查询等接口。
3. 将服务地址与鉴权方式提供给前端或第三方系统。

切片任务

1. 在瓦片/切片模块创建预切任务（范围、级别、样式等）。
2. data 侧 Worker 认领并执行；可在任务列表查看进度。
3. 超管可在「系统控制」探测预切 Worker 状态。

用户权限

• 空间内：用户管理、角色、服务授权。
• 超管：管理员管理、跨空间的数据空间/数据源配置。

超管运维

服务状态

查看 manage / core / data / Geode / MinIO 等连通性，以及本机 CPU、内存、磁盘。

存储状态

分栏查看：

• 数据库：平台主连接 + 已登记业务数据源连通
• 数据空间：空间与数据源绑定
• Geode / GPKG：状态与业务元数据行数对照（是否与备份一致）

系统控制

推荐日常节奏

1. 变更元数据后，可在系统控制「立即备份 GPKG」，或等待每日 02:00 定时备份。
2. Cache 冷启动后，确认空 Region 已按 initCacheFlag 从 GPKG 灌入。
3. 出现「删了又回来」时，先看存储状态 Geode↔GPKG 差异，再决定备份或销毁 Region。

常见问题