first commit

docs/EXECUTION_PLAN.md

@@ -0,0 +1,80 @@
+# 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` 只放不阻擋主線的細修