# 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