first commit

HANDOFF.md

@@ -0,0 +1,45 @@
+# Project Handoff
+
+## 先看
+
+1. [ROADMAP.md](/Users/chirs/Documents/workspace/marketing/mkt.ose.tw/ROADMAP.md)
+2. [docs/INDEX.md](/Users/chirs/Documents/workspace/marketing/mkt.ose.tw/docs/INDEX.md)
+3. [docs/EXECUTION_PLAN.md](/Users/chirs/Documents/workspace/marketing/mkt.ose.tw/docs/EXECUTION_PLAN.md)
+4. [docs/CURRENT_WORK_ITEMS.md](/Users/chirs/Documents/workspace/marketing/mkt.ose.tw/docs/CURRENT_WORK_ITEMS.md)
+
+## 系統目標
+
+- 建立可實際運行的銷售實驗平台
+- 核心流程：`Experiment -> Variant -> Editor -> Release -> Runtime`
+- FastAPI 為產品 API 主入口，Directus 為 CMS / Identity 底座
+
+## 現在主線
+
+- Phase A：文件治理與結構收斂
+- Phase B：Visual Editor 穩定化
+- Phase C：管理流 API 與頁面補齊
+
+## 本輪強制規格（先遵守）
+
+- URL 規則 + 裝置限制決定實驗命中
+- 建立 Experiment 時自動建立原始 Variant
+- 移除 `is_control`
+- 移除 `variant_changes.enabled`
+- `experiment_key` 由系統生 `EX+timestamp`
+- `variant_key` 由系統生 `VA+timestamp`
+- Variant 使用者只可編輯 `name` / `traffic_weight`
+
+## 重要程式入口
+
+- Frontend Editor：`frontend/src/module/editor/*`
+- Frontend 管理流：`frontend/src/module/experiment`、`variant`、`release`
+- Backend API：`backend/app/api/*`
+- Backend domain/service：`backend/app/domain`、`backend/app/services`
+- Bridge snippet：`frontend/public/editor-bridge-snippet.js`
+
+## 文件維護規則
+
+- 方向只寫 `ROADMAP.md`
+- 任務只寫 `docs/EXECUTION_PLAN.md`
+- 當前細項只寫 `docs/CURRENT_WORK_ITEMS.md`
+- 細修 backlog 只寫 `docs/DEFERRED_POLISH_BACKLOG.md`