feat: 天地图瓦片缓存(tile-cache)、拓扑标注助手与文档更新

- tile-cache: 瓦片缓存服务(vec/cva)、启动探针、详细日志、上游超时可配置(UPSTREAM_TIMEOUT_MS)
- central: docker-compose 集成 tile-cache，env.example 增加 TILE_CACHE_* / TIANDITU_TK
- topology-editor: 天地图/缓存加载、GPS 安全来源错误提示、TIANDITU 文档(403/白名单、localhost 测试说明)
- doc: README 部署步骤与 GPS 安全来源说明，TIANDITU_CONFIG 完善

Co-authored-by: Cursor <cursoragent@cursor.com>

doc/TARGETS_AND_MONITORING.md

@@ -0,0 +1,75 @@
+# 监控目标与 targets.csv
+
+边缘监控目标统一由 `edge-agent/config/targets.csv` 配置，经 `update-configs.sh` 生成 `onvif-targets.json`、`ping-targets.json`，并可生成拓扑 GeoJSON 供 Grafana Geomap 使用。
+
+---
+
+## targets.csv 格式
+
+表头（列顺序固定）：
+
+```text
+type,ip,name,role,parent,uplink_type,network,device_type,model,location,username,password,onvif_port,lat,lon
+```
+
+| 字段 | 说明 | 适用类型 |
+|------|------|----------|
+| type | `ping` / `onvif` / `topology` | 必填 |
+| ip | IP（topology 哑设备可空） | ping, onvif |
+| name | 节点唯一名，用于拓扑 parent 引用 | 必填 |
+| role | 如 core_switch, access_switch, camera, wireless_bridge, media_converter | 可选 |
+| parent | 上联设备 name，用于画拓扑连线 | 可选 |
+| uplink_type | 与上联链路类型：fiber / copper / wireless | 可选 |
+| network | 如 internal / external | 可选 |
+| device_type, model, location | 设备描述；onvif 必填 location、账号等 | onvif |
+| username, password, onvif_port | ONVIF 认证与端口（默认 80） | onvif |
+| lat, lon | 经纬度（十进制度），Geomap 打点与拓扑 | 可选 |
+
+- **ping**：有 IP，由 Blackbox Exporter 探测，生成 `ping-targets.json`。
+- **onvif**：有 IP，由 ONVIF Exporter 探测，生成 `onvif-targets.json`；需填 device_type, model, location, username, password。
+- **topology**：仅拓扑节点（可无 IP），不参与抓取；用于生成 `topology.geojson` 画点与连线。
+
+---
+
+## 示例
+
+```csv
+type,ip,name,role,parent,uplink_type,network,device_type,model,location,username,password,onvif_port,lat,lon
+ping,192.168.2.1,core_sw_1,core_switch,,,internal,,,,,,,22.54,113.98
+ping,8.8.8.8,google_dns,dns,core_sw_1,fiber,external,,,,,,,22.55,113.99
+topology,,dumb_sw_1,access_switch,core_sw_1,copper,internal,switch,,building_A,,,,22.543,113.988
+onvif,192.168.1.100,camera_front,camera,dumb_sw_1,copper,internal,camera,HIKVISION,front_door,admin,pass,80,22.123,113.567
+```
+
+---
+
+## 生成配置与拓扑
+
+```bash
+cd edge-agent/config
+chmod +x *.sh
+./update-configs.sh
+./csv-to-topology-geojson.sh targets.csv topology.geojson
+```
+
+- `update-configs.sh`：根据 targets.csv 生成 `onvif-targets.json`、`ping-targets.json`。
+- `csv-to-topology-geojson.sh`：生成 `topology.geojson`，供 Grafana Geomap 加载（设备点 + parent 连线，uplink_type 可区分线型）。
+
+---
+
+## 监控类型与数据流
+
+| 类型 | Job | Exporter | 配置文件 |
+|------|-----|----------|----------|
+| 网络 Ping | network-ping | Blackbox | ping-targets.json |
+| ONVIF | onvif-devices | ONVIF Exporter | onvif-targets.json |
+| 边缘自身 | prometheus-edge | Prometheus | 内置 |
+
+数据流：目标 → Exporter → prometheus-edge 抓取 → remote_write → 中央 VictoriaMetrics。Grafana 查边缘数据需选 **VictoriaMetrics** 数据源。
+
+---
+
+## 验证
+
+- 边缘 Prometheus（http://localhost:9092）：`probe_success{job="network-ping"}`、`onvif_device_up`。
+- 中央 Grafana（VictoriaMetrics 数据源）：`probe_success{region="workernode_1"}` 等。