chore: initial snapshot of 2meet-data-optimizer v0.1.0

Baseline before backporting wp-data-optimizer v3.0.1-v3.4.6.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TbG1keQQ7XBa7qMQY16KCY

README.md

@@ -0,0 +1,127 @@
+# 2meet Data Optimizer
+
+> 通用 WordPress 反 EAV 引擎 — 零依賴，零 HivePress / WooCommerce / 2meet-* 綁定
+
+把 `wp_postmeta` / `wp_usermeta` / `wp_termmeta` / `wp_commentmeta` 的高頻欄位自動分流到四象限扁平表（Hot / Warm / Cold / Archive），帶來 3-30× 的查詢加速。
+
+從 [`wp-data-optimizer v2.16.0`](https://github.com/2meet/wp-data-optimizer) 提煉的純核心，整合層全部移到獨立 AddOn。
+
+---
+
+## 為什麼
+
+WordPress 預設用 EAV (Entity-Attribute-Value) 模式儲存所有 meta：每筆 meta 都是 `wp_*meta` 表的一列。對少量欄位無傷，但站台一長大就出現：
+
+- 單一 listing 可能對應數十條 postmeta → 列表頁查詢爆炸
+- meta_query 複雜過濾必須 N 次 JOIN
+- `autoload=yes` 的 wp_options 拖慢每頁載入
+- `_transient_*` 滲入 wp_options 造成持續性脹
+
+`2meet-data-optimizer` 為這些 meta 建立**扁平欄位表**（每 post_type 一張），由 Sync Bridge 雙寫，由 Query Router 改寫 `meta_query` 為直接 JOIN，達到接近原生欄位的效能。
+
+---
+
+## 四象限
+
+| Zone | 表名 | 用途 | 加速場景 |
+|---|---|---|---|
+| **A Hot** | `wp_wpdo_hot_{type}` | 搜尋 / 篩選欄位 | meta_query 過濾、ORDER BY 排序 |
+| **B Warm** | `wp_wpdo_warm` | TTL 計數 / 短期快取 | 瀏覽計數、暫時旗標 |
+| **C Cold** | `wp_wpdo_cold_{type}` | 展示 / 描述欄位 | 詳情頁讀取 |
+| **D Archive** | `wp_wpdo_archive` | 過期 gzip 歸檔 | 歷史資料保留 |
+
+---
+
+## 系統需求
+
+- WordPress ≥ 6.0
+- PHP ≥ 8.1
+- MySQL ≥ 5.7 / MariaDB ≥ 10.3 (SQLite 亦支援)
+
+---
+
+## 安裝
+
+1. 從 GitHub Release 下載 `2meet-data-optimizer-v0.1.0.zip`
+2. 在 WordPress 後台 → 外掛 → 安裝外掛 → 上傳外掛
+3. 啟用後執行 `wp tmdo doctor` 驗證
+
+---
+
+## 整合 AddOn（選用）
+
+主外掛只覆蓋 WordPress 原生 4 entity meta。若使用 HivePress / WooCommerce / LatePoint / 2meet-* 系列等外掛並希望也享有反 EAV 加速，請額外安裝對應 AddOn：
+
+| AddOn | 對應外掛 |
+|---|---|
+| `2meet-data-optimizer-hub-addon` | 2meet-hub-core |
+| `2meet-data-optimizer-spoke-addon` | 2meet-spoke-sso |
+| `2meet-data-optimizer-hivepress-addon` | hivepress + 12 HP 擴充 |
+| `2meet-data-optimizer-woocommerce-addon` | woocommerce |
+| `2meet-data-optimizer-latepoint-addon` | latepoint |
+| `2meet-data-optimizer-infocards-addon` | 2meet-infocards |
+| `2meet-data-optimizer-bookings-addon` | 2meet-bookings |
+| `2meet-data-optimizer-quotation-addon` | 2meet-quotation |
+| `2meet-data-optimizer-mobile-bridge-addon` | 2meet-mobile-bridge |
+| `2meet-data-optimizer-collab-addon` | 2meet-collab |
+| `2meet-data-optimizer-playlist-addon` | 2meet-playlist |
+
+---
+
+## WP-CLI 速查
+
+```bash
+wp tmdo status                  # 整體狀態
+wp tmdo doctor                  # 健診（schema drift / 表對齊 / index）
+wp tmdo benchmark hot_post --samples=200
+wp tmdo migrate hot_post        # 執行 backfill
+wp tmdo verify hot_post         # 比對 postmeta 與 zone 表
+wp tmdo cutover hot_post        # 讀寫切到 zone 表
+wp tmdo rollback hot_post       # 退回 postmeta
+wp tmdo cleanup --archive-expired
+```
+
+---
+
+## 公開 API（給其他外掛）
+
+```php
+// 通用 4-entity 讀寫
+TMDO_API::set_entity( 'user', $user_id, 'membership_level', 'gold' );
+$level = TMDO_API::get_entity( 'user', $user_id, 'membership_level' );
+
+// Schema 註冊
+add_action( 'tmdo_register_entity_fields', function ( $registry_class ) {
+    $registry_class::register_group( 'user', 'my_group', [
+        [ 'key' => 'my_field', 'type' => 'text', 'searchable' => true ],
+    ] );
+} );
+
+// 自訂表註冊（給其他外掛的表加入 doctor 監控）
+add_action( 'tmdo_register_custom_tables', function ( $registry ) {
+    $registry->register( 'my-plugin', [
+        'table_name' => 'my_table',
+        'primary_key' => 'id',
+        'expected_columns' => [ ... ],
+    ] );
+} );
+```
+
+向後相容：`WPDO_API` / `WPDO_Schema_Registry` 等舊類別名透過 `class_alias()` 仍可使用（`v0.2.0` 起加 deprecation notice）。
+
+---
+
+## 授權
+
+GPL-2.0-or-later
+
+---
+
+## 文件
+
+- [PLAN.md](PLAN.md) — 開發任務追蹤
+- [CHANGELOG.md](CHANGELOG.md) — 版本歷史
+- [DEPLOY.md](DEPLOY.md) — 部署流程
+- [SECURITY.md](SECURITY.md) — 安全聯絡
+- [DESIGN.md](DESIGN.md) — 架構決策
+- [CLAUDE.md](CLAUDE.md) — AI 協作指引