diff --git a/docs/adr/ADR-017-modularization-cleanup-roadmap.md b/docs/adr/ADR-017-modularization-cleanup-roadmap.md index 76511e7..a1aeecb 100644 --- a/docs/adr/ADR-017-modularization-cleanup-roadmap.md +++ b/docs/adr/ADR-017-modularization-cleanup-roadmap.md @@ -21,6 +21,16 @@ Phase 3e(4/28-29)完成 app.py 7,386→6,590 行(-10.8%),但**僅完 | 模板統一 | ~50% | 三目錄並存 + 1 空檔 + 3 死檔 + 2 TemplateNotFound 風險 | | DB schema vs Model | ~60% | manager.py import 漏 3 模組;6 張表有 SQL 無 ORM;realtime_sales_monthly 孤兒 | +## 實作狀態補記(2026-05-13) + +上表是 2026-04-29 立案時的盤點基線;後續整改已把多個 HIGH 項目落地並加上回歸守門: + +- `app.py` 已收斂為 Flask bootstrap / Blueprint registration / 啟動自檢,active `@app.route` 為 0,並由 `tests/test_phase3f_cleanup_contracts.py::test_app_py_stays_blueprint_only_for_routes` 守住。 +- 舊 `USE_MODULAR_ROUTES`、`register_blueprints()`、`MODULAR_ENDPOINTS`、duplicate cleanup shim 已移除;`routes/__init__.py` 僅保留 package docstring。 +- DB metadata / migration 覆蓋已由 `tests/test_migration_metadata_coverage.py` 與啟動自檢守住,v5 observability / Market Intel 等表不再只靠手動口述。 +- 模板路徑已收斂為 `templates/` 與 `web/templates/vendor_stockout/`;根層 placeholder `templates/list.html` 已刪除並有測試防回歸。 +- 大檔治理仍未結案:`routes/openclaw_bot_routes.py`、`routes/admin_observability_routes.py`、`routes/sales_routes.py`、`scheduler.py` 仍超過 800 行,後續只能做 bugfix、安全修補或往外抽模組。 + ## 決策 執行 **Phase 3f 五階段收尾**,總工期估 12-15 小時(不含驗證),每階段獨立 commit、每階段 critic 審查、每階段先 SSH 驗證 production。