chore: initial snapshot of 2meet-data-optimizer-hivepress-addon 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
2026-07-31 05:06:36 +08:00
commit b4400a68e5
56 changed files with 10395 additions and 0 deletions
@@ -0,0 +1,104 @@
+# 2meet Data Optimizer — HivePress AddOn
+
+> 為 **HivePress** + 12 個官方擴充提供完整反 EAV 整合（最大 AddOn，~7,400 行）。
+
+---
+
+## What it does
+
+從 `wp-data-optimizer v2.16.0` 提煉的 HivePress 整合層，包含 13 個 adapter、7 個 HPCT 攔截器、5 個查詢攔截器、bootstrap、admin tab、CLI namespace。
+
+### 13 HP Adapter 全清單
+
+| Adapter | 對應 HP 擴充 | 行數 |
+|---|---|---:|
+| Core | hivepress | 407 |
+| Reviews | hivepress-reviews | 146 |
+| Bookings | hivepress-bookings | 159 |
+| Messages | hivepress-messages | 263 |
+| Memberships | hivepress-memberships | 169 |
+| Requests | hivepress-requests | 267 |
+| Favorites | hivepress-favorites | 234 |
+| Statistics | hivepress-statistics | 130 |
+| Tags | hivepress-tags | 84 |
+| SEO | hivepress-seo | 76 |
+| Social Links | hivepress-social-links | 115 |
+| Blocks | hivepress-blocks | 73 |
+| Marketplace | hivepress-marketplace | 135 |
+
+### 7 HPCT Interceptor
+
+reviews / messages / favorites / memberships / requests / statistics / listing-meta
+
+### 5 Query Interceptor (pre_get_posts 改寫)
+
+reviews / messages / memberships / requests / listing-meta
+
+### 額外組件
+
+- HP transient filter（`_transient_hp_*` postmeta → wp_options 路由，避免 postmeta 脹大）
+- HPCT (HP Custom Tables) import 工具（v2.0.0 取代 HPCT 之相容路徑）
+- HP attribute bridge / cron optimizer / suitability scorer / benchmark / REST
+- HivePress comment router
+
+---
+
+## Requirements
+
+- WordPress ≥ 6.0
+- PHP ≥ 8.1
+- 2meet-data-optimizer ≥ 0.1.0
+- hivepress ≥ 1.7.22 (支援 `_alias` / `_external` field convention)
+
+---
+
+## Installation
+
+```bash
+# 啟用前確認 HP 已啟用
+wp plugin list | grep hivepress
+
+# 安裝 + 啟用
+wp plugin install /path/to/2meet-data-optimizer-hivepress-addon-v0.1.0.zip --activate
+
+# 驗證 13 adapter 全 bound
+wp tmdo hivepress detect
+
+# Benchmark vs HP 預設
+wp tmdo hivepress benchmark --post-type=hp_listing --samples=200
+```
+
+---
+
+## 為什麼選擇單一 AddOn（不拆 13 sub-AddOn）
+
+| 維度 | 單一 AddOn ✓ | 13 sub-AddOn ✗ |
+|---|---|---|
+| 啟動開銷 | 一次偵測 | 13 次重複偵測 |
+| 依存管理 | 單一 ZIP | WP 依存解析複雜 |
+| Feature flags | 統一管理 | 跨 sub-AddOn 同步 |
+| UX | 一鍵啟用 | 分次啟用 |
+
+---
+
+## CLI
+
+```bash
+wp tmdo hivepress detect
+wp tmdo hivepress benchmark
+wp tmdo hivepress import-hpct --dry-run
+wp tmdo hivepress score          # 8 維 anti-EAV 評分
+wp tmdo hivepress doctor
+```
+
+---
+
+## Phase
+
+Phase 3 — 與 [WooCommerce AddOn](../2meet-data-optimizer-woocommerce-addon/) 與 [LatePoint AddOn](../2meet-data-optimizer-latepoint-addon/) 同期 ship。風險最高的 phase。
+
+---
+
+## License
+
+GPL-2.0-or-later