chore: initialize insar management system v2

docs/PROJ_CONFIGURATION.md

@@ -0,0 +1,149 @@
+# PROJ 数据库配置指南
+
+## 问题背景
+
+InSAR 管理系统使用地理空间库（GDAL、pyproj）进行坐标转换和空间查询。这些库依赖 PROJ 数据库来执行坐标系转换。
+
+**版本冲突问题**：
+- PostgreSQL PostGIS 扩展自带 PROJ 数据库 **v2**（旧版本）
+- GDAL/pyproj 期望 PROJ 数据库 **v3+**（新版本）
+- 版本不匹配会导致警告，甚至**坐标转换错误**
+
+## 配置方式
+
+### 方式 1：自动配置（推荐）
+
+**不需要任何配置**，系统会自动使用 pyproj 的 PROJ 数据库。
+
+启动后端时，会看到：
+```
+[*] Configuring PROJ database...
+[*] Auto-detected PROJ_LIB: C:\Users\Administrator\.conda\envs\InSAR\lib\site-packages\pyproj\proj_dir\share\proj
+[*] PROJ version: 9.2.0
+```
+
+### 方式 2：手动配置（高级）
+
+如果需要使用自定义的 PROJ 数据库，可以在 `.env` 文件中配置：
+
+```bash
+# PROJ 数据库路径
+PROJ_LIB=C:\path\to\your\proj\data
+```
+
+**配置优先级**：
+1. `.env` 中的 `PROJ_LIB`（如果设置）
+2. pyproj 自动检测（默认）
+
+## 验证配置
+
+### 方法 1：查看启动日志
+
+启动后端时，检查日志输出：
+
+```bash
+# 正确配置（使用 pyproj）
+[*] Auto-detected PROJ_LIB: ...pyproj\proj_dir\share\proj
+[*] PROJ version: 9.2.0
+
+# 错误配置（使用 PostgreSQL）
+[*] Using PROJ_LIB from .env: C:\Program Files\PostgreSQL\17\share\contrib\postgis-3.6\proj
+```
+
+### 方法 2：运行诊断脚本
+
+```bash
+# 激活 InSAR 环境
+conda activate InSAR
+
+# 运行诊断
+python scripts/check_proj.py
+```
+
+诊断脚本会检查：
+- 环境变量 `PROJ_LIB` 的值
+- PROJ 数据库文件是否存在
+- PROJ 版本信息
+- 坐标转换功能是否正常
+
+### 方法 3：测试坐标转换
+
+```python
+import pyproj
+
+# WGS84 to Web Mercator
+transformer = pyproj.Transformer.from_crs("EPSG:4326", "EPSG:3857", always_xy=True)
+x, y = transformer.transform(116.4, 39.9)  # 北京坐标
+print(f"WGS84 (116.4, 39.9) -> Web Mercator ({x:.2f}, {y:.2f})")
+# 预期输出: WGS84 (116.4, 39.9) -> Web Mercator (12957588.73, 4851421.18)
+```
+
+## 常见问题
+
+### Q1: 为什么不能使用 PostgreSQL 的 PROJ 数据库？
+
+**A**: PostgreSQL PostGIS 自带的 PROJ 数据库是 v2 版本，而 GDAL/pyproj 期望 v3+ 版本。使用旧版本可能导致：
+- 坐标转换精度下降
+- 某些坐标系不支持
+- 空间查询结果错误
+
+### Q2: 如何知道当前使用的是哪个 PROJ 数据库？
+
+**A**: 查看后端启动日志，或运行 `python scripts/check_proj.py`。
+
+### Q3: 删除数据库重建后，PROJ 警告又出现了怎么办？
+
+**A**: 这是正常的。删除数据库后，PostGIS 扩展会重新安装，系统环境变量可能被重置。重启后端即可自动修复。
+
+### Q4: 我想使用自定义的 PROJ 数据库，如何配置？
+
+**A**: 在 `.env` 文件中设置 `PROJ_LIB` 环境变量：
+
+```bash
+PROJ_LIB=D:\custom\proj\data
+```
+
+确保该目录包含 `proj.db` 文件。
+
+### Q5: 如何确认 PROJ 配置生效？
+
+**A**: 执行雷达数据扫描操作，检查日志中是否还有 PROJ 警告：
+
+```
+GDAL signalled an error: err_no=1, msg='PROJ: proj_identify: ... DATABASE.LAYOUT.VERSION.MINOR = 2 ...'
+```
+
+如果没有此警告，说明配置生效。
+
+## 影响范围
+
+正确配置 PROJ 数据库对以下功能至关重要：
+
+- ✅ **雷达数据扫描**：解析影像坐标系
+- ✅ **空间查询**：隐患点与影像范围匹配
+- ✅ **D-InSAR 处理**：地理配准和坐标转换
+- ✅ **水体监测**：地理编码
+- ✅ **地图显示**：坐标系转换（WGS84 ↔ Web Mercator）
+
+## 技术细节
+
+### PROJ 数据库版本对比
+
+| 来源 | 版本 | 路径 | 推荐 |
+|------|------|------|------|
+| PostgreSQL PostGIS | v2 | `C:\Program Files\PostgreSQL\17\share\contrib\postgis-3.6\proj` | ❌ |
+| pyproj (conda) | v9.2 | `C:\Users\...\envs\InSAR\lib\site-packages\pyproj\proj_dir\share\proj` | ✅ |
+
+### 环境变量优先级
+
+1. 程序内设置的 `os.environ["PROJ_LIB"]`（最高优先级）
+2. 系统环境变量 `PROJ_LIB`
+3. pyproj 默认路径
+
+我们的配置策略是在程序启动时**强制覆盖**环境变量，确保使用正确的 PROJ 数据库。
+
+## 参考资料
+
+- [PROJ 官方文档](https://proj.org/)
+- [pyproj 文档](https://pyproj4.github.io/pyproj/)
+- [PostGIS 文档](https://postgis.net/)