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

文档索引

本页用于区分“当前有效文档”和“历史参考文档”。

原则：

• 只有列在“当前有效”区域的文档，才作为现网架构、部署、运维和产品边界的事实依据。
• 没有列入“当前有效”区域的材料，默认只作为设计过程记录、阶段性任务单或历史参考。
• 历史文档即使还保留在仓库中，也不应被当作当前系统的真实规则。

1. 当前有效

• ../README.md 项目总览、当前架构和启动入口。

• DOCUMENTATION_GOVERNANCE.md 文档治理约定，定义事实来源优先级、命名规则、归档规则与语言/编码约束。

• CURRENT_STATUS_20260425.md 2026-04-25 的项目状态快照，包含结果目录、运行时、健康检查摘要。

• DEPLOYMENT.md 当前 Windows + PostgreSQL + WSL2 部署模型、环境变量和启动链路。

• DATABASE_SELF_MAINTENANCE_AUDIT_20260425.md 当前数据库自维护机制与现场数据库一致性审计结果。

• CODEBASE_CLEANUP_AUDIT_20260425.md 代码库清理审计，记录过渡文件、文档治理和编码显示问题的判定结果。

• PROJ_CONFIGURATION.md PROJ / GDAL 相关专项配置说明。

2. 当前执行中的核心设计

• PRODUCTION_RESULTS_MULTI_ENGINE_DESIGN_20260423.md 多引擎结果目录、发布结构和 catalog 治理设计。

• FLOOD_GEOTIFF_GAMMA_PREPROCESS_DESIGN_20260515.md 洪涝模块 GeoTIFF 化与 GAMMA 前处理评估，定义“原始数据到分析级 TIF 由可插拔处理器完成，水体/洪涝算法只运行在 GeoTIFF 层”的当前技术决策。

• FLOOD_DISASTER_ANALYSIS_SYSTEM_DESIGN_20260514.md 洪涝灾害分析独立系统早期设计，保留工作台、产品包和矢量套合分析边界；其中 ENVI/SARscape 作为洪涝主线的表述已被 2026-05-15 GeoTIFF 化设计取代。

• WSL_RUNTIME_REFACTOR_DESIGN_20260422.md WSL 共享运行时和 Broker 设计。

• ISCE2_MANAGED_DINSAR_IMPLEMENTATION_20260424.md ISCE2 托管式 D-InSAR 落地说明。

• ISCE2_PRODUCTION_RELIABILITY_HARDENING_DESIGN_20260424.md ISCE2 生产链路稳定性修补与约束。

3. 时序 InSAR / SBAS

• SBAS_INSAR_PRODUCTION_PIPELINE_DESIGN_20260519.md Gamma/LT1 SBAS-InSAR 独立生产页面与统一流水线收口设计。
• TIMESERIES_LEGACY_DEPRECATION_20260521.md 旧 ISCE2/MintPy 时序生产链路停用记录，定义当前入口隐藏、配置默认关闭和后续物理删除条件。
• GAMMA_IPTA_LT1_SBAS_TRIAL_RUNBOOK_20260518.md Gamma 官方 DIFF + IPTA 路径处理 LT1 数据的本地试验记录、产物和符号约定。

说明：

• 当前 SBAS-InSAR 生产主线是 Gamma 独立生产页面，不再使用旧 ISCE2/MintPy 时序生产页作为入口。
• 旧 timeseries-production 后端、旧前端面板和 ps_timeseries_runs 相关结构暂时保留兼容，但默认关闭。
• ISCE2_SBAS_TIMESERIES_DESIGN.md、ISCE2_SBAS_PRODUCT_SPEC.md、ISCE2_SBAS_ENGINEERING_DESIGN_20260428.md 仅作为历史参考，不再作为当前生产事实依据。
• SBAS_* 命名的一批旧文档已经归档，只保留历史追溯价值。

4. 配对与前端导航

• SENTINEL1_SOURCE_ORBIT_ASSET_DESIGN_20260512.md Sentinel-1 / LT-1 源数据与精密轨道资产层设计，定义统一源产品库存、轨道资产、scene 绑定、启动自维护和健康检查边界。
• SENTINEL1_SYSTEM_ENHANCEMENT_MASTER_PLAN_20260510.md Sentinel-1 系统增强主维护文档，汇总数据管理、精轨、配对、任务分发、Gamma/PyINT 生产、结果管理和分阶段实施边界。
• SENTINEL1_DATA_MANAGEMENT_ADAPTATION_PLAN_20260510.md Sentinel-1 源数据管理、精轨匹配、配对约束、分发和后续生产适配的分阶段改造规划。
• SENTINEL1_DINSAR_GAMMA_ISCE2_FEASIBILITY_20260510.md Sentinel-1 D-InSAR 在不使用 ENVI + SARscape 核心时，基于 Gamma/PyINT 与 ISCE2 的可行性、接入边界和推荐实施顺序。
• DINSAR_PAIRING_DISTRIBUTION_LOGIC_20260508.md 2026-05-08 源码走读记录，梳理 D-InSAR 配对缓存、策略筛选、批次保存、数据分发和生产 worker 执行链路。
• DINSAR_SOURCE_BUNDLE_REVERSE_TOOL_TASK_20260511.md D-InSAR 去重源数据包的目录协议、续分发规则和外部反向还原工具任务书。
• PAIRING_ENHANCEMENT_DESIGN.md
• FRONTEND_NAVIGATION_ARCHITECTURE.md

说明：

• PAIRING_ENHANCEMENT_DESIGN.md 保留配对语义、策略命名和产品交互边界设计价值。
• 当前 pairing cache 的运行态事实，以 CURRENT_STATUS_20260425.md 和 DATABASE_SELF_MAINTENANCE_AUDIT_20260425.md 为准。

5. Gamma / PyINT

• PYINT_GAMMA_INTEGRATION_DESIGN_20260418.md
• PYINT_INPUT_ASSET_ADAPTATION_DESIGN_20260419.md
• PYINT_LT1_PRECISE_ORBIT_BRIDGE_DESIGN_20260419.md
• PYINT_GAMMA_AB_FINDINGS_20260420.md

说明：

• 这部分保留当前仍有导航价值的 PyINT / Gamma 设计与结论。
• 旧的 GAMMA_WSL2_INTEGRATION_PLAN.md 已于 2026-04-26 归档，因为它描述的是已被替代的 /idl + 独立 Gamma 服务方案。
• 真正的当前运行时事实，以 WSL_RUNTIME_REFACTOR_DESIGN_20260422.md、README.md 和健康面板为准。

6. 安全与审计

• SECURITY_AUDIT_2026-03-12.md

Clone Bootstrap

• ../scripts/bootstrap_clone.ps1 Fresh-server bootstrap entry for clone-based deployment. It keeps .env initialization, frontend dependency install/build, runtime bootstrap, and deployment validation in one place without changing the main startup chain.

7. 工作笔记

• ../INIT.md

说明：

• INIT.md 视为工作笔记，不是架构、部署和运行事实的最高依据。
• 需要判断“当前真实规则”时，优先看 README.md、本页和长期有效文档。

8. 历史参考

以下材料默认视为历史设计记录或过程文档：

• archive/INDEX.md
• docs/archive/
• 已归档的 SBAS_* 阶段文档
• 已归档的 GAMMA_WSL2_INTEGRATION_PLAN.md
• 已归档的 PAIRING_SYSTEM_REFACTOR_PLAN_20260413.md
• 已归档的 DINSAR_ENHANCEMENT_TASKS.md
• 已归档的 WSL2_ISCE2_MINTPY_SBAS_INTEGRATION_PLAN_20260412.md
• 已归档的 项目汇报.md
• 已归档的各类 *_EXPERIMENT_* / *_PROGRESS_* / *_TODO_*

最后更新：2026-05-15 最近修订：2026-05-21