# Execution Plan

## 目的

這份是唯一任務主控文件，只記：

- 現在做什麼
- 下一階段做什麼
- 每階段完成定義（DoD）

## Phase A：文件治理（優先）

### 交付

- 文件重整到 `docs/frontend`、`docs/backend`、`docs/validation`、`docs/operations`
- 舊文件清理完成，連結修正完成

### DoD

- [INDEX.md](/Users/chirs/Documents/workspace/marketing/mkt.ose.tw/docs/INDEX.md) 可 2 次點擊內定位主要主題
- 不再存在重複入口文件

## Phase B：Frontend 主線（Visual Editor 穩定）

### 交付

- hover / selected 框、泡泡編輯、結構操作、undo/redo 一致
- toolbar 與畫布編輯流程穩定

### DoD

- 20+ 高頻操作案例連續通過
- 無阻塞型錯誤（無法編輯、history 失效、selector 無法定位）

## Phase C：Backend 主線（實驗管理流）

### 交付

- experiment / variant / release / goals API 可完整支援後台流程
- release build / publish / rollback 可運作
- 套用這輪新規格：
  - experiment_key / variant_key 系統生成
  - 建立 experiment 時自動建立原始 variant
  - variant 移除 status / is_control
  - variant_changes 移除 enabled
  - targeting 改為 URL 規則 + 裝置限制

### DoD

- 從建立實驗到發布/回退能跑通整條鏈路
- DTO 與 API 契約固定 v1
- 新增/編輯表單不再要求使用者輸入 key、control、enabled、variant status

## Phase D：Runtime / SDK

### 交付

- snippet 載入 runtime API
- assignment / payload / events 可用

### DoD

- 真實頁面可分流套用變更，事件可回傳

## Phase E：Staging / Production Readiness

### 交付

- validation、go/no-go、rollback、deployment 手冊可執行
- 回歸與 smoke 流程固定

### DoD

- staging 完成一輪上線演練與回退演練

## 任務維護規則

- `ROADMAP.md` 只放方向，不放細節流水帳
- `CURRENT_WORK_ITEMS.md` 只放當前迭代細項
- `DEFERRED_POLISH_BACKLOG.md` 只放不阻擋主線的細修