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 治理设计。

• 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

• ISCE2_SBAS_TIMESERIES_DESIGN.md
• ISCE2_SBAS_PRODUCT_SPEC.md
• ISCE2_SBAS_ENGINEERING_DESIGN_20260428.md Current-phase engineering design for the managed ISCE2 + MintPy SBAS route.

说明：

• 当前前端顶级显示名已经统一为“时序 InSAR”。
• 当前默认接入仍然是 SBAS 路径，因此这两份文档仍然有效。
• SBAS_* 命名的一批旧文档已经归档，只保留历史追溯价值。

4. 配对与前端导航

• DINSAR_PAIRING_DISTRIBUTION_LOGIC_20260508.md 2026-05-08 源码走读记录，梳理 D-InSAR 配对缓存、策略筛选、批次保存、数据分发和生产 worker 执行链路。
• 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-04-26