diff --git a/README.md b/README.md index 4df55e4..b0a71a5 100644 --- a/README.md +++ b/README.md @@ -84,10 +84,19 @@ python run_worker.py ## 文档导航 -- [当前状态快照](docs/CURRENT_STATUS_20260425.md) -- [部署与运行说明](docs/DEPLOYMENT.md) -- [数据库自维护审计](docs/DATABASE_SELF_MAINTENANCE_AUDIT_20260425.md) -- [文档索引](docs/INDEX.md) +建议阅读顺序: + +1. [文档治理约定](docs/DOCUMENTATION_GOVERNANCE.md) +2. [文档索引](docs/INDEX.md) +3. [当前状态快照](docs/CURRENT_STATUS_20260425.md) +4. [部署与运行说明](docs/DEPLOYMENT.md) +5. [数据库自维护审计](docs/DATABASE_SELF_MAINTENANCE_AUDIT_20260425.md) + +说明: + +- `docs/INDEX.md` 是当前有效文档与历史参考文档的总入口。 +- `INIT.md` 是工作笔记,不应替代正式文档。 +- 历史材料可从 `docs/archive/INDEX.md` 进入。 当前仍在生效的专题设计文档: diff --git a/docs/CODEBASE_CLEANUP_AUDIT_20260425.md b/docs/CODEBASE_CLEANUP_AUDIT_20260425.md new file mode 100644 index 0000000..c3b662a --- /dev/null +++ b/docs/CODEBASE_CLEANUP_AUDIT_20260425.md @@ -0,0 +1,148 @@ +# Codebase Cleanup Audit + +Updated: 2026-04-25 + +## Scope + +This audit focuses on three cleanup questions: + +1. Which files are clearly transitional or unused? +2. Which documentation files are authoritative versus historical? +3. Are the reported "garbled comments" real source corruption or terminal/display issues? + +## Confirmed Cleanup Completed In This Wave + +The frontend had active implementations living under transitional filenames while older same-purpose files remained in place. + +Completed normalization: + +- Promoted active files from transitional names back to canonical names: + - `frontend/src/DinsarProductsPanel.jsx` + - `frontend/src/components/DinsarCatalogPanel.jsx` + - `frontend/src/panels/DinsarResultPanel.jsx` + - `frontend/src/components/ResultExportModal.jsx` + - `frontend/src/components/panels/DinsarResultRow.jsx` + - `frontend/src/LogManagementPanel.jsx` +- Removed superseded duplicate implementations that were no longer referenced. +- Updated imports so runtime entry points no longer depend on `.rewrite` or `.clean` suffixes. +- Updated `INIT.md` so it no longer describes the old temporary naming scheme as current reality. + +## High-Confidence Findings + +### 1. Transitional frontend files had become the real implementation + +Before cleanup, the live entry points imported: + +- `DinsarProductsPanel.rewrite.jsx` +- `DinsarResultPanel.rewrite.jsx` +- `LogManagementPanel.clean.jsx` + +while older canonical filenames still existed beside them. + +This is a maintenance hazard because: + +- file names no longer reflect runtime truth +- engineers can patch the wrong file +- stale files increase review and search noise + +### 2. Several "unused file" suspicions were correct, but not all of them + +Confirmed pattern: + +- some canonical frontend files were effectively dead +- some `.rewrite` or `.clean` files were not dead at all; they were the active implementation + +Conclusion: + +- `rewrite` / `clean` suffix is not enough to classify a file as removable +- reference tracing is required before deletion + +### 3. Most observed Chinese garbling is a tooling/display problem, not necessarily source corruption + +Key project files such as: + +- `README.md` +- `docs/DEPLOYMENT.md` +- `docs/CURRENT_STATUS_20260425.md` +- `backend/app/main.py` +- `backend/app/config.py` + +read correctly when opened as UTF-8. + +This indicates that a significant part of the reported garbling comes from PowerShell/default encoding behavior rather than broken source text. + +### 4. Some operational notes were stale even when the code was fine + +`INIT.md` still described the temporary `LogManagementPanel.clean.jsx` workflow after the codebase had already stabilized enough for normalization. + +That kind of drift is small, but it compounds quickly in a repo with many dated design notes. + +## Remaining Cleanup Candidates + +These items were not removed automatically in this wave, but they should be considered next. + +### A. Documentation governance + +Current situation: + +- `docs/INDEX.md` does a reasonable job separating current docs from historical docs +- the repository still contains many dated design, TODO, experiment, and archive documents + +Recommended next step: + +- keep `docs/INDEX.md` as the contract +- move any newly superseded design notes to `docs/archive/` +- avoid leaving outdated process notes at repo root unless they are still operational + +### B. Large-file refactors + +Large files remain a maintainability risk even when they are active: + +- `frontend/src/App.jsx` +- `backend/app/services/timeseries_service.py` +- `backend/app/models/orm.py` +- `backend/app/services/dinsar_production_service.py` + +Recommended next step: + +- split by responsibility, not by arbitrary line count +- keep public contracts stable while extracting helpers/modules + +### C. Historical compatibility layers + +There are still intentional legacy bridges in the backend, for example: + +- compatibility catalog/data bridges +- legacy manifest normalization paths +- legacy environment variables in WSL runtime definitions + +These should not be removed blindly. They need a separate compatibility retirement review driven by real production usage. + +## Recommendations + +### Phase 1: Done + +- remove dead duplicate frontend files +- normalize active transitional filenames +- correct stale operational notes + +### Phase 2: Safe repository hygiene + +- review root-level notes such as `INIT.md` for whether they still belong at repo root +- move superseded design/process notes to `docs/archive/` +- add a lightweight naming rule: no long-lived `.rewrite`, `.clean`, `.tmp`, `.bak` files in active UI paths + +### Phase 3: Controlled architecture cleanup + +- split oversized service files +- document which compatibility layers are still required by production data +- retire legacy code only after proving there is no runtime dependency + +## Practical Rule Going Forward + +Use this decision order for cleanup: + +1. Trace imports or runtime references. +2. Normalize active files back to canonical names. +3. Delete only the files that are both superseded and unreferenced. +4. Update the nearest authoritative document in the same change. diff --git a/docs/DOCUMENTATION_GOVERNANCE.md b/docs/DOCUMENTATION_GOVERNANCE.md new file mode 100644 index 0000000..c8f4044 --- /dev/null +++ b/docs/DOCUMENTATION_GOVERNANCE.md @@ -0,0 +1,195 @@ +# 文档治理约定 + +最后更新:2026-04-25 + +## 1. 目标 + +本文件用于定义本仓库的文档治理规则,解决以下问题: + +- 哪些文档是当前事实来源 +- 哪些文档只是设计过程记录 +- 哪些文档应归档而不是继续留在主导航里 +- 新文档应如何命名、放置和维护 + +本文件是长期有效的治理约定,不是一次性的状态快照。 + +## 2. 事实来源优先级 + +当多个文档描述同一主题且内容不一致时,按以下优先级判断: + +1. `README.md` + 项目总览、当前架构收口、启动入口。 + +2. `docs/INDEX.md` + 当前有效文档与历史参考文档的总入口。 + +3. 当前状态 / 部署 / 审计类文档 + 例如: + - `CURRENT_STATUS_*` + - `DEPLOYMENT.md` + - `*_AUDIT_*` + +4. 当前执行中的设计 / 规格文档 + 例如: + - `*_DESIGN_*` + - `*_SPEC_*` + +5. 计划 / TODO / 实验 / 过程记录 + 例如: + - `*_PLAN_*` + - `*_TODO_*` + - `*_EXPERIMENT_*` + - 临时工作笔记 + +6. `docs/archive/` + 默认只作为历史参考,不作为现行事实来源。 + +## 3. 文档分类 + +### 3.1 长期有效文档 + +适合长期保留在 `docs/` 根目录并放入 `docs/INDEX.md` 的文档: + +- 总览:项目总览、部署说明、运行约束 +- 状态:当前状态快照、健康检查摘要 +- 审计:数据库、自维护、安全、代码库清理等审计结论 +- 设计:当前仍在执行中的架构设计 +- 规格:仍然有效的接口、产物、目录或包结构规范 + +### 3.2 过程型文档 + +通常不应作为主事实来源,除非 `docs/INDEX.md` 显式列入“当前有效”: + +- 实施计划 +- TODO 清单 +- 阶段性实验记录 +- 迁移草案 +- 工作过程笔记 + +### 3.3 历史文档 + +满足以下任一条件时,应优先考虑归档到 `docs/archive/`: + +- 已被更新文档明确取代 +- 描述的是已结束阶段 +- 只保留历史讨论价值,不再指导当前开发或部署 + +## 4. 放置规则 + +### 4.1 仓库根目录 + +根目录只保留高频入口或必须靠近项目根的文件: + +- `README.md` +- `.env.example` +- 启动脚本 +- 极少数确实需要放在根目录的说明文件 + +不应在根目录长期堆积阶段性分析、实验记录、临时修复说明。 + +### 4.2 `docs/` + +`docs/` 根目录用于放当前仍有导航价值的正式文档。 + +### 4.3 `docs/archive/` + +`docs/archive/` 用于放: + +- 已退役设计 +- 已完成修复的过程文档 +- 旧版方案 +- 只保留追溯价值的材料 + +当归档材料数量继续增长时,应维护: + +- `docs/archive/INDEX.md` + +用于提供历史文档的结构化入口。 + +## 5. 命名规则 + +建议优先使用以下命名模式: + +- `CURRENT_STATUS_YYYYMMDD.md` + 当前状态快照 + +- `*_AUDIT_YYYYMMDD.md` + 审计结论 + +- `*_DESIGN_YYYYMMDD.md` + 当前设计 + +- `*_SPEC.md` + 稳定规格 + +- `*_PLAN_YYYYMMDD.md` + 计划文档 + +- `*_TODO_YYYYMMDD.md` 或 `*_TODO.md` + 待办事项 + +- `*_EXPERIMENT_YYYYMMDD.md` + 实验记录 + +规则: + +- 有日期的文档应表达“状态时间点”或“阶段结论”。 +- 没有日期的文档应尽量只用于长期有效的稳定说明。 +- 如果文档已经明显是阶段性材料,不要再继续使用无日期命名。 + +## 6. 索引维护规则 + +每次新增或退役正式文档时,至少同步更新以下其中之一: + +- `README.md` +- `docs/INDEX.md` + +推荐规则: + +- 新的正式文档进入 `docs/` 根目录时,必须决定是否加入 `docs/INDEX.md` +- 文档失效时,必须从“当前有效”区移除 +- 被取代文档如仍需保留,应移动到 `docs/archive/` + +## 7. 语言与编码规则 + +### 7.1 文档语言 + +当前项目以中文工程文档为主,这没有问题。 + +但为了降低终端编码、跨环境协作和代码审阅成本,建议: + +- 代码注释与 docstring:默认使用 English +- 用户界面文案:可继续使用中文 +- 面向本地团队的正式说明文档:可使用中文 +- 如同一主题同时涉及代码约束与面向用户的描述,优先让代码侧说明保持 English + +### 7.2 编码 + +文本文件建议统一使用: + +- UTF-8 +- 尽量无 BOM + +如果 PowerShell 中看到乱码,不应立即判断源码损坏。应先: + +1. 在编辑器中确认文件实际编码 +2. 再决定是否需要修复源文件 + +## 8. `INIT.md` 的定位 + +`INIT.md` 视为“开发/运维工作笔记”,不是系统架构、部署或运行事实的最高依据。 + +使用原则: + +- 可以记录当前机器、本轮修复、局部操作注意事项 +- 不应替代 `README.md` 和 `docs/INDEX.md` +- 如果其中内容已经成为长期规则,应迁移到正式文档中 + +## 9. 当前建议的下一步整理方向 + +后续文档清理建议按以下顺序推进: + +1. 保持 `README.md` 与 `docs/INDEX.md` 为主导航入口 +2. 将明确失效的阶段性文档继续迁入 `docs/archive/` +3. 收紧 `docs/` 根目录,只保留当前仍需导航的文档 +4. 逐步减少无明确角色的过程型文件 diff --git a/docs/INDEX.md b/docs/INDEX.md index 56bd9f9..a82cdf6 100644 --- a/docs/INDEX.md +++ b/docs/INDEX.md @@ -1,18 +1,21 @@ # 文档索引 -本索引用来区分“当前有效文档”和“历史参考文档”。 +本页用于区分“当前有效文档”和“历史参考文档”。 原则: -- 以本页列为“当前有效”的文档,才作为现网架构、部署和运维的事实依据。 -- 没有列入“当前有效”区域的文档,默认只作为设计过程记录或历史参考。 -- 旧文档即使仍保留在 `docs/` 根目录,也不代表它仍然描述当前系统。 +- 只有列在“当前有效”区域的文档,才作为现网架构、部署、运维和产品边界的事实依据。 +- 没有列入“当前有效”区域的材料,默认只作为设计过程记录、阶段性任务单或历史参考。 +- 历史文档即使还保留在仓库中,也不应被当作当前系统的真实规则。 ## 1. 当前有效 - [../README.md](../README.md) 项目总览、当前架构和启动入口。 +- [DOCUMENTATION_GOVERNANCE.md](DOCUMENTATION_GOVERNANCE.md) + 文档治理约定,定义事实来源优先级、命名规则、归档规则与语言/编码约束。 + - [CURRENT_STATUS_20260425.md](CURRENT_STATUS_20260425.md) 2026-04-25 的项目状态快照,包含结果目录、运行时、健康检查摘要。 @@ -22,6 +25,9 @@ - [DATABASE_SELF_MAINTENANCE_AUDIT_20260425.md](DATABASE_SELF_MAINTENANCE_AUDIT_20260425.md) 当前数据库自维护机制与现场数据库一致性审计结果。 +- [CODEBASE_CLEANUP_AUDIT_20260425.md](CODEBASE_CLEANUP_AUDIT_20260425.md) + 代码库清理审计,记录过渡文件、文档治理和编码显示问题的判定结果。 + - [PROJ_CONFIGURATION.md](PROJ_CONFIGURATION.md) PROJ / GDAL 相关专项配置说明。 @@ -39,9 +45,6 @@ - [ISCE2_PRODUCTION_RELIABILITY_HARDENING_DESIGN_20260424.md](ISCE2_PRODUCTION_RELIABILITY_HARDENING_DESIGN_20260424.md) ISCE2 生产链路稳定性修补与约束。 -- [DINSAR_ENHANCEMENT_TASKS.md](DINSAR_ENHANCEMENT_TASKS.md) - D-InSAR 生产相关任务清单。 - ## 3. 时序 InSAR / SBAS - [ISCE2_SBAS_TIMESERIES_DESIGN.md](ISCE2_SBAS_TIMESERIES_DESIGN.md) @@ -51,38 +54,56 @@ - 当前前端顶级显示名已经统一为“时序 InSAR”。 - 当前默认接入仍然是 SBAS 路径,因此这两份文档仍然有效。 -- `SBAS_*` 命名的一批旧文档大多是阶段性设计材料,不再作为总事实来源。 +- `SBAS_*` 命名的一批旧文档已经归档,只保留历史追溯价值。 ## 4. 配对与前端导航 - [PAIRING_ENHANCEMENT_DESIGN.md](PAIRING_ENHANCEMENT_DESIGN.md) -- [PAIRING_SYSTEM_REFACTOR_PLAN_20260413.md](PAIRING_SYSTEM_REFACTOR_PLAN_20260413.md) - [FRONTEND_NAVIGATION_ARCHITECTURE.md](FRONTEND_NAVIGATION_ARCHITECTURE.md) -## 5. Gamma / PyINT / WSL 预留 +说明: + +- `PAIRING_ENHANCEMENT_DESIGN.md` 保留配对语义、策略命名和产品交互边界设计价值。 +- 当前 pairing cache 的运行态事实,以 `CURRENT_STATUS_20260425.md` 和 `DATABASE_SELF_MAINTENANCE_AUDIT_20260425.md` 为准。 + +## 5. Gamma / PyINT -- [GAMMA_WSL2_INTEGRATION_PLAN.md](GAMMA_WSL2_INTEGRATION_PLAN.md) - [PYINT_GAMMA_INTEGRATION_DESIGN_20260418.md](PYINT_GAMMA_INTEGRATION_DESIGN_20260418.md) - [PYINT_INPUT_ASSET_ADAPTATION_DESIGN_20260419.md](PYINT_INPUT_ASSET_ADAPTATION_DESIGN_20260419.md) +- [PYINT_LT1_PRECISE_ORBIT_BRIDGE_DESIGN_20260419.md](PYINT_LT1_PRECISE_ORBIT_BRIDGE_DESIGN_20260419.md) - [PYINT_GAMMA_AB_FINDINGS_20260420.md](PYINT_GAMMA_AB_FINDINGS_20260420.md) 说明: -- 这部分主要作为 Gamma / PyINT 接入的预留设计和实验记录。 -- 真正的当前运行时事实,以 `WSL_RUNTIME_REFACTOR_DESIGN_20260422.md`、`.env` 和健康面板为准。 +- 这部分保留当前仍有导航价值的 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](SECURITY_AUDIT_2026-03-12.md) -## 7. 历史参考 +## 7. 工作笔记 + +- [../INIT.md](../INIT.md) + +说明: + +- `INIT.md` 视为工作笔记,不是架构、部署和运行事实的最高依据。 +- 需要判断“当前真实规则”时,优先看 `README.md`、本页和长期有效文档。 + +## 8. 历史参考 以下材料默认视为历史设计记录或过程文档: +- [archive/INDEX.md](archive/INDEX.md) - `docs/archive/` -- `SBAS_*` -- `WSL2_ISCE2_MINTPY_SBAS_INTEGRATION_PLAN_20260412.md` -- `项目汇报.md` -- 各类 `*_EXPERIMENT_*` / `*_PROGRESS_*` / `*_TODO_*` +- 已归档的 `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-25 +最后更新:2026-04-26 diff --git a/docs/PAIRING_ENHANCEMENT_DESIGN.md b/docs/PAIRING_ENHANCEMENT_DESIGN.md index fc72ee8..6c7ce0d 100644 --- a/docs/PAIRING_ENHANCEMENT_DESIGN.md +++ b/docs/PAIRING_ENHANCEMENT_DESIGN.md @@ -2,13 +2,15 @@ **版本**: v2.0 **日期**: 2026-03-08 -**状态**: 设计阶段 +**状态**: 概念设计,部分能力已落地 + +> 更新说明(2026-04-26):截至 2026-04-25,pairing cache、pairing health 状态和基础指标统计已经在现网落地。当前运行态事实请优先参考 `CURRENT_STATUS_20260425.md`、`DATABASE_SELF_MAINTENANCE_AUDIT_20260425.md` 和健康检查接口;本文档保留配对语义、策略命名、产品交互和后续演进方向的设计价值。 --- ## 一、背景与目标 -### 1.1 现有系统局限 +### 1.1 设计起点(2026-03-08 基线) 当前配对系统采用**单池全组合**模式: - 所有影像放入同一个池子,两两组合,用时间基线范围过滤 diff --git a/docs/archive/AI_ANALYSIS_REDESIGN.md b/docs/archive/AI_ANALYSIS_REDESIGN.md index 5e195d1..fd92489 100644 --- a/docs/archive/AI_ANALYSIS_REDESIGN.md +++ b/docs/archive/AI_ANALYSIS_REDESIGN.md @@ -164,7 +164,7 @@ GET /api/ai-diagnosis?page=1&limit=20&result_id=123&risk_level=HIGH&sort=-create GET /api/ai-diagnosis/{id} ``` -**响��**: +**响应**: ```json { "id": 42, diff --git a/docs/DINSAR_ENHANCEMENT_TASKS.md b/docs/archive/DINSAR_ENHANCEMENT_TASKS.md similarity index 100% rename from docs/DINSAR_ENHANCEMENT_TASKS.md rename to docs/archive/DINSAR_ENHANCEMENT_TASKS.md diff --git a/docs/archive/ENVI_Integration_Notes.md b/docs/archive/ENVI_Integration_Notes.md index 189a594..6352772 100644 --- a/docs/archive/ENVI_Integration_Notes.md +++ b/docs/archive/ENVI_Integration_Notes.md @@ -121,7 +121,7 @@ |------|------| | `backend/app/services/envi_service.py` | ENVI 工作流核心(6 步流程、GCP 生成、文件稳定等待) | | `backend/app/services/envi_runner_cli.py` | 子进程入口(加载 .env、调用 run_workflow) | -| `backend/app/services/job_handlers.py` | Job handler(子进程监控、keepalive、文件稳定检查��� | +| `backend/app/services/job_handlers.py` | Job handler(子进程监控、keepalive、文件稳定检查) | | `backend/app/services/job_worker.py` | Worker 主循环(心跳、stale 检测) | | `backend/app/services/task_service.py` | Task 管理(僵尸检测在 get_active_tasks 中) | | `backend/app/routers/tasks.py` | Task API(含 force-cancel 端点) | diff --git a/docs/GAMMA_WSL2_INTEGRATION_PLAN.md b/docs/archive/GAMMA_WSL2_INTEGRATION_PLAN.md similarity index 100% rename from docs/GAMMA_WSL2_INTEGRATION_PLAN.md rename to docs/archive/GAMMA_WSL2_INTEGRATION_PLAN.md diff --git a/docs/archive/INDEX.md b/docs/archive/INDEX.md new file mode 100644 index 0000000..95ac613 --- /dev/null +++ b/docs/archive/INDEX.md @@ -0,0 +1,85 @@ +# 历史文档索引 + +最后更新:2026-04-26 + +本页用于组织 `docs/archive/` 下的历史文档。 + +原则: + +- 本目录中的材料默认不作为当前系统事实来源。 +- 它们保留用于追溯设计演进、阶段性判断和历史决策背景。 +- 当前真实规则优先看: + - [../../README.md](../../README.md) + - [../INDEX.md](../INDEX.md) + - [../DOCUMENTATION_GOVERNANCE.md](../DOCUMENTATION_GOVERNANCE.md) + +## 1. 2026-04-26 归档批次 + +### 1.1 旧 Gamma 直连方案 + +- [GAMMA_WSL2_INTEGRATION_PLAN.md](GAMMA_WSL2_INTEGRATION_PLAN.md) + +说明: + +- 这份文档描述的是旧的 `/idl/jobs/dinsar` + 独立 Gamma service / status 端点方案。 +- 当前代码和文档已经转向多引擎生产中心、共享 WSL 运行时和 `pyint`/Gamma 集成路径,因此该文档只保留历史参考价值。 + +### 1.2 旧配对重构计划与任务板 + +- [PAIRING_SYSTEM_REFACTOR_PLAN_20260413.md](PAIRING_SYSTEM_REFACTOR_PLAN_20260413.md) +- [DINSAR_ENHANCEMENT_TASKS.md](DINSAR_ENHANCEMENT_TASKS.md) + +说明: + +- 这两份材料保留分阶段计划和当时边界判断的价值,但不再作为当前系统事实来源。 +- 当前 pairing 运行态事实以 `CURRENT_STATUS_20260425.md`、`DATABASE_SELF_MAINTENANCE_AUDIT_20260425.md` 和健康检查为准。 +- 当前 D-InSAR 生产设计以 `PRODUCTION_RESULTS_MULTI_ENGINE_DESIGN_20260423.md`、`ISCE2_MANAGED_DINSAR_IMPLEMENTATION_20260424.md`、`ISCE2_PRODUCTION_RELIABILITY_HARDENING_DESIGN_20260424.md` 为准。 + +## 2. 2026-04-25 归档批次 + +### 2.1 SBAS 阶段文档 + +- [SBAS_FRONTEND_UX_SPEC_20260406.md](SBAS_FRONTEND_UX_SPEC_20260406.md) +- [SBAS_IMPLEMENTATION_TODO_20260406.md](SBAS_IMPLEMENTATION_TODO_20260406.md) +- [SBAS_PROGRESS_STATUS_20260406.md](SBAS_PROGRESS_STATUS_20260406.md) +- [SBAS_RESULT_MANAGEMENT_AND_DISPLAY_SPEC_20260406.md](SBAS_RESULT_MANAGEMENT_AND_DISPLAY_SPEC_20260406.md) +- [SBAS_SYSTEM_CHANGE_RISK_ASSESSMENT_20260406.md](SBAS_SYSTEM_CHANGE_RISK_ASSESSMENT_20260406.md) +- [SBAS_SYSTEM_EMBEDDING_DESIGN_20260406.md](SBAS_SYSTEM_EMBEDDING_DESIGN_20260406.md) +- [SBAS_SYSTEM_INTEGRATION_AUDIT_20260406.md](SBAS_SYSTEM_INTEGRATION_AUDIT_20260406.md) +- [SBAS_TASK_PATH_MODE_EVALUATION_20260406.md](SBAS_TASK_PATH_MODE_EVALUATION_20260406.md) + +说明: + +- 这批文档描述的是时序 InSAR / SBAS 接入初期的阶段方案。 +- 当前仍有效的时序主文档保留在 `docs/` 根目录: + - [../ISCE2_SBAS_TIMESERIES_DESIGN.md](../ISCE2_SBAS_TIMESERIES_DESIGN.md) + - [../ISCE2_SBAS_PRODUCT_SPEC.md](../ISCE2_SBAS_PRODUCT_SPEC.md) + +### 2.2 旧集成方案与汇报材料 + +- [WSL2_ISCE2_MINTPY_SBAS_INTEGRATION_PLAN_20260412.md](WSL2_ISCE2_MINTPY_SBAS_INTEGRATION_PLAN_20260412.md) +- [项目汇报.md](项目汇报.md) + +### 2.3 PyINT 过程型材料 + +- [PYINT_GAMMA_IMPLEMENTATION_TODO_20260418.md](PYINT_GAMMA_IMPLEMENTATION_TODO_20260418.md) +- [PYINT_LT1_COREG_ORBIT_HYPOTHESIS_EXPERIMENT_20260420.md](PYINT_LT1_COREG_ORBIT_HYPOTHESIS_EXPERIMENT_20260420.md) +- [PYINT_LT1_DEM_GEOMETRY_CHAIN_EXPERIMENT_20260420.md](PYINT_LT1_DEM_GEOMETRY_CHAIN_EXPERIMENT_20260420.md) +- [PYINT_LT1_DEM_SOURCE_EXPERIMENT_RESULTS_20260420.md](PYINT_LT1_DEM_SOURCE_EXPERIMENT_RESULTS_20260420.md) +- [PYINT_LT1_PAIR_SELECTION_EXPERIMENT_20260421.md](PYINT_LT1_PAIR_SELECTION_EXPERIMENT_20260421.md) + +说明: + +- 这批文档保留实验和实施过程价值,但不再放在主导航中。 +- 当前仍有导航价值的 PyINT 文档保留在 `docs/` 根目录。 + +## 3. 更早的历史文档 + +本目录还保留以下较早批次的历史材料: + +- 安全审计与修复过程 +- 热修复记录 +- 旧版 AI / ENVI / 日志管理设计 +- 历史 TODO 与阶段性工作单 + +如需判断它们是否仍然有效,以 `docs/INDEX.md` 的“当前有效”区为准。 diff --git a/docs/PAIRING_SYSTEM_REFACTOR_PLAN_20260413.md b/docs/archive/PAIRING_SYSTEM_REFACTOR_PLAN_20260413.md similarity index 100% rename from docs/PAIRING_SYSTEM_REFACTOR_PLAN_20260413.md rename to docs/archive/PAIRING_SYSTEM_REFACTOR_PLAN_20260413.md diff --git a/docs/PYINT_GAMMA_IMPLEMENTATION_TODO_20260418.md b/docs/archive/PYINT_GAMMA_IMPLEMENTATION_TODO_20260418.md similarity index 100% rename from docs/PYINT_GAMMA_IMPLEMENTATION_TODO_20260418.md rename to docs/archive/PYINT_GAMMA_IMPLEMENTATION_TODO_20260418.md diff --git a/docs/PYINT_LT1_COREG_ORBIT_HYPOTHESIS_EXPERIMENT_20260420.md b/docs/archive/PYINT_LT1_COREG_ORBIT_HYPOTHESIS_EXPERIMENT_20260420.md similarity index 100% rename from docs/PYINT_LT1_COREG_ORBIT_HYPOTHESIS_EXPERIMENT_20260420.md rename to docs/archive/PYINT_LT1_COREG_ORBIT_HYPOTHESIS_EXPERIMENT_20260420.md diff --git a/docs/PYINT_LT1_DEM_GEOMETRY_CHAIN_EXPERIMENT_20260420.md b/docs/archive/PYINT_LT1_DEM_GEOMETRY_CHAIN_EXPERIMENT_20260420.md similarity index 100% rename from docs/PYINT_LT1_DEM_GEOMETRY_CHAIN_EXPERIMENT_20260420.md rename to docs/archive/PYINT_LT1_DEM_GEOMETRY_CHAIN_EXPERIMENT_20260420.md diff --git a/docs/PYINT_LT1_DEM_SOURCE_EXPERIMENT_RESULTS_20260420.md b/docs/archive/PYINT_LT1_DEM_SOURCE_EXPERIMENT_RESULTS_20260420.md similarity index 100% rename from docs/PYINT_LT1_DEM_SOURCE_EXPERIMENT_RESULTS_20260420.md rename to docs/archive/PYINT_LT1_DEM_SOURCE_EXPERIMENT_RESULTS_20260420.md diff --git a/docs/PYINT_LT1_PAIR_SELECTION_EXPERIMENT_20260421.md b/docs/archive/PYINT_LT1_PAIR_SELECTION_EXPERIMENT_20260421.md similarity index 100% rename from docs/PYINT_LT1_PAIR_SELECTION_EXPERIMENT_20260421.md rename to docs/archive/PYINT_LT1_PAIR_SELECTION_EXPERIMENT_20260421.md diff --git a/docs/SBAS_FRONTEND_UX_SPEC_20260406.md b/docs/archive/SBAS_FRONTEND_UX_SPEC_20260406.md similarity index 100% rename from docs/SBAS_FRONTEND_UX_SPEC_20260406.md rename to docs/archive/SBAS_FRONTEND_UX_SPEC_20260406.md diff --git a/docs/SBAS_IMPLEMENTATION_TODO_20260406.md b/docs/archive/SBAS_IMPLEMENTATION_TODO_20260406.md similarity index 100% rename from docs/SBAS_IMPLEMENTATION_TODO_20260406.md rename to docs/archive/SBAS_IMPLEMENTATION_TODO_20260406.md diff --git a/docs/SBAS_PROGRESS_STATUS_20260406.md b/docs/archive/SBAS_PROGRESS_STATUS_20260406.md similarity index 100% rename from docs/SBAS_PROGRESS_STATUS_20260406.md rename to docs/archive/SBAS_PROGRESS_STATUS_20260406.md diff --git a/docs/SBAS_RESULT_MANAGEMENT_AND_DISPLAY_SPEC_20260406.md b/docs/archive/SBAS_RESULT_MANAGEMENT_AND_DISPLAY_SPEC_20260406.md similarity index 100% rename from docs/SBAS_RESULT_MANAGEMENT_AND_DISPLAY_SPEC_20260406.md rename to docs/archive/SBAS_RESULT_MANAGEMENT_AND_DISPLAY_SPEC_20260406.md diff --git a/docs/SBAS_SYSTEM_CHANGE_RISK_ASSESSMENT_20260406.md b/docs/archive/SBAS_SYSTEM_CHANGE_RISK_ASSESSMENT_20260406.md similarity index 100% rename from docs/SBAS_SYSTEM_CHANGE_RISK_ASSESSMENT_20260406.md rename to docs/archive/SBAS_SYSTEM_CHANGE_RISK_ASSESSMENT_20260406.md diff --git a/docs/SBAS_SYSTEM_EMBEDDING_DESIGN_20260406.md b/docs/archive/SBAS_SYSTEM_EMBEDDING_DESIGN_20260406.md similarity index 100% rename from docs/SBAS_SYSTEM_EMBEDDING_DESIGN_20260406.md rename to docs/archive/SBAS_SYSTEM_EMBEDDING_DESIGN_20260406.md diff --git a/docs/SBAS_SYSTEM_INTEGRATION_AUDIT_20260406.md b/docs/archive/SBAS_SYSTEM_INTEGRATION_AUDIT_20260406.md similarity index 100% rename from docs/SBAS_SYSTEM_INTEGRATION_AUDIT_20260406.md rename to docs/archive/SBAS_SYSTEM_INTEGRATION_AUDIT_20260406.md diff --git a/docs/SBAS_TASK_PATH_MODE_EVALUATION_20260406.md b/docs/archive/SBAS_TASK_PATH_MODE_EVALUATION_20260406.md similarity index 100% rename from docs/SBAS_TASK_PATH_MODE_EVALUATION_20260406.md rename to docs/archive/SBAS_TASK_PATH_MODE_EVALUATION_20260406.md diff --git a/docs/WSL2_ISCE2_MINTPY_SBAS_INTEGRATION_PLAN_20260412.md b/docs/archive/WSL2_ISCE2_MINTPY_SBAS_INTEGRATION_PLAN_20260412.md similarity index 100% rename from docs/WSL2_ISCE2_MINTPY_SBAS_INTEGRATION_PLAN_20260412.md rename to docs/archive/WSL2_ISCE2_MINTPY_SBAS_INTEGRATION_PLAN_20260412.md diff --git a/docs/项目汇报.md b/docs/archive/项目汇报.md similarity index 100% rename from docs/项目汇报.md rename to docs/archive/项目汇报.md