chore: initialize insar management system v2

2026-04-14 13:16:01 +08:00
commit ecc72ec9cd
361 changed files with 2142522 additions and 0 deletions
@@ -0,0 +1,330 @@
+# 安全修复快速检查清单
+
+## 使用说明
+- 每次修复前检查此清单
+- 每次修复后更新状态
+- 测试失败立即停止，分析原因
+
+---
+
+## 第一阶段检查清单
+
+### ✅ 1.1 ENVI 主流程返回值
+- [x] 代码已修改
+- [ ] 本地测试通过
+- [ ] 集成测试通过
+- [ ] 无副作用
+- [ ] 可以继续下一项
+
+**快速测试命令**：
+```bash
+# 运行一个 D-InSAR 工作流
+# 在前端 IDL 自动化面板中提交任务
+# 观察任务状态和日志
+```
+
+---
+
+### ✅ 1.2 失败计数重复累加
+- [x] 代码已修改
+- [ ] 本地测试通过
+- [ ] 集成测试通过
+- [ ] 无副作用
+- [ ] 可以继续下一项
+
+**快速测试命令**：
+```bash
+# 在前端 IDL 自动化面板中
+# 使用 "Step 3: 提取 Disp 结果" 功能
+# 故意触发一些失败（如修改文件权限）
+# 检查返回的统计数据
+```
+
+---
+
+### ✅ 1.3 PowerShell 编码
+- [x] 代码已修改
+- [ ] 本地测试通过
+- [ ] 集成测试通过
+- [ ] 无副作用
+- [ ] 可以继续下一项
+
+**快速测试命令**：
+```powershell
+# 运行启动脚本
+.\scripts\start_app.ps1
+
+# 检查 nginx.conf 编码
+Get-Content .\nginx\conf\nginx.conf -Encoding UTF8
+
+# 验证 Nginx 启动
+curl http://localhost:8080
+```
+
+---
+
+## 第二阶段检查清单
+
+### ⏳ 2.1 AOI token 容量上限
+- [ ] 代码已修改
+- [ ] 环境变量已配置
+- [ ] 本地测试通过
+- [ ] 压力测试通过
+- [ ] 内存监控正常
+- [ ] 无副作用
+- [ ] 可以继续下一项
+
+**快速测试脚本**：
+```python
+# 创建测试脚本 test_aoi_token_limit.py
+import requests
+import json
+
+base_url = "http://localhost:8000"
+token = "your_auth_token"
+
+# 创建 1500 个 AOI token
+for i in range(1500):
+    geojson = {
+        "type": "FeatureCollection",
+        "features": [{
+            "type": "Feature",
+            "geometry": {
+                "type": "Point",
+                "coordinates": [100 + i * 0.001, 30 + i * 0.001]
+            }
+        }]
+    }
+    response = requests.post(
+        f"{base_url}/api/aoi/upload",
+        headers={"Authorization": f"Bearer {token}"},
+        json=geojson
+    )
+    if i % 100 == 0:
+        print(f"Created {i} tokens")
+
+print("Test completed")
+```
+
+---
+
+### ⏳ 2.2 AOI 解析异常处理
+- [ ] 代码已修改
+- [ ] 本地测试通过
+- [ ] 前端兼容性测试通过
+- [ ] 错误消息清晰
+- [ ] 无副作用
+- [ ] 可以继续下一项
+
+**快速测试数据**：
+```json
+// 无效 GeoJSON 1：缺少 type
+{
+  "features": []
+}
+
+// 无效 GeoJSON 2：错误的坐标
+{
+  "type": "FeatureCollection",
+  "features": [{
+    "type": "Feature",
+    "geometry": {
+      "type": "Point",
+      "coordinates": [999, 999]
+    }
+  }]
+}
+
+// 无效 GeoJSON 3：格式错误
+{
+  "type": "FeatureCollection",
+  "features": "not an array"
+}
+```
+
+---
+
+### ⏳ 2.3 路径归属判断
+- [ ] 代码已修改
+- [ ] 本地测试通过
+- [ ] 边界情况测试通过
+- [ ] 扫描结果准确
+- [ ] 无副作用
+- [ ] 可以继续下一项
+
+**快速测试步骤**：
+```bash
+# 1. 创建测试目录结构
+mkdir -p /data/radar_backup
+mkdir -p /data/radar/subdir
+
+# 2. 放入测试文件
+touch /data/radar_backup/test.tif
+touch /data/radar/subdir/test.tif
+
+# 3. 运行数据扫描
+# 在前端数据管理面板中点击"刷新"
+
+# 4. 验证结果
+# radar_backup 的文件不应该出现在列表中
+# radar/subdir 的文件应该出现在列表中
+```
+
+---
+
+## 第三阶段检查清单
+
+### ⏳ 3.1 解包安全校验
+- [ ] 代码已修改
+- [ ] 本地测试通过
+- [ ] 安全测试通过
+- [ ] 性能测试通过
+- [ ] 无副作用
+- [ ] 可以继续下一项
+
+**快速测试脚本**：
+```python
+# 创建测试脚本 test_tar_security.py
+import tarfile
+import os
+
+# 测试 1：创建包含符号链接的 tar
+with tarfile.open("test_symlink.tar", "w") as tar:
+    # 创建一个符号链接指向 /etc/passwd
+    info = tarfile.TarInfo(name="link_to_passwd")
+    info.type = tarfile.SYMTYPE
+    info.linkname = "/etc/passwd"
+    tar.addfile(info)
+
+# 测试 2：创建包含 .. 路径的 tar
+with tarfile.open("test_escape.tar", "w") as tar:
+    info = tarfile.TarInfo(name="../../../etc/passwd")
+    info.size = 0
+    tar.addfile(info)
+
+# 测试 3：创建正常的 tar
+with tarfile.open("test_normal.tar", "w") as tar:
+    # 创建一个正常文件
+    info = tarfile.TarInfo(name="normal_file.txt")
+    info.size = 5
+    tar.addfile(info, fileobj=io.BytesIO(b"hello"))
+
+print("Test archives created")
+print("test_symlink.tar - should be rejected")
+print("test_escape.tar - should be rejected")
+print("test_normal.tar - should be accepted")
+```
+
+---
+
+## 紧急回滚程序
+
+如果任何测试失败，立即执行：
+
+```bash
+# 1. 查看最近的提交
+git log --oneline -5
+
+# 2. 回滚到上一个提交
+git revert HEAD
+
+# 3. 或者硬回滚（谨慎使用）
+git reset --hard HEAD~1
+
+# 4. 重启服务
+# 停止所有服务
+# 重新运行 start_app.ps1
+
+# 5. 验证系统恢复正常
+curl http://localhost:8080
+```
+
+---
+
+## 测试环境要求
+
+### 最小测试环境
+- [ ] Python 3.9+
+- [ ] PostgreSQL 运行中
+- [ ] Ollama 运行中（如果测试 AI 功能）
+- [ ] 至少 1 个 D-InSAR 结果数据
+- [ ] 至少 1 个雷达数据
+
+### 推荐测试环境
+- [ ] 完整的开发环境
+- [ ] 测试数据库（非生产）
+- [ ] 监控工具（内存、CPU）
+- [ ] 日志查看工具
+
+---
+
+## 测试数据准备
+
+### D-InSAR 测试数据
+```
+需要准备：
+- 至少 1 个完整的 Task_* 目录
+- 包含 dinsar_results/out_ISARPTD_*_rsp_disp
+- 用于测试 extract_disp_results 功能
+```
+
+### 雷达数据测试
+```
+需要准备：
+- 至少 2 个 .tif 文件
+- 放在 MONITOR_RADAR_DIRS 配置的目录中
+- 用于测试预览图生成和路径判断
+```
+
+### AOI 测试数据
+```
+需要准备：
+- 有效的 GeoJSON 文件
+- 无效的 GeoJSON 文件（多种错误类型）
+- 用于测试异常处理
+```
+
+---
+
+## 性能基准
+
+记录修复前后的性能指标：
+
+### ENVI 工作流
+- 修复前成功率：_%
+- 修复后成功率：_%
+- 平均耗时：_秒
+
+### AOI token
+- 修复前内存占用：_MB
+- 修复后内存占用：_MB
+- Token 数量上限：_个
+
+### 解包性能
+- 修复前平均耗时：_秒
+- 修复后平均耗时：_秒
+- 性能差异：_%
+
+---
+
+## 签名确认
+
+每完成一个阶段，填写以下信息：
+
+### 第一阶段
+- 修复人：_______
+- 测试人：_______
+- 完成日期：_______
+- 签名：_______
+
+### 第二阶段
+- 修复人：_______
+- 测试人：_______
+- 完成日期：_______
+- 签名：_______
+
+### 第三阶段
+- 修复人：_______
+- 测试人：_______
+- 完成日期：_______
+- 签名：_______