insar-management-system-v2/docs/INDEX.md

当前文档总览

这是 docs/ 目录的统一入口文档。

从现在开始，docs/ 根目录只保留“当前仍在使用”的文档；历史过程材料、已完成实施记录、被新文档覆盖的旧方案，统一放入 docs/archive/。

1. 当前有效文档

核心使用

• README.md
  系统主文档。优先阅读，包含整体功能、架构、快速开始和主要配置说明。
• DEPLOYMENT.md
  部署与运维细节文档。适合正式部署、数据库初始化、服务启动和环境核对时使用。
• PROJ_CONFIGURATION.md
  PROJ/GDAL 相关专项配置说明。只有在坐标转换或 PROJ 冲突时才需要单独查看。

当前安全状态

• SECURITY_AUDIT_2026-03-12.md
  当前有效的安全审计结论。已经把“开发机阶段可接受暴露”和“上线前必须修复的问题”分开说明，后续安全判断以这份为准。

仍在推进的设计与任务

• DINSAR_ENHANCEMENT_TASKS.md
  D-InSAR 多引擎生产增强与结果管理增强的总 Task 文档。覆盖前端架构、ENVI 六步链路、ISCE2 的 WSL 校验、运维自检与结果治理。
• PAIRING_ENHANCEMENT_DESIGN.md
  配对能力增强设计。属于未完全落地的专项设计文档。
• GAMMA_WSL2_INTEGRATION_PLAN.md
  GAMMA + WSL2 双引擎方案。属于后续扩展规划，不是当前默认运行链路。
• PYINT_GAMMA_INTEGRATION_DESIGN_20260418.md
  PyINT 生产引擎与 Gamma 精配对总体设计。明确现有多引擎架构下的接入边界、配置管理、数据库策略、运维自检扩展与前端入口分布。
• PYINT_GAMMA_IMPLEMENTATION_TODO_20260418.md
  PyINT 生产引擎与 Gamma 精配对实施清单。按阶段拆分后端、前端、接口、运维与可选数据库任务，作为后续落地执行顺序。
• PYINT_INPUT_ASSET_ADAPTATION_DESIGN_20260419.md
  PyINT 输入资产适配设计。聚焦 Task_* 路径如何映射到 PyINT 工作区，以及 DEM、LT-1 精密轨道、运维自检和前端入口应如何纳入系统托管治理。
• PYINT_LT1_COREG_ORBIT_HYPOTHESIS_EXPERIMENT_20260420.md
  LT-1 在 PyINT/Gamma 中 coreg 失败的轨道假设验证实验设计。固定输入和 DEM，只改变 .slc.par 的 state vector 处理方式，对照验证问题是否集中在导入后的轨道几何链条。
• PYINT_LT1_DEM_GEOMETRY_CHAIN_EXPERIMENT_20260420.md
  LT-1 在 PyINT/Gamma 中 init_offsetm 失败的 DEM 几何链定位实验。聚焦 HGTSIM / lt0 / mli0 / Samp 的中间产物，区分 DEM 本体问题、DEM 几何映射链问题和中心 patch 选取问题。
• WSL2_ISCE2_MINTPY_SBAS_INTEGRATION_PLAN_20260412.md
  基于本机 Ubuntu-24.04 WSL2、isce2 / mintpy / isce2_mintpy_v1 实际环境核对后的 SBAS 集成落地方案，明确推荐运行时、workflow 补全顺序和正式产品边界。
• ISCE2_SBAS_TIMESERIES_DESIGN.md
  ISCE2 框架下 SBAS / 时序生产设计稿，说明如何从现有 PS stack batch 扩展到 workflow + psinsar catalog 的正式生产链路。
• SBAS_PROGRESS_STATUS_20260406.md
  SBAS 系统改造当前落地状态。优先查看这份文档以了解“已经做到哪一步、验证做到哪一步、下一步该补什么”。
• SBAS_SYSTEM_INTEGRATION_AUDIT_20260406.md
  对现有系统接入 SBAS 的审计结果，聚焦现状缺口与最小可行接入点。
• SBAS_SYSTEM_EMBEDDING_DESIGN_20260406.md
  SBAS 嵌入现有系统的详细设计稿，覆盖运行记录、作业编排、结果注册与前端页面边界。
• SBAS_TASK_PATH_MODE_EVALUATION_20260406.md
  评估是否沿用现有 D-InSAR task 路径 -> 生产 模式，以及 SBAS 为什么必须增加 prepare 阶段。
• SBAS_SYSTEM_CHANGE_RISK_ASSESSMENT_20260406.md
  SBAS 系统改造风险评估，重点约束“新增不伤旧链”。
• SBAS_RESULT_MANAGEMENT_AND_DISPLAY_SPEC_20260406.md
  SBAS 结果管理、编目和展示约定，明确发布级 bundle 与系统结果目录的关系。
• SBAS_FRONTEND_UX_SPEC_20260406.md
  SBAS 生产页、结果页与分析页的前端交互设计。
• SBAS_IMPLEMENTATION_TODO_20260406.md
  SBAS 系统改造任务清单，适合作为后续 Phase 2 / Phase 3 推进的执行列表。

2. 已归档文档

以下文档已移入 docs/archive/，原因通常是“历史记录”“已完成实施”或“被后续结论覆盖”。

本轮归档

• SECURITY_AUDIT_2026-03-04.md
• SECURITY_AUDIT_ANALYSIS_2026-03-04.md
• SECURITY_FIX_PLAN.md
• SECURITY_FIX_PROGRESS.md
• SECURITY_FIX_CHECKLIST.md
• SECURITY_FIX_STAGE1_SUMMARY.md
• SECURITY_OVERVIEW.md
• HARDCODE_AUDIT_2026-03-05.md
• LOG_MANAGEMENT_IMPLEMENTATION_2026-03-05.md

既有归档

docs/archive/ 中原有的旧设计、旧 TODO、阶段性分析和历史修复记录继续保留，仅作历史参考，不再视为当前执行依据。

3. 建议阅读顺序

新接手项目

1. 先读 README.md
2. 再读 DEPLOYMENT.md
3. 若涉及上线前风险，再读 SECURITY_AUDIT_2026-03-12.md

正式部署

1. README.md
2. DEPLOYMENT.md
3. PROJ_CONFIGURATION.md（仅在需要时）

后续功能规划

1. DINSAR_ENHANCEMENT_TASKS.md
2. PAIRING_ENHANCEMENT_DESIGN.md
3. PAIRING_SYSTEM_REFACTOR_PLAN_20260413.md
4. ISCE2_SBAS_TIMESERIES_DESIGN.md
5. WSL2_ISCE2_MINTPY_SBAS_INTEGRATION_PLAN_20260412.md
6. GAMMA_WSL2_INTEGRATION_PLAN.md
7. PYINT_GAMMA_INTEGRATION_DESIGN_20260418.md
8. PYINT_GAMMA_IMPLEMENTATION_TODO_20260418.md
9. PYINT_INPUT_ASSET_ADAPTATION_DESIGN_20260419.md
10. PYINT_LT1_COREG_ORBIT_HYPOTHESIS_EXPERIMENT_20260420.md
11. PYINT_LT1_DEM_GEOMETRY_CHAIN_EXPERIMENT_20260420.md

4. 后续维护规则

• docs/ 根目录只放当前有效文档。
• 已完成实施总结、阶段性修复过程、旧审计分析、被覆盖方案，统一放入 docs/archive/。
• 新增文档前，优先判断是否可以并入现有文档，避免再次堆出多份并行说明。
• 如果某份文档只记录一次任务过程，而不是长期参考资料，不应继续留在根目录。

最后整理：2026-03-13