feat: v3 refactor with MMDB GeoIP, network clustering, node/edge viz, offline tile cache, dual export

- GeoIP: MMDB (GeoLite2-City + ASN) support with text fallback
- Upload: two-phase flow with advanced preset filter builder
- Clustering: IP communication network community discovery (/24 + HDBSCAN)
- Map: per-IP node rendering, node click detail, edge click detail
- Offline: Cache API tile caching with fallback
- Export: node table + edge table CSV download
- Fix: null-guard DOM operations throughout

Co-Authored-By: Claude <noreply@anthropic.com>

requirements.md

@@ -1,5 +1,80 @@
 # 天璇 — 更新记录
 
+## 2026-07-23 — Simple Analysis V3 重构
+
+### 概览
+对简单分析模块进行 V3 全面重构：GeoIP MMDB 支持、上传预设高级筛选器、IP 通信网络社区发现聚类、节点/边交互增强、离线地图 Cache API 缓存、点表/边表导出、前端空值防护。
+
+### 变更详情
+
+#### 1. GeoIP 升级为 MMDB 格式
+- `analysis/geoip.py`：重写，支持 MaxMind GeoLite2-City.mmdb + GeoLite2-ASN.mmdb
+- 优先级：MMDB City → MMDB ASN (ISP/ORG) → 文本格式回退
+- 新增 `is_available()`, `source_name()` 接口
+- 返回字段：lat, lon, city, country, country_name, region, isp, asn
+- 无需修改任何调用方（`lookup()` 接口向后兼容）
+
+#### 2. 上传预设筛选高级化
+- `simple_analysis/views.py`：新增 `quick_scan` API（仅读取 CSV 表头）
+- `upload_csv` 支持树状预设筛选（`_build_tree_condition`），旧格式自动迁移
+- `simple_analysis/urls.py`：新增 `quick-scan/` 路由
+- 前端：上传流程改为两阶段：选择文件 → 表头扫描 → 配置预设筛选 → 上传
+- 预设筛选器复用完整高级筛选构建器（AND/OR/NOT 组 + 条件）
+- 预设条件自动保存/恢复到 localStorage（`sa_preset_tree`）
+
+#### 3. 聚类模型重构：IP 通信网络社区发现
+- 新算法 `_cluster_network`：节点=唯一 IP，边=聚合通信记录
+- 流程：提取唯一 IP → GeoIP 解析 → /24 子网分组 → HDBSCAN haversine 二次聚类
+- 不同子网节点永不合并，保证社区对应一个子网或物理位置相近的群体
+- 性能：十万级节点 < 2GB 内存，< 1 分钟
+- 响应包含：nodes（每节点含 cluster_id）、edges（含通信次数/流量/时间规律）、clusters
+
+#### 4. 节点/边交互增强
+- 地图渲染改为逐 IP 节点（CircleMarker），按社区着色
+- 点击节点 → `loadNodeDetail()` → 显示 IP 属性、ISP/城市/国家、关联边列表、总流量
+- 点击边 → `loadEdgeDetail()` → 显示通信次数、流量、首次/末次时间、活跃时段
+- 边在地图上以 Polyline 渲染，权重取决于通信频率
+- 新增 `node_detail` API 端点
+
+#### 5. 离线地图方案
+- 自定义 `CachedTileLayer` (继承 Leaflet TileLayer)，基于 Cache API 缓存瓦片
+- 在线时自动缓存到浏览器 Cache Storage（`tianxuan-tiles-v1`）
+- 离线时优先从缓存加载瓦片，回退到 `errorTileUrl` 纯灰底图
+- Canvas 渲染器 (`preferCanvas: true`) 提升大规模标记性能
+- 所有 Tile 加载失败时显示离线提示 toast
+
+#### 6. 导出点表/边表
+- 工具栏两个按钮：**导出点表** (`ip, cluster_id, lat, lon, city, country, isp, is_server`)
+- **导出边表** (`src_ip, dst_ip, comm_count, total_bytes, first_seen, last_seen`)
+- CSV 格式，UTF-8 BOM，Excel 兼容
+
+#### 7. 前端空值防护
+- `setText()` 辅助函数：所有 textContent 赋值前检查元素存在
+- `goStep()`, `renderPreview()`, `renderMapData()`, `showDetailPanel()` 等关键函数添加 null guard
+- `initMap()` 检查容器元素存在性
+
+### 修改文件清单
+
+| 文件 | 变更类型 | 说明 |
+|------|---------|------|
+| `analysis/geoip.py` | 重写 | MMDB 支持 + 文本回退 |
+| `simple_analysis/views.py` | 重写 | quick_scan, 网络聚类, node_detail, 树状预设筛选 |
+| `simple_analysis/urls.py` | 修改 | 新增 quick-scan, node 路由 |
+| `simple_analysis/templates/.../simple_analysis.html` | 重写 | 两阶段上传, 网络聚类UI, 节点/边交互, 离线缓存, 双导出 |
+
+### 启动方式
+```bash
+runtime/python/python.exe manage.py runserver 127.0.0.1:8000 --noreload
+```
+
+### 获取 GeoLite2-City.mmdb
+1. 注册 MaxMind 账号：https://www.maxmind.com/en/geolite2/signup
+2. 下载 GeoLite2-City.mmdb 和 GeoLite2-ASN.mmdb
+3. 放置到 `data/` 目录下
+4. 重启服务器，GeoIP 模块自动检测并切换到 MMDB 模式
+
+---
+
 ## 2026-07-23 — Simple Analysis v2 功能完善
 
 ### 概览