From 2139d1213231a0e794dc9000b721af338f1a5baf Mon Sep 17 00:00:00 2001 From: jxxghp Date: Sun, 30 Aug 2026 07:19:03 +0800 Subject: [PATCH] docs(architecture): group governance documents --- docs/architecture-overview.md | 6 +++--- .../optimization-checklist.md} | 0 .../refactor-roadmap.md} | 0 tests/test_architecture_contract_baseline.py | 10 ++++++++-- 4 files changed, 11 insertions(+), 5 deletions(-) rename docs/{architecture-optimization-checklist.md => architecture/optimization-checklist.md} (100%) rename docs/{architecture-refactor-roadmap.md => architecture/refactor-roadmap.md} (100%) diff --git a/docs/architecture-overview.md b/docs/architecture-overview.md index 1b75bdc21..5d6b4830b 100644 --- a/docs/architecture-overview.md +++ b/docs/architecture-overview.md @@ -798,7 +798,7 @@ flowchart LR 保留多余导出。 当前架构问题、优先级、分阶段实施步骤与验收门禁见 -[`docs/architecture-optimization-checklist.md`](architecture-optimization-checklist.md)。 +[`docs/architecture/optimization-checklist.md`](architecture/optimization-checklist.md)。 --- @@ -814,7 +814,7 @@ flowchart LR | [`docs/rules/10-data-and-persistent.md`](rules/10-data-and-persistent.md) | 数据模型、迁移与缓存规范 | | [`docs/subscribe-lifecycle.md`](subscribe-lifecycle.md) | 订阅生命周期详解 | | [`docs/mcp-api.md`](mcp-api.md) | MCP 工具端点说明 | -| [`docs/architecture-optimization-checklist.md`](architecture-optimization-checklist.md) | 当前架构差距、优先级与可执行优化清单 | -| [`docs/architecture-refactor-roadmap.md`](architecture-refactor-roadmap.md) | 多级 Goal、叶子依赖、清零条件与交付状态 | +| [`docs/architecture/optimization-checklist.md`](architecture/optimization-checklist.md) | 当前架构差距、优先级与可执行优化清单 | +| [`docs/architecture/refactor-roadmap.md`](architecture/refactor-roadmap.md) | 多级 Goal、叶子依赖、清零条件与交付状态 | | [`docs/v3t-runtime-governance.md`](v3t-runtime-governance.md) | V3/V3t 运行依赖、故障恢复、GIL 可观测性与兼容退场门禁 | | [`docs/adr/0007-background-action-reliability.md`](adr/0007-background-action-reliability.md) | 后台动作 E0–E3 可靠性分级与完成语义决策 | diff --git a/docs/architecture-optimization-checklist.md b/docs/architecture/optimization-checklist.md similarity index 100% rename from docs/architecture-optimization-checklist.md rename to docs/architecture/optimization-checklist.md diff --git a/docs/architecture-refactor-roadmap.md b/docs/architecture/refactor-roadmap.md similarity index 100% rename from docs/architecture-refactor-roadmap.md rename to docs/architecture/refactor-roadmap.md diff --git a/tests/test_architecture_contract_baseline.py b/tests/test_architecture_contract_baseline.py index 62febecfd..74c0d3b82 100644 --- a/tests/test_architecture_contract_baseline.py +++ b/tests/test_architecture_contract_baseline.py @@ -105,10 +105,16 @@ def test_architecture_documents_match_generated_quality_metrics() -> None: encoding="utf-8" ) checklist = ( - PROJECT_ROOT / "docs" / "architecture-optimization-checklist.md" + PROJECT_ROOT + / "docs" + / "architecture" + / "optimization-checklist.md" ).read_text(encoding="utf-8") roadmap = ( - PROJECT_ROOT / "docs" / "architecture-refactor-roadmap.md" + PROJECT_ROOT + / "docs" + / "architecture" + / "refactor-roadmap.md" ).read_text(encoding="utf-8") edge_count = f"{dependency['edge_count']:,}" ruff_count = sum(