chore: initial snapshot of 2meet-data-optimizer-woocommerce-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 47288db826
17 changed files with 3903 additions and 0 deletions
@@ -0,0 +1,65 @@
+# 2meet Data Optimizer — WooCommerce AddOn
+
+> 為 **WooCommerce** 提供 schema 註冊、commission tracking 與 product/order 反 EAV 加速。
+
+---
+
+## What it does
+
+| 項目 | 內容 |
+|---|---|
+| Custom tables | WC 20 張 schema 註冊到 TMDO Custom Table Registry（`wc_admin_notes` / `wc_orders` (HPOS) / `wc_product_meta_lookup` 等）|
+| Product zone | `_price` / `_sku` / `_stock_status` / `_featured` 等 11 欄位 → Hot zone (indexed) |
+| Cold zone | `_product_attributes` / `_purchase_note` |
+| Subscription | WC Subscriptions 偵測 + 對應欄位 |
+| Order zone | `_order_total` / `_billing_email` / `_payment_method` 等（HPOS 關閉時）|
+| Customer entity | `_money_spent` / `_order_count` / `_last_order` |
+| Commission tracking | `wp_wpdo_wc_commissions` 表（marketplace `_hp_vendor` / `_hp_commission` 等）|
+| Term count filter | `product_count_*` termmeta → wp_options transient（避免 termmeta 脹大）|
+| HPOS notice | 偵測 HPOS 是否啟用，未啟用時 admin notice 推薦升級 |
+
+---
+
+## Requirements
+
+- WordPress ≥ 6.0
+- PHP ≥ 8.1
+- 2meet-data-optimizer ≥ 0.1.0
+- WooCommerce ≥ 3.3（HPOS 表本身需 8.2+）
+- **軟相依**：`2meet-data-optimizer-hivepress-addon` — commission tracking 需要 HP marketplace 提供 `_hp_vendor` / `_hp_listing` 等 meta，WC-only 站台 commission interceptor 會自動 skip
+
+---
+
+## Installation
+
+```bash
+wp plugin install /path/to/2meet-data-optimizer-woocommerce-addon-v0.1.0.zip --activate
+
+# 驗證
+wp tmdo custom-tables --provider=woocommerce
+wp tmdo doctor --table=wpdo_wc_commissions
+```
+
+---
+
+## HPOS（High Performance Order Storage）
+
+WooCommerce 8.2+ 引入 HPOS 後，order 自有 custom table，本 AddOn 偵測到 HPOS 啟用時會：
+
+- ✅ 仍註冊 20 張 WC 表到 Custom Table Registry（doctor 健診）
+- ✅ 仍處理 `_hp_vendor` / `_hp_commission` 等 marketplace meta
+- ❌ 不再為 order 建獨立 zone（HPOS 已是反 EAV，無需重複）
+
+未啟用 HPOS 的舊站台：本 AddOn 為 order 建 Hot zone（5 欄位）作為 legacy 加速。
+
+---
+
+## Phase
+
+Phase 3 — 與 [HivePress AddOn](../2meet-data-optimizer-hivepress-addon/) 與 [LatePoint AddOn](../2meet-data-optimizer-latepoint-addon/) 同期 ship。
+
+---
+
+## License
+
+GPL-2.0-or-later