diff --git a/README.md b/README.md index 6360977..017b989 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ > 一套面向人工服务运营的高考志愿填报系统：管理后台、订单/分享/渠道同步、AI 审核链路已成形；用户端 Web 自助闭环仍在推进中。 > > 当前真相源：`docs/CURRENT_STATE.md` → `docs/ACTIVE_EXECUTION_BOARD_2026-06-17.md` -> 历史归档报告：`docs/FINAL_COMPLETION_REPORT_2026-06-13.md` +> 历史归档报告：`docs/archive/2026-06-historical-snapshots/FINAL_COMPLETION_REPORT_2026-06-13.md` > > 当前项目定位：人工服务运营增强系统；用户端 Web 自助闭环仅为本地 MVP/目标态，不是完整用户端 Web 自助产品。 diff --git a/docs/ACTIVE_EXECUTION_BOARD_2026-06-13.md b/docs/ACTIVE_EXECUTION_BOARD_2026-06-13.md index b70f20f..0334e50 100644 --- a/docs/ACTIVE_EXECUTION_BOARD_2026-06-13.md +++ b/docs/ACTIVE_EXECUTION_BOARD_2026-06-13.md @@ -246,8 +246,8 @@ Owner: docs / PM 交付物: - 补丁更新以下文档头部说明： - - `docs/AUDIT_REPORT_2026-06-11.md` - - `docs/REMEDIATION_TASK_BOARD_2026-06-11.md` + - `docs/archive/2026-06-historical-snapshots/AUDIT_REPORT_2026-06-11.md` + - `docs/archive/2026-06-historical-snapshots/REMEDIATION_TASK_BOARD_2026-06-11.md` - `reports/PROJECT_SYSTEM_REVIEW_2026-06-13.md` 完成标准: diff --git a/docs/ACTIVE_REMEDIATION_2026-06-13.md b/docs/ACTIVE_REMEDIATION_2026-06-13.md index df505c0..a78b856 100644 --- a/docs/ACTIVE_REMEDIATION_2026-06-13.md +++ b/docs/ACTIVE_REMEDIATION_2026-06-13.md @@ -239,8 +239,8 @@ 已解决： -- `docs/AUDIT_REPORT_2026-06-11.md` 已标注历史快照 -- `docs/REMEDIATION_TASK_BOARD_2026-06-11.md` 已标注历史快照 +- `docs/archive/2026-06-historical-snapshots/AUDIT_REPORT_2026-06-11.md` 已标注历史快照 +- `docs/archive/2026-06-historical-snapshots/REMEDIATION_TASK_BOARD_2026-06-11.md` 已标注历史快照 - `reports/PROJECT_SYSTEM_REVIEW_2026-06-13.md` 已标注历史快照与真相源跳转 仍缺： diff --git a/docs/CURRENT_STATE.md b/docs/CURRENT_STATE.md index c42358c..6ebdeca 100644 --- a/docs/CURRENT_STATE.md +++ b/docs/CURRENT_STATE.md @@ -208,7 +208,7 @@ ## 7. 推荐阅读顺序 1. docs/CURRENT_STATE.md -2. docs/FINAL_COMPLETION_REPORT_2026-06-13.md +2. docs/archive/2026-06-historical-snapshots/FINAL_COMPLETION_REPORT_2026-06-13.md 3. product/PRD.md 4. product/ROADMAP.md 5. docs/IMPLEMENTATION_PLAN_v2.md diff --git a/docs/IMPLEMENTATION_PLAN_v2.md b/docs/IMPLEMENTATION_PLAN_v2.md index fdf7933..053f2fd 100644 --- a/docs/IMPLEMENTATION_PLAN_v2.md +++ b/docs/IMPLEMENTATION_PLAN_v2.md @@ -34,8 +34,8 @@ ### 关联文档 -- [AUDIT_REPORT_2026-06-11.md](../AUDIT_REPORT_2026-06-11.md) -- [REMEDIATION_TASK_BOARD_2026-06-11.md](../REMEDIATION_TASK_BOARD_2026-06-11.md) +- [AUDIT_REPORT_2026-06-11.md](archive/2026-06-historical-snapshots/AUDIT_REPORT_2026-06-11.md) +- [REMEDIATION_TASK_BOARD_2026-06-11.md](archive/2026-06-historical-snapshots/REMEDIATION_TASK_BOARD_2026-06-11.md) --- @@ -424,8 +424,8 @@ jobs: ## 相关文档 -- [AUDIT_REPORT](../AUDIT_REPORT_2026-06-11.md) - 审核报告 -- [REMEDIATION_TASK_BOARD](../REMEDIATION_TASK_BOARD_2026-06-11.md) - 任务板 +- [AUDIT_REPORT](archive/2026-06-historical-snapshots/AUDIT_REPORT_2026-06-11.md) - 审核报告 +- [REMEDIATION_TASK_BOARD](archive/2026-06-historical-snapshots/REMEDIATION_TASK_BOARD_2026-06-11.md) - 任务板 - [TECH_ARCHITECTURE](../TECH_ARCHITECTURE.md) - 技术架构 - [PRD](../../product/PRD.md) - 产品需求 diff --git a/docs/NAVIGATION.md b/docs/NAVIGATION.md index 4996124..1417fde 100644 --- a/docs/NAVIGATION.md +++ b/docs/NAVIGATION.md @@ -64,9 +64,6 @@ | [PRODUCTION_DEPLOYMENT_CHECKLIST_2026-06-15.md](PRODUCTION_DEPLOYMENT_CHECKLIST_2026-06-15.md) | 线上部署与真实配置注入清单 🆕 | | [IMPLEMENTATION_PLAN.md](IMPLEMENTATION_PLAN.md) | v2.1实施计划 v1.0 | | [IMPLEMENTATION_PLAN_v2.md](IMPLEMENTATION_PLAN_v2.md) | v2.1实施计划 v2.0（修订版）🆕 | -| [AUDIT_REPORT_2026-06-11.md](AUDIT_REPORT_2026-06-11.md) | 历史审核报告（6/11快照） | -| [REMEDIATION_TASK_BOARD_2026-06-11.md](REMEDIATION_TASK_BOARD_2026-06-11.md) | 历史修复任务板（6/11快照） | -| [FINAL_COMPLETION_REPORT_2026-06-13.md](FINAL_COMPLETION_REPORT_2026-06-13.md) | 历史完成报告（6/13口径） | | [plans/](plans/) | 详细任务计划 🆕 | ### 🗃️ 历史归档（docs/archive/） @@ -75,6 +72,9 @@ | ------------------------------------------------------------ | ---------------------------- | | [archive/README.md](archive/README.md) | 历史归档总索引 | | [archive/2026-06-historical-snapshots/README.md](archive/2026-06-historical-snapshots/README.md) | 6 月历史快照索引 | +| [archive/2026-06-historical-snapshots/AUDIT_REPORT_2026-06-11.md](archive/2026-06-historical-snapshots/AUDIT_REPORT_2026-06-11.md) | 历史审核报告（6/11快照） | +| [archive/2026-06-historical-snapshots/REMEDIATION_TASK_BOARD_2026-06-11.md](archive/2026-06-historical-snapshots/REMEDIATION_TASK_BOARD_2026-06-11.md) | 历史修复任务板（6/11快照） | +| [archive/2026-06-historical-snapshots/FINAL_COMPLETION_REPORT_2026-06-13.md](archive/2026-06-historical-snapshots/FINAL_COMPLETION_REPORT_2026-06-13.md) | 历史完成报告（6/13口径） | | [archive/2026-06-18-rules-cleanup/README.md](archive/2026-06-18-rules-cleanup/README.md) | 417 文件整理与规则清理记录 | ### 🔍 规则文档（rules/） diff --git a/docs/AUDIT_REPORT_2026-06-11.md b/docs/archive/2026-06-historical-snapshots/AUDIT_REPORT_2026-06-11.md similarity index 100% rename from docs/AUDIT_REPORT_2026-06-11.md rename to docs/archive/2026-06-historical-snapshots/AUDIT_REPORT_2026-06-11.md diff --git a/docs/FINAL_COMPLETION_REPORT_2026-06-13.md b/docs/archive/2026-06-historical-snapshots/FINAL_COMPLETION_REPORT_2026-06-13.md similarity index 93% rename from docs/FINAL_COMPLETION_REPORT_2026-06-13.md rename to docs/archive/2026-06-historical-snapshots/FINAL_COMPLETION_REPORT_2026-06-13.md index f3b70d4..df9d054 100644 --- a/docs/FINAL_COMPLETION_REPORT_2026-06-13.md +++ b/docs/archive/2026-06-historical-snapshots/FINAL_COMPLETION_REPORT_2026-06-13.md @@ -1,4 +1,6 @@ -# v2.1 最终完成报告 +# v2.1 最终完成报告（历史快照） + +> 该文档保留 2026-06-13 当时的结项口径，不再代表当前真实状态。当前真相源请优先阅读：`docs/CURRENT_STATE.md` → `docs/ACTIVE_EXECUTION_BOARD_2026-06-17.md` → `docs/ACTIVE_REMEDIATION_2026-06-13.md`。 生成时间: 2026-06-13 项目: /home/long/project/gaokao-volunteer-system diff --git a/docs/archive/2026-06-historical-snapshots/README.md b/docs/archive/2026-06-historical-snapshots/README.md index 6aba3a5..d5a7565 100644 --- a/docs/archive/2026-06-historical-snapshots/README.md +++ b/docs/archive/2026-06-historical-snapshots/README.md @@ -16,3 +16,12 @@ - `REMEDIATION_TASK_BOARD_2026-06-13.md` - 原路径：`docs/REMEDIATION_TASK_BOARD_2026-06-13.md` - 迁入原因：已明确标注“历史快照”，仓库内无剩余直接引用 +- `AUDIT_REPORT_2026-06-11.md` + - 原路径：`docs/AUDIT_REPORT_2026-06-11.md` + - 迁入原因：仅保留历史评审参考价值，当前执行链路已不再直接引用 +- `REMEDIATION_TASK_BOARD_2026-06-11.md` + - 原路径：`docs/REMEDIATION_TASK_BOARD_2026-06-11.md` + - 迁入原因：仅保留历史整改板参考价值，当前整改板已切换到后续执行板 +- `FINAL_COMPLETION_REPORT_2026-06-13.md` + - 原路径：`docs/FINAL_COMPLETION_REPORT_2026-06-13.md` + - 迁入原因：只保留 2026-06-13 当时的结项口径，不再作为顶层当前入口文档 diff --git a/docs/REMEDIATION_TASK_BOARD_2026-06-11.md b/docs/archive/2026-06-historical-snapshots/REMEDIATION_TASK_BOARD_2026-06-11.md similarity index 98% rename from docs/REMEDIATION_TASK_BOARD_2026-06-11.md rename to docs/archive/2026-06-historical-snapshots/REMEDIATION_TASK_BOARD_2026-06-11.md index f43a7ca..78c6527 100644 --- a/docs/REMEDIATION_TASK_BOARD_2026-06-11.md +++ b/docs/archive/2026-06-historical-snapshots/REMEDIATION_TASK_BOARD_2026-06-11.md @@ -377,9 +377,9 @@ T1.x → T2.x → T3.x → T4.x → T5.x → T6.x → T7.x（v2.2） | 文档 | 链接 | 关系 | | -------- | -------------------------------------------------------- | ------ | | 审核报告 | [AUDIT_REPORT_2026-06-11.md](AUDIT_REPORT_2026-06-11.md) | 上游 | -| 实施计划 | [IMPLEMENTATION_PLAN.md](IMPLEMENTATION_PLAN.md) | 待修订 | -| PRD | [../product/PRD.md](../product/PRD.md) | 待修订 | -| 技术架构 | [TECH_ARCHITECTURE.md](TECH_ARCHITECTURE.md) | 参考 | +| 实施计划 | [IMPLEMENTATION_PLAN.md](../../IMPLEMENTATION_PLAN.md) | 待修订 | +| PRD | [PRD.md](../../../product/PRD.md) | 待修订 | +| 技术架构 | [TECH_ARCHITECTURE.md](../../TECH_ARCHITECTURE.md) | 参考 | --- diff --git a/reports/PRODUCT_PLANNING_TECH_ALIGNMENT_REVIEW_2026-06-13.md b/reports/PRODUCT_PLANNING_TECH_ALIGNMENT_REVIEW_2026-06-13.md index af67fcb..75a0b04 100644 --- a/reports/PRODUCT_PLANNING_TECH_ALIGNMENT_REVIEW_2026-06-13.md +++ b/reports/PRODUCT_PLANNING_TECH_ALIGNMENT_REVIEW_2026-06-13.md @@ -383,7 +383,7 @@ PRD 中仍有一些表述需要更严谨： - 2026-06-15 至 2026-07-25。 - 第 1 周、第 2 周、第 3 周等未来时间表。 -但当前代码已经包含 T1-T11 大量成果，且 `docs/FINAL_COMPLETION_REPORT_2026-06-13.md` 声称 T1-T11 Goal 执行闭环条件完成。 +但当前代码已经包含 T1-T11 大量成果，且 `docs/archive/2026-06-historical-snapshots/FINAL_COMPLETION_REPORT_2026-06-13.md` 声称 T1-T11 Goal 执行闭环条件完成。 这会造成计划文档和实际状态冲突。 #### I-2: 顶层状态与子项状态仍不完全一致 @@ -402,7 +402,7 @@ PRD 中仍有一些表述需要更严谨： - `docker-compose.yml` - `tests/test_t5_e2e_workflows.py` - `tests/test_t5_performance.py` -- `docs/FINAL_COMPLETION_REPORT_2026-06-13.md` +- `docs/archive/2026-06-historical-snapshots/FINAL_COMPLETION_REPORT_2026-06-13.md` 说明实际状态比计划文档更靠前。建议将实施计划转为“计划 vs 实际”格式，不再只保留原始排期。 diff --git a/reports/PRODUCT_TECH_REVIEW_2026-06-12.md b/reports/PRODUCT_TECH_REVIEW_2026-06-12.md index eb83e6e..7f9bb11 100644 --- a/reports/PRODUCT_TECH_REVIEW_2026-06-12.md +++ b/reports/PRODUCT_TECH_REVIEW_2026-06-12.md @@ -47,7 +47,7 @@ - `docs/BUSINESS_SCENE.md` - `docs/TECH_ARCHITECTURE.md` - `docs/IMPLEMENTATION_PLAN_v2.md` -- `docs/AUDIT_REPORT_2026-06-11.md` +- `docs/archive/2026-06-historical-snapshots/AUDIT_REPORT_2026-06-11.md` ### 2.2 代码与运行时证据 diff --git a/reports/PROJECT_SYSTEM_REVIEW_2026-06-13.md b/reports/PROJECT_SYSTEM_REVIEW_2026-06-13.md index bcc4829..3e8c042 100644 --- a/reports/PROJECT_SYSTEM_REVIEW_2026-06-13.md +++ b/reports/PROJECT_SYSTEM_REVIEW_2026-06-13.md @@ -60,7 +60,7 @@ pytest -q admin/tests - 当前 pytest / ruff / mypy / bandit / coverage 输出 2. **README + CHANGELOG（部分可信）** 3. **IMPLEMENTATION_PLAN_v2 / CHANNEL_INTEGRATION（部分过时，需结合代码）** -4. **PRODUCT_TECH_REVIEW_2026-06-12 / AUDIT_REPORT_2026-06-11 / REMEDIATION_TASK_BOARD_2026-06-11（历史快照，不能直接继承为当前结论）** +4. **PRODUCT_TECH_REVIEW_2026-06-12 / archive/AUDIT_REPORT_2026-06-11 / archive/REMEDIATION_TASK_BOARD_2026-06-11（历史快照，不能直接继承为当前结论）** --- @@ -119,8 +119,8 @@ pytest -q admin/tests | 文档 | 当前判断 | | ------------------------------------------- | ---------------------------------- | -| `docs/AUDIT_REPORT_2026-06-11.md` | **严重过时** | -| `docs/REMEDIATION_TASK_BOARD_2026-06-11.md` | **严重过时** | +| `docs/archive/2026-06-historical-snapshots/AUDIT_REPORT_2026-06-11.md` | **严重过时** | +| `docs/archive/2026-06-historical-snapshots/REMEDIATION_TASK_BOARD_2026-06-11.md` | **严重过时** | | `reports/PRODUCT_TECH_REVIEW_2026-06-12.md` | **部分仍有效，但若直接继承会失真** | 仍有效的旧判断： @@ -320,5 +320,5 @@ pytest -q admin/tests ## 10. 本报告与旧报告的关系 - 本报告是 **2026-06-13 的新鲜实跑结论** -- `docs/AUDIT_REPORT_2026-06-11.md`、`docs/REMEDIATION_TASK_BOARD_2026-06-11.md`、`reports/PRODUCT_TECH_REVIEW_2026-06-12.md` 仅保留历史参考价值 +- `docs/archive/2026-06-historical-snapshots/AUDIT_REPORT_2026-06-11.md`、`docs/archive/2026-06-historical-snapshots/REMEDIATION_TASK_BOARD_2026-06-11.md`、`reports/PRODUCT_TECH_REVIEW_2026-06-12.md` 仅保留历史参考价值 - 之后若继续推进，应以本报告与新的整改任务板作为当前真相源 diff --git a/tests/test_historical_snapshot_headers.py b/tests/test_historical_snapshot_headers.py index 051cd98..c742272 100644 --- a/tests/test_historical_snapshot_headers.py +++ b/tests/test_historical_snapshot_headers.py @@ -16,6 +16,7 @@ from pathlib import Path REPO_ROOT = Path(__file__).resolve().parents[1] DOCS_DIR = REPO_ROOT / "docs" REPORTS_DIR = REPO_ROOT / "reports" +ARCHIVE_2026_06_DIR = DOCS_DIR / "archive" / "2026-06-historical-snapshots" # 每个“历史快照”文档必须满足: @@ -54,7 +55,7 @@ def _missing_pointers(head: str) -> list[str]: def test_historical_audit_reports_have_snapshot_header(): - target = DOCS_DIR / "AUDIT_REPORT_2026-06-11.md" + target = ARCHIVE_2026_06_DIR / "AUDIT_REPORT_2026-06-11.md" assert target.exists(), target head = target.read_text(encoding="utf-8") assert "历史快照" in head @@ -65,7 +66,18 @@ def test_historical_audit_reports_have_snapshot_header(): def test_historical_remediation_boards_have_snapshot_header(): - target = DOCS_DIR / "REMEDIATION_TASK_BOARD_2026-06-11.md" + target = ARCHIVE_2026_06_DIR / "REMEDIATION_TASK_BOARD_2026-06-11.md" + assert target.exists(), target + head = target.read_text(encoding="utf-8") + assert "历史快照" in head + missing = _missing_pointers(head) + assert not missing, ( + f"{target.name} 缺少真相源指针: {missing}" + ) + + +def test_historical_final_completion_report_has_snapshot_header(): + target = ARCHIVE_2026_06_DIR / "FINAL_COMPLETION_REPORT_2026-06-13.md" assert target.exists(), target head = target.read_text(encoding="utf-8") assert "历史快照" in head @@ -104,7 +116,6 @@ def test_any_new_2026_snapshot_doc_with_historical_marker_carries_pointers(): "CURRENT_STATE.md", "ACTIVE_REMEDIATION_2026-06-13.md", "ACTIVE_EXECUTION_BOARD_2026-06-13.md", - "FINAL_COMPLETION_REPORT_2026-06-13.md", "P0_P1_P2_REMEDIATION_PLAN_2026-06-14.md", } for path in DOCS_DIR.glob("*.md"):