From 49653667fbbcb8e386e1fdc57cc2dda6e0547d91 Mon Sep 17 00:00:00 2001 From: wpdev Date: Fri, 31 Jul 2026 05:57:04 +0800 Subject: [PATCH] =?UTF-8?q?docs(plan):=20=E6=A8=99=E8=A8=98=E9=9A=8E?= =?UTF-8?q?=E6=AE=B5=203=20=E5=AE=8C=E6=88=90=EF=BC=8C=E8=A3=9C=204=20?= =?UTF-8?q?=E6=A2=9D=20lessons=20learned?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_01TbG1keQQ7XBa7qMQY16KCY --- PLAN.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/PLAN.md b/PLAN.md index 3c3d5c5..4c326c8 100644 --- a/PLAN.md +++ b/PLAN.md @@ -205,7 +205,7 @@ | 0 | 回歸網：composer dev 依賴、test bootstrap FSM guard、`failOnWarning=true`、12 個 repo `git init` | ✅ 2026-07-31（unit 379 / integration 398 全綠） | | 1 | 安全與正確性 A1–A14（13 個 admin GET→POST、REST allowlist、DDL 白名單、Logger 3-arity fatal…） | ✅ 2026-07-31 | | 2 | DDL 與並發 B1–B4（warm UNIQUE KEY → Zone_Cold save_patch → Zone_Warm increment） | ✅ 2026-07-31 | -| 3 | 架構回填（Zone_Router + Routing_Predicate；13 個 Migration Phase 類別） | ⬜ | +| 3 | 架構回填（Zone_Router + Routing_Predicate；13 個 Migration Phase 類別） | ✅ 2026-07-31 | | 4 | 相容層 E1–E7（雙向 hook 橋、67 個 AddOn alias、38 個 CLI 子指令、選單 slug redirect） | ⬜ | | 5 | AddOn 同步 F1–F5（Standard_Post_Interceptor、HP detector v3.4.5、WC） | ⬜ | | 6 | 功能與診斷 PR-G（crypto 健檢、doctor_callback ABI、15 個 usermeta 欄位…） | ⬜ | @@ -223,6 +223,9 @@ 2. `A/admin/class-wpdo-dashboard-widget.php:191` 的 `wpdo_postmeta_cleanup` 仍是 `wp_nonce_url` GET 連結，但其 handler 已只收 POST → 該按鈕在 A 是壞的。B 改成 form。 - B 有 7 處 `Logger::error( 'event', array(...) )` 兩參數呼叫（4 個 stress tester、auto-promoter、conflict-detector、hook-bus），全部是 array→string 的 TypeError。用 token 掃描器（`scan_logger.php`）找出來的，肉眼與 grep 都容易漏。 - `Zone_Warm::set()` 改 upsert 後，**測試表也要有 `UNIQUE KEY ui_post_meta`**，否則 integration 會出現「set 沒覆蓋舊值」的假失敗。 +- **B 的 unit bootstrap 會載入 `Member_Fields` / `Post_Fields`，A 的不會**。這使 Entity_Registry 在測試啟動時就有註冊 group，從 A 移植過來、假設「registry 為空」的測試（`MigrationPhaseRemainingTest`）會真的走進 `dbDelta` 而爆掉。修法是在該測試 setUp 以 reflection 清空 registry **並移除 `wpdo_register_entity_fields` listener**（phase 內部會再 fire 一次）。 +- **快取類重構必定連帶測試隔離工作**：`Routing_Predicate::flush_cache()`（SyncBridgeEntityGuardTest）與 `Schema_Manager::flush_table_exists_cache()`（PostMigrationTest / PostEntityLifecycleTest）兩處都是 A 事後才補的，移植時要一起帶，否則出現「表被 drop 但快取說還在」的假錯誤。 +- **PHP 無法 `class_alias()` 介面**。`WPDO_Migration_Phase_Interface` 沒有雙向 alias 的乾淨解法（單向 `extends` wrapper 無法讓 `instanceof` 成立），該契約是核心內部擴充點，測試改用 `TMDO_` 正式名稱即可。 ---